Apex 開発者ガイド
jNewer Version Available
コールアウトの制限事項
Apex コードで、HTTP 要求または Web サービスコールに対するコールアウトを実行する場合に次の制限が適用されます。Web サービスコールには、SOAP API コールまたは外部の Web サービスコールを使用できます。
- 1 つの Apex トランザクションで、HTTP 要求または API コールに対するコールアウトを最大 100 回実行できます。
- デフォルトのタイムアウトは 10 秒です。カスタムタイムアウトはコールアウトごとに定義できます。最小値は 1 ミリ秒、最大値は 120,000 ミリ秒です。Web サービスまたは HTTP コールアウトのカスタムタイムアウトの設定方法については、次のセクションの例を参照してください。
- 1 つの Apex トランザクションによる各コールアウトのタイムアウトの累積値は、最大 120 秒です。累積値とは、特定の Apex トランザクションによって呼び出されたすべてのコールアウトのタイムアウトを合計した値です。
- 同じトランザクション内に待機中の操作が存在する場合はコールアウトを実行できません。操作が待機中となるものには、DML ステートメント、非同期 Apex (future メソッドや Apex 一括処理ジョブなど)、スケジュール済み Apex、メールの送信があります。このような操作を行う前に、コールアウトを実行するようにします。
- 同じトランザクション内で疑似コールアウト��り前に待機中の操作が発生する可能性があります。WSDL ベースのコールアウトに関する 「DML 操作と擬似コールアウトの実行」または HTTP コールアウトに関する 「DML 操作と擬似コールアウトの実行」を参照してください。
- ヘッダー Expect: 100-Continue がコールアウト要求に追加されていると、HTTP/1.1 100 Continue 応答が外部サーバーから返されない場合にタイムアウトが発生します。
参照のみモードの Apex コールアウト
参照のみモード中、外部サービスへの Apex コールアウトは実行され、システムによってブロックされることはありません。通常、コールアウトから応答を受信後、同じトランザクションでフォローアップ操作を実行する場合があります。たとえば、DML コールを実行して Salesforce レコードを更新する場合があります。ただし、参照のみモードでは、レコードの更新など Salesforce での書き込み操作がブロックされます。この参照のみモードの動作の矛盾によって、プログラムフローが壊れたり、問題が発生したりする可能性があります。不正なプログラム動作を避けるために、参照のみモードでのコールアウトを防止することをお勧めします。組織が参照のみモードであるかどうかを確認するために、System.getApplicationReadWriteMode() をコールします。
次の例では、System.getApplicationReadWriteMode() の戻り値を確認します。戻り値が ApplicationReadWriteMode.READ_ONLY 列挙値と等しい場合、組織は参照のみモードで、コールアウトがスキップされます。それ以外の場合 (ApplicationReadWriteMode.DEFAULT 値) は、コールアウトが実行されます。
Salesforce 組織は、計画的なサイト切り替えやインスタンス更新など、Salesforce のメンテナンアクティビティ中に参照のみモードになります。継続的サイト切り替えの一環として、Salesforce 組織はほぼ 6 か月おきに準備サイトに切り替えられます。サイト切り替えについての詳細は、「継続的サイト切り替え」を参照してください。
Sandbox で参照のみモードをテストするには、Salesforce に連絡して参照のみモードのテストオプションを有効化してください。テストオプションが有効化されたら、参照のみモードをオンに切り替えてアプリケーションを検証できます。
コールアウトタイムアウトの設定
次に、HTTP コールアウトのカスタムタイムアウトの設定の例を示します。