氚云适配器配置指南

一、平台接口API文档

氚云是一款面向数字化管理员的开发工具，拥有可视化表单、自动化流程、智能报表、丰富API接口等强大功能，通过拖拉拽的积木搭建方式，让企业快速实现管理与业务移动在线，提升业务效率，降低管理成本，助力企业实现一站式数字化管理。

• 获取地址：氚云平台API文档
• 登录后台获取授权信息：请先登录后台以获取必要的授权信息。

二、连接器与适配器配置

2.1 连接器配置

• 平台选择：选择“氚云”作为您要连接的平台。
• 配置参数：
  • Host：输入氚云接口请求地址，例如 https://www.h3yun.com/OpenApi/Invoke
  • enginecode：此代码需从氚云后台获取。
  • enginesecret：此密钥也需从氚云后台获取。
• 示例方案链接：
  https://pro.qliang.cloud/strategy/detail/be25ecb2-a4d7-304b-93f7-c7d41302a5f4

2.2 适配器

• 查询适配器：选择“ChuanYunQueryAdapter”作为查询适配器。
• 写入适配器：选择“ChuanYunExecuteAdapter”作为写入适配器。

三、方案配置

3.1 查询配置

• 接口信息配置：指定API地址，如 CreateBizObject。
• 请求参数配置：根据接口的具体需求配置相应的请求参数。

3.1.1 Request参数配置

• 配置接口所需的请求参数。

3.1.2 OtherResponse参数配置（接口响应参数）

• StatusKey：接口响应状态字段，支持最多两级。
• StatusValue：接口响应成功状态的值。
• DataKey：接口响应数据的key，支持最多三级。
• PageKey：分页的key。

详情请求示例：

{
  "SchemaCode": "D2857047bf88e9f78cf42f9a2f1e24dbecffb8b",
  "BizObjectId": "e0c37dfc-d89d-4d32-878e-53605c679baa"
}

列表请求示例：

{
  "SchemaCode": "D2857047bf88e9f78cf42f9a2f1e24dbecffb8b",
  "BizObjectId": "e0c37dfc-d89d-4d32-878e-53605c679baa",
  "Filter": {
    "FromRowNum": "0",
    "RequireCount": "true",
    "ReturnItems": [],
    "SortByCollection": [],
    "ToRowNum": "100",
    "Matcher": {
      "Type": "",
      "And": "",
      "Matchers": []
    }
  }
}

3.2 写入配置

• 接口信息配置：指定API地址，如 CreateBizObject。

3.2.1 Request参数配置

• 根据接口文档要求配置参数。

3.2.2 OtherRequest参数配置

• 暂无特殊配置。

3.2.3 OtherResponse参数配置（接口响应参数）

• 参数配置与查询配置中的OtherResponse相同。

写入示例：

{
  "SchemaCode": "D2857047bf88e9f78cf42f9a2f1e24dbecffb8b",
  "BizObject": {
    "CreatedBy": "ff1311a6-ecc8-4445-83f2-1c8205d0af09",
    "OwnerId": "ff1311a6-ecc8-4445-83f2-1c8205d0af09",
    "F0000001": "测试001",
    "F0000002": "2024/5/14 0:00:00",
    "F0000003": "41545",
    "D285704Fa4152ce9f5b74d8eaa003aa4ccd0dc57": [
      {
        "F0000005": "123456",
        "F0000006": "12345689798"
      },
      {
        "F0000005": "f00005",
        "F0000006": "5"
      }
    ]
  },
  "IsSubmit": true
}

四、其他注意事项

4.1：搭建表单

如何得到表单code,及控制编码，在表单设计的时候，选中对应的表单控制，得到里面的信息
文档链接
https://help.h3yun.com/contents/1000/1614.html

4.2:授权配置获取

选择个人中心-》系统管理-》系统集成
链接地址
https://help.h3yun.com/contents/1005/1631.html

4.3: 表单字段设计说明

里面的具体字段说明，需要在表单设计里面找到