Configure access
datasourceConfig¶
connecting applications to datasource instances¶
In SINUMERIK Edge, applications can share or require data to communicate with each other. Available data is defined as datasource instance - identified by a unique ID. In order to access data of available datasources, "datasourceConfig" section of "appconfig.json" needs to be configured properly.
"datasourceConfig" object consists of "providedDatasource" and "requiredDatasource" objects.
Inside "requiredDatasource" objects, the requirements of a data consuming application are defined. This application wants to access data of a datasource. Inside "providedDatasource" objects, the available data which is provided for other applications by several services are defined. Most known datasource providing application is the SINUMERIK adapter.
Every service has its own custom settings. Please refer to the corresponding service documentation of the supported services to get details about the configuration.
Rename datasources Each datasource instance is identified by a unique id. The id can be changed by changing the “datasourceId” to your needs. Take care, to modify the providers and corresponding consumers of the datasource consistent to not break any existing connections.
Example
The configuration of an sample data providing application looks like this
{
"datasourceConfig": {
"providedDatasource": [
{
"datasourceId": "downsample database",
"type": "SAMPLE_DATA",
"services": {
"parameter-service/v1":{
}
}
}
]
}
}
Attention!: Unless explicity stated in the documentation of the corresponding app, do not change settings other than the datasourceId in the providedDatasource section.
Attention!: Do not change the type of a datasource!
After this, have a look to other installed Applications. An application which needs access to the datasource might look like this:
{
"datasourceConfig": {
"requiredDatasource": [
{
"datasourceId": "downsample database",
"type": "SAMPLE_DATA",
"services": {
"parameter-service/v1":{
}
}
}
]
}
}
This datasource also has to address the new id to connect to the datasource. Otherwise this application will not work. * "datasourceId": "myMachine" *
Attention!: There will be no check and no feedback if you select a non existing “datasourceId”. Please carefully check the configuration before saving the configuration to the SINUMERIK Edge.
Diagnose On configuration error, a short error message in the configuration jobs response can be found in the responsible configuration backend. Error details can be found in the logfiles. Also refer to the UI of the AdapterFramework - this can be found at the dashboard on the SINUMERIK Edge.
Attention: Always verify the resulting status of a configuration job.
Attention! There will be no warning or error message if you configure a subscription to datapoints which are not available. If the application does not get the subscribed data messages, you might get information in the log files of the datasource providing application.
data access services¶
Supported services are:
- parameter-service/v1
- subscription-service/v1
- information-service/v1
Any questions left?
Except where otherwise noted, content on this site is licensed under the The Siemens Inner Source License - 1.1.