BizTalk でConfluence にストアドプロシージャを実行する
CData BizTalk Adapter が提供するストアドプロシージャを使用して、BizTalk のConfluence を自動化できます。ストアドプロシージャは、基盤となるAPI で使用できるアクションを実装しています。
加藤龍彦
デジタルマーケティング
最終更新日:2021-07-17
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないConfluence アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。
プロジェクトにアダプターを追加する
[Add Adapter] ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。
- [Solution Explorer] の[project] で右クリックし、[Add] -> [Add Generated Items] と進みます。
- [resulting dialog box] の[Add Adapter Metadata] を選択します。
- 表示される[Add Adapter] ウィザードで、リストからアダプターを選択します。
- [Port menu] では、選択を空白のままにします。もしくは、Confluence アダプターを使用するように構成されている受信場所や送信ポートを選択します。
送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、[Connection String] ページで、それらを入力します。下は一般的な接続文字列です。
User=admin;APIToken=myApiToken;Url=https://yoursitename.atlassian.net;Timezone=America/New_York;
API Token を取得する方法
API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token
に進みます。生成されたトークンが表示されます。
Confluence Cloud Account への接続
Cloud アカウントへの接続には、以下のプロパティを設定します(Password は、Server Instance への接続時のみ必要で、Cloud Account
への接続には不要になりました。):
- User: Confluence サーバーに認証するユーザー名。
- APIToken: 認証するユーザーに紐付けられたAPI Token。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
Confluence Server Instance への接続
Server instance への接続には以下を設定します:
- User: Confluence Instance に接続するユーザー名。
- Password: Confluence Instance に接続するユーザーのパスワード。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
スキーマを作成する
[Add Adapter] ウィザードで接続プロパティを入力すると、[Schema] ウィザードが表示されます。
- 次の[Schema Information] のページでは、Confluence アダプターを使用するために構成した送信ポートを選択します。
- CData Confluence アダプターが要請応答送信ポートで構成されている場合、[One-Way] オプションを無効にします。
- [Command Type] メニューで、ストアドプロシージャを選択します。
- メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
- ウィザードで表示される概要の設定を確認して[Finish] をクリックし、schema.xsd ファイルを作成します。
スキーマを処理する
BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。