tenant details

将消息来源实体的租户详情（如名称、邮箱、国家）添加到消息data或metadata。

配置

节点配置允许选择要获取的租户详情及其在消息中的放置位置。

• Select details：要获取的租户详情集合。至少需选择一项。可用选项：
  • Id：租户的唯一标识符。
  • Title：租户名称。
  • Country：租户国家。
  • State：州/省。
  • City：城市。
  • Zip：邮编。
  • Address：主要街道地址。
  • Address2：次要街道地址。
  • Email：联系邮箱地址。
  • Phone：联系电话。
  • Additional Info：租户 additionalInfo JSON对象中的 description 字段。
• Add selected details to：确定获取的租户详情的目标位置。
  • Message：将详情添加到消息data负载。消息data必须为JSON对象才能成功。
  • Metadata：将详情添加到消息metadata。

JSON Schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "TbGetTenantDetailsNodeConfiguration",
  "type": "object",
  "properties": {
    "detailsList": {
      "type": "array",
      "description": "A set of tenant details to fetch.",
      "items": {
        "type": "string",
        "enum": [
          "ID",
          "TITLE",
          "COUNTRY",
          "STATE",
          "CITY",
          "ZIP",
          "ADDRESS",
          "ADDRESS2",
          "EMAIL",
          "PHONE",
          "ADDITIONAL_INFO"
        ]
      }
    },
    "fetchTo": {
      "type": "string",
      "description": "Destination for the fetched details (message data or metadata).",
      "enum": [
        "DATA",
        "METADATA"
      ]
    }
  },
  "required": [
    "detailsList",
    "fetchTo"
  ],
  "additionalProperties": false
}

消息处理逻辑

1. 节点识别与入站消息关联的租户。
2. 读取Select details集合以确定要获取的租户详情。
3. 节点异步从租户获取所选详情的值。
4. 对每个获取的详情，通过在详情名称前添加 tenant_ 创建新键。例如，选择 Email 得到键 tenant_email，Title 得到 tenant_title。
5. 若租户未设置所选详情，则跳过不添加到消息。
6. 根据Add selected details to设置，节点将结果键值对（如 "tenant_email": "info@example.com"）添加到消息data或metadata。
7. 丰富后的消息经 Success 连接转发。若发生错误（如尝试向非JSON消息data添加详情），原始消息经 Failure 连接路由。

输出连接

• Success：消息已成功使用租户详情丰富。
• Failure：处理过程中发生错误。例如，Add selected details to 设为 Message 但入站消息data不是有效JSON对象时。

示例

示例1：将租户联系信息添加到metadata

入站消息

Metadata: {}

节点配置

1
2
3
4
5
6
7
{
  "detailsList": [
    "TITLE",
    "EMAIL"
  ],
  "fetchTo": "METADATA"
}

系统状态

当前租户的title为 Building Corp，邮箱为 example@building-corp.com。

出站消息

节点将获取的详情添加到metadata，消息经 Success 连接路由。

Metadata:

1
2
3
4
{
  "tenant_title": "Building Corp",
  "tenant_email": "alerts@building-corp.com"
}

说明：节点从租户获取 Title 和 Email，并以键 tenant_title 和 tenant_email 添加到消息metadata。

示例2：将租户位置添加到消息data

入站消息：

Data: {}

节点配置：

1
2
3
4
5
6
{
  "detailsList": [
    "COUNTRY"
  ],
  "fetchTo": "DATA"
}

系统状态

当前租户的国家设置为 Ukraine。

出站消息

新键值对合并到消息data的JSON对象中。消息经 Success 连接路由。

Data:

1
2
3
{
  "tenant_country": "Ukraine"
}

说明：节点从租户获取 Country，并以键 tenant_country 添加到消息data。