Studio Web 用户指南

适用平台：

上次更新日期 2025年9月22日

IF条件

“If 条件”活动允许 API 工作流中的条件分支，以根据数据驱动的条件创建动态执行路径。对于需要执行不同操作（具体取决于实时 API 响应、用户输入或系统状态）的工作流，请使用“If 条件”活动。

使用“If 条件”活动

要将“If 条件”活动添加到工作流中，请执行以下操作：

在 API 工作流设计器画布上，选择加号 (+) 图标。系统将显示“添加活动”菜单。
选择“IF 条件”。
在属性面板中，向条件字段写入表达式。
根据需要向Then和Else分支添加活动。
测试工作流以执行活动并生成输出字段以供以后使用。

“If 条件”活动示例

以下示例可确保事务同步工作流仅处理在过去 24 小时内至少进行了一项事务的活跃客户。如果不满足条件，工作流将退出并显示失败响应。

打开“调试配置”窗口，然后粘贴并保存以下 JSON 语法：

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-25T10:30:00Z"
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-25T10:30:00Z"
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

在 API 工作流设计器画布上，添加“If条件”活动。
在属性面板中选择“条件”字段以打开“表达式编辑器”。

使用 Autopilot 表达式生成器创建条件，并提示以下内容：

“编写一个条件语句，以检查输入请求是否针对活跃客户，以及是否在过去 24 小时内至少创建了一个事务对象”。

响应应如下所示：

const now = new Date();
const twentyFourHoursAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000);

if ($workflow.input.isActive) {
  const recentTransactions = $workflow.input.transactions.filter(transaction => {
    const transactionTimestamp = new Date(transaction.timestamp);
    return transactionTimestamp > twentyFourHoursAgo;
  });

  const hasRecentTransactions = recentTransactions.length > 0;

  hasRecentTransactions;
} else {
  false;
}const now = new Date();
const twentyFourHoursAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000);

if ($workflow.input.isActive) {
  const recentTransactions = $workflow.input.transactions.filter(transaction => {
    const transactionTimestamp = new Date(transaction.timestamp);
    return transactionTimestamp > twentyFourHoursAgo;
  });

  const hasRecentTransactions = recentTransactions.length > 0;

  hasRecentTransactions;
} else {
  false;
}

检查“活动测试输入”和“表达式输出”面板，以验证表达式是否生成了预期的结果。
保存条件配置。
在“Then”分支中，添加“响应”活动。
按如下方式配置响应：
- 类型— 失败
- 详细信息— 打开“表达式编辑器”，写入以下内容:
```
{
    message: "Customer is not active or no transaction to process"
}{
    message: "Customer is not active or no transaction to process"
}
```
此步骤在工作流开头添加验证，以在处理之前确认存在有效事务。