开始节点是计算脚本的起点,可接受外部请求并启动整个计算脚本。
每一个计算脚本只能有一个开始节点,不可新增,不可删除。
初始状态的开始节点仅显示icon和名称,系统语言环境为简体中文时,显示中文文案“开始”,其他所有语言环境均显示英文文案“start”。
点击开始节点后,节点变为选中状态,画布右侧弹出节点属性栏。
【开始节点】的基本信息配置为3个基础配置项,分别是:编码、名称(多语言)、备注。
编码是【开始节点】的ID,且在当前脚本内唯一,是必填项。
【开始节点】的编码默认为”start”,不可修改。
节点的名称会显示在节点卡片中,非必填,不验重。
【开始节点】的名称默认为”开始”,可编辑修改。
备注是提供给用户记录节点的作用和执行内容的注释栏,可不填。
【开始节点】可以接受请求携带的数据,然后使用JSON PATH对其进行解析,并将解析的结果赋值给设置好的变量。
:width: 500px
入参配置界面是参数解析的配置项,其名称旁还有提示icon,悬停即可显示文案:
“可以通过JSON PATH表达式将入参对象的值解析出来并赋给指定的变量”
:width: 500px
点击编辑按钮即可打开整个参数解析表格区域。
:width: 500px
参数解析表格的编辑区主要有8个内容,分别是多选框、变量、数据类型、JSON PATH表达式、操作栏、新增按钮。
多选框是操作辅助列,无实际业务含义,勾选任意一个或多个选择框,系统则会弹出“批量删除”的提示框,点击即可删除所有选中的变量行信息。
:width: 500px
变量是用于显示和选择配置变量的操作控件,点击表格中变量列下的空白字段,即可显示下拉展示的变量选项。
:width: 500px
变量选项的展示内容是变量的编码与名称,样式表现为”{编码} - {名称}”。
变量在下拉列表中的展示顺序是变量列表中的变量顺序,此处不可调整变量的展示顺序。
变量在下拉列表中仅可单选,点击即表示选中,单元格内出现变量信息,下拉框在点击后消失。
点开下拉框以后,可以在输入框中输入变量的编码或名称内容,对下拉列表的变量执行实时的搜索。
这里的搜索功能表现和变量列表顶部栏的搜索功能一样,只是这里的下拉框选项是根据用户输入的内容实时响应的,无需点击Enter键。
:width: 500px
如果没有适合的变量,也可以直接点击下拉框底部的“新增变量”唤起变量配置弹框,新增变量。
“新增变量”选项是独立于选项列表显示的,其始终位于列表底部,不随着列表内容的滚动而改变位置。
输入变量信息并点击确认后,即可新增一个变量,重新点击变量选择区域,可以在变量选择框的底部可以选择新增的变量。
变量被选择后,会以”{编码} - {名称}”的模式显示在单元格内,如果没有名称则仅展示编码。
变量被选择以后,单元格内显示的是变量实时信息,如果变量的编码或名称被修改后,再次打开开始节点的配置页面时,单元格始终显示最新的”{编码} - {名称}”。
变量被选择以后,如果用户将对应的变量删除,此时保存脚本,配置系统会进行报错,表示开始节点的变量配置中,[XX]变量为空,点开具体的配置页面时,单元格内会显示变量对应的随机ID,并显示”变量已被删除”。
:width: 500px
数据类型是显示变量所属的数据类型信息的列区域。
变量被选择后,会自动带出其数据类型,并不可修改,填充进指定的单元格中。
这部分的值会被自动带出,被带出的值显示禁用状态,不可编辑。
如果用户在变量列表中修改了变量的数据类型,再次打开节点的变量配置项,其数据类型会显示修改后的最新值。
JSON PATH表达式指的是在这个节点执行中,通过JSON PATH工具给变量赋值的表达式语句。
系统在执行节点时,会通过JSON PATH解析请求中携带的入参数据,并将执行JSON PATH表达式后得到的值赋给当前行的变量。
赋值表达式标题右侧会有一个提示文案icon,hover上去后会显示Tooltips:
:width: 500px
用户选择好一个变量后,赋值表达式的默认值为”$..变量编码”。
例如,变量「实体」编码为Entity,其赋值表达式的默认值即为$..Entity,表达式可手动修改值。
具体案例如下:
:width: 800px
赋值表达式中,$..Entity表示在外部请求携带的JSON数据中,遍历搜索Entity的值,并将获得的值赋值给计算脚本中的变量「实体」,新赋的值会覆盖该变量原有的值。
更多表达式规则,可参考《JSON PATH教程》。
操作栏中有可以对当前行进行操作的交互按钮,目前仅支持删除操作。
点击删除按钮时,系统会弹出提示框:
:width: 500px
点击确认则删除当前行的变量配置;点击取消则关闭提醒框,不受影响。
变量是以一个表格样式展现的,点击“+新增”可以新增行,让用户去添加新的变量。
“+新增”是独立于表格显示的,其始终位于表格底部,不会随着列表内容的滚动而改变位置。
回到顶部
咨询热线