外部操作配置

转到​管理 > 配置。

单击中间面板上的​外部操作。

{width="800" modal="regular"}

单击右上方的​创建操作。

输入外部服务的OpenAPI规范的URL，然后单击​创建。

{width="500"}

外部服务必须处于活动状态并且可访问，才能成功完成此步骤。 如果存在验证错误，对话框将显示一条描述错误的消息以及解决该错误的建议。 有关详细信息，请参阅​疑难解答。

成功解析URL后，查看​服务详细信息。

创建操作后，将直接从OpenAPI规范中读取服务详细信息。 创建后，无法在配置中更改这些属性。

输入外部服务(components.securitySchemes)的​ 身份验证 ​凭据。

{width="600" modal="regular"}

当配置的操作处于​ 草稿 ​或​ 活动 ​状态时，您可以根据需要更改凭据。

单击​下一步。

设置​ 配置 ​属性以定义操作与外部服务交换数据的方式。

• 操作类型 （静态） — 支持的历程节点类型：

  • 外部操作 (enableSplitPath = false)
  • 外部操作拆分路径 (enableSplitPath = true)

  创建操作配置后，无法更改操作类型。

• 访问器 （静态） — （仅限外部操作拆分路径）外部服务返回的变量可用作外部拆分路径节点中的路径条件。 (invocationPayloadDef.accessorsMetadata)

• 历程上下文 （静态） — 在请求中发送的受众数据的范围(supportedEntityType)：

  • 帐户 — 仅发送帐户

  • 人员 — 仅发送人员

  • 帐户中的人员 — 发送帐户和与帐户相关的人员

• 传出字段 — 将表中的每个字段映射到XDM字段。 这些字段在请求正文中发送到外部服务。 服务定义属性： invocationPayloadDef.accountFields，invocationPayloadDef.fields。

  {width="600" modal="regular"}

• 传入字段 — 将表中的每个字段映射到可更新的XDM字段。 这些字段从外部服务响应中填充。 服务定义属性： callbackPayloadDef.accountFields，callbackPayloadDef.fields。 创建后可更新。

• 标头参数 — 为请求中要作为HTTP标头传递的每一行输入一个值。 服务定义属性： invocationPayloadDef.headers。

• 超时 — 输入在请求被视为失败之前等待外部服务调用回调的分钟数。 服务定义属性： timeout。

• 全局属性 — 为每一行输入一个值，以作为静态字段包含在请求正文中。 服务定义属性： invocationPayloadDef.globalAttributes。

  {width="600" modal="regular"}

单击​ 上退箭头 ​返回列表并将操作保持在​ 草稿 ​状态。

或者，单击​ 激活 ​以将操作配置更改为​ 活动 ​状态。 配置的外部操作必须处于活动状态才能在帐户历程中使用。