SOAP API 開発者ガイド
j送信メッセージの WSDL
このトピックの残りの部分は、送信メッセージの WSDL の関連セクションについて説明します。特定のオブジェクトの特定のイベントに送信メッセージを設定した際に選択した内容によって、ご使用の WSDL は異なります。
notifications()
このセクションでは、notifications() コールを定義します。このコールは特定のオブジェクトの指定された項目および値を記載した送信メッセージを作成し、指定されたエンドポイント URL に値を送信します。
次の表で、notifications メソッドの定義で指定される要素について説明します。
| 名前 | 型 | 説明 |
|---|---|---|
| OrganizationId | ID | メッセージを送信する組織の ID。 |
| ActionId | string | メッセージをトリガするワークフロールール (アクション)。 |
| SessionId | string | 送信メッセージに応答するエンドポイント URL クライアントが使用するセッション ID (省略可能)。Salesforce にコールバックする受信コードによって使用します。 |
| EnterpriseURL | string | Enterprise WSDL を使用して Salesforce に API コールバックするために使用する URL。 |
| PartnerURL | string | Partner WSDL を使用して Salesforce に API コールバックするために使用する URL。 |
| Notification | Notification | 次のセクションで定義され、OpportunityNotification または ContactNotification など、オブジェクトデータ型と Id が指定されています。 |
Notification データ型は WSDL で定義されます。次の例では、notifications() コールの定義の Notification エントリに基づいて、商談の Notification が定義されます。
各オブジェクト要素 (今回の例では商談) には、送信メッセージを作成したときに選択した項目のサブセットが指定されます。各メッセージの Notification にはオブジェクト ID も指定されています。このオブジェクト ID を使用して、すでに処理された通知の再送信を追跡します。
notificationsResponse
この要素は、確認応答 (ack) を Salesforce に送信するためのスキーマです。
複数の通知がある場合、メッセージ内ですべての通知を確認します。