CData Asana BizTalk Adapter の要請応答送信ポートを構成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

ここでは、CData BizTalk Adapter for Asana を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。

送信ポートを作成し構成する

静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。

1. 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
2. BizTalk アプリのノードで、［Send Ports］を右クリックし、［New］->［Static Solicit-Response Send Port］を選択すると、送信ポートプロパティのダイアログが表示されます。
3. 送信ポートのプロパティで、受信ポートの名前を入力します。
4. ［Transport Type］メニューで、CData.Asana を選択します。
5. ［Send Pipeline］メニューで、デフォルトオプションの［PassThruTransmit］を選択します。
6. ［Receive Pipeline］メニューで、デフォルトオプションの［PassThruReceive］を選択します。

アダプタを構成する

［Transport Properties］ダイアログで、アダプタが実行するコマンドを定義します。

1. 送信ポートのプロパティで、［Configure］ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
2. ［CommandType］プロパティで、実行したいコマンドタイプを選択します。
3. SQL コマンドを実行したい場合は、［SQL Command］のボックスにコマンドを入力してください。

Asana への接続を構成する

［Connection String Options］ダイアログで、Asana への接続に必要な資格情報とその他のプロパティを設定します。

1. 送信ポートのプロパティで、［Configure］をクリックします。アダプタのプロパティダイアログが表示されます。
2. ［Connection String］プロパティのボタンをクリックします。［Connection String Options］ダイアログが表示されます。
3. 接続プロパティを入力します。下は一般的な接続文字列です。

   OAuthClientId=YourClientId;OAuthClientSecret=YourClientSecret;CallbackURL='http://localhost:33333';

   Asana への接続は以下のように行います。

   • WorkspaceId: Asana Wrokspace のglobally unique identifier (gid) を設定すると指定されたWorkspace のプロジェクトだけを返します。Workspace Id はhttps://app.asana.com/api/1.0/workspaces から取得します。表示されるJSON にWorkspace name およびId が含まれます。
   • ProjectId: Asana Project のglobally unique identifier (gid) に設定すると指定されたProject のデータだけを返します。Project ID はプロジェクトのOverview ページのURL を参照してください。/0/ の後ろの数字 です。

   OAuth 認証

   Asana への認証にはOAuth 認証が使われます。OAuth はAsana のブラウザで認証ユーザーを認証する処理が必要です。OAuth の詳細については、ヘルプドキュメントの「はじめに」を参照してください。

4. ［Test Connection］をクリックして値を確認し、接続を確認します。