プロダクションから Amazon SNS へのメッセージの送信
Amazon SNSOpens in a new tab は、パブリッシャからのメッセージをサブスクライバに提供するクラウド・サービスです。SNS 送信アダプタを使用するビジネス・オペレーションを含む相互運用プロダクションを作成することにより、SNS パブリッシャとしてインターシステムズ製品を構成できます。ビジネス・オペレーションおよびアダプタに不慣れな場合は、"相互運用プロダクションの概要" を参照してください。
SNS に送信されるメッセージには、トピック、件名、メッセージのコンテンツの 3 つのコンポーネントがあります。パブリッシャによって SNS に送信される各メッセージは、特定のトピックに関連付けられている必要があります。SNS は、特定のトピックをサブスクライブしているサブスクライバにメッセージをプッシュします。SNS に送信されたメッセージには、件名も含めることができます。メッセージが電子メールとしてサブスクライバに配信されると、SNS はこの件名を件名行として使用します。
アダプタの詳細
SNS 送信アダプタの ObjectScript クラスは EnsLib.AmazonSNS.OutboundAdapterOpens in a new tab です。組み込みのビジネス・オペレーションを使用している場合、この送信アダプタの詳細について知る必要はありません。ビジネス・オペレーションがこれを処理します。ただし、カスタムのビジネス・オペレーションを記述している場合は、これがアダプタの Publish() メソッドを呼び出して、SNS にメッセージを送信することになります。カスタムのビジネス・オペレーションからこのメソッドを呼び出すには、以下を追加します。
Set tSC = ..Adapter.Publish(..ARNTopic, request.Message, ..Subject)
説明 :
-
ARNTopic は、SNS トピックを定義するビジネス・オペレーションのプロパティです。必須。
-
request.Message は、SNS に送信されるメッセージを含むプロダクション要求オブジェクトのプロパティです。必須。
-
Subject は、SNS サブジェクトを定義するビジネス・オペレーションのプロパティです。オプション。
これがどのように機能するのかを示した例は、EnsLib.AmazonSNS.BusinessOperation のソース・コードを参照してください。カスタムのビジネス・オペレーションの作成の詳細は、"ビジネス・オペレーションの定義" を参照してください。
SNS 送信アダプタは、InterSystems PEX フレームワークを使用して開発されているため、このアダプタの ObjectScript ソース・コードは、他のアダプタとは異なるように見えます。例えば、アダプタのメソッドは、実際には Java PEX コンポーネント内に記述されたメソッドのラッパです。
組み込みのビジネス・オペレーション
インターシステムズは、カスタム・コードを記述することなく、SNS にメッセージを公開するために使用できる、組み込みのビジネス・オペレーションを提供しています。SNS 送信アダプタを使用しているため、プロダクションを SNS パブリッシャにするために必要なのは、この組み込みのビジネス・オペレーションのみです。ただ、EnsLib.AmazonSNS.BusinessOperationOpens in a new tab をプロダクションに追加し、このビジネス・オペレーションに EnsLib.AmazonSNS.PublishRequestOpens in a new tab 要求を送信するよう、その他のビジネス・ホストを構成するだけです。ビジネス・オペレーションのプロダクションへの追加に関する情報は、"ビジネス・ホストの追加" を参照してください。
EnsLib.AmazonSNS.BusinessOperationOpens in a new tab ビジネス・オペレーションには、メッセージを SNS トピックに関連付けるために使用されるプロパティ ARNTopic が含まれます。管理ポータルの [SNS]→[ARNTopic] 設定を使用してトピックを指定できます。
[SNS]→[件名] 設定を使用して、ビジネス・オペレーションによって送信されるメッセージに件名を付与できます。件名の定義はオプションです。
メッセージのトピックと件名はビジネス・オペレーションで定義される一方、メッセージの実際のコンテンツは、EnsLib.AmazonSNS.PublishRequestOpens in a new tab 要求でビジネス・オペレーションに送信されて、この要求オブジェクトを別のビジネス・ホストから送信するようにプロダクションが構成されます。
一般的な AWS 設定
SNS 送信アダプタは、一般的な AWS プロパティを含む一般的なアダプタ・クラスを拡張します。これらの AWS プロパティは、送信アダプタを使用するビジネス・オペレーションをプロダクションに追加する際、管理ポータルでビジネス・オペレーションの [AWS] 設定を使用して設定できます。
-
CredentialsFile — 空白の場合、Amazon は既定の認証情報プロバイダ・チェーンOpens in a new tabを使用して、SNS へのアクセスに必要な認証情報を取得します。AWS 認証情報ファイルを使用する場合は、そのパス名を入力します。
-
リージョン — アクセスする AWS リージョンを指定します。リージョンのリストは、"Amazon Regions, Availability Zones, and Local ZonesOpens in a new tab" を参照してください。
関連項目
-
Amazon SNS メッセージング API の使用法 (プロダクションなしで使用する場合)