EventRelation
行動に招待された人 (ユーザ、リード、取引先責任者) またはリソース (会議室など) を表します。このオブジェクトを使用すると、行動に招待者を追加または削除したり、API を使用して招待者の招待への返答を管理したりできます。Shared Activities が有効化されている場合、このオブジェクトはトリガ、ワークフロー、データ入力規則をサポートしません。
EventRelation では、Shared Activities が有効かどうかに応じて、許可されるリレーション数が異なり、削除された行動が異なる方法で処理されます。
- Shared Activities が有効な場合
-
- 1 つの行動を最大 50 件の取引先責任者または 1 件のリードに関連付けることができます。
- 行動を削除すると、その行動と指定された取引先責任者、リード、レコード間のリレーションも削除されます。WhoId、WhatId、および AccountId 項目値はクリアされます。削除した行動を復元すると、その行動と指定された取引先責任者、リード、レコード間のリレーションも復元されます。WhoId、WhatId、および AccountId 項目値は、EventRelation の項目値を使用して再計算されます。
- Shared Activities が有効ではない場合
-
- 1 つの行動を関連付けられるのは、1 件の取引先責任者またはリードのみです。
- 行動を削除した場合、WhoId、WhatId、および AccountId 項目値はクリアされません。
Shared Activities が有効かどうかに関係なく、1 つの行動には (1 つ以上の取引先責任者に加え)、取引先、商談、カスタムオブジェクトなど、他の種類のレコード 1 件に関連付けることができます。
サポートされているコール
create()、delete()、describeSObjects()、getDeleted()、getUpdated()、query()、queryAll()、retrieve()、update()、upsert()
項目
| 項目 | 詳細 |
|---|---|
| AccountId |
|
| EventId |
|
| IsDeleted |
|
| IsInvitee |
|
| IsParent |
|
| IsWhat |
|
| RelationId |
|
| RespondedDate |
|
| Response |
|
| Status |
|
使用方法
- メール通知の送信
- 指定された行動のメール通知を送信するには、行動の EventRelation をクエリしてリストを反復処理し、状況を検証して、招待を受諾したすべての個人にメール通知を送信します。
- 指定された招待者が参加する行動の確認
- 特定の人物がある決まった期間 (例: 来週など) に出席するすべての行動を確認するには、クライアントアプリケーションを使用して、指定された日付の範囲の Event オブジェクトをクエリし、結果を反復し、各行動について EventRelation オブジェクトをクエリして特定の個人 (RelationId) がその行動への招待を受けたかどうかを確認します。
- Shared Activities が有効化されている場合 (または、有効化中やロールバック中) の招待者の作成
- 招待者がすでに取引先責任者またはリードの場合は、IsInvitee を true に更新します。
- 招待者がまだ取引先責任者またはリードではない場合は、IsInvitee を true に設定して招待者の EventRelation オブジェクトを作成します。
- Shared Activities が有効化されていない場合の招待者の作成
- 招待者の EventRelation オブジェクトを作成します。
- 取引先責任者またはリードに対するリレーションのクエリ
-
- 招待者リレーションのクエリ
-
- 招待者リレーションの取引先責任者またはリード招待者リレーションへの更新
-
- 取引先責任者またはリードリレーションの取引先責任者またはリード招待者リレーションへの更新
-
- 取引先責任者またはリードリレーションの挿入
-
- 招待者リレーションの挿入
-
isParent、isWhat、および IsInvitee が設定されておらず、RelationId が取引先責任者、リード、ユーザまたはカレンダーのいずれかである場合、IsInvitee はデフォルトの true に設定されます。つまり、EventRelation が取引先責任者またはリードに対するリレーションとして明確に挿入されない場合、デフォルトでは招待者リレーションとして処理されます。