こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ここでは、CData BizTalk Adapter for Bitbucket を使用して静的な一方向送信ポートを作成、構成、テストする手順を説明します。静的な一方向送信ポートを使用することで、アップデートグラム、SQL コマンド、ストアドプロシージャを実行できます。送信ポートは、 返答データを持たない Bitbucket データ変更の操作に役立ちます。通常、これはDELETE またはUPDATE のSQL コマンドか、アップデートグラムですが、場合によっては、ストアドプロシージャになります。
SELECT コマンドの実行や、作成したレコードId の取得のような、応答するアクションをトリガーする場合は、要請応答送信ポートを使用します。
一方向送信ポートを作成し実行する
静的な一方向送信ポートを作成し、Bitbucket アダプタをトランスポートタイプとして使用するように構成します。
- 未実行の場合、BizTalk 管理コンソールでBizTalk アプリケーションを開きます。
- BizTalk アプリのノードで、[Send Ports]を右クリックし、[New]->[Static One-Way Send Port]を選択します。送信ポートプロパティのダイアログが表示されます。
- [Name]メニューで、送信ポートの名前を入力します。
- [Type]メニューで、CData.Bitbucket を選択します。
- [Send Pipeline]メニューで、デフォルトオプションの[PassThruTransmit]を選択します。
アダプタを構成する
[Transport Properties]ダイアログで、アダプタが実行するコマンドを定義します。
- 送信ポートのプロパティで、[Configure]ボタンをクリックします。CData.Bitbucket トランスポートプロパティのダイアログが表示されます。
- [CommandType]プロパティで、実行したいコマンドタイプを選択します。
- SQL コマンドを実行したい場合は、[SQL Command]のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、
ヘルプドキュメントの[Adapter Configuration]を参照してください。
Bitbucket への接続を構成する
Connection String Options ダイアログで、Bitbucket への接続に必要な資格情報とその他のプロパティを設定します。
- 送信ポートのプロパティダイアログで[Configure]をクリックすると、アダプタのプロパティダイアログが表示されます。
- [Connection String]プロパティのボタンをクリックします。
- [Connection String]プロパティのボックスをクリックします。[Connection String Options]ダイアログが表示されます。
- 接続プロパティを入力します。下は一般的な接続文字列です。
Workspace=myworkspaceslug;Schema=Information
ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。
Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。
- Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
- Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。
Bitbucketでの認証
BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。
特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。
カスタムOAuthアプリケーションの作成
Bitbucketアカウントから、以下のステップを実行します。
- 設定(歯車アイコン)に移動し、ワークスペース設定を選択します。
- アプリと機能セクションで、OAuthコンシューマーを選択します。
- コンシューマーを追加をクリックします。
- カスタムアプリケーションの名前と説明を入力します。
- コールバックURLを設定します。
- デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
- Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
- クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
- OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
- 新しいカスタムアプリケーションを保存するには、保存をクリックします。
- アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。
- [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、
ヘルプドキュメントの[Connection String Options]チャプターを参照してください。
接続に成功し、アダプターが実行するコマンドを定義することで、送信ポートを使用できるようになります。アプリケーションで一方向送信ポートを使用する例については、次のセクションを参照してください。アプリケーションはファイルに含まれているアップデートグラムコマンドを読み取り、送信ポートを使用してコマンドを実行します。
この例ではフィルターを利用して、アップデートグラムを含むメッセージを受信場所から送信ポートに移動します。フィルターについてのより詳しい説明は次のセクションを参照してください。
フィルターを作成し、アプリケーションを介してBizTalk メッセージをルーティングする
送信ポートを必要なメッセージに関連付けるには、その送信ポートのプロパティの[Filters]セクションでフィルタールールを作成します。条件に一致するメッセージは、送信ポートにルーティングされます。受信場所でのフィルタリングに関しては、次の例を参照してください。
例:一方向送信ポートでアップデートグラムを実行する
このセクションでは、一方向送信ポートをアプリケーションで使用する方法について説明します。アプリケーションはファイルに含まれているアップデートグラムコマンドを読み取り、コマンドを実行します。
- 一方向受信場所はアップデートグラムを含むXML ドキュメントをピックアップします。
- 受信場所は、コマンドの結果を含むBizTalk メッセージを作成します。
- 一方向送信ポートは、受信場所のURI をフィルタリングします。ドキュメントは一方向送信ポートにルーティングされます。
- 送信ポートは、アップデートグラムコマンドを実行します。
前の例と同様に次のステップでは、ファイルからアップデートグラムを読み取るための受信場所を設定し、送信ポートを使用してコマンドを実行する方法を説明します。
- 静的な一方向の受信場所を作成、構成します。転送タイプのファイルを使用します。「CData BizTalk Adapter for Bitbucket の受信場所を作成、構成する」と同じ手順に従います。
- 静的な一方向送信ポートを作成します。
- 送信ポートのプロパティで、[Filters]をクリックします。
- 空のプロパティで、次の値を設定します。
- プロパティ
- メニューから BTS.InboundTransportLocation を選択します。
- 値
- 新しく作成された一方向受信場所のURI を入力します。