BaseFunctoid の使用
すべてのカスタム Functoid は、 BaseFunctoid クラスから派生する必要があります。 これを行うには、最初にコンストラクターをオーバーライドし、カスタム Functoid に関する情報を BizTalk マッパーに通知する呼び出しのセットを作成します。 次に、Functoid ロジックを記述します。
コンストラクターのオーバーライド
Functoid の特性を設定するには、クラス コンストラクターをオーバーライドするメソッドで、さまざまなタスクを実行する必要があります。 これらのタスクは、ソリューションに必要な Functoid 固有のコードの他に、追加で実行するタスクです。 次の表では、主要なタスクについて説明します。
| タスク | 使用するメソッドまたはプロパティ | 説明 |
|---|---|---|
| Functoid に一意の ID を割り当てる | ID | 6000 を超える値のうち、未使用の数値を ID として使用します。 6000 未満の値は、内部 Functoid 用に予約されています。 |
| Functoid に副作用があるかどうかを示す | HasSideEffects | 生成された XSLT コードの最適化のため、マッパーによって使用されます。 このプロパティの既定値は True です。 |
| リソース アセンブリをポイントする | SetupResourceAssembly | プロジェクトと共に、リソース ファイルを含めます。 Visual Studio を使用してビルドする場合、リソース アセンブリは ProjectName.ResourceName である必要があります。 |
| BizTalk マッパーのパレットにカスタム Functoid を表示する | SetName SetTooltip SetDescription SetBitmap |
名前、ツールヒント、および説明用の文字列を表すリソース ID と、16x16 ピクセルのビットマップを使用します。 |
| 1 つまたは複数のカテゴリに Functoid を割り当てる | カテゴリ | 1 つまたは複数の Microsoft.BizTalk.BaseFunctoids.FunctoidCategory 値を使用して Functoid を分類します。 |
| 受け取るパラメーターの数を指定する | SetMinParams SetMaxParams HasVariableInputs |
SetMinParams メソッドで必要なパラメーターの数を設定し、 SetMaxParams メソッドで省略可能なパラメーターの数を設定します。 次のガイドラインに従って値を設定してください。 - 省略可能なパラメーターがない場合は、min = max を設定します。 - 省略可能なパラメーターがある場合は、max = (省略可能なパラメーターの数 - パラメーターの最小数) を設定します。 - 無制限の省略可能なパラメーターを許可する場合は、max を設定しないでください。 - 可変数の入力がある場合は、min または max を設定せず、HasVariableInputs を設定します = true。 |
| Functoid への接続が可能なオブジェクトの種類を宣言する | AddInputConnectionType | Functoid がサポートする各 Microsoft.BizTalk.BaseFunctoids.ConnectionType に対して、 AddInputConnectionType を 1 回ずつ呼び出します。 |
| Functoid からの接続が可能なオブジェクトの種類を宣言する | OutputConnectionType | Microsoft.BizTalk.BaseFunctoids.ConnectionType の値を使用して、Functoid からの出力を受信できるオブジェクトの種類を BizTalk マッパーに通知します。 複数の接続の種類を指定するには OR を使用します。 |
| Functoid を呼び出すメソッドを BizTalk Server に通知する | SetExternalFunctionName SetExternalFunctionName2 SetExternalFunctionName3 |
累積 Functoid の場合、 SetExternalFunctionName で初期化関数を設定し、 SetExternalFunctionName2 で累積関数を設定し、 SetExternalFunctionName3 で累積値を返す関数を指定します。 累積 Functoid 以外の場合、 SetExternalFunctionName で Functoid メソッドを設定します。 |
| BizTalk Server で、インライン コードによって Functoid が呼び出されるようにする | AddScriptTypeSupport SetScriptBuffer | Microsoft.BizTalk.BaseFunctoids.ScriptType を指定して AddScriptTypeSupport を呼び出し、インライン コードを有効にします。 SetScriptBuffer を呼び出して、Functoid のコードに渡します。 このコードは、マップにコピーされます。 |
| インライン型の Functoid にグローバル変数を宣言する | SetScriptGlobalBuffer | 作成した宣言は、マップに含まれるその他のインライン スクリプトで参照可能になります。 |
| インライン型の Functoid に必要なヘルパー関数を示す | RequiredGlobalHelperFunctions | InlineGlobalHelperFunction 列挙の値を使用して、必要なヘルパー関数を指定します。 複数のヘルパー関数を指定するには OR を使用します。 |
| Functoid に渡されるパラメーターを検証する | IsDate IsNumeric |
これらの関数では、例外がスローされることなく、True/False の応答が返されます。 |
Functoid ロジックの実装
Functoid を活用するには、Functoid のカテゴリに応じて 1 つ以上のメソッドを実装する必要があります。 累積 Functoid の場合は、初期化するメソッド、累積するメソッド、および累積値を返すメソッドの 3 つを指定します。 累積 Functoid 以外の場合は、値を返すメソッドを 1 つ指定します。
また、Functoid の実装コードをマップにコピーするか、コンパイル済み .NET アセンブリ内にコードを保持して参照によって使用するかを決定する必要があります。
次の場合は、インライン型の Functoid の使用を検討してください。
ビジネス ロジックが他のユーザーに読み取り可能で、変更される可能性がある場合。
Functoid が、マップでサポートされる .NET Framework 名前空間のみに依存する場合。 使用可能な名前空間については、「 インライン C#、JScript .NET、Visual Basic .NET を使用したスクリプト作成」を参照してください。
BizTalk ソリューションで別のアセンブリの展開や管理を行わない場合。
変数を共有する一連の Functoid を記述する場合。
次の場合は、参照型の Functoid の使用を検討してください。
他のユーザーから参照されたり変更される可能性があるビジネス ロジックを、マップにコピーしない場合。
Functoid が、マップでサポートされない .NET Framework クラスに依存する場合。
.NET Framework で提供される追加機能を使用するため、BizTalk ソリューションで別のアセンブリを展開したり管理することが妥当な場合。
参照
参照型のカスタム Functoid の開発
インライン型のカスタム Functoid の開発
カスタムの累積 Functoid の開発
Microsoft.BizTalk.BaseFunctoids.BaseFunctoid