Product Features
Integration
Add Topics to Connectors
12min
after adding a connector, you can now add topics to it you have several options for adding topics to connectors notes when configuring connector topics, you have the option to use one local topic to publish to multiple remote topics please consider the following when working with integration connectors the performance of outbound data in integration connectors is slow (around 4mb/sec) if you use the queue mode fifo (first in first out), this can lead to higher cpu usage add individual topics you can add outbound (local to remote) and inbound (remote to local) topics to connectors before you begin if you are adding individual outbound topics, you will need to connect the devicehub device and tags that will be used to create the topics see connect a device docid\ nm1lqfefya dsiffitity and add tags docid\ h5heqicxrcy3nch9kbg9i to learn more to add a topic to a connector from the integration pane, click the connector tile you want to add the topic to click the topics tab click the add a new subscription icon the data integration dialog box appears select a data direction from the data direction drop down list local to remote inbound remote to local outbound in the local data topic field, paste the raw topic for the tag or click the search icon and select the appropriate devicehub device and tag the remote data topic field may have a default value for the integration topic parameter of the connector if the field is blank, enter the remote data topic name enter a short description in the description field (if available) from the qos dropdown menu, select a quality of service value available values default , 0 , 1 , 2 click the enable toggle to enable the connection click ok if the connector is connected, the confirmation dialog box appears click yes follow the prompt to restart the connector the new topic appears on the topics pane and is enabled import tags from devicehub you can automatically import tags from a device in devicehub and convert them to topics to import tags from devicehub from the integration pane, click the connector tile you want to add the topic to click the topics tab click the import from devicehub tags icon the devicehub import dialog box displays select the checkbox for individual devices to import all the tags for that device alternatively, select the checkbox for raw / alias to select tags from all devicehub devices when done select tags to import, click yes, proceed with import use csv file you can upload a csv file of topics and automatically add them to the connector step 1 download sample csv file you will first need to download the sample file that will be used to upload the topics to add to the connector to download the sample file from the integration pane, click the connector tile you want to add the topic to click the topics tab click the download icon and select download a sample step 2 create csv file after downloading the file, use the template to enter all the topics that will be added to the connector required parameters important review the following for configuring the instance id and instance name for the csv file if the instance id and instance name aren't configured correctly, the entire csv file will be rejected and no topics will be uploaded if the instance id isn't configured correctly but the instance name is configured correctly, the appropriate instance id will be retrieved from the associated instance name and the csv file will upload topics successfully to the retrieved instance id you must enter data for the following parameters instance id this field must be entered correctly see the important note above retrieve this parameter by copying the instance identifier field from the connector tile instance name see the important note above retrieve this parameter from the name configured for the connector direction enter one of the following based on the direction of data for the topic inbound or outbound local remote topic if the topic is outbound , you will need to define the topic that will be sending the data our of manufacturing connect edge enter the local topic name or click the copy icon for the topic name from devicehub > tags if the topic is inbound , you can leave the field blank remote data topic if the topic is inbound , you will need to define the topic that will be used to pull data into manufacturing connect edge enter the name of the remote data topic if the topic is outbound , you can leave the field blank enable you must enter one of the following statuses depending if you want the topic enabled true or false qos only required for the following connectors enter one of the following values default , 0 , 1 , 2 mqtt generic mqtt generic over ssl mqtt system protobuf ssl mqtt system protobuf tcp optional parameters the description field is optional and can be left empty once you update the template csv file, you can upload it step 3 upload csv file to upload the csv file from the integration pane, click the connector tile you want to add the topic to click the topics tab click the add icon and select upload csv select the file and click open csv file example refer to the following csv file example that includes one inbound topic and one outbound topic https //archbee doc uploads s3 amazonaws com/ssuuxkzuk9bftepnn 6zo/xai8xnzupmexqedyia6dz csvfileexample csv