Functoid 入力パラメーターを構成する方法
マップ内の Functoid に対する入力パラメーターを適切に構成する操作は、最も重要な操作の 1 つです。ただし、Functoid を使用する際にエラーが発生する可能性があるので注意して行う必要があります。 Functoid の入力パラメーターは次のように構成できます。
スキーマ ノードとそれぞれの Functoid を接続して、表示可能な入力リンクを作成します (マウスをスキーマ ノードから Functoid にドラッグ アンド ドロップします)。
[Functoid Functoid> の構成<] ダイアログ ボックスを使用して、入力パラメーターの一覧を直接編集します。
このトピックでは、これらのメソッドを使用して Functoid の入力パラメーターを構成する手順について説明します。
ドラッグして Functoid の入力パラメーターを設定する方法は、XPath 仕様を含む入力パラメーターを送信元スキーマに指定する場合に便利です。 スキーマ ノードと Functoid 入力パラメーターの作成については、「 基本的な Functoid をマップに追加する方法」を参照してください。 ただし、[Functoid Functoid> の構成<] ダイアログ ボックスは、すべての入力パラメーターを Functoid に表示したり、定数パラメーターを作成および変更したり、必要に応じて入力パラメーターの順序を再調整したりするための決定的なメカニズムです。
グリッド ページで Functoid の入力パラメーターを直接構成する (マウスのドラッグ アンド ドロップによって送信元スキーマ ノードから線を描画して Functoid にリンクする) 場合、入力数が最大値に達すると、カーソルが禁止の状態に変わります。 また、ステータス バーに理由が表示されます。 次の図は、入力リンクを 1 つだけ受け付ける Functoid を示しています。
[Functoid Functoid の構成] ダイアログ ボックスを使用して、スクリプトとテーブル ループ Functoid> を構成<できます。 Functoid を構成する方法については、「 スクリプト Functoid を構成する方法 」および「 How to Configure the Table Looping and Table Extractor Functoids」を参照してください。
前提条件
これらの手順では、BizTalk マッパーが実行されている必要があります。
入力パラメーターとは
入力パラメーターには、次のいずれかを指定できます。
送信元スキーマ ノードから Functoid へのリンク
Functoid から別の有効な Functoid へのリンク
定数値
Note
入力パラメーターを必要としない 、日付、 時刻、 日付と時刻、 Nil など、いくつかの Functoid があります。
次の図に、2 つの入力パラメーター (Input[0] および Input[1]) と定数パラメーター (Input[2]) を持つ Functoid (赤で強調表示) を示します。
[Functoid Functoid> の構成<] ダイアログ ボックスを開くには
[Functoid Functoid> の構成<] ダイアログ ボックスは、次のいずれかの方法で開くことができます。
関連するグリッド ページで Functoid を右クリックし、[ Functoid 入力の構成] をクリックします。
入力パラメーターを構成する Functoid をダブルクリックします。
Functoid を選択し、Visual Studio の [プロパティ] ウィンドウで省略記号 (...) をクリックします。
Functoid を選択し、Enter キーを押します。
Functoid を選択し、Ctrl キーを押しながら M キーを押し、Ctrl キーを押しながら I キーを押します。 マッパー ショートカット キーの一覧については、「 BizTalk マッパーのキーボード ショートカット」を参照してください。
定数の入力パラメーターを挿入するには
[Functoid> Functoid の構成<] ダイアログ ボックスで、[Functoid の入力] タブを選択します。
Note
[ Functoid の入力 ] タブは既定で選択されています。
[
] ボタンをクリックします。 新しい行が追加されます。新しい入力パラメーターの値を入力し、[OK] をクリック します。
Note
追加ボタンが使用できない場合は、Functoid が入力パラメーターを受け入れないか、入力パラメーターを必要としていません。または、許可される入力パラメーターの最大数に達しています。
既存の定数入力パラメーターを編集するには
[Functoid Functoid> の構成<] ダイアログ ボックスで、編集する既存の定数入力パラメーターをクリックします。 現在の値が選択されています。
重要
編集できるのは定数入力のパラメーターだけです。 その他の種類の入力パラメーターは編集できません。 順序の並べ替えまたは削除のみ行うことができます。
[
] ボタンをクリックします。 定数値に適切な変更を加え、[OK] をクリック します。この代わりに、定数入力パラメーターをダブルクリックして編集するか、または F2 キーを押すこともできます。
複数の入力パラメーターを選択するには
Ctrl キーを押しながら目的の行をクリックして複数の入力パラメーターを選択した後、次のいずれかの操作を実行できます。 Ctrl キーを押しながら A キーを押すと、すべての行を選択できます。
選択項目を上下に移動します。
Note
一括選択に一番上の行または一番下の行が含まれる場合は、選択項目を上下に移動することはできません。
選択項目を並べ替えます。
選択項目を削除します。
既存の入力パラメーターの順序を変更するには
[Functoid> Functoid の構成<] ダイアログ ボックスで、入力パラメーターの順序付きリスト内の別の位置に移動する既存の入力パラメーターをクリックします。
一
] ボタンをクリックして、パラメーター リスト内のパラメーターを上に移動します。 選択した入力パラメーターが目的の位置になるまで必要なだけ繰り返します。 または、上方向キーを押してもかまいません。 マッパー ショートカット キーの一覧については、「 BizTalk マッパーのキーボード ショートカット」を参照してください。\- または -
[
ボタンをクリックして、パラメーター リスト内のパラメーターを下に移動します。 選択した入力パラメーターが目的の位置になるまで必要なだけ繰り返します。 または、下方向キーを押してもかまいません。 マッパー ショートカット キーの一覧については、「 BizTalk マッパーのキーボード ショートカット」を参照してください。重要
入力のシーケンスは、[Functoid Functoid> の構成<] ダイアログ ボックスからのみ再配置できます。 一番上または一番下の行を選択した場合は、[
またはそれぞれ無効になります。
入力リンクを削除して入力パラメーターを削除するには
関連するグリッド ページで、削除する入力パラメーターに対応する入力リンクをクリックします。
[ 編集 ] メニューの [ 削除] をクリックします。
Note
または、DELETE キーを押すか、関連するグリッド ページのリンクを右クリックして、ショートカット メニューの [削除 ] をクリックします。
重要
入力リンクは、確認メッセージが表示されずに削除されます。 よくわからない場合は削除をいつでも元に戻すことができます。 元に戻す/やり直す操作の詳細については、「 ユーザー操作を元に戻すまたはやり直す方法」を参照してください。
[Functoid Functoid> の構成<] ダイアログ ボックス内の既存の入力パラメーターを削除するには
[Functoid Functoid> の構成<] ダイアログ ボックスで、削除する既存の入力パラメーターをクリックします。
Note
この方法を使用して、入力パラメーター (入力リンクに対応するパラメーターを含む) を削除できます。
[
] ボタンをクリックします。 選択した既存の入力パラメーターが、パラメーター一覧から削除されます。 [OK] をクリックします。または、削除する行を選択して、キーボードの Del キーを押します。
重要
入力パラメーターは、確認メッセージが表示されずに削除されます。 よくわからない場合は削除をいつでも元に戻すことができます。 元に戻す/やり直す操作の詳細については、「 ユーザー操作を元に戻すまたはやり直す方法」を参照してください。
Note
削除ボタンは、パラメーターの一覧に入力パラメーターがないと使用できません。
Functoid のラベルとコメントを設定するには
Functoid のラベルとコメントは、[Functoid> Functoid の構成<] ダイアログ ボックスを使用して設定できます。
[Functoid Functoid> の構成<] ダイアログ ボックスで、[ラベルとコメント] タブをクリックします。
[ラベル] と [コメント] を入力し、[OK] をクリックします。
重要
Functoid やリンクにラベルを付ける方法とコメントを付ける方法の詳細については、「 How to Label a Link 」および「 How to Label and Comment a Functoid」を参照してください。