Salesforce および Force.com のオブジェクトリファレンス
j複合項目
複合項目は、数値や文字列などのプリミティブデータ型の複数の要素をグループ化して、場所や住所などの複雑なデータ型を表します。複合項目は値を処理するアプリケーションコードを簡略化できる抽象化であり、コードがより簡潔でわかりやすくなります。
住所複合項目は、API バージョン 30.0 以降の SOAP および REST API で使用できます。地理位置情報項目は、API バージョン 26.0 以降の SOAP および REST API で使用できますが、API バージョン 30.0 より前の SOAP では一部制限があります。
複合項目は、単一の項目、構造化された項目、または個別のコンポーネント項目としてアクセスできます。複合項目に含まれる値と、個別の項目に含まれる値は、どちらも Salesforce に保存される基盤となる同じデータに対応付けられ、その値は常に同じになります。個別のコンポーネント項目を参照するコードは、新しい複合項目の影響を受けません。
複合項目は参照のみです。変更を加えるには、個別のコンポーネント項目に書き込みます。これにより、更新を実行する 1 つの一貫した方法が保持され、競合が生じるのを回避できます。たとえば、BillingAddress 複合項目と個別の BillingCity コンポーネント項目がどちらも同じ API コールで更新されると、どの値を保存すべきかが不明確になります。
複合項目は、SOAP および REST API を介してのみ使用できます。複合項目は Enterprise WSDL および Partner WSDL の両方に記述されています。新しい複合データ型にアクセスするには、WSDL を API 30.0 以降に更新します。