如何向映射添加“脚本”Functoid

使用 “脚本编写 ”functoid,可以在运行时使用自定义脚本或代码来执行其他不可用的功能。 例如,可以在运行时通过使用 Scripting functoid 并编写自己的自定义脚本来调用 COM 对象。

有关 Scripting functoid 的概念信息,请参阅 Scripting Functoid

向映射添加“脚本”functoid 并对其进行配置

  1. 在“Visual Studio 工具箱”处于活动状态的情况下,单击“ 高级 Functoid ”选项卡以选择该类别的 functoid。

    此时,将显示所选类别的高级 functoid 列表。

  2. 拖动表示“脚本”functoid 的“脚本”functoid 图像。从“工具箱”到网格页上的相应位置。

    注意

    该 functoid 将放置到显示的网格页上。 如果要将 functoid 放在其他网格页上,则需要首先显示该其他网格页。

    注意

    如果要同时使用多个 functoid 构造地图,则需要考虑其相对从左到右的位置。 Functoid 是按照从左到右的顺序执行的。 一个 functoid 的输出只能输入到其右侧的另一个 functoid 中。

  3. 选择刚刚添加到显示的网格页的 “脚本编写 ”functoid。

  4. 在 Visual Studio 属性窗口中,单击与 Script 属性关联的省略号 (...) 按钮。

    注意

    或者,可以右键单击 functoid,然后单击上下文菜单中的“ 配置 Functoid 脚本 ”。 此时将显示“ 配置脚本 Functoid ”对话框,其中选择了“ 脚本 Functoid 配置 ”选项卡。

  5. “配置脚本”Functoid 对话框中的 “选择脚本类型 ”下拉列表中,选择脚本的类型。

    注意

    根据所选择的脚本类型,将启用和禁用剩余对话框字段的不同子集。

  6. 如果选择“ 外部程序集” 作为脚本类型,请使用 “脚本程序集”、“ 脚本类”和“ 脚本方法 ”下拉列表,按顺序分别选择程序集、类和方法,以与此 脚本 functoid 相关联。

    警告

    外部程序集中的代码必须为线程安全代码。 在任务繁忙时,可以同时运行多个映射实例。

    注意

    选择程序集后, 脚本类 下拉列表将填充该程序集中的类。 同样,选择类后,脚本 方法 下拉列表将填充该类中的方法。

    注意

    选择“外部程序集”作为脚本类型时,将禁用“内联脚本”文本框。

    如果选择了“ 外部程序集 ”以外的其他内容作为脚本类型 () 内联选项之一,请使用 “内联脚本 ”文本框以所选语言输入脚本。

    注意

    脚本 functoid 的内联语言选项包括 C# .NET、JScript.NET、Visual Basic .NET、XSLT 和 XSLT 调用模板。

    使用 C# 编写脚本时不允许使用“using”语句。 如果脚本需要使用任何特殊的 .Net 类,则应将相应的程序集及其依存程序集添加到 BizTalk 项目的“参考”中,并且脚本代码应该使用完全限定的名称。 如果您编写一个执行区分区域性的小写转换脚本,应按如下所示编写相应的代码段。 类似限制适用于所有受支持的脚本语言。

    string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);  
    

    在脚本中,若要使用任何程序集中的类,请确保将相应程序集及其依存程序集添加到包含映射的 BizTalk 项目的“参考”中。

    注意

    可以直接在“ 内联 脚本”文本框中创建自定义脚本,也可以在其他位置创建脚本,并将其粘贴到 “内联脚本 ”文本框中。

    注意

    如果选择一个内联选项, (外部程序集) 以外的选项作为脚本类型,则会禁用“脚本程序集”、“脚本”和“脚本方法”下拉列表。

    重要

    如果创建包含多个函数的脚本,则第一个函数将被视为主函数,其余函数只在执行主函数时进行调用。

    单击 “确定”

  7. 如果外部程序集中的脚本或相关方法需要输入参数,请创建相应数量和类型的输入链接(就像使用基本 functoid 一样)。

  8. 在大多数情况下, 脚本 functoid 将生成一个输出值,该值用于填充目标架构中的字段,或作为另一个 functoid 的输入,其方式与基本 functoid 大致相同。

另请参阅

向映射添加高级 Functoid