Set up InRobot with the CDF Toolkit
Follow the steps in this article to set up InRobot with the CDF Toolkit.
When deploying InRobot with the toolkit, all changes you make in the user interface will be overwritten by the next change in the toolkit.
Before you start
Make sure you have the following:
-
A Cognite project you can use to access Cognite Data Fusion.
-
A classic asset hierarchy in place. In Data explorer in
CDF, note the External ID of the root asset; you'll need it for your location. -
The following groups in your source system (
Azure portal):Group Purpose Users_<Location>
The users can access all InRobot functionality, such as controlling the robot, creating and running missions, etc. Admin_<Location>
The users can access the CDF project and create assets, data models, 3D models, see functions, etc. Robot_1_<Location>
The robot can write the robotics data, download robot-specific files, such as maps, read or access uploaded robot data, upload the collected data to CDF, etc. Run_Function_User
The function that runs on images that the robot has created. The function can write labels, time series, files, data model instances, events, annotations, etc.
If you need to add more locations and robots, ensure that the groups are clearly named.
-
A 3D model of the location where the robot inspection will take place. In Data management > Data explorer > 3D, select your model and note its name; from the URL, note the model
modelId
andrevisionId
. -
An application registered in the Azure portal. Copy and store the Application (client) ID (clientId) and the Directory (tenant) ID (tenantID) values securely.
-
A client secret. Copy and store the client secret value securely.
-
Access groups. Copy and store the Object Id of the created group securely.
-
Functions service activated for your project. Go to
CDF> Data management > Build solutions > Functions > Activate functions. It can take up to 2 hours to activate the functions service.
Use toolkit
To set up InRobot with the CDF Toolkit:
- Install and configure the CDF Toolkit.
- Make sure you added URLs to your allowlist.
- If necessary, contact Cognite Support to enable sign-in to InRobot.
- In config.<env>.yaml, replace the
<change_me>
values. The config file has three modulesinrobot
,common
, andcdf_apm_base
that must be used together.
InRobot module
Set up the following InRobot variables:
inrobot module
inrobot:
first_root_asset_external_id: "<change_me>"
inrobot_admin_first_location_source_id: <change_me>
inrobot_users_first_location_source_id: <change_me>
robot_1_first_location_source_id: <change_me>
run_function_user_group_source_id: <change_me>
run_function_client_id: <change_me>
run_function_secret: ${<change_me>}
robot_1_dataset_ext_id: "<change_me>"
three_d_model_name: "<change_me>"
three_d_type: "<change_me>" # either THREEDMODEL or POINTCLOUD
three_d_model_id: <change_me>
three_d_revision_id: <change_me>
Variable name | Description |
---|---|
first_root_asset_external_id | The external ID for your root asset. |
first_location | A human-readable name included as a part of different location-specific spaces and groups. |
inrobot_admin_first_location_source_id | The ID for the admin group for the location. |
inrobot_users_first_location_source_id | The ID for the user group for the location. |
robot_1_first_location_source_id | The ID for the robot group for the location. |
run_function_user_group_source_id | The ID for the run function group. |
run_function_client_id | The run function client ID (app registration in Azure). |
run_function_secret | The secret for the run function app registration. This will be stored in your .env file and should be referenced securely. |
robot_1_dataset_ext_id | This is the data set for your robot. You can give this whatever value you want. |
three_d_model_name | The name of the 3D model as named in CDF. |
three_d_type | The type of 3D model, either THREEDMODEL or POINTCLOUD . |
three_d_model_id | The model ID of your 3D model. |
three_d_revision_id | The revision ID of your 3D model. |
CDF APM Base module
Do not include this module if you've already set up InField. If you've included the module and run into an error, rerun the toolkit command without the cdf_apm_base
module.
cdf_apm_base module
cdf_apm_base:
apm_datamodel_space: "<change_me>"
apm_datamodel_version: "<change_me>"
Set up the following data modeling configuration variables:
Variable name | Description |
---|---|
apm_datamodel_space | The space used for the APM data model. Most customers can use APM_SourceData . |
apm_datamodel_version | The version of the APM data model. Most customers can use 1 . |
To introduce a new robot or location, contact InRobot support for help. There will be toolkit support for this process in the future.
Сommon module
common module
cdf_auth_readwrite_all:
readwrite_source_id: <change_me>
readonly_source_id: <change_me>
If you've created the toolkit admin groups in Azure, you can set up the following variables:
Variable name | Description |
---|---|
readwrite_source_id | The ID for the group that can create, edit, and delete groups, access spaces, etc., for the toolkit. |
readonly_source_id | The ID for the group that can only view groups, spaces, functions, data, etc. |