SOAP API 開発者ガイド
jretrieve()
構文
1sObject[] result = connection.retrieve(string fieldList, string sObjectType, ID ids[]);使用方法
retrieve() コールを使用すると、オブジェクトから個別のレコードを取得できます。クライアントアプリケーションは、取得する項目、オブジェクト、および取得するレコード ID の配列を渡します。retrieve() コールは、削除されたレコードを返しません。
一般に、取得するレコードの ID が前もってわかっている場合に、retrieve() を使用します。ID がわかっていないか、他の選択条件を指定する場合は、代わりに query() を使用します。
クライアントアプリケーションは、retrieve() を使用してクライアント側で結合を実行できます。たとえば、クライアントアプリケーションは、query() を実行して、一連の Opportunity レコードを取得し、返された商談レコードを反復処理しながら、商談ごとに accountId を取得し、retrieve() をコールして各 accountId の Account 情報を取得できます。
特定のオブジェクトのレコードは、API からは取得できません。retrieve() コールからレコードを取得するには、そのオブジェクトが取得可能に設定されている (retrieveable が true) 必要があります。取得可能かどうかを決定するために、クライアントアプリケーションは、オブジェクトで describeSObjects() コールを呼び出すことができ、retrievable プロパティを確認することができます。
クライアントアプリケーションは、指定したオブジェクト内のレコードを取得し、指定した項目リストの項目を取得するのに十分なアクセス権限でログインする必要があります。詳細は、「データアクセスに影響する要素」を参照してください。
サンプルコード — Java
このサンプルでは、指定の取引先レコードの「ID」、「Name」、「Website」を取得します。取得したレコードの項目をコンソールに書き込みます。
1public void retrieveRecords(String[] ids) {
2 try {
3 SObject[] sObjects = connection.retrieve("ID, Name, Website",
4 "Account", ids);
5 // Verify that some objects were returned.
6 // Even though we began with valid object IDs,
7 // someone else might have deleted them in the meantime.
8 if (sObjects != null) {
9 for (int i = 0; i < sObjects.length; i++) {
10 // Cast the SObject into an Account object
11 Account retrievedAccount = (Account) sObjects[i];
12 if (retrievedAccount != null) {
13 System.out.println("Account ID: " + retrievedAccount.getId());
14 System.out.println("Account Name: " + retrievedAccount.getName());
15 System.out.println("Account Website: "
16 + retrievedAccount.getWebsite());
17 }
18 }
19 }
20 } catch (ConnectionException ce) {
21 ce.printStackTrace();
22 }
23}サンプルコード — C#
このサンプルでは、指定の取引先レコードの「ID」、「Name」、「Website」を取得します。取得したレコードの項目をコンソールに書き込みます。
1public void retrieveRecords(String[] ids)
2{
3 try
4 {
5 sObject[] sObjects = binding.retrieve("ID, Name, Website",
6 "Account", ids);
7 // Verify that some objects were returned.
8 // Even though we began with valid object IDs,
9 // someone else might have deleted them in the meantime.
10 if (sObjects != null)
11 {
12 for (int i = 0; i < sObjects.Length; i++)
13 {
14 // Cast the SObject into an Account object
15 Account retrievedAccount = (Account)sObjects[i];
16 if (retrievedAccount != null)
17 {
18 Console.WriteLine("Account ID: " + retrievedAccount.Id);
19 Console.WriteLine("Account Name: " + retrievedAccount.Name);
20 Console.WriteLine("Account Website: "
21 + retrievedAccount.Website);
22 }
23 }
24 }
25 }
26 catch (SoapException e)
27 {
28 Console.WriteLine("An unexpected error has occurred: " +
29 e.Message + "\n" + e.StackTrace);
30 }
31}引数
| 名前 | 型 | 説明 |
|---|---|---|
| fieldList | string | カンマで区切られた指定オブジェクトの 1 つ以上のリスト。有効な項目名を指定する必要があり、各指定項目の参照レベルの権限を持っている必要があります。fieldList は、result 内の項目の順序を定義します。 |
| sObjectType | string | データ取得元のオブジェクト。指定された値は、組織で有効なオブジェクトである必要があります。完全なオブジェクトのセットについては、「標準オブジェクト」を参照してください。 |
| ids | ID[] | 取得するオブジェクトの 1 つ以上の ID の配列。retrieve() コールには、最大 2000 個のオブジェクト ID を渡すことができます。ID についての詳細は、「ID データ型」を参照してください。 |