创建或使用流程参数

流程参数

脚本向导编辑界面新增了“流程参数”面板,此处可以对引用当前组件的流程进行流程参数的设置与获取。

  • 根据参数类型,可分为 “String” 和 “File”,即设置/获取流程的 “String” 和 “File” 类型参数;
  • 根据流程类型,可分为“流程”和“节点”,即设置/获取“流程”参数或者流程的“节点”参数;
  • 根据状态类型,可分为“设计时”和“运行时”,即设置/获取流程“设计时”或者“运行时”状态参数;
  • 根据参数传递方向,可分为“输入”和“输出”。
    • 输入:类似于在组件中使用“获取流程参数”和“获取流程参数文件”函数,可以获取流程设计状态或者运行状态下的参数值。
    • 输出:类似于在组件中使用“设置流程参数”或者“设置流程结果文件”,可以设置流程设计状态或者运行状态下的参数值。

创建流程参数

在流程参数面板中创建,若组件编辑界面下方未显示流程参数面板,则可单击下图的“流程参数”,展开流程参数面板:

在展开的流程参数面板中,单击 F2 可进入编辑状态,可新建流程参数。

[warning] 注意

流程参数支持的方向、参数类型、流程类型和状态类型,可通过单击对应列后按F2进行下拉选择,此处建立的流程参数名称需保证与调用该组件的流程的参数名称一致。

使用与传递流程参数

  • 字符串类型

    1、新建向导组件,并编辑和审核组件。

    打开【组件管理】界面,新增一个名为“流程参数测试”的脚本向导组件,打开后切换到“流程参数”面板中新建 一个名为“参数1”的输入参数和一个名为“参数2”的输出参数,同时在在脚本编辑界面添加两行【日志消息】函数,分别打印“参数1”和“参数2”。

    [warning] 注意

    “参数1”为输入参数,无需设置默认值;“参数2”为输出参数,需设置默认值。

    编辑并调试完成后,保存和审核组件。

    2、新建流程,并调用“流程参数测试”组件。

    打开【流程设计】界面,新建一个名为“流程参数流程”的流程,并调用“流程参数测试”组件。

    流程中设置与“流程参数测试”组件中“流程参数”面板同名同类型的流程参数,其中“参数1”赋予相应的参数值。

    [warning] 注意

    “参数1”设置参数值;“参数2”无需设置值。

    3、保存并执行该流程,可查看到流程日志中已打印“参数1”和“参数2”的值。

    [warning] 注意

    • 第一行日志打印的是“参数1”的值,可以发现该值来源于【流程设计】界面中“参数1”设置的值,即【流程设计】界面中“参数1”设置的值传入到了组件的“参数1”中。
    • 第二行日志打印的是“参数2”的值,可以发现该值来源于组件的“参数2”中设置的默认值,即组件的“参数2”中设置的默认值传入到了【流程设计】界面的“参数2”中。

    4、综上可知,“字符串”类型流程参数:组件中输入流程参数可以获取到流程的同名参数值,并将获取到的参数值在组件中传递使用;组件中输出流程参数设置的默认值可以传递给流程的同名参数里,并将设置的默认值在流程中传递使用。

    [warning] 注意

    • 运行状态下的操作类似,不同在于设计状态下可以在界面查看,而运行状态下无法查看到界面。
    • 节点类型下的操作类似,不同在于若组件中流程参数为“流程”类型,则在流程中无需选中节点新建同名参数;若组件中流程参数为“节点”类型,则需在流程中选中调用该组件的节点后,再新建流程节点的同名参数。
  • 文件类型 1、新建向导组件,并编辑和审核组件。

    打开【组件管理】界面,新增一个名为“流程参数test”的脚本向导组件,打开后切换到“流程参数”面板中新建一个名为“文件参数1”的输入参数和一个名为“文件参数2”的输出参数,同时在在脚本编辑界面添加两行【日志消息】函数,分别打印“文件参数1”和“文件参数2”。

    [warning] 注意

    由于“文件参数1”和“文件参数2”都为“文件”类型流程参数,因此都需要设置默认值,即需要设置两个默认文件路径,下面为设置的两个默认文件 “D:\1.txt” 和 “D:\1.txt” 的内容。

    编辑并调试完成后,保存和审核组件。

    2、新建流程,并调用 “流程参数test” 组件。

    打开【流程设计】界面,新建一个名为 “流程参数test测试” 的流程,并调用 “流程参数test” 组件。

    流程中设置与“流程参数测试”组件中“流程参数”面板同名同类型的流程参数,并勾选“手动执行流程弹出参数设置”选项。

    3、保存并执行该流程。

    流程执行时,会弹出“运行配置”窗口,此时分别上传 “D:\3.txt” 和 “D:\4.txt” 两个文件。

    [warning] 注意

    由于“文件参数1”和“文件参数2”都为“文件”类型参数,因此都需要上传文件,下面为上传的两个文件 “D:\3.txt” 和 “D:\4.txt” 的内容。

    4、查看流程日志。

    ① 第一行日志打印的是“文件参数1”的值,可以发现该值来源于【流程设计】界面中“文件参数1”上传的文件路径(“D:\3.txt”),即【流程设计】界面中“文件参数1”上传的文件路径(“D:\3.txt”)传入到了组件的“文件参数1”中。

    ② 第二行日志打印的是“文件参数2”的值,可以发现该值来源于组件的“文件参数2”中设置的文件路径(“D:\2.txt”),即组件的“文件参数2”中设置的文件路径(“D:\2.txt”)传入到了【流程设计】界面的“文件参数2”中。

    5、查看参数。

    ① 流程执行过程中上传的 “D:\3.txt” 和 “D:\4.txt” 文件可在执行后的“参数”-“文件”里下载;

    ② 【流程设计】界面中“文件参数1”上传的文件(“D:\3.txt”)内容覆盖了组件的“文件参数1”中设置的文件(“D:\1.txt”)内容,可供组件使用,即【流程设计】界面中“文件参数1”上传的文件内容传入到了组件的“文件参数1”的文件中;

    ③ 组件中“文件参数2”中设置的文件(“D:\2.txt”)已传入到流程中,可在执行后的“参数”-“文件”里下载使用,即组件中“文件参数2”中设置的文件传递到流程中使用;

    6、综上可知,“文件”类型流程参数:组件中输入流程参数可以获取到流程同名参数中上传文件的内容,并将获取到的文件在组件中传递使用;组件中输出流程参数设置的文件可以上传到流程的同名参数中,并将设置的文件在流程中传递下载使用。

    [warning] 注意

    • 运行状态下的操作类似,不同在于设计状态下可以在界面查看,而运行状态下无法查看到界面。
    • 节点类型下的操作类似,不同在于若组件中流程参数为“流程”类型,则在流程中无需选中节点新建同名参数;若组件中流程参数为“节点”类型,则需在流程中选中调用该组件的节点后,再新建流程节点的同名参数。

results matching ""

    No results matching ""

    results matching ""

      No results matching ""