リモートコールイン

• アクセス性 — Salesforce が提供する SOAP API を使用してリモートシステムは以下の操作を実行できます。
  • 組織内のデータのクエリ
  • データの追加、更新、削除
  • 組織のメタデータの取得
  • 管理タスク実行のためのユーティリティの実行
• 同期 API — API コールが行われた後、リモートクライアントアプリケーションはサービスから応答を受信するまで待機します。Salesforce への非同期コールはサポートされていません。
• 生成された WSDL — Salesforce では、リモートシステムに 2 つの WSDL を使用できます。
  • Enterprise WSDL — Salesforce 組織に固有の強く型付けされた WSDL を使用できます。
  • Partner WSDL — Salesforce 組織に固有ではない、緩やかに型付けされた WSDL を使用できます。
• セキュリティ — SOAP API を実行するクライアントは、有効なログイン情報を持ち、API コールを実行するためのセッションを取得する必要があります。API は、ログインユーザのプロファイルに基づいてアプリケーションに設定されたオブジェクトレベルおよび項目レベルのセキュリティを反映します。
• トランザクション/コミット動作 — デフォルトでは、各 API コールは、一部のレコードがエラーとマークされた場合に部分的な成功を許容します。これを「オールオアナッシング」動作に変更して、エラーが発生したらすべての結果をロールバックすることができます。複数の API コールにまたがってトランザクションを実行することはできません。この制限を打開するために、1 つの API で複数のオブジェクトに影響を与えることができます。
• 大量データ — 大量データ (500,000 件を超えるレコード) 操作の場合、REST ベースの Bulk API を使用します。

• アクセス性 — Salesforce が提供する REST API を使用してリモートシステムは以下の操作を実行できます。
  • 組織内のデータのクエリ
  • データの追加、更新、削除
  • 組織のメタデータの取得
  • 管理タスク実行のためのユーティリティの実行
• 同期 API — API コールが行われた後、リモートクライアントアプリケーションはサービスから応答を受信するまで待機します。Salesforce への非同期コールはサポートされていません。
• REST API と SOAP API の比較 — REST はリソース (エンティティ/オブジェクト) を URI として公開し、HTTP 動詞を使用してこれらのリソースに対する CRUD 操作を定義します。SOAP とは異なり、REST API では、事前定義した契約は不要で、応答には XML と JSON を利用し、緩やかな型付けを使用します。REST API は軽量であり、Salesforce との相互作用のための単純な方法を提供します。インテグレーションおよび開発が容易という利点があり、モバイルアプリケーションおよび Web 2.0 プロジェクトで使用するためには最適な選択です。
• セキュリティ — REST API を実行するクライアントは、有効なログイン情報を持ち、API コールを実行するためのセッションを取得する必要があります。API は、ログインユーザのプロファイルに基づいてアプリケーションに設定されたオブジェクトレベルおよび項目レベルのセキュリティを反映します。
• トランザクション/コミット動作 — デフォルトでは、各レコードは、個別のトランザクションとして扱われ、個別にコミットされます。1 つのレコード変更が失敗しても、他のレコード変更はロールバックされません。これを「オールオアナッシング」動作に変更できます。
• 大量データ — 大量データ (500,000 件を超えるレコード) 操作の場合、REST ベースの Bulk API を使用します。

• 完全なトランザクションサポートが必要である (たとえば、取引先、取引先責任者、および商談をすべて 1 つのトランザクションで作成する場合など)。
• コミットする前に、カスタムロジックを Salesforce 側で適用する必要がある。

Apex Web サービスを使用する利点と、Salesforce でメンテナンスが必要な追加コードを比較して評価する必要があります。

SOAP とは異なり、クライアントがサービス定義/契約 (WSDL) をコンシュームしてクライアントスタブを生成する必要はありません。リモートシステムには、HTTP 要求を作成して、返された結果 (XML または JSON) を処理する機能のみが必要です。

Bulk API では、クライアントアプリケーションは、複数のバッチを送信し、そのバッチが Salesforce によりバックグラウンドで処理されることで、大量のレコードをクエリ、挿入、更新、更新/挿入、削除できます。対照的に、SOAP API は、一度に少数のレコードを更新するリアルタイムのクライアントアプリケーション用に最適化されています。

SOAP API を使用しても多数のレコードを処理することはできますが、数百から、数千、数百万のレコードがデータセットに含まれている場合には実用性に欠けます。これは、比較的オーバーヘッドが高く、パフォーマンスが低いという特性のためです。

次に、リモートシステムは、適切な動詞で REST 呼び出し (HTTP 要求) を生成し、返された結果 (JSON および XML データ形式がサポート対象) を処理します。

リモートシステムがセッション ID を取得するには、有効なログイン情報を使用してログインする必要があります。リモートシステムにすでに有効なセッション ID がある場合は、明示的なログインなしで API をコールできます。これは、このドキュメントですでに説明したコールバックパターンで使用されます。このパターンでは、先行する Salesforce アウトバウンドメッセージに含まれているセッション ID とレコード ID が後続の作業で使用されます。

クライアントは、コールごとに新しいセッション ID を取得するのではなく、SOAP API キャッシュをコールし、セッション ID を再利用してパフォーマンスを最大化することをお勧めします。

クライアントは、コールごとに新しいセッション ID を取得するのではなく、REST API キャッシュをコールし、セッション ID を再利用してパフォーマンスを最大化することをお勧めします。

• ログイン — ログイン要求のサイズは、10 KB 未満に制限されています。
• 作成、更新、��除 — リモートシステムが一度に作成、更新、または削除できるレコード数は最大 200 件です。複数回のコールを行えば合計 200 件を超えるレコードを処理できますが、要求ごとのサイズは 200 レコードに制限されています。
• クエリ結果サイズ — デフォルトでは、query() または queryMore() コールで返される、クエリ結果オブジェクト内に返される行数 (バッチサイズ) は 500 に設定されています。返される行数がバッチサイズを上回る場合、queryMore() API コールを使用して複数のバッチを反復処理します。最大バッチサイズは 2,000 レコードです。ただし、追加のルールが適用される場合もあるため、詳細は、『Salesforce の制限クイックリファレンスガイド』を参照してください。

Bulk API は、大規模なデータセットの非同期のインポートまたはエクスポート用に最適化されています。

Bulk API は、バッチ要求と関連データを送信するときは同期します。データの実際の処理は、バックグラウンドで非同期に行われます。API とバッチ処理制限の詳細は、「Bulk API の制限」を参照してください。

• 24 時間あたりに送信可能なバッチ数は最大で 2,000 件に制限されています。

• 1 つのバッチには、最大で 10,000 件のレコードを含めることができます。

• API 要求制限 – Salesforce は、24 時間あたりの API コール数に制限を適用します。制限は、Salesforce のエディションの種類とライセンス数に基づきます。たとえば、Unlimited Edition では、24 時間あたり、Salesforce または Force.com ライセンスにつき、5,000 API 要求を使用できます。詳細は、『Salesforce の制限クイックリファレンスガイド』を参照してください。
• API クエリカーソル制限 — ユーザは一度に最大 10 個のクエリカーソルを開くことができます。10 個を超えると、10 個のカーソルのうち最も古いものが解放されます。リモートアプリケーションが解放されたクエリカーソルを開こうとすると、エラーになります。たとえば、インテグレーションユーザログイン情報を共有する場合、最大クエリカーソル数を考慮する必要があります。ミドルウェアは、「ラウンドロビン」式に複数のユーザの要求を実行することが必要になる場合があります。
• コール制限 — 作成、更新、およびクエリの制限については、補足の「データ量」を参照してください。