BizTalk でGraphQL にストアドプロシージャを実行する
CData BizTalk Adapter が提供するストアドプロシージャを使用して、BizTalk のGraphQL を自動化できます。ストアドプロシージャは、基盤となるAPI で使用できるアクションを実装しています。
加藤龍彦
デジタルマーケティング
最終更新日:2021-07-17
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないGraphQL アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。
プロジェクトにアダプターを追加する
[Add Adapter] ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。
- [Solution Explorer] の[project] で右クリックし、[Add] -> [Add Generated Items] と進みます。
- [resulting dialog box] の[Add Adapter Metadata] を選択します。
- 表示される[Add Adapter] ウィザードで、リストからアダプターを選択します。
- [Port menu] では、選択を空白のままにします。もしくは、GraphQL アダプターを使用するように構成されている受信場所や送信ポートを選択します。
送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、[Connection String] ページで、それらを入力します。下は一般的な接続文字列です。
AuthScheme=Basic;User=username;Password=password;URL=https://mysite.com;
GraphQL サービスのURL を指定する必要があります。
ドライバーは2種類の認証をサポートします。
- Basic: AuthScheme をBasic に設定。GraphQL サービスのUser とPassword を指定する必要があります。
- OAuth 1.0 & 2.0: 詳しい説明は、ヘルプドキュメントのOAuth セクションを参照してください。
スキーマを作成する
[Add Adapter] ウィザードで接続プロパティを入力すると、[Schema] ウィザードが表示されます。
- 次の[Schema Information] のページでは、GraphQL アダプターを使用するために構成した送信ポートを選択します。
- CData GraphQL アダプターが要請応答送信ポートで構成されている場合、[One-Way] オプションを無効にします。
- [Command Type] メニューで、ストアドプロシージャを選択します。
- メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
- ウィザードで表示される概要の設定を確認して[Finish] をクリックし、schema.xsd ファイルを作成します。
スキーマを処理する
BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。