この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

SOQL クエリの多態的なリレーションの処理

多態的なリレーションは、参照されるオブジェクトに複数の異なる種別を使用できるオブジェクト間のリレーションです。たとえば、Task の Who リレーション項目には、Contact または Lead のいずれかを使用できます。

Apex で多態的なリレーションの SOQL クエリを使用する方法についての説明を次に示します。多態的なリレーションについてのより一般的な情報は、『SOQL および SOSL リファレンス』の「リレーション項目および多態的な項目について」を参照してください。

Apex で多態的な項目を参照する SOQL クエリを使用して、多態的な項目によって参照されるオブジェクト種別に依存する結果を取得できます。1 つのアプローチとして、Type 修飾子を使用して結果を絞り込むという方法があります。次の例では、What 項目を使用して Account または Opportunity に関連する Event を照会します。

1List<Event> events = [SELECT Description FROM Event WHERE What.Type IN ('Account', 'Opportunity')];

別のアプローチとして、SOQL の SELECT ステートメントで TYPEOF 句を使用する方法があります。この例でも、What 項目を使用して Account または Opportunity に関連する Event を照会します。

1List<Event> events = [SELECT TYPEOF What WHEN Account THEN Phone WHEN Opportunity THEN Amount END FROM Event];

これらのクエリは、リレーション項目が目的のオブジェクト種別を参照する sObject のリストを返します。

多態的なリレーションで参照されるオブジェクトにアクセスする必要がある場合は、オブジェクト種別を判断するために instanceof キーワードを使用できます。次の例では、instanceof を使用して、Account または Opportunity が Event に関連しているかどうかを判断します。

1Event myEvent = eventFromQuery;
2if (myEvent.What instanceof Account) {
3    // myEvent.What references an Account, so process accordingly
4} else if (myEvent.What instanceof Opportunity) {
5    // myEvent.What references an Opportunity, so process accordingly
6}

別のメソッドに渡す前に、クエリが返す参照される sObject を適切な種別の変数に割り当てる必要があります。この例では次の処理が行われます。

TYPEOF 句で SOQL クエリを使用して、Merchandise__c カスタムオブジェクトの User または Group 所有者を照会する。
instanceof を使用して、所有者の種別を判断する。
所有者オブジェクトを User または Group 種別の変数に割り当ててから、ユーティリティメソッドに渡す。

1public class PolymorphismExampleClass {
2
3    // Utility method for a User
4    public static void processUser(User theUser) {
5        System.debug('Processed User');
6    }
7    
8    // Utility method for a Group
9    public static void processGroup(Group theGroup) {
10        System.debug('Processed Group');
11    }
12
13    public static void processOwnersOfMerchandise() {
14        // Select records based on the Owner polymorphic relationship field
15        List<Merchandise__c> merchandiseList = [SELECT TYPEOF Owner WHEN User THEN LastName WHEN Group THEN Email END FROM Merchandise__c];	
16        // We now have a list of Merchandise__c records owned by either a User or Group
17        for (Merchandise__c merch: merchandiseList) {
18            // We can use instanceof to check the polymorphic relationship type
19            // Note that we have to assign the polymorphic reference to the appropriate
20            // sObject type before passing to a method
21            if (merch.Owner instanceof User) {
22                User userOwner = merch.Owner;
23                processUser(userOwner);
24            } else if (merch.Owner instanceof Group) {
25                Group groupOwner = merch.Owner;
26                processGroup(groupOwner);
27            }
28        }
29    }
30}
31

Apex 開発者ガイド

SOQL クエリの多態的なリレーションの処理