Newer Version Available
InvocableMethod アノテーション
呼び出し可能なメソッドは、REST API でコールされ、1 つの Apex メソッドを呼び出すために使用します。呼び出し可能なメソッドには動的な入力値と出力値があり、記述用の API コール (describe) をサポートします。
次のサンプルコードは、プリミティブデータ型を取る呼び出し可能なメソッドを示します。
次のサンプルコードは、特定の sObject データ型を取る呼び出し可能なメソッドを示します。
呼び出し可能なメソッドに関する考慮事項
- クラスの 1 つのメソッドにのみ InvocableMethod アノテーションを付加できます。
- トリガは呼び出し可能なメソッドを使用できません。
- 呼び出し可能なメソッドは、static で、public または global である必要があり、そのクラスは外部クラスである必要があります。
- 他のアノテーションと InvocableMethod アノテーションを併用することはできません。
- 最大 1 つの入力パラメータが存在する可能性があり、そのデータ型は次のいずれかである必要があります。
- プリミティブデータ型のリスト、またはプリミティブデータ型のリストのリスト – 汎用 Object 型はサポートされていません。
- sObject 型のリスト、または sObject 型のリストのリスト – 汎用 sObject 型はサポートされていません。
- サポートされている型の変数を含み、InvocableVariable アノテーションが付加されているユーザ定義型のリスト。各自のデータ型を実装するカスタムのグローバルまたは公開 Apex クラスを作成し、そのクラスに呼び出し可能な変数アノテーションが付加されているメンバー変数が少なくとも 1 つ含まれていることを確認します。
- 戻り値の型が Null 以外の場合は、メソッドによって返されるデータ型が次のいずれかである必要があります。
- プリミティブデータ型のリスト、またはプリミティブデータ型のリストのリスト – 汎用 Object 型はサポートされていません。
- sObject 型のリスト、または sObject 型のリストのリスト – 汎用 sObject 型はサポートされていません。
- サポートされている型の変数を含み、InvocableVariable アノテーションが付加されているユーザ定義型のリスト。各自のデータ型を実装するカスタムのグローバルまたは公開 Apex クラスを作成し、そのクラスに呼び出し可能な変数アノテーションが付加されているメンバー変数が少なくとも 1 つ含まれていることを確認します。
- パッケージの呼び出し可能なメソッドを使用できますが、呼び出し可能なメソッドを追加すると、パッケージの後続のバージョンからそのメソッドを削除できません。
- 呼び出し可能なメソッドは、管理パッケージ内で public にできますが、Cloud Flow Designer でフローの作成中または編集中に使用可能なアクションのリストにアクションとして表示されません。その場合でも、これらの呼び出し可能なアクションは同じ管理パッケージ内でフローから参照できます。管理パッケージ内のグローバル呼び出し可能なメソッドは、管理パッケージ外のフローおよび組織内の任意の場所のフローで使用でき、Cloud Flow Designer でフローの追加に使用可能なアクションのリストに表示されます。
呼び出し可能アクションについての詳細は、『Force.com Actions Developer's Guide』を参照してください。