Insights Hub 如何通过Agent Management Service API和MindConnect API创建数据映射？

我们在使用Insights Hub平台过程中，可能平台提供的App无法满足我们的功能需求，此时我们可能需要开发自己的App，在开发过程可能需要将代理(agent)中的数据点(datapoint)与asset引用的aspect中的变量(asset attribute )建立数据映射，如果是在UI界面中，我们可以直接通过手动创建数据映射。如果我们需要通过API来实现自动创建数据映射，API创建数据映射的操作步骤如下：

• 首先我们需要使用 POST API https://gateway.{域名信息}/api/technicaltokenmanager/v3/oauth/token 通过 App应用凭证信息获取token, 选择 Basic Auth，输入client id 和client secret，在输入body，然后点击发送获取token。如图所示：

body信息如下：

{
  "appName": "mindspherepvt",
  "appVersion": "1.0.0",
  "hostTenant": "suppdev",
  "userTenant": "suppdev",
  "grant_type":"client_credentials"
}

• 我们先在UI中创建代理（agent），创建数据源，然后使用Agent Management Service提供的API：GET /agents/{id}/boarding/configuration 接口获取配置信息。创建代理创建数据源我们都可以通过API来实现，但是我们这里展示数据映射功能，所以为了方便，我们手动创建代理和数据点，关于如何创建代理和数据API可以参考链接中的内容：https://developer.mindsphere.io/zh/apis/connectivity-agentmanagement/api-agentmanagement-api-swagger-v3-3-0.html ， postman调用示例图如下 ：

agent id获取：点击assetmanager中创建的agent，在地址栏中显示的selectd=后面的值为agentid的值，如下图所示 ：

• 先使用MindConnect API服务提供的API接口GET api/mindconnect/v3/dataPointMapping获取先获取agent中已有的数据源datasourceId，代理的agent id，如图所示：

• 使用MindConnect API服务提供的API接口：POST  api/mindconnect/v3/dataPointMappings  通过body中json格式创建数据映射,body格式如下：

{

  "agentId": "013db2f935ad4337a23c7ee9ed717499",（点击代理获取selesct后面的agent id）

  "dataPointId": "917b10fd1d124",(数据映射id，缺省时系统自动创建)

  "entityId": "5b3376469a5843aa87bfabd906f10892", （点击asset获取selesct后面的asset id）

  "propertySetName": "test_del", （aspect  name名称）

  "propertyName": "dd", （变量名称的值）

  "keepMapping": false （自动删除映射或者保持已有的映射，false删除映射）

}

注意：括号中的为注释说明，使用时需要删除

body中asset id的获取：点击在Asset Manager中创建的asset，在地址栏中显示的selectd=后面的值为assetid，如下图所示 

其中 Mindconnect API使用信息请参考链接中的内容https://developer.mindsphere.io/zh/apis/connectivity-mindconnect/api-mindconnect-api-swagger-v3-5-0.html