名称:

Insert Numberred Item | 插入第N个

图标:

e-collection-insertnumberreditem.PNG

功能:

  • 多个对象中插入第N个对象/值
  • 通常为复数对象传值时,最新传入的值放在最后,如果需要将其插入中间,就用此功能,比如一个表格中,将某一行放在中间而不是最后一行显示

    使用方式:

    将某个对象放在一组对象的某个序号位置

    输入:

  • <Item>:任意类型值的输入,单数,必须项;输入要插入的对象

  • <Index>:整数数字类型值输入,单数,必须项;顺序号数字传入,是插入对象在全部对象中的位置顺序号,<Index>为1是第一个位置,如果插入到最后一个,则<Index>应是初始全部对象个数加1
  • <Parent>:任意类型值的输入,单数,必须项;是包含要插入的对象为子对象的一个父元件对象
    ·?插入规则:接收插入对象的父对象中的某个对象组应是<Parent>父对象中,与<Item>输入对象同类型的复数状态子对象中;比如下图中<Item>输入是个文本字符,则默认插入到Text 2对象中:

Insert Numberred Item插入第N个 - 图2
· 如果<Item>是一个数字,则插入到上图中Number对象中
· 但如果<Item>的类型在父对象中有多个同类的复数对象,比如上图中还有个复数的Text 3或Number 2,则插入结果是不确定的

  • <Control>:空值输入,单数,非必须项;用于流程控制,当前面有逻辑完成后任意输出连线传入此输入元件时触发当前元件开始运行

    输出:

  • <Inserted>:任意类型值输出,单数,非必须项;输出返的是插入成功的对象,即<Item>输入的对象/值

  • <Invalid Parent>:任意类型值的输出,单数,非必须项;如果父元件中没有任何子元件/对象,则输出<Parent>输入的父元件对象
  • <Invalid Item>:任意类型值的输出,单数,非必须项;如果处理时发现父元件中没有<Item>输入对象同类型的子元件/对象,则输出<Item>输入的对象
  • <Invalid Index>:数字类型值的输出,单数,非必须项;如果<Index>输入顺序号小于1或大于父元件中要更新的对象个数,则输出<Index>输入的数字
  • 如果以上三个无效输出没有添加到此元件中但运行时出现无效结果,则系统会报出错误信息(运行时前端出现错误信息弹窗,后台Log文件记录错误日志,参考“从需求出发的开发”一章下“错误、调试和处理”中说明)
  • 处理时如果无效输出元件验证会提示没有类型,此时可以从目录中找到对应的父元件拖放到<Invalid Parent>输出元件三角形图标上;<Invalid Item>如果需要类型,同样方式或者从选项板中数据类型中拖入前面输入的<Item>一样的类型
  • <Done>:空值输出,单数,必须项;完成处理时的空值输出,一般只用于确认已完成处理并向下控制触发下一步处理对象,与<Control>配合定义元件的执行顺序

    示例:

    安全:父元件中插入一个文本值

    任意一个项目的目录“Common/Templates/Collections/Insert Numbered Item/Test 1/Test”中:
    Insert Numberred Item插入第N个 - 图3