宜搭表单字段如何取到数据管理界面的“实例状态”字段

你好，要获取表单实例在数据管理界面中的“实例状态”字段的值，需要使用连接器去调用钉钉开放平台接口来实现。
连接器使用文档：https://docs.aliwork.com/docs/yida_support/wtwabe/zevvr1/_1/zbq17y
钉钉开放平台接口文档：https://open.dingtalk.com/document/orgapp/queries-a-process-instance-based-on-its-id#h2-sr5-vfm-ad9
更多使用案例参考：https://docs.aliwork.com/docs/yida_subject/qrtkhsoac388k3m0

在阿里巴巴的宜搭平台上，若要获取表单实例在数据管理界面中的“实例状态”字段的值，通常会在编程逻辑、API调用或者页面展示时涉及此操作。以下是一般步骤：

1. 页面展示：

   • 如果要在表单页面直接展示已有的实例状态，可通过内置组件（例如动态表格、详情展示控件等）关联对应表单字段，设置数据源绑定至表单实例，并且找到对应的“实例状态”字段展示出来。

2. API调用获取：

   • 使用钉钉开放平台的API（如get_form_instance_data等接口）查询表单实例数据时，“实例状态”作为一个属性存在于返回的结果中。在请求体中指定表单实例ID，并在响应数据中查找表示实例状态的字段。

3. 流程状态获取：

   • 若“实例状态”是指业务流程中的状态，那么可能需要通过调用工作流API来获取流程实例的状态，并映射到表单实例状态上。

{
  "method": "POST",
  "url": "https://oapi.dingtalk.com/topapi/form/instance/get",
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer ACCESS_TOKEN"
  },
  "body": {
    "process_code": "your_process_code",
    "form_instance_id": "your_form_instance_id"
  }
}

响应数据中会包含表单实例的所有字段信息，从中提取出“实例状态”的字段值即可。