如何配置 Functoid 输入参数

  • 项目

正确配置映射中 functoid 的输入参数是使用 functoid 最重要的一个方面，也是最可能出错的一个环节。 可以按如下所示配置 functoid 输入参数：

  • 通过将架构节点和相应的 functoid 连接 (将鼠标从架构节点拖放到 functoid) 来创建可见的输入链接。

  • 使用“配置 <Functoid Functoid>”对话框直接编辑输入参数列表。

    本主题提供了使用这些方法配置 functoid 的输入参数的分步说明。

    用拖放方法建立 functoid 输入参数可以很方便地指定在源架构中使用 XPath 规范所涉及的输入参数。 有关创建架构节点和 functoid 输入参数的信息，请参阅 How to Add Basic Functoids to a Map。 但是，“ 配置 <Functoid> Functoid ”对话框是查看 functoid 的所有输入参数、创建和修改任何常量参数以及在必要时重新排列输入参数顺序的最终机制。

    当您直接在网格页上为 functoid 配置输入参数时（通过使用鼠标从源 schema 节点执行拖放操作并将该节点链接到 functoid 来绘制线条），如果输入数量达到最大值，则光标将更改为 NO 状态。 此外，状态栏将显示原因。 下图显示仅接受一个输入链接的 functoid。

    配置 functoid 输入参数的 NO 状态

    可以使用“配置 Functoid Functoid”对话框配置<>“脚本”和“表循环”functoid。 有关如何配置 functoid 的信息，请参阅 How to Configure the Scripting Functoid 和 How to Configure the Table Looping and Table Extractor Functoids。

必备条件

这些说明需要 BizTalk 映射器处于运行状态。

什么是输入参数？

输入参数可以是以下任何形式：

  • 从源 schema 节点到 functoid 的链接

  • 从 functoid 到另一个有效 functoid 的链接

  • 一个常数值

注意

有几个不需要任何输入参数的 functoid，例如“日期”、“时间”、“日期和时间”和“Nil”。

下图显示了具有两个输入参数（Input[0] 和 Input[1]）和一个常数参数 (Input[2]) 的 functoid（以红色突出显示）。

显示 functoid的输入参数

打开“配置 <Functoid> Functoid”对话框

可以通过以下方式之一打开“ 配置 <Functoid> Functoid ”对话框：

  • 在相关网格页中，右键单击 functoid，然后单击“ 配置 Functoid 输入”。

  • 双击要为其配置输入参数的 functoid。

  • 选择 functoid，然后单击 Visual Studio 的“属性”窗口中的省略号 (...) 。

  • 选择 functoid，然后按键盘上的 Enter。

  • 选择 functoid，然后按键盘上的 Ctrl+M、Ctrl+I。 有关映射器快捷键的列表，请参阅 BizTalk 映射器键盘快捷方式。

插入常数输入参数

  1. 在 “配置 <Functoid> Functoid ”对话框中，选择“ Functoid 输入 ”选项卡。

    注意

    默认情况下，“ Functoid 输入 ”选项卡处于选中状态。

  2. 单击“ 将常量输入参数添加到 functoid ”按钮。 将添加一个新行。

  3. 键入新输入参数的值，然后单击“ 确定”。

    注意

    如果添加按钮未启用，则说明该 functoid 不接受或不需要输入参数，或者已经具有允许的最大输入数。

编辑现有常数输入参数

  1. 在 “配置 <Functoid> Functoid ”对话框中，单击要编辑的现有常量输入参数。 当前值已被选中。

    重要

    只能编辑常数输入的参数。 不能编辑所有其他类型的输入参数。 只能重新排列或删除这些参数。

  2. 单击“ 编辑常量输入参数 ”按钮。 对常量值进行适当的更改，然后单击“ 确定”。

    此外，还可以双击常数输入参数来对其进行编辑，或按键盘上的 F2。

选择多个输入参数

通过按住 Ctrl 键并单击所需的行，可以选择多个输入参数，然后执行以下任何操作。 您可以按键盘上的 Ctrl+A 选择所有行。

  • 上移/下移所选内容。

    注意

    如果批量选择包括其他行中的最上行或最下端行，则不能分别向上/向下移动所选内容。

  • 重新排列所选内容。

  • 删除所选内容。

更改现有输入参数的顺序

  1. 在 “配置 <Functoid> Functoid ”对话框中，单击要移动到输入参数排序列表中的不同位置的现有输入参数。

  2. 在上移列表中单击“按钮，在参数列表中向上移动参数。 根据需要重复此步骤，直到所选输入参数位于期望位置。 或者，可以从键盘按向上键。 有关映射器快捷键的列表，请参阅 BizTalk 映射器键盘快捷方式。

    \- 或 -

    单击“ 在列表中向下移动 按钮，在参数列表中向下移动参数。 根据需要重复此步骤，直到所选输入参数位于期望位置。 此外，还可以按键盘上的向下键。 有关映射器快捷键的列表，请参阅 BizTalk 映射器键盘快捷方式。

    重要

    只能从“配置 <Functoid Functoid>”对话框重新排列输入序列。 如果选择最上行或最下一行，将分别禁用列表中或列表中下移按钮。

  1. 在相关网格页中，单击与要删除的输入参数对应的输入链接。

  2. 在 “编辑” 菜单上，单击“ 删除”。

    注意

    或者，可以按 DELETE 键，或右键单击相关网格页中的链接，然后在快捷菜单中单击“ 删除 ”。

    重要

    将自行删除输入链接。 如果不确定，可以始终撤消删除。 有关撤消/恢复操作的详细信息，请参阅 如何撤消或恢复用户操作。

删除“配置 <Functoid Functoid> ”对话框中的现有输入参数

  1. 在 “配置 <Functoid> Functoid ”对话框中，单击要删除的现有输入参数。

    注意

    您可以使用此方法删除任何输入参数，甚至是与输入链接相对应的输入参数。

  2. 单击“ 删除所选内容 ”按钮。 将从参数列表中删除所选现有输入参数。 单击 “确定” 。

    或者，您可以选择要删除的行，然后按键盘上的 Delete 键。

    重要

    将自行删除输入参数。 如果不确定，可以始终撤消删除。 有关撤消/恢复操作的详细信息，请参阅 如何撤消或恢复用户操作。

    注意

    如果参数列表中没有输入参数，则不启用删除按钮。

为 functoid 设置标签和注释

可以使用“配置 Functoid”对话框为 functoid> 设置标签和注释。<

  1. 在 “配置 <Functoid> Functoid ”对话框中，单击“ 标签和注释 ”选项卡。

  2. 键入 “标签 ”和“ 注释”，然后单击“ 确定”。

    重要

    有关如何标记和注释 functoid 和/或链接的详细信息，请参阅 如何标记链接 和 如何标记和注释 Functoid。

另请参阅

编辑 Functoid 属性和输入参数