Event

サポートされているコール

create()、delete()、describeLayout()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()、search()、undelete()、update()、upsert()

項目

使用方法

Event を使用して、カレンダーの予定を管理します。

行動のクエリと絞り込み

行動に関するクエリは、大きすぎるデータを使用する場合、タイムアウトする前に拒否されます。そのような場合、例外コード OPERATION_TOO_LARGE が返されます。OPERATION_TOO_LARGE を受け取った場合、より少量のデータをスキャンするか、クエリを再構成します。

また、バージョン 13.0 以降では、StartDateTime で絞り込み、特定の期日の行動を検索することができます。たとえば、期日が 2003 年 2 月 14 日であるすべての行動を検索するには、ローカルタイムゾーンの 2003 年 2 月 14 日の午前 0 時以降、かつユーザのローカルタイムゾーンの 2003 年 2 月 15 日午前 0 時以前の StartDateTime で絞り込みます。

EventRelation オブジェクトの EventId 項目は必ずマスターレコードを指し示します。グループ行動の招待者は EventRelation オブジェクトを照会して、マスターレコードを参照できます。

一連の行動と定期的な行動

Lightning Experience では、複数回発生する行動を一連の行動と呼び、IsRecurrence2 項目を true に設定して示します。Salesforce Classic では、複数回発生する行動を定期的な行動と呼び、IsRecurrence 項目を true に設定して示します。どちらの項目も、同じ行動に対して true に設定できません。

• Lightning Experience の一連の行動は、API バージョン 44.0 以降で参照のみの項目として使用できます。Salesforce Classic の定期的な行動は、バージョン 7.0 以降で使用できます。それより前のバージョンでは、SOQL クエリを実行しても、Lightning Experience の一連の行動は返されません。
• 行動を作成した後、IsRecurrence2 または IsRecurrence の値を true から false (またはその逆) に変更することはできません。
• IsRecurrence が true に設定されている行動で IsRecurrence2 に関連付けられた項目は設定できません (その逆もできません)。
• Lightning Experience の一連の行動で IsRecurrence2 が true の場合、1 つまたは残りすべての行動を削除するには、REST API コールを使用します。Salesforce Classic の定期的な行動で IsRecurrence が true の場合、API で定期的な行動を削除すると、過去と将来の一連の行動がすべて削除されます。ただし、ユーザインターフェースで定期的な行動を削除すると、将来の行動だけが削除されます。
• Salesforce Classic の定期的な行動を作成する場合、行動の時間は 24 時間以下である必要があります。Salesforce Classic の定期的な行動を作成すると、複数日の行動が有効な場合は、個々の行動時間を 24 時間以上に延長できます。詳細は、「複数日の行動」を参照してください。
• Salesforce Classic の定期的な行動の場合、RecurrenceStartDateTime、RecurrenceEndDateOnly, RecurrenceType, および特定の繰り返し種別に関連付けられたプロパティ (「Recurrence Field Usage for Salesforce Classic Recurring Events」 (Salesforce Classic の定期的な行動の繰り返し項目の使用) 表を参照) に値を入力する必要があります。
• Salesforce Classic の定期的な行動を更新する際、定期的な行動オブジェクトの EventRelation と、個々の行動オブジェクトの EventRelation を同時に更新することはできません。
• Lightning Experience の一連の行動には ID がないため、一連の行動内の他の行動を検索することができません。Salesforce Classic の定期的な行動では、RecurrenceActivityId を使用して他の行動を検索できます。
• Lightning Experience の一連の行動と Salesforce Classic の定期的な行動のどちらも、行動が毎日、毎月、または毎年繰り返す場合、行動を 1 日、1 か月、または 1 年に 1 回のみスケジュールできます。毎週オプションを使用すると、1 週間の複数日に行動をスケジュールできます。

Lightning Experience の一連の行動の制限および Salesforce Classic の定期的な行動の制限も適用されます。

次の表では、Salesforce Classic の定期的な行動の繰り返し項目の使用について説明します。それぞれの繰り返しのタイプでは、すべてのプロパティが指定されている必要があります。未使用のプロパティはすべて null に設定する必要があります。

被招集者、招待者、およびリソース

GroupEventType 項目は、行動の参加者が行動に���まれていることを示します。リソースは、対応可能な場合にのみ行動に追加できます。リソースに割り当て可能な参加状況は「参加」のみです。追加したリソースが対応不可の場合、行動を保存することはできません。

JunctionIdList

1public void createEventNew(Contact[] contacts) {
2	String[] contactIds = new String[contacts.size()];
3	for (int i = 0; i < contacts.size(); i++) {
4		contactIds[i] = contacts[i].getID();
5	}
6	Event event = new Event();
7	event.setSubject("New Event");
8	event.setEventWhoIds(contactIds);
9	SaveResult[] results = null;
10	try {
11		results = connection.create(new Event[] {
12			task
13		});
14	} catch (ConnectionException ce) {
15		ce.printStackTrace();
16	}
17}

Lightning Sync による行動の同期

被招集者の状況 (「参加または未定」、「不参加」、または「無回答」) は Microsoft® Exchange または Google から Salesforce に同期されますが、Salesforce から Exchange または Google には同期されません。双方向に同期するように設定されたユーザの場合、Salesforce で被招集者の状況を更新する API フローの作成には注意してください。最終的に、Salesforce で加えられた更新は Exchange または Google の元の状況で上書きされます。

関連付けられたオブジェクト

このオブジェクトには次の関連するオブジェクトがあります。特に記載がない限り、これらはこのオブジェクトと同じ API バージョンで使用できます。

EventFeed (API バージョン 20.0)

このオブジェクトに対してフィード追跡を実行できます。