在执行请求中传递运行时参数

您可以在工作流执行请求中传递运行时实参，并使用工作流变量访问这些实参。

设置接收运行时参数的工作流

如需将工作流设置为接收您在执行请求中传递给它的运行时参数，请执行以下操作：

1. 按照相应步骤创建新工作流，或选择现有工作流进行更新，但请勿进行部署。

2. 在工作流的定义中添加一个 params 字段。确保将参数名称放在方括号内，并将主工作流放在 main 块中：

   YAML

   main:
     params: [ARG_NAME]
     steps:
       ...

   JSON

   {
     "main": {
       "params": ["ARG_NAME"],
       "steps": [
         ...
       ]
       ...
     }
   }
     

   main 块接受单个参数，该参数是任何有效的 JSON 数据类型的名称，例如数组、对象或字符串。

   最佳做法是传入具有多个已指定参数的对象，以便更轻松地理解其用途以及添加参数。然后，您可以使用点表示法访问参数。

   其他子工作流可以有多个参数。

   例如，以下工作流会向您以运行时参数传递其姓名的用户返回“Hello”问候语：

   YAML

   main:
     params: [args]
     steps:
       - step1:
           assign:
             - outputVar: ${"Hello, " + args.firstName + " " + args.lastName + "!"}
       - step2:
           return: ${outputVar}

   JSON

   {
     "main": {
       "params": [
         "args"
       ],
       "steps": [
         {
           "step1": {
             "assign": [
               {
                 "outputVar": "${\"Hello \" + args.firstName + \" \" + args.lastName}"
               }
             ]
           }
         },
         {
           "step2": {
             "return": "${outputVar}"
           }
         }
       ]
     }
   }
     

3. 部署您的工作流以完成创建或更新。

在执行请求中传递数据

如果您的工作流设置为接收运行时实参，您可以将 JSON 格式的字符串（如 {"firstName":"Workflows","lastName":"User"}）传递给执行请求中的工作流。