この記事の目次
Salesforceにおけるアウトバウンドメッセージとは
Salesforceにおけるアウトバウンドメッセージはワークフロールール機能の一部で、Salesforceの項目が変更された際に自動的にアクションを起動します。
変更された項目に関する、以下のようなメッセージを送信します。受信したエンドポイントは、アウトバウンドメッセージに記載されたアクションを実行します。
・メールアラートの送信
・ToDo レコードの作成
・アウトバウンドメッセージの送信 など
Salesforce アウトバウンドメッセージの機能概要
SalesForceのアウトバウンドメッセージの機能は、以下の流れで実行されます。
この手順を次のトリガにつなげる形で、循環型の変更を作成できます。
①ワークフロールールでトリガイベントが発生する。
②指定されたエンドポイント URL に、指定された項目を含むSOAP メッセージを送信する。
③エンドポイント URL が受信したメッセージから情報を取得して処理
Salesforceでアウトバウンドメッセージ送信の設定
ここでは、Salesforceでアウトバウンドメッセージを送信するための設定について説明します。
アウトバウンドメッセージを使用するには、事前に設定が必要です。この設定を済ませた後、アウトバウンドメッセージにワークフロールールを関連づけ、WSDLを作成するという流れになります。
Salesforceのアウトバウンドメッセージは、notifications() コールを使用して送信されます。アウトバウンドメッセージに必要なメタデータ含むWDSLによって定義します。
アウトバウンドメッセージに関連づけたWSDLに、エンドポイントサービスへの到達方法の情報と、エンドポイントサービスに送信するデータを記載します。
1、ユーザプロファイルを設定する
ユーザプロファイルの設定により、アウトバウンドメッセージを送信先となるユーザを指定します。 指定されたワークフローのアクションにより、指定されたユーザへのセッションID を含むアウトバウンドメッセージがトリガされます。 このアウトバウンドメッセージを受信したエンドポイントが、Lightning プラットフォーム API を呼び出し、同じ操作を実行します。この更新により、さらに新たなワークフロー、アクション、アウトバウンドメッセージがトリガされ、変更が循環していきます。 ①アウトバウンドメッセージを設定して、セッションID を指定します。 ②[送信ユーザ] 項目で、ユーザを指定します。 ※ユーザ側ではアウトバウンドメッセージを無効化しないことが前提です。循環型の変更を回避したい場合
アウトバウンドメッセージに応答する1人のユーザを指定し、このユーザのアウトバウンドメッセージを無効化することで、循環型の変更を回避できます。 アウトバウンドメッセージの無効化： ユーザのProfileから、[アウトバウンドメッセージの送信] を解除します。2、アウトバウンドメッセージを定義する
Salesforce ユーザインターフェースから、次の手順を実行してアウトバウンドメッセージを定義します。アウトバウンドメッセージの新規作成から、送信先、アウトバウンドメッセージに記載する内容などを設定します。①アウトバウンドメッセージを作成・編集する
アウトバウンドメッセージの新規作成と既存のアウトバウンドメッセージの編集を説明します。既存のアウトバウンドメッセージでは、ワークフロールールと承認プロセスが表示されます。 新規作成する場合： [設定] ＞ [クイック検索] ボックスに「アウトバウンドメッセージ」と入力＞ [アウトバウンドメッセージ] ＞ [新規アウトバウンドメッセージ] 既存のアウトバウンドメッセージを編集、削除する場合： [設定] ＞ [クイック検索] ボックスに「アウトバウンドメッセージ」と入力＞ [アウトバウンドメッセージ] ＞ [アウトバウンドメッセージ]②アウトバウンドメッセージを設定する
アウトバウンドメッセージに含める情報を持つオブジェクトを選択し、以下の項目を入力します。セキュリティのため、送信ポートは制限されます。 ・アウトバウンドメッセージの名前と説明 ・メッセージを受信するエンドポイント URL （SOAP メッセージの送信先） ・送信ポートの設定 ポート80：HTTP 接続のみ、ポート443：HTTPS接続のみ、ポート1024から66535：HTTP 接続または HTTPS 接続③送信ユーザを指定する
アウトバウンドメッセージを送信するSalesforce ユーザを指定します。ここで指定したユーザにより、アウトバウンドメッセージのデータのアクセス権が制御されます。 [送信ユーザ] 項目 ＞ ユーザを選択④送信するセッション IDを指定する
アウトバウンドメッセージに含む、[送信セッション ID] を選択します。 リスナーから Salesforce への API コールバックを作成する際にセッション IDが必要です。セッション IDは、ワークフローをトリガしたユーザではなく、送信ユーザとして定義されたユーザを示します。⑤アウトバウンドメッセージに含める項目を選択する
ここで作成・編集している、アウトバウンドメッセージに含める項目を選択し、[追加]をクリックします。 その後、[保存]をクリックすると、ここまでの入力内容が一旦保存されます。⑥アウトバウンドメッセージの詳細ページを確認する
アウトバウンドメッセージの詳細ページから、API バージョンとWSDLを確認します。 組織でアウトバウンドメッセージを有効にしていない場合は、これらのオプションが表示されません。その場合は、Salesforce に連絡して対応してもらいます。 ・[API バージョン] 項目 アウトバウンドメッセージが作成された際、自動的に現在の API バージョンに設定されます。変更する場合はメタデータ API を使用します。API バージョンは、Enterprise または Partner WSDL を使用した Salesforce への API コールバックで使用されます。 ・WSDL [WSDL はこちら] から、アウトバウンドメッセージに関連づけられている WSDL を参照できます。エンドポイントサービスへの到達方法、エンドポイントサービスに送信するデータを確認します。3、Salesforce クライアント証明書でSalesforce ID を検証する
Salesforce クライアント証明書を使用して、Salesforce の ID を検証することができます。Salesforce アプリケーションのユーザインターフェースから、アウトバウンドメッセージと一緒に送信するクライアント証明書をダウンロードします。①Salesforce クライアント証明書のダウンロードの手順
①[API クライアント証明書を管理] を開きます。 [設定] ＞ [クイック検索] ボックスに「API」と入力＞ [API] ＞ API WSDL ページ＞ [API クライアント証明書を管理] ②[API クライアント証明書]を開きます。 [証明書と鍵の管理] ページ＞ [API クライアント証明書] ＞ [API クライアント証明書] ③ [証明書のダウンロード]をクリックして、ダウンロード場所を指定します。指定の場所にクライアント証明書（.crt ファイル）が保存されます。 [証明書] ページ＞ [証明書のダウンロード]②アプリケーション（エンドポイント）への設定
アプリケーション（エンドポイント）サーバが、クライアント証明書（双方向 SSL/TLS）を要求するよう設定し、ダウンロードした証明書との一致によりSalesforce の ID を検証します。サーバへのクライアントのロールを取得するタイミングで実行されます。 ①アプリケーションサーバに、ダウンロードした証明書をインポートします。 ②アプリケーションサーバが、クライアント証明書を要求するよう設定します。 ③SSL/TLS ハンドシェイクで使用する証明書との一致により、検証します。Salesforceのアウトバウンドメッセージの配信状況を追跡する
Saelesforoceでは、アウトバウンドメッセージの配信状況を追跡できます。
アウトバウンドメッセージ送信の試行回数、アウトバウンドメッセージをトリガしたアクションなどを参照できます。その他に、アウバウンドメッセージの送信試行のスケジュール変更、キューから完全に削除する操作を行えます。
[設定] ＞ [クイック検索] ボックスに「アウトバウンドメッセージ」と入力＞ [アウトバウンドメッセージ] ＞ [メッセージ送信状況の参照]
Salesforceにおけるアウトバウンドメッセージの設定を理解する
Salesforceのアウトバウンドメッセージの機能概要と設定について説明しました。
アウトバウンドメッセージにより、Salesforceの項目の変更など、ワークフローのアクションをトリガに、関連づけた項目やレコードの変更を循環させることができます。
アウトバウンドメッセージの活用に先立ち、アウトバウンドメッセージの送信に必要な設定について理解しましょう。]]>
