Skip to content

Data Source#

The Data Source Tasks can be categorized as Barcode, Generic Table, Query, System Core, or System MES. Each type is further described in the sections below.

Barcode#

The Barcode Data Source allows the use of barcodes to retrieve data. To configure a Barcode Data Source, you need to provide a name and, optionally, a description. You can also customize its behavior by adjusting the following settings:

  • Auto Refresh - When enabled, the page will automatically update its data at defined intervals. You can set the specific interval according to your needs. The default setting is false.
  • Retrieve Data on Start - When enabled, the system will fetch and display relevant data as soon as the page loads. The default setting is true.
  • Retrieve Data on Changes - When enabled, the system will update the data displayed whenever there are changes. The default setting is true.
  • Maximum Delay Between Keystrokes (ms) - Determines the maximum allowable time between keystrokes for barcode input, ensuring accurate data capture.
  • Minimum Barcode Length - Sets the shortest length of barcodes that will be recognized and processed by the system.
  • Disable Scan When Inside Input - Prevents barcode scanning from interfering when typing in input fields. The default setting is false.
  • Use Keyboard Emulation - Allows barcode scanning to mimic keyboard input for compatibility with different systems. The default setting is false.
  • Trigger Emulation on Release - Activates barcode scanning upon release of the scanner trigger. The default setting is false.

Data Source Barcode Settings

Smart Barcode Scanning

This data source supports Smart Barcodes.

Generic Table#

The Generic Table Data Source allows you to use predefined generic tables within the MES system. To configure this type of data source, you need to provide a name and, optionally, a description. You can customize its behavior by adjusting the following settings:

  • Auto Refresh - When enabled, the page will automatically update its data at defined intervals. You can set the specific interval according to your needs. The default setting is false.
  • Retrieve Data on Start - When enabled, the system will fetch and display relevant data as soon as the page loads. The default setting is true.
  • Retrieve Data on Changes - When enabled, the system will update the data displayed whenever there are changes. The default setting is true.
  • Generic Table - Specifies which generic table in the MES system to use as the data source.

Generic Table Data Source

Query#

The Query Data Source fetches data from either a saved query or an inline query definition supplied as JSON. If both are configured, the inline query definition takes precedence over the saved query. If the query has parameters, they can be sent through linking. To use this Data Source, provide a name and, optionally, a description. You can further customize its behavior by adjusting the following settings:

  • Auto Refresh - when enabled, the page will automatically update its data at defined intervals. You can set the specific interval according to your needs. The default setting is false.
  • Retrieve Data on Start - when enabled, the system will fetch and display relevant data as soon as the page loads. The default setting is true.
  • Retrieve Data on Changes - when enabled, the system will update the data display whenever there are changes in the underlying data. The default setting is true.
  • Show Feedback Messages - provides user feedback about the data retrieval process. The default setting is false.
  • Show Error Feedback Messages - alerts users to errors encountered during data retrieval. The default setting is false.
  • Use Default Page Size - when enabled, the system will use the value specified in the /Cmf/Guis/Configuration/Common/Paging/Default/PageSize/ configuration entry. The default setting is false.
  • Query - allows selection of a predefined query in the MES system to retrieve data. The system validates the query, where each query parameter becomes an input and each query column becomes an output.
  • Query Schema - defines an inline query object in JSON. The object must contain an EntityTypeName property and a Query object. The query parameters become inputs and the query fields become outputs. When a Query Schema is provided, it takes precedence over the selected Query.

Query Data Source

Use Query Schema when the page needs a query that is not saved in the MES system or when the query definition must be stored with the UI Page. To create the JSON definition, open the query's generated-code view, select the JSON tab, and copy the definition or export it as a .json file. The JSON object must include EntityTypeName and Query, and at least one of Query or Query Schema must be provided.

After editing the schema, select Apply Schema to update the inputs and outputs available for linking. Links to unchanged parameters are preserved. If applying the schema removes a query parameter or changes its type, confirm the removal of links to the affected parameters. Invalid JSON or a schema without the required properties cannot be applied or saved. Clear Query Schema and apply the change to use the selected Query again.

System (Core)#

The System (Core) Data Source provides data from the system regarding the user that is logged in, current date and time (local and UTC). To use this Data Source, provide a name and, optionally, a description. You can further customize its behavior by adjusting the following settings:

  • Auto Refresh - When enabled, the page will automatically update its data at defined intervals. You can set the specific interval according to your needs. The default setting is false.
  • Retrieve Data on Start - When enabled, the system will fetch and display relevant data as soon as the page loads. The default setting is true.

System Core Data Source

System (MES)#

The System (MES) Data Source provides data from the system regarding the user employee that is logged in. To use this Data Source, provide a name and, optionally, a description. You can further customize its behavior by adjusting the following settings:

  • Auto Refresh - When enabled, the page will automatically update its data at defined intervals. You can set the specific interval according to your needs. The default setting is false.
  • Retrieve Data on Start - When enabled, the system will fetch and display relevant data as soon as the page loads. The default setting is true.

System MES Data Source