Skip to main content

吉客云服务调用

访问路径：数据抽取 -> Restful服务调用 -> 吉客云服务调用

功能简述​

该功能模块提供了远程调用吉客云服务以获取特定客户数据的能力，并且系统集成了吉客云API接口中涉及到的账号验证和Token管理等功能，实际使用时，不再需要做额外处理。

服务定义​

调用吉客云接口前需要预定义相应的API接口信息。在创建一个API_RESTFUL类型的数据源后，再创建一个与之关联的应用（数据库），并配置相应的授权信息。

DB

  • 数据源：预定义的API_RESTFUL类型的数据源名称
  • 业务库名：自定义业务名
  • 数据库/应用/站点：自定义业务名
  • AgentID/AccessID: 吉客云授权的访问ID
  • Secret Key: 吉客云授权的密钥

创建对应的应用后，即可以在该应用（数据库）下创建多个API接口（表）记录：

API

  • 数据库/应用：预先定义的API_RESTFUL类型，（数据库级别定义）
  • 表名：定义用于标识当前API接口名称
  • 服务地址：对应于吉客云API接口的全链接地址，后续任务运行时，将会读取该地址进行访问

服务调用​

在任务包设计界面中，通过数据抽取 - Restful服务调用 - 吉客云服务调用功能来创建一个吉客云接口数据同步任务。

Basic

  • 子节点数据：该选项中选择本地创建的工作表，表结构需要按接口中获取的数据（数组元素项）结构来定义。

Info

在接口调用页签中，点击查询按钮，选择需要调用的预定义接口信息。并根据当前接口属性选择相应的调用方法。

如果当前接口需要循环多次调用的话，可以在任务脚本页签中通过SQL脚本实现，SQL查询出的记录数，就是当前任务重复调用的次数，并且，系统在每次循环调用前，均会使用SQL查询结果中对应的行数据来初始化当前调用的提交数据内容。

如当前案例中，就使用了数据遍历变量模式：<db:start_dt_str/>变量来提取每次SQL查询结果中对应的开始和结束时间，并作为参数重新调用吉客云接口，从而获取不同时间段内的业务数据。

注：

  • 因为吉客云的销售部分数据是通过奇门接口做二次封装后获取的，所以涉及到该类接口调用时，需要勾选是否需要清理奇门数据格式选项，从而才可以正确的解析出结果。
  • 子节点路径：对应的是需要提取的数据节点在接口返回的JSON结构中的路径。如果含奇门数据，则需要在节点路径中通过添加-符号来增加二次封装的奇门数据的节点名称。如果不含奇门数据， 则仅使用.号拼接节点路径地址即可。

Mapping

节点中数据的匹配模式中，来源字段中包含的是接口返回的JSON数组元素的属性路径值，如果含多层路径，则可以使用相对路径匹配，如pay.no来对应目标字段里面的payno

其它任务选项​

当前任务中的前置脚本,善后脚本，分别在当前数据同步前、后执行，用于对同步数据进行预处理，和同步后的再清理计算等用途。可以根据场景需求采用。