使用 Scripting functoid,可以在运行时使用自定义脚本或代码来执行其他不可用的函数。 例如,可以使用 Scripting functoid 和编写自己的自定义脚本,在运行时调用 COM 对象。
有关 Scripting functoid 的概念性信息,请参阅 Scripting Functoid。
将脚本 functoid 添加到地图并对其进行配置
在 Visual Studio 工具箱处于活动状态的情况下,单击高级 Functoids选项卡以选择该类别的 functoids。
此时会显示所选类别中的高级 functoid 列表。
拖动Scripting functoid
从工具箱到网格页上的相应位置。
注释
functoid 将放置在当前显示的网格页面上。 如果要将 functoid 置于其他网格页上,则需要先显示其他网格页。
注释
如果要一起使用多个 functoid 构造地图,则需要考虑其相对从左到右的位置。 运算单元从左到右执行。 一个 functoid 的输出只能输入到位于其右侧更远位置的另一个 functoid。
选择您刚刚添加到显示网格页面上的“脚本”功能体。
在 Visual Studio 属性窗口中,单击与 Script 属性关联的省略号(...)按钮。
注释
或者,可以右键单击 functoid,然后单击上下文菜单中的“ 配置 Functoid 脚本 ”。 此时将显示“配置脚本 Functoid”对话框,并且“脚本 Functoid 配置”选项卡已选中。
在 “配置脚本”Functoid 对话框中的 “选择脚本类型 ”下拉列表中,选择脚本的类型。
注释
根据脚本类型的选择,将启用和禁用剩余对话框字段的不同子集。
如果选择 外部程序集 作为脚本类型,请使用脚本 程序集、 脚本类和 Script 方法 下拉列表,以便分别选择程序集、类和方法以与此 Scripting functoid 相关联。
警告
外部程序集中的代码必须是线程安全的。 在压力条件下,映射的多个实例可能同时运行。
注释
选择程序集后, 脚本类 下拉列表将填充该程序集中的类。 同样,选择类后, 脚本方法 下拉列表将填充该类中的方法。
注释
选择外部程序集作为脚本类型时,将禁用内联脚本文本框。
如果选择了外部 程序集 以外的内容作为脚本类型(其中一个内联选项),请使用 内联脚本 文本框以所选语言输入脚本。
注释
脚本 functoid 的内联语言选择包括 C# .NET、JScript.NET、Visual Basic .NET、XSLT 和 XSLT 调用模板。
使用 C# 编写脚本不允许“using”语句。 如果脚本需要使用任何特殊的 .Net 类,则应将相应的程序集及其依赖程序集添加到 BizTalk 项目中的“引用”,并且脚本代码应使用完全限定的名称。 如果编写脚本以执行区分区域性的小写转换,则应按如下所示编写相应的代码片段。 类似的限制适用于所有受支持的脚本语言。
string x = y.ToLower(System.Globalization.CultureInfo.CurrentCulture);
在脚本中,若要使用任何程序集中的类,请确保将相应的程序集及其依赖程序集添加到包含映射的 BizTalk 项目中的“引用”。
注释
可以直接在 “内联脚本 ”文本框中创建自定义脚本,也可以在其他位置创建脚本,然后将其粘贴到 “内联脚本 ”文本框中。
注释
选择其中一个内联选项(外部程序集以外的选项)作为脚本类型时,将禁用脚本程序集、Script 类和 Script 方法下拉列表。
重要
如果创建包含多个函数的脚本,则第一个函数将被视为主函数或主函数;仅当在主函数的执行中调用其他函数时,才会调用其他函数。
单击 “确定” 。
如果外部程序集中的脚本或关联方法需要输入参数,请根据基本功能构造的要求,创建适当数量和类型的输入链接。
在大多数情况下, 脚本 functoid 将生成一个输出值,用于填充目标架构中的字段,或作为对另一个 functoid 的输入,其方式与基本 functoid 的工作方式大致相同。