開發自訂運算質

發行項
10/14/2023

雖然 BizTalk Server 提供許多運算質支援許多不同的作業，仍可能會遇到一些需要不同解決方法的情況。自訂運算質提供您一個擴充 BizTalk Server 對應環境中之可用作業範圍的方式。每個自訂運算質都會使用衍生自 Microsoft.BizTalk.BaseFunctoids 的類別，部署為 .NET 元件。一個組件可包含一個以上的自訂運算質。

您應該考慮在下列案例中使用自訂運算質：

對於使用只能透過專屬舊版 API 存取之資料的字元程式碼欄位，您具有特殊的驗證和轉換規則。
您需要使用自訂商務邏輯和金鑰管理來加密或解密欄位。
您需要從部分訊息產生雜湊程式碼，以供在另一個應用程式中使用。
訊息傳送至其部門的帳戶處理要求包含依每個產品類型的總銷售額摘要資訊。
您想要組合幾個相關步驟、使用不同的方式，或是使用新的類別庫，來降低對應的複雜性。
有一個以上的對應正在使用指令碼運算質中的相同指令碼。
作業失敗時，您需要寫入事件記錄。

自訂運算質可直接使用內嵌程式碼或間接使用部署至全域組件快取之類別庫中的方法參考，整合至方案中。這兩種類型的整合都依賴 BizTalk.BaseFunctoid 類別，並遵循一組相同的一般步驟：

使用您選擇的 .NET 語言建立新的程式庫專案。
使用強式命名的公用程式 sn.exe 建立 keyfile，並將它指派至專案。
新增 Microsoft.BizTalk.BaseFunctoids.dll 的參考。此元件包含 BaseFunctoid 基類。
建立資源檔案，並將它新增至專案。新增運算質名稱、工具提示和描述的字串資源。新增 16x16 像素的影像資源，以在對應設計師工具板上代表運算質。
實作運算質類別，方法是衍生自 BaseFunctoid、在建構函式中建立基本參數，然後撰寫運算質方法和任何支援的方法。此組件可包含多個自訂運算質。
部署該組件，並確定可從 [工具箱] 工具板取得新的運算質。請參閱從 Visual Studio 工具箱新增和移除自訂運算質。

下列是 Floor 運算質的圖例。

/// <summary>  
/// Floor Functoid - finds the floor of input  
/// </summary>  
public class FloorFunctoid : BaseFunctoid  
{  
    public FloorFunctoid()  
        : base()  
    {  
        this.ID = 11001;  
        SetupResourceAssembly("MultipleFunctoids.Resource", Assembly.GetExecutingAssembly());  
  
        SetName("NAME_FLOOR");  
        SetDescription("DESCRIPTION_FLOOR");  
        SetTooltip("DESCRIPTION_FLOOR");  
        SetBitmap("IMAGE_FLOOR");  
  
        SetExternalFunctionName(GetType().Assembly.FullName, " MultipleFunctoids.FloorFunctoid", "MathFloor");  
        this.RequiredGlobalHelperFunctions = InlineGlobalHelperFunction.IsNumeric;  
  
        AddScriptTypeSupport(ScriptType.CSharp);  
        SetMinParams(1);  
        SetMaxParams(1);  
  
        this.Category = FunctoidCategory.Math;  
        this.OutputConnectionType = ConnectionType.AllExceptRecord;  
        AddInputConnectionType(ConnectionType.AllExceptRecord);  
        this.HasSideEffects = false;  
    }  
  
    /// <summary>  
    /// To create the C# function  
    /// </summary>  
    /// <param name="scriptType">Script type</param>  
    /// <param name="numParams">Number of parameters</param>  
    /// <param name="functionNumber">Functoid number</param>  
    /// <returns>C# script</returns>  
    protected override string GetInlineScriptBuffer(ScriptType scriptType, int numParams, int functionNumber)  
    {  
        if (ScriptType.CSharp == scriptType)  
        {  
            StringBuilder builder = new StringBuilder();  
  
            builder.Append("public string MathFloor(string input)\n");  
            builder.Append("{\n");  
            builder.Append("  if(string.IsNullOrEmpty(input))\n");  
            builder.Append("    return string.Empty;\n");  
            builder.Append("double d = 0.0;\n");  
            builder.Append("if (IsNumeric(input, ref d))\n");  
            builder.Append("    return Math.Floor(d).ToString(System.Globalization.CultureInfo.InvariantCulture);\n");  
            builder.Append("else\n");  
            builder.Append("    return string.Empty;\n");  
            builder.Append("}\n");  
  
            return builder.ToString();  
        }  
        else  
        {  
            return string.Empty;  
        }  
    }  
}

在 C# 專案中使用此範例程式碼時，“Assembly name” 必須設為 “MultipleFunctoids”。您的 C# 專案 (包含此程式碼) 應該包含 Resource.resx 檔案。

SetName("NAME_FLOOR");  
SetDescription("DESCRIPTION_FLOOR");  
SetTooltip("DESCRIPTION_FLOOR");  
SetBitmap("IMAGE_FLOOR");

在上述程式碼中，“NAME_FLOOR”、“DESCRIPTION_FLOOR” 和 “DESCRIPTION_FLOOR” 這些值是 Resource.resx 檔案中內嵌的資源字串的「識別碼」。 “IMAGE_FLOOR” 是 Resource.resx 檔案中內嵌的影像的名稱。此影像會作為運算質的圖示。

如果您未指定適當的資源索引鍵，或如果您刪除 SetName 方法，則會建立無名稱的自訂運算質，這不是良好的作法。 SetDescription 和 SetTooltip 方法也是一樣。請務必正確地使用這些方法，以避免任何不必要的無用行為。不過，如果您沒有任何適合的影像可做為運算質圖示，您可以略過 SetBitmap 方法。在此情況下，自訂運算質會使用預設圖示，此舉並沒有害處 (除非有多個無圖示的運算質)。

如需如何建立自訂運算質的詳細資訊，請參閱自訂運算質 (BizTalk Server 範例) 。

重要

標準/內建對應工具運算質會保留特定運算質識別碼。標準 Mapper 運算質通常會使用從 1 到 10000 的識別碼。建立自訂運算質時，請勿使用小於 10000 的運算質識別碼。

本節內容

此部分包含：

另請參閱

使用運算質建立更多複雜對應

共用方式為

開發自訂運算質

本節內容

另請參閱

意見反應

其他資源