.NET コードを介してデータにアクセスして、異なる多数のソース (MSMQ、ファイル、データベースなど) からデータを取得するには、.NETInput ノードを使用します。
このトピックには、以下のセクションが含まれています。
.NETInput ノードは、その作成者がメッセージ・フローを開始するために指定したソースからデータを取得します。.NETInput ノードでは、データ・ソース (.NET アプリケーション、COM アプリケーションなど) から取得されたメッセージを解釈することにより、出力メッセージを形成できます。
.NETInput ノードは、C#、Visual Basic (VB)、F#、C++/CLI など、共通言語ランタイム (CLR) に準拠する任意の言語を使用してメッセージを作成します。
メッセージ・フロー 開発者は .NET コードを制御できます。これにより .NETInput ノードは、データを取得できる場所に関して柔軟性を持ちます。例えば、MSMQ ソース、WebSphere® MQ キュー、ファイル・システム、またはデータベースからメッセージを読み取る .NET コードを記述できます。.NETInput ノードのコードを記述するときには、Microsoft Visual Studio 内に 2 つのテンプレートが用意されています。
.NETInput ノードはパレットの「.NET」ドロワーに入っていて、IBM® Integration Toolkit 内では次のアイコンによって表されます。
.NETInput ノードは Windows ブローカー上でのみ稼働します。 .NETInput ノードを含むメッセージ・フローを、Windows 以外のシステムで稼働するブローカーにデプロイしようとすると、エラーが発生します。メッセージ・フローをデプロイする前に、Windows でブローカーが稼働していることを確認してください。
.NETInput ノードのコードを記述するときには、Microsoft Visual Studio 内に 2 つのテンプレートが用意されています。これらの 2 つのテンプレートは、次の 2 種類の相互作用形式用です。
.NETInput ノードとデータまたはメッセージのソースの間の相互作用を制御するコードが含まれる .NET アセンブリーに .NETInput ノードを関連付ける必要があります。これは、メッセージ・フローによって伝搬します。
詳しくは、.NETInput ノードに対するコードの作成を参照してください。
Microsoft Visual Studio に提供されるテンプレート・コード・スケルトンを使用して、.NETInput ノードの動作をカスタマイズするコードを作成します。ノードのコードを含む .NET アセンブリーを使って .NETInput ノードを構成する必要があります。 このコードは、IBM.Broker.Plugin.dll アセンブリーにある抽象基本クラス (NBPollingConnector または NBEventConnector) の 1 つから派生するクラスで構成されます。
メッセージ・フローに対して実行されるスレッドの数 (追加インスタンスまたは複数の入力ノードの結果として) に関係なく、特定の .NETInput ノードのインスタンスは 1 つしか作成されません。このため、ユーザー .NET コードはすべてスレッド・セーフかつ再入可能でなければなりません。 ノードをスレッド・セーフにする方法と、ユーザー定義拡張機能によって実装および開始される機能を再入可能にする方法について、詳しくはユーザー定義拡張機能の実行モデルおよびユーザー定義拡張機能のスレッド化に関する考慮事項を参照してください。
.NET 入力ノード用に作成されたコードは、Integration Bus トランザクションに参加しません。
.NETCompute ノードの .NET コードの作成について詳しくは、Windows の「スタート」メニューから、IBM Integration Bus のインストールに含まれている .NET API 文書にアクセスできます。
.NETInput ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。ノードを構成するには、ファイル・エクスプローラーでアセンブリー・ファイルをノードまでドラッグするか、または「参照」ボタンをクリックします。ノードのプロパティーが、「プロパティー」ビューに表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
.NETInput ノード用にカスタマイズしたパラメーターおよび属性を複製するには、そのノードから Cloned ノードを作成します。Cloned ノードには、独自の特別なプロパティーはなく、パレット・ドロワーからは作成できません。これは、既存の構成済み .NETInput ノードからのみ、作成できます。
Cloned ノードを作成するには、.NETInput ノードを選択し、右クリックしてから、「複製ノードの作成...」を選択する必要があります。
Cloned ノードは、パレットの「.NET」ドロワーに、指定した名前で保存され、IBM Integration Toolkit 内では選択したノード・アイコンによって表されます。
Cloned ノードのインスタンスを作成すると、クローン作成元の .NETInput ノードに指定したプロパティーおよび値を使用して構成されます。
Cloned ノードのプロパティーまたは値を変更するには、それらを構成します。メッセージ・フロー・ノードの構成を参照してください。
Cloned ノードのインスタンスは、グラフィカル・データ・マップにドラッグするときに構成できます。ノードを構成するには、ファイル・エクスプローラーでアセンブリー・ファイルをノードにドラッグします。 ノードのプロパティーが、「プロパティー」ビューに表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
妥当性検査プロパティーを設定して、.NETInput ノードによって生成されたメッセージの妥当性検査を行う方法を定義します。
詳しくは、メッセージの妥当性検査および妥当性検査プロパティーを参照してください。
.NETInput ノードのターミナルについては、次の表に説明されています。
| ターミナル | 説明 |
|---|---|
| Failure | Out ターミナルにメッセージが伝搬される前にエラーが起きた場合、メッセージのルーティング先となる出力ターミナル。 「妥当性検査」プロパティーが設定されている場合でも、このターミナルに伝搬されるメッセージは妥当性検査が行われません。 |
| Out | 入力ノード内でエラーが起こらなかった場合、外部リソースから受信されるメッセージは常にこの Out ターミナルにまず送信されます。 |
| Catch | 例外がダウンストリームでスローされ、ノードによってキャッチされた場合に、メッセージがルーティングされる出力ターミナル。 例外がキャッチされるのは、このターミナルが接続されている場合のみです。 |
以下の表は、指定したタブで設定できるノード・プロパティーについて説明しています。 M の見出しの列では、プロパティーが必須 かどうか (デフォルトが定義されていない場合に値を入力することが必要かどうか) を示します (必須であれば、ツールキットでアスタリスクのマークが付きます)。 C の見出しの列では、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| ノード名 | いいえ | いいえ | ノード・タイプ | ノードの名前。 |
| 簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
| 詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| アセンブリー名 | はい | はい | ノードを実装するアセンブリー。 アセンブリーを選択するには「参照」オプションを使用します。 または、アセンブリーの .dll ファイルをノードまでドロップすると、このプロパティーの指定が自動的に完了します。 | assemblyName | |
| クラス名 | いいえ | はい | ノードを実装するクラスの名前。 このプロパティーの値が必要とされるのは、同じアセンブリーから複数のノードが公開される場合、または実装ノードとしてサブクラスを明示的に指定する場合だけです。 | connectorClassName |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| メッセージ・ドメイン | いいえ | いいえ | BLOB | メッセージの構文解析に使用されるドメイン。 フィールドがブランクの場合、デフォルトは BLOB になります。 |
| メッセージ・モデル | いいえ | いいえ | 選択されていない | メッセージが定義されているメッセージ・モデル・スキーマ・ファイルの名前またはロケーション。 このリストには、選択したメッセージ・ドメインに使用可能なすべてのメッセージ・モデル・スキーマ・ファイルが取り込まれます。 |
| メッセージ | いいえ | いいえ | 選択されていない | メッセージ・モデル・スキーマ・ファイル内のメッセージ・ルートの名前またはロケーション。 このリストには、選択したメッセージ・モデルで定義された、利用可能なすべてのメッセージが取り込まれます。 |
| 物理形式 | いいえ | いいえ | 選択されていない | メッセージの物理フォーマットの名前。 MRM または IDoc パーサーを使用する場合は、リストから着信メッセージの物理形式を選択します。このリストには、選択されたメッセージ・モデル用に定義したすべての物理形式が含まれます。「メッセージ・ドメイン」プロパティーを DataObject に設定した場合、このプロパティーを XML または SAP ALE IDoc に設定できます。 外部ソースからのビット・ストリームを構文解析してメッセージ・ツリーを生成するには、このプロパティーを SAP ALE IDoc に設定します。 |
| メッセージ・コード化文字セット ID | いいえ | いいえ | ブローカー・システム・デフォルト | 読み取られるファイルのバイトを解釈するのに使用されるコード化文字セットの ID。mqsiapplybaroverride のコマンド・プロパティーは messageCodedCharSetIdProperty です。 |
| メッセージ・エンコード | いいえ | いいえ | ブローカー・システム指定 | 読み取られるファイルのバイトを解釈するのに使用される数字およびラージ文字のエンコード・スキーム。有効な値は、「ブローカー・システム指定」または数値のエンコード値です。 エンコードの詳細については、データ変換を参照してください。 mqsiapplybaroverride のコマンド・プロパティーは messageEncodingProperty です。 |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| 構文解析のタイミング | はい | いいえ | 要求時 | このプロパティーは、入力メッセージを構文解析する時を制御します。 有効な値は、「要求時」、「即時」、
および「完全」です。 「解析のタイミング」は、デフォルトによって、「要求時」に設定されます。これにより、メッセージの妥当性検査が遅延されます。 メッセージが即時に解析されるようにするには、要求時の構文解析を参照してください。 |
| XML スキーマ・データ・タイプを使用してツリーを構築する | はい | いいえ | 選択されていない | このプロパティーは、XML スキーマから取得されたデータ・タイプを使って、XMLNSC パーサーがメッセージ・ツリー内に構文エレメントを作成するかどうかを制御します。 「妥当性検査」タブ上の「妥当性検査」プロパティーを「内容」 または 「内容と値」 に設定した場合にのみ、このプロパティーを選択できます。 |
| XMLNSC コンパクト・パーサーを XMLNS ドメインに使用 | はい | いいえ | 選択されていない | このプロパティーは、XMLNS ドメイン内のメッセージに XMLNSC コンパクト・パーサーを使用するかどうかを制御します。 このプロパティーを設定すると、入力 MQRFH2 ヘッダーまたは「入力メッセージの構文解析」プロパティー「メッセージ・ドメイン」が XMLNS の場合に、出力ターミナルに接続されているノードの XMLNSC の下にメッセージ・データが表示されます。 詳しくは、XMLNSC ドメインでのメッセージの操作を参照してください。 |
| 混合内容の保存 | はい | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内に混合テキストを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、混合テキスト用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、混合テキストは無視されて、エレメントは作成されません。 |
| コメントの保存 | はい | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内にコメントを検出したとき、メッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、コメント用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、コメントは無視されて、エレメントは作成されません。 |
| 処理命令の保存 | はい | いいえ | 選択されていない | このプロパティーは、XMLNSC パーサーが入力メッセージ内に処理命令を検出したとき、これらのメッセージ・ツリー内にエレメントを作成するかどうかを制御します。 チェック・ボックスを選択すると、処理命令用のエレメントが作成されます。 このチェック・ボックスのチェックを外した場合、処理命令は無視されて、エレメントは作成されません。 |
| 不透明エレメント | はい | いいえ | ブランク | XMLNSC パーサーによって不透明解析される入力メッセージ内のエレメントのリストを指定するときに、このプロパティーを使用します。 不透明解析が実行されるのは、妥当性検査が使用不可に設定されている場合のみ (つまり、「妥当性検査」が「なし」の場合) です。妥当性検査が使用可能な場合、「不透明エレメント」で指定される項目は無視されます。 |
.NETInput ノードの「妥当性検査」プロパティーについては、次の表に説明されています。メッセージ・モデルに照らしてメッセージの本体をパーサーで妥当性検査するには、これらのプロパティーを設定します。(メッセージがノードの Failure ターミナルに伝搬される場合には、妥当性検査は行われません。)
詳しくは、メッセージの妥当性検査および妥当性検査プロパティーを参照してください。
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| 妥当性検査 | はい | はい | なし | このプロパティーは、妥当性検査を行うかどうかを制御します。 有効な値は、「なし」、「内容」、「内容と値」、および「継承」です。 | validateMaster |
| 失敗時の処置 | はい | いいえ | 例外 | このプロパティーは、妥当性検査が失敗した場合の動作を制御します。 「妥当性検査」を「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。 有効な値は、「ユーザー・トレース」、「ローカル・エラー・ログ」、「例外」、および「例外リスト」です。 |
「インスタンス」プロパティーの詳細については、構成可能な「メッセージ・フロー」プロパティーを参照してください。
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| 追加インスタンス・プール | いいえ | はい | メッセージ・フローに関連付けられたプールの使用 | 追加インスタンスの取得元のプール。
|
|
| 追加インスタンス | いいえ | はい | 0 | 「追加インスタンス・プール」プロパティーが「ノードに関連付けられたプールの使用」に設定されている場合に、ノードが開始できる追加インスタンスの数。 | additionalInstances |
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| イベント | いいえ | いいえ | なし | ノードに対して定義したイベントが、このタブに表示されます。デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。 |
.NETInput ノードの「Microsoft Visual Studio」プロパティーについては、次の表に説明されています。 これらのプロパティーは、入力コネクターへのデプロイメントの一環として、実行時に送信されます。
詳しくは、.NETInput ノードを使用したメッセージの作成を参照してください。
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| Visual Studio プロジェクト名 | いいえ | いいえ | ノードのコードが入っている Microsoft Visual Studio プロジェクトまたはソリューション。 |
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| AppDomain 名 | いいえ | はい | ノードのホストである .NET AppDomain。 | AppDomain | |
| バージョン | いいえ | はい | アセンブリーのバージョン。 | AssemblyVersion | |
| 国/地域別環境 | いいえ | はい | アセンブリーの国/地域別情報。 | AssemblyCulture | |
| 公開鍵トークン | いいえ | はい | アセンブリーの公開鍵トークン。 | AssemblyPublicKeyToken |
| プロパティー | M | C | デフォルト | 説明 | mqsiapplybaroverride コマンド・プロパティー |
|---|---|---|---|---|---|
| <ユーザー指定の名前> | いいえ | いいえ | ノードは、それぞれに名前と値のペアが含まれた行をユーザーが追加、編集、または削除できる表を提供します。 |