Apex ワークブック
jApex REST POST メソッドを使用したレコードの作成
このレッスンでは、ワークベンチで REST Explorer を使用し、REST クライアント要求を送信して新しい商品レコードを作成します。この要求は、レッスン 1 で実装した Apex REST メソッドの 1 つを呼び出します。
ワークベンチの REST Explorer は REST クライアントをシミュレーションします。ログインユーザのセッションを、Apex REST メソッドをコールする認証メカニズムとして使用します。
前のチュートリアルですでにサンプルデータをワークベンチで設定している場合、この手順の最初の数ステップを省略してもかまいません。
- https://developer.salesforce.com/page/Workbench に移動します。
- ログイン情報の入力を求められたら、ログイン情報を入力し、[Login (ログイン)] をクリックします。
- [Environment (環境)] で [Production (本番)] を選択します。
- サービスの利用規約に同意し、[Salesforce でログイン] をクリックします。
- [Allow (許可)] をクリックして、ワークベンチが自分の情報にアクセスできるようにします。
- ログインしたら、 をクリックします。
- [POST (投稿)] をクリックします。
- REST Explorer では、組織のインスタンス URL に対する相対パスを指定する必要があるため、インスタンス URL に追加するパスのみを入力します。URL の入力ボックスで、デフォルトの URL を /services/apexrest/Merchandise/ で置き換えます。
-
リクエストボディに、挿入するオブジェクトを示す次の JSON 文字列を挿入します。
1{ 2 "name" : "Eraser", 3 "description" : "White eraser", 4 "price" : 0.75, 5 "inventory" : 1000 6}作成するオブジェクトの項目名は、コールするメソッドのパラメータ名と大文字小文字を含め一致させる必要があります。
-
[Execute (実行)] をクリックします。これにより、createMerchandise メソッドがコールされます。応答には、新しい商品レコードの ID が含まれます。
-
応答から ID 値を取得するには、[Show Raw Response (未加工の応答を表示)] をクリックし、応答の下部に表示される ID 値を引用符なしでコピーします。たとえば、"a04R00000007xX1IAI" などが表示されていますが、値はそれぞれ異なります。次のレッスンでは、この ID を使用して挿入したレコードを取得します。