输入和输出

构造器中涉及的系统表达式

构造器中涉及的系统表达式如下：

• $Context：生命周期贯穿整个工作流执行过程，关于$Context的详细信息，请参见数据传递。

• $Input：生命周期开始于进入State，结束于State退出，是$Context.Current.Input的快捷形式。

• $Output：生命周期开始于进入任务调用返回，结束于State退出，是$Context.Current.Output的快捷形式。

下图展示了$Input、$Output和$Context这3个系统表达式的生命周期，以及它们是在不同状态下的赋值过程。

• 图中$Input表示在这个流程的执行输入。

• 图中$Input= InputConstructor表示在这个作用域内，InputConstructor构造完成之后，将构造的结果赋值给$Input。

• 图中$Output表示Task调用之后的返回结果，如果Task的调用是异步回调模式，那么$Output取值就是回调之后的返回结果。

• 图中$Output= OutputConstructor表示在这个作用域范围内，OutputConstructor构造完成之后，将构造的结果赋值给$Output。

• 图中$Context 贯穿全程，在工作流执行过程中共享上下文信息。

输入构造器

InputConstructor用于构建工作流的输入参数。输入构造器的表达式与选择（Choice）状态的条件表达式不同，条件表达式只能返回布尔值，而输入构造器的表达式可以返回任意值。状态输入构造器中可以使用的系统变量如下：

• $Context

• $Input

以下状态机定义示例显示了输入构造器的用法。

Type: StateMachine
Name: InputConstructExample
SpecVersion: v1
StartAt: InvokeFunction
States:
  - Type: Task
    Name: InvokeFunction
    Action: FC:InvokeFunction
    TaskMode: RequestComplete
    InputConstructor:
      FieldA.$: $Context.Execution.Input
      FieldB: World
      FieldC.$: length($Context.Execution.Input)
    Parameters:
      resourceArn: >-
        acs:fc:cn-hangzhou:123456:services/helloworld.LATEST/functions/helloworld
      invocationType: Sync
      body.$: $Input 
    End: true

• 输入构造器InputConstructor的数据结构为map[string]any。

• FieldA.$: $Context.Execution.Input表示FieldA将动态获取$Context.Execution.Input表达式的值，而不是当作字符串处理。

• FieldB: World表示FieldB的内容是World，若FieldB后面没有使用.$标记，后面的内容会当作字符串处理，而不是动态引用。

• FieldC.$: length($Context.Execution.Input)表示使用内置函数length获取$Context.Execution.Input值的长度，再将这个值赋值给FieldC。关于构造器中可使用的内置函数，请参见内置函数。

输出构造器

OutputConstructor与输入构造器相比，输出构造器除了执行时机不同，还可以使用更多的上下文表达式变量。例如，一个工作流集成，在输入构造器的位置，只可以使用$Context与$Input，而在输出构造器的位置，已经通过该 Task 调用产生输出，则可以使用$Output代表输出内容。状态输出构造器中可以使用的系统变量如下：

• $Context

• $Input

• $Output

以下状态机定义示例显示了输出构造器的用法。

Type: StateMachine
Name: OutputConstructExample
SpecVersion: v1
StartAt: InvokeFunction
States:
  - Type: Task
    Name: InvokeFunction
    Action: FC:InvokeFunction
    TaskMode: RequestComplete
    Parameters:
      resourceArn: >-
        acs:fc:cn-hangzhou:123456:services/helloworld.LATEST/functions/helloworld
      invocationType: Sync
      body.$: $Input 
    OutputConstructor:
      returnID.$: uuid()
      functionResult.$: $Output
      functionResultStr.$: jsonToString($Output)
      executionInput.$: $Context.Execution.Input
      lastOutput.$: $Input
    End: true

• 输出构造器OutputConstructor的数据结构为map[string]any。

• functionResult.$、executionInput.$和lastOutput.$使用动态引用获取状态输出、执行输入和状态输入。

• returnID.$和functionResultStr.$分别使用内置函数获取唯一ID、将状态输出转换为字符串。