リレーション項目および多態的な項目について

いくつかの項目はリレーション項目で、関連オブジェクトの情報を取得するために使用できます。これらのリレーション項目のいくつかは、多態的な項目です。多態的な項目とは、関連オブジェクトを複数の異なる種別のオブジェクトのいずれかにできる項目です。たとえば、Task の Who リレーション項目には、Contact または Lead のいずれかを使用できます。

リレーション項目の例

1SELECT Id, Owner.Name FROM Account

多態的な項目の例

これは、多態的な項目であることを示しています。Owner は、Calendar または User にすることができます。たとえば、次の SOQL クエリを使用できます。

1SELECT Id, Owner.Name FROM Event WHERE Owner.Type = 'User'

多態的な項目の使用

よく使用される多態的な項目

よく使用される多態的な項目には、次のものがあります。

• Owner: この項目は、レコードの親を表します。次に例を示します。
  1SELECT Id, Owner.Name
  2FROM Task
  3WHERE Owner.FirstName like 'B%'

  このクエリ例は、Calendar または User のいずれかを所有者とする ToDo レコードに対して機能します。

• Who: この項目は、レコードに関連付けられている個人を表します。次に例を示します。
  1SELECT Id, Who.FirstName, Who.LastName
  2FROM Task
  3WHERE Owner.FirstName LIKE 'B%'

  このクエリ例は、所有者が Calendar または User のいずれかで、Who 項目が Contact または Lead のいずれかである ToDo レコードに対して機能します。

  クエリで返されるオブジェクトの種別を確認するには、Who.Type を使用します。次に例を示します。

  1SELECT Id, Who.Id, Who.Type
  2FROM Task

  この例を使用して、Contact に関連付けられたすべての ToDo を照会できます。

  1SELECT Id, Who.Id, Who.Type
  2FROM Task
  3WHERE Who.Type='Contact'

• What: この項目は、レコードに関連付けられている、人以外のオブジェクトを表します。次に例を示します。
  1SELECT Id, What.Name
  2FROM Event

  このクエリ例は、What が Account もしくは Solution、または別の番号の任意のオブジェクト種別になる場合がある Event に対して機能します。

Type 修飾子の使用

1SELECT Id
2FROM Event
3WHERE What.Type IN ('Account', 'Opportunity')

TYPEOF の使用

SOQL では、SELECT ステートメントで TYPEOF 式を使用して、多態的なリレーションをサポートします。TYPEOF は、API バージョン 46.0 以降で使用できます。(これは、開発者プレビューの一部として API バージョン 26.0 以降で使用することもできます。)

1SELECT 
2  TYPEOF What
3    WHEN Account THEN Phone, NumberOfEmployees
4    WHEN Opportunity THEN Amount, CloseDate
5    ELSE Name, Email
6  END
7FROM Event

TYPEOF の考慮事項について、次の点を注意してください。

• namePointing 属性が false のリレーションで TYPEOF を使用することはできません。
• relationshipName 属性が false のリレーションで TYPEOF を使用することはできません。
• TYPEOF は、クエリの SELECT 句でのみ使用できます。WHERE 句で Type 修飾子を使用して、多態的なリレーションのオブジェクト種別を絞り込むことができます。詳細は、「多態的なリレーション項目の絞り込み」を参照してください。
• TYPEOF は、COUNT() など、オブジェクトを返さないクエリでは使用できません。
• TYPEOF は、ストリーミング API PushTopic のベースの SOQL クエリでは使用できません。
• TYPEOF は、Bulk API で使用される SOQL では使用できません。
• TYPEOF 式はネストできません。たとえば、TYPEOF 式の WHEN 句内で別の TYPEOF を使用することはできません��
• TYPEOF は、準結合クエリの SELECT 句では使用できません。準結合クエリを含む外側のクエリの SELECT 句では TYPEOF を使用できます。次の例は、TYPEOF が準結合クエリで使用されているため無効です。
  1SELECT Name FROM Account
  2WHERE CreatedById IN
  3    (
  4    SELECT 
  5        TYPEOF Owner
  6            WHEN User THEN Id
  7            WHEN Group THEN CreatedById
  8        END
  9    FROM CASE
  10    )

  TYPEOF が外側の SELECT 句のみで使用されているため、次の例は有効です。
  1SELECT 
  2    TYPEOF What
  3        WHEN Account THEN Phone
  4        ELSE Name
  5    END
  6FROM Event
  7WHERE CreatedById IN
  8    (
  9    SELECT CreatedById
  10    FROM Case
  11    )

• TYPEOF は、SELECT 句で関数を含むクエリでは使用できません。次の例は、TYPEOF に FORMAT 関数が含まれているため無効です。
  1SELECT
  2 TYPEOF What
  3  WHEN Account THEN Id, FORMAT(LastModifiedDate) LastModifiedDate__f
  4  WHEN Oppty THEN Id
  5 END
  6FROM Task

  代わりに、同じクエリを関数を使わずに実行して ID のリストを取得します。
  1SELECT
  2    TYPEOF What
  3        WHEN Account THEN Id, LastModifiedDate
  4        WHEN Opportunity THEN Id
  5    END
  6FROM Task

  次に、結果の ID リストに対して、関数を使用する 2 番目のクエリを実行します。
  1SELECT 
  2    FORMAT(LastModifiedDate) LastModifiedDate__f 
  3FROM Account 
  4WHERE Id in RetrievedIdList

• TYPEOF は、GROUP BY、GROUP BY ROLLUP、GROUP BY CUBE、および HAVING を含むクエリでは使用できません。

TYPEOF と Type の併用

1SELECT Id,
2  TYPEOF What
3    WHEN Account THEN Phone
4    WHEN Opportunity THEN Amount
5  END
6FROM Event
7WHERE What.Type IN ('Account', 'Opportunity')

WSDL のオブジェクト種別

1private com.sforce.soap.enterprise.sobject.SObject Owner;