クエリと Partner WSDL

Partner WSDL で query() ��ールを使用する場合、次のガイドラインに従ってください。

• queryString パラメーターは、大文字と小文字を区別しません。API は、大文字と小文字の組み合わせを使用した fieldList の項目名を受け入れます。ただし、QueryResult では、項目名 (定義済みの項目およびカスタム項目) の大文字と小文字は、DescribeSObjectResult の Field 型の name 項目の値と完全に一致する必要があります。fieldList で項目を指定する場合、大文字と小文字を適切に使用することをお勧めします。
• Partner WSDL の場合、QueryResult の項目の順序は、WSDL の項目順ではなく、fieldList の項目順で指定されます。
• fieldList には、重複する項目名を指定できません。次に例を示します。
  • 無効 (エラー発生): "SELECT Firstname, Lastname, Firstname FROM User"
  • 有効: "SELECT Firstname, Lastname FROM User"
• QueryResult では、項目の一部にデータがない (null) 場合でも、fieldList で指定されたすべての項目が指定されます。SOAP を使用すると結果セットに値が指定されていない項目を省略できますが、API は、すべての項目を含む配列を返します。
• Partner WSDL を使用する場合、ID を含むクエリでは SOAP XML 応答データに ID 項目が 2 回返されます。同様に、ID を含まないクエリでは、SOAP XML 応答データに単一の null ID 項目が返されます。たとえば、SELECT ID, FirstName, LastName FROM Contact に対するクエリによって、次のようなレコードとともに SOAP XML 応答が返される場合があります。
  1<records xsi:type="sf:sObject" xmlns="urn:partner.soap.sforce.com">
  2    <sf:type>Contact</sf:type>
  3    <sf:Id>0038000000FrjoBQRW</sf:Id>
  4    <sf:Id>0038000000FrjoBQRW</sf:Id>
  5    <sf:FirstName>John</sf:FirstName>
  6    <sf:LastName>Smith</sf:LastName>
  7</records>

  これは予期される動作であり、すべての SOAP XML 応答データにアクセスし、WSC を使用して Web サービス応答にアクセスしていない場合に把握しておく必要があります。