PutZendeskTicket

说明

该 Processor 使用 Zendesk API 把工单写入 Zendesk。该 Processor 可以直接从 FlowFile 内容发送请求，也可以使用 RecordReader 从传入记录构建请求对象。

认证

Zendesk API 使用基本认证。必须提供密码或认证令牌之一。在 Zendesk API Settings 中可以生成认证令牌，这样用户无需暴露 密码。这种方式还提供了需要时快速吊销令牌的优势。

属性值

向请求对象提供属性值有多种方式：

Record Path：

如果值提供在以 '%' 开头的方括号内，属性值会作为 record path 求值。

示例：

传入记录如下。

{
  "record": {
    "description": "This is a sample description.",
    "issue\_type": "Immediate",
    "issue": {
      "name": "General error",
      "type": "Immediate"
    },
    "project": {
      "name": "Maintenance"
    }
  }
}

我们要为 Comment Body、Subject、Priority 和 Type Processor 属性提供 Record Path 值：

Comment Body : %{/record/description}
Subject : %{/record/issue/name}
Priority : %{/record/issue/type}
Type : %{/record/project/name}

将要发送给 Zendesk API 的构建请求对象如下：

{
  "comment": {
    "body": "This is a sample description."
  },
  "subject": "General error",
  "priority": "Immediate",
  "type": "Maintenance"
}

常量：

如果提供的值不符合 Record Path 格式，属性值会被视为常量。

示例：

我们要为 Comment Body、Subject、Priority 和 Type Processor 属性提供常量值：

Comment Body : Sample description
Subject : Sample subject
Priority : High
Type : Sample type

将要发送给 Zendesk API 的构建请求对象如下：

{
  "comment": {
    "body": "Sample description"
  },
  "subject": "Sample subject",
  "priority": "High",
  "type": "Sample type"
}

附加属性

该 Processor 的属性列表中提供了一组常用的 Zendesk 工单属性。不过，用户可以使用动态属性灵活地包含任意数量的 附加属性。这些动态属性的键用作 Json Pointer，表示请求对象内的路径。相应地，这些动态属性的值 与预定义的属性属性对齐。可能的 Zendesk 请求属性参见 Zendesk API 文档。

属性键的值：

动态属性的键必须是有效的 Json Pointer 值，其语法规则如下：

• 路径以 / 开头。
• 每个段由 / 分隔。
• 每个段可以解释为数组索引或对象键。

示例：

我们要给该 Processor 添加新的动态属性：

/request/new_object : This is a new property
/request/new_array/0 : This is a new array element

构建的请求对象如下：

{
  "request": {
    "new_object": "This is a new property",
    "new_array": [
      "This is a new array element"
    ]
  }
}