プロダクションから Amazon SQS へのメッセージの送信

アダプタの詳細

Amazon SQS 送信アダプタは、クラス EnsLib.AmazonSQS.OutboundAdapterOpens in a new tab です。

送信アダプタを使用するカスタムのビジネス・オペレーションの構築に関する一般情報は、"ビジネス・オペレーションの定義" を参照してください。

Amazon SQS メッセージの送信

送信アダプタにより Amazon SQS に送信されるメッセージのクラスは EnsLib.AmazonSQS.MessageOpens in a new tab です。このクラスには、以下を含め、メッセージを定義するためのいくつかのプロパティが含まれます。

• queue は、プロデューサがメッセージを送信する Amazon SQS キューを定義します。

• body は、メッセージのコンテンツを定義します。

このクラスがメッセージ・オブジェクト・プロパティを介して利用できるメッセージ識別子の詳細な説明は、Amazon SQS のドキュメントOpens in a new tabを参照してください。

messageAttributes プロパティを使用して、メッセージのカスタム・メタデータを指定することもできます。messageAttributes プロパティは、%External.Messaging.SQSMessageAttribute オブジェクトの %ListOfObjects コレクションを受け入れます。SQS メッセージ属性オブジェクトの作成に関する詳細なガイダンスについては、Amazon SQS API に関するドキュメントを参照してください。メッセージ属性を使用してカスタム・メタデータを添付する場合の一般情報は、Amazon SQS のドキュメントOpens in a new tabを参照してください。

送信アダプタの SendMessage() メソッドは、唯一の引数として EnsLib.AmazonSQS.MessageOpens in a new tab オブジェクトを取り、そのメッセージを Amazon SQS サーバに送信します。例えば、カスタムのビジネス・オペレーションは、以下を含めることにより、アダプタのメソッドを呼び出すことができます。

Do ..Adapter.SendMessage(pRequest)

組み込みのビジネス・オペレーション

送信アダプタを使用するカスタムのビジネス・オペレーションを構築するのではなく、管理ポータルを使用して、プロダクションに単に EnsLib.AmazonSQS.OperationOpens in a new tab を追加し、必要な設定を定義するだけです。このビジネス・オペレーションは、プロダクション内の別のビジネス・ホストから要求を受信すると、アダプタの SendMessage() メソッドを呼び出します。この要求には、EnsLib.AmazonSQS.MessageOpens in a new tab のタイプの Amazon SQS メッセージを含める必要があります。

ビジネス・オペレーションのプロダクションへの追加に関する基本情報は、"ビジネス・ホストの追加" を参照してください。

一般的な AWS 設定

SQS 送信アダプタは、一般的な AWS プロパティを含む一般的なアダプタ・クラスを拡張します。これらの AWS プロパティは、送信アダプタを使用するビジネス・オペレーションをプロダクションに追加する際、管理ポータルでビジネス・オペレーションの [AWS] 設定を使用して設定できます。

• CredentialsFile — 空白の場合、Amazon は既定の認証情報プロバイダ・チェーンOpens in a new tabを使用して、SQS へのアクセスに必要な認証情報を取得します。AWS 認証情報ファイルを使用する場合は、そのパス名を入力します。

• リージョン — アクセスする AWS リージョンを指定します。リージョンのリストは、"Amazon Regions, Availability Zones, and Local ZonesOpens in a new tab" を参照してください。

関連項目

• プロダクション内からの Amazon SQS メッセージの取得

• Amazon SQS メッセージング API の使用法 (プロダクションなしで使用する場合)