Data selection

In addition to the data source configuration, you need to provide a data selection configuration to specify the data you want the AVEVA Events to CONNECT to collect from the data sources.

Configure AVEVA Events to CONNECT data selection using Curl commands

Complete the following steps to configure an AVEVA Events to CONNECT data selection. Use the PUT method in conjunction with the api/v1/configuration/<ComponentId>/DataSelection REST endpoint to initialize the configuration.

1. Use a text editor to create an empty text file.

2. Copy and paste an example configuration for AVEVA Events to CONNECT data selection into the file. For sample JSON, see Data selection examples.

3. Update the example JSON parameters for your environment. For a table of all available parameters, see Data selection parameters.

4. Save the file. For example, as ConfigureDataSelection.json.

5. Open a command line session. Change directory to the location of ConfigureDataSelection.json.

6. Enter the following curl command (which uses the PUT method) to initialize the data selection configuration.

   curl.exe --ntlm --negotiate -u <UserName> -d "@ConfigureDataSelection.json" -H "Content-Type: application/json" -X PUT http://localhost:5590/api/v1/configuration/EventsToCONNECTComponent1/DataSelection

   Notes:
   If you installed the agent to listen on a non-default port, update 5590 to the port number in use.
   If you use a component ID other than EventsToCONNECTComponent1, update the endpoint with your chosen component ID.
   For a list of other REST operations you can perform, like updating or deleting a data selection configuration, see Data selection REST URLs.

Configure AVEVA Events to CONNECT data selection using the Configurator plugin

Data selection items can be added, edited, or deleted in the Data Ingress Data Selection tab for the selected component.

Create a new data selection item

To add a data selection item:

7. Select Add.

8. To form the data selection item, enter values for the Data Selection Details input fields including the following:

   Selected

   A data selection item will be selected for data collection only if it is ‘Enabled’.

   Type

   

   Action

   

   Resource Id

   

   Query Id

   Specifies the unique identifier of a configured query in order to filter the data.

   Schedule Id (Optional)

   Select a blank Schedule Id if the data selection item is intended to be picked up for data collection only when the data selection is updated.

   Message Fields

   

   The message fields specify the JSON property names in the response from on-premises REST API call that agent makes to fetch event data.

   For more information on the input fields, see the Data selection parameters.

   For recommendations on using Data Selection items to publish types and event data, see Using Data Selection to publish types and events to CONNECT data services .

Modify a data selection item

To edit a data selection item:

9. Select an existing item from the Data Selection list.

10. Update the input fields.

    The Data Selection Name will be read-only once it has been created.

Delete a data selection item

To delete a data selection item:

11. Select an existing item from the Data Selection list.

12. Select Delete.