CData BizTalk Adapter for AmazonS3 の受信場所（Receive Location）を設定

この記事では、Amazon S3 データに接続し、静的な単方向の受信場所を設定する方法を紹介します。さらにこの受信場所を使用してAmazon S3 データを取得し、XML ファイルに書き込むという簡単なテストを実行していきます。

受信場所はSQL コマンドを実行し、その結果を含むBizTalk メッセージを作成することができます。アップデートグラムコマンドを実行したい場合は、送信ポートを使用してください。

受信ポートを作成する

アプリケーションに受信場所を追加するには、まず受信ポートを追加する必要があります。受信ポートは複数の受信場所からのデータを受け取ることができます。

1. 未実行の場合、BizTalk Administration Console でアプリケーションを開きます。
2. アプリケーションを開いたら、「Receive Ports」を右クリックし、「New」 -> 「Static One-Way Receive Port」と進みます。受信ポートプロパティのダイアログが表示されます。
3. 「Name」メニューで、受信ポートの名前を入力します。

受信場所を作成する

受信ポートの作成後、受信場所を作成し、トランスポートタイプとしてSalesforce アダプタを使用するように設定します。

1. 「Receive Locations」を右クリックし、「New」 -> 「One-Way Receive Location」と進みます。
2. 新しい受信場所がメンバとなる適切な受信ポートを選択します。受信場所プロパティのダイアログが表示されます。
3. 「Name」メニューで、受信場所の名前を入力します。
4. 受信場所のプロパティの、「Transport Type」メニュー内でCData.AmazonS3 を選択します。
5. 「Receive Pipeline」メニューで、デフォルトオプションの「PassThruReceive」を選択します。

アダプタを設定する

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

1. 受信場所のプロパティで、「Configure」をクリックします。アダプタの「Transport Properties」ダイアログが表示されます。
2. 「SQL Command」プロパティで、コマンドを入力します。この例では、SELECT Name, OwnerId FROM ObjectsACL WHERE Name = 'TestBucket'を使用します。

接続文字列を構成する

Connection String Options ダイアログで、資格情報とその他の接続プロパティを設定します。

1. 受信場所のプロパティで、「Configure」をクリックします。アダプタのプロパティダイアログが表示されます。
2. 「Connection String」プロパティのボタンをクリックします。
3. 「Connection String」プロパティのボックスをクリックします。「Connection String Options」ダイアログが表示されます。
4. 接続プロパティを入力します。以下は一般的な接続文字列です。 AccessKey=a123;SecretKey=s123;

   Amazon S3 リクエストを認可するには、管理者アカウントまたはカスタム権限を持つIAM ユーザーの認証情報を入力します。AccessKey をアクセスキーID に設定します。SecretKey をシークレットアクセスキーに設定します。

   Note: AWS アカウント管理者として接続できますが、AWS サービスにアクセスするにはIAM ユーザー認証情報を使用することをお勧めします。

   尚、本製品はAmazon S3 のファイルの一覧表示やユーザー管理情報の取得用です。S3 に保管されているExcel、CSV、JSON などのファイル内のデータを読み込みたい場合には、Excel Driver、CSV Driver、JSON Driver をご利用ください。

   アクセスキーの取得

   IAM ユーザーの資格情報を取得するには：

   1. IAM コンソールにサインインします。
   2. ナビゲーションペインで「ユーザー」を選択します。
   3. ユーザーのアクセスキーを作成または管理するには、ユーザーを選択してから「セキュリティ認証情報」タブを選択します。

   AWS ルートアカウントの資格情報を取得するには：

   1. ルートアカウントの資格情報を使用してAWS 管理コンソールにサインインします。
   2. アカウント名または番号を選択し、表示されたメニューで「My Security Credentials」を選択します。
   3. 「Continue to Security Credentials」をクリックし、「Access Keys」セクションを展開して、ルートアカウントのアクセスキーを管理または作成します。

   AWS ロールとして認証

   多くの場合、認証にはAWS ルートユーザーのダイレクトなセキュリティ認証情報ではなく、IAM ロールを使用することをお勧めします。RoleARN を指定することでAWS ロールを代わりに使用できます。これにより、本製品は指定されたロールの資格情報を取得しようと試みます。

   （すでにEC2 インスタンスなどで接続されているのではなく）AWS に接続している場合は、ロールを引き受けるIAM ユーザーのAccessKey とSecretKey を追加で指定する必要があります。AWS ルートユーザーのAccessKey および SecretKey を指定する場合、ロールは使用できません。

   SSO 認証

   SSO 認証を必要とするユーザーおよびロールには、RoleARN およびPrincipalArn 接続プロパティを指定してください。各Identity Provider に固有のSSOProperties を指定し、AccessKey とSecretKey を空のままにする必要があります。これにより、本製品は一時的な認証資格情報を取得するために、リクエストでSSO 認証情報を送信します。

5. 「Test Connection」をクリックして値を確認し、接続を確認します。

プロパティとその機能についての説明は、ヘルプドキュメントを参照してください。

送信ポートを使用して、XML ファイルにデータを書き込む

これまでの操作で、静的な単方向の受信場所を送信ポートとともに使うことができるようになります。送信ポートは、受信場所で作成されるBizTalk メッセージと関連付けられていなければなりません。ファイルにデータを書き込むために、ファイル送信ポートを作成します。

1. 「BizTalk Administration」コンソールで右クリックし、「Send Ports」 -> 「New」 -> 「Static One-Way Send Port」と進みます。

2. 構成ウィンドウの最初で送信ポートの名前を入力し、「Type」メニューから「FILE」を選択します。

3. 宛先フォルダを設定します。これは、ディスク上にファイルが作成される場所になります。

4. ファイル名にマクロを使用すれば、ファイルの作成日を簡単に識別できます。デフォルトでは、%MessageId%.xml が使用されます。これはランダムに生成されたBizTalk Id であり、ユーザーフレンドリーな命名ではありません。 ObjectsACL_yyyy-MM-dd.xml の形式でファイルを作成するには、ObjectsACL_%Date%.xml と入力します。

   Noteマクロの詳細については、ヘルプドキュメントの「BizTalk Configuration」のセクションを参照してください。

5. 「OK」をクリックします。URI フィールドに値が含まれるはずです。
6. 送信ポートの、構成画面の左側にある「Filters」をクリックします。
7. 次のプロパティを設定します。

   プロパティ:メニューから、「BTS.InboundTransportLocation」を選択します。

   オペレーター:メニューから、「==」を選択します。

   値:受信場所のURI を入力します。受信場所のプロパティに、URI が表示されます。

送信ポートを使用して、受信場所から送信されたファイルを書き込むことができます。

ロケーションとポートをエンリストして有効にする

最後に、送信ポートをエンリストし、受信場所を有効にします。送信ポートを右クリックし、「Enlist」をクリックします。次に、受信場所を右クリックし、「Enable」をクリックします。

Note最後に受信場所を有効にすることで、送信ポートによって、ファイルが書き込み用として確実にピックアップされます。

トラブルシューティング

エラーが発生しているかどうかを確認するには、「Administration Console」のナビゲーションツリーで「Event Viewer (Local)」を展開します。Windows ログを展開し、「Applications」をクリックします。