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

Event

カレンダーの行動を表します。ユーザインターフェースで、行動と ToDo レコードは活動として集合的に参照されます。

EventRelation オブジェクトは、下位行動に関連付けることはできません。また、下位行動には [招待者] 関連リストは含まれません。
API バージョン 25.0 以前では、複数の取引先責任者に関連する行動で、query()、delete()、および update() は許可されません。
upsert() および undelete() は、API で Lightning Sync 機能を使用してイベントに加えた変更の同期ではサポートされません。

メモ

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

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

項目

項目	詳細
AcceptedEventInviteeIds	型 JunctionIdList プロパティ Create、Update 説明この行動を承諾した取引先責任者またはリードの ID の文字列配列。この JunctionIdList は、AcceptedEventRelation 子リレーションにリンクしています。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
AccountId	型 reference プロパティ Filter、Group、Nillable、Sort 説明関連する取引先の ID を表します。AccountId は次のように決定されます。 WhatId の値が次のオブジェクトのいずれかである場合、Salesforce はそのオブジェクトの AccountId を使用します。 Account Opportunity Contract Account の子であるカスタムオブジェクト WhatId 項目の値がその他のオブジェクトで、かつ WhoId 項目の値が Contact オブジェクトである場合、Salesforce はその取引先責任者の AccountId を使用します。組織で Shared Activities を使用する場合は、Salesforce は主取引先責任者の AccountId を使用します。それ以外の場合は、Salesforce は AccountId 項目の値を `null` に設定します。 ID については、「ID データ型」を参照してください。
ActivityDate	型 date プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 IsAllDayEvent フラグが `true` に設定されている場合、行動の期日が含まれます。この項目には、協定世界時 (UTC) タイムゾーンの午前 0 時に常に設定されている日付項目があります。タイムゾーンの違いを考慮してタイムスタンプを変更しないでください。表示ラベルは [期日のみ] です。 IsAllDayEvent フラグが `true` に設定されている場合、この項目はバージョン 12.0 以前で必須です。この項目の値と StartDateTime が一致するか、いずれかが `null` である必要があります。
ActivityDateTime	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明 IsAllDayEvent フラグが `false` に設定されている場合、行動の期日が含まれます。この項目の時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換します。表示ラベルは [期日時間] です。 IsAllDayEvent フラグが `false` に設定されている場合、この項目はバージョン 12.0 以前で必須です。この項目の値と StartDateTime が一致するか、いずれかが `null` である必要があります。
ClientGuid	型 string プロパティ Filter、Group、Nillable、Sort 説明クライアントのグローバル一意識別子は、行動の作成に使用される外部 API クライアントを識別します。表示ラベルは [クライアント GUID] です。
CurrencyIsoCode	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明複数の currency 機能を有効化している組織にのみ使用できます。組織で使用できる currency の ISO コードが指定されています。
DeclinedEventInviteeIds	型 JunctionIdList プロパティ Create、Update 説明この行動を拒否した取引先責任者、リード、またはユーザの ID の文字列配列。この JunctionIdList は、DeclinedEventRelation 子リレーションにリンクしています。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
Description	型 textarea プロパティ Create、Nillable、Update 説明行動のテキストによる説明が含まれます。最大 32,000 文字です。
Division	型 picklist プロパティ Defaulted on create、Filter、Group、Restricted picklist、Sort 説明組織のデータの論理セグメントです。たとえば、会社がさまざまな事業単位によって構成されている場合、「北米」、「ヘルスケア」、「コンサルティグ」など、各事業単位のディビジョンを作成することができます。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
DurationInMinutes	型 int プロパティ Create、Filter、Group、Nillable、Sort、Update 説明行動の長さ (分) が含まれます。時間を表す値ですが、Date/Time 型ではなく integer 型です。 IsAllDayEvent が false の場合、バージョン 12.0 以前では必須です。バージョン 13.0 以降の場合、次の条件によって指定可能なものや省略可能なものが変わります。 IsAllDayEvent が true の場合、DurationInMinutes または EndDateTime のいずれかに値を指定できます。指定した値が同じ時間になる場合は、両方の項目に値を指定できます。両方の項目が `null` の場合、時間はデフォルトの 1 日になります。 IsAllDayEvent が false の場合、DurationInMinutes または EndDateTime のいずれかの値にする必要があります。指定した値が同じ時間になる場合は、両方の項目に値を指定できます。複数日の行動機能が有効な場合、API バージョン 13.0 以降では、DurationInMinutes 項目の 1440 を超える値をサポートします。API バージョン 12.0 以前では、DurationInMinutes が 1440 を超える行動オブジェクトにはアクセスできません。詳細は、「複数日の行動」を参照してください。使用している API バージョンによって、DurationInMinutes 項目および EndDateTime 項目に関するエラーの表示場所が異なる場合があります。バージョン 38.0 以前 — エラーは常に DurationInMinutes 項目に表示されます。バージョン 39.0 以降 — DurationInMinutes 項目に値がない場合、エラーは EndDateTime 項目に表示されます。値がある場合は DurationInMinutes 項目に表示されます。
EndDateTime	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明バージョン 13.0 以降で使用できます。この項目の時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換します。この項目は、次の条件によって指定可能なものや省略可能なものが変わります。 IsAllDayEvent が true の場合、DurationInMinutes または EndDateTime のいずれかに値を指定できます。指定した値が同じ時間になる場合は、両方の項目に値を指定できます。両方の項目が `null` の場合、時間はデフォルトの 1 日になります。 IsAllDayEvent が false の場合、DurationInMinutes または EndDateTime のいずれかの値にする必要があります。指定した値が同じ時間になる場合は、両方の項目に値を指定できます。使用している API バージョンによって、DurationInMinutes 項目および EndDateTime 項目に関するエラーの表示場所が異なる場合があります。バージョン 38.0 以前 — エラーは常に DurationInMinutes 項目に表示されます。バージョン 39.0 以降 — DurationInMinutes 項目に値がない場合、エラーは EndDateTime 項目に表示されます。値がある場合は DurationInMinutes 項目に表示されます。
EventSubtype	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort 説明標準のサブタイプを提供して、行動の作成および検索を容易にします。この項目は更新できません。
EventWhoIds	型 JunctionIdList プロパティ Create、Update 説明共有行動による多対多リレーションの作成に使用された取引先責任者またはリードの ID の文字列配列。EventWhoIds は、Shared Activities 設定が有効な場合に使用できます。主 WhoId が指定されていないと、リスト内の最初の取引先責任者またはリード ID が主 WhoId になります。EventWhoIds 項目を null に設定すると、リスト内のすべてのエントリが削除され、WhoId の値が最初のエントリとして追加されます。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
GroupEventType	型 picklist プロパティ Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort 説明参照のみ。API バージョン 19.0 以降で使用できます。値は次のとおりです。 `0` (グループでない行動) – 招待者がない行動。 `1` (グループの行動) — 招待者がある行動。 `2` (提案済み行動) — Salesforce ユーザインターフェースを使用して取引先責任者、リード、または個人取引先とのミーティングを要請する場合に作成される行動。ユーザがミーティングを確認すると、提案済み行動はグループの行動になります。API では提案済み行動を作成、編集または削除することはできません。この値は、API バージョン 41.0 以降では使用できなくなりました。 `3` (非表示) — Lightning Experience での一連のイベントの繰り返しパターンを表す行動。
IsAllDayEvent	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明 ActivityDate 項目 (`true`) または ActivityDateTime 項目 (`false`) のどちらを使用して、行動の日付/時間を定義するかを示します。表示ラベルは [終日の行動] です。「DurationInMinutes」と「EndDateTime」も参照してください。
IsArchived	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明行動がアーカイブされたかどうかを示します。
IsChild	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明行動が別の行動の子 (下位行動) であるか (`true`)、否か (`false`) を示します。下位行動では、IsReminderSet および ReminderDateTime のみを更新できます。下位行動をクエリおよび削除することができます。下位行動に関連するオブジェクトが親行動に関連するオブジェクトと異なる場合 (この違いは、API バージョン 25.0 以前を使用している場合に発生する可能性がある)、下位行動に関連するいずれかのオブジェクトが削除されると、データの整合性を確保するために親行動に関連するオブジェクトが更新されます。
IsClientManaged	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明外部クライアントによって行動が管理されているかどうかを示します。この項目の値が false の場合、行動は外部クライアントによって所有または管理されておらず、Salesforce を使用して更新できます。値が true の場合、Salesforce で変更できる行動の項目は、重要性の低い項目のみになります。表示ラベルは [はクライアントが管理] です。
IsGroupEvent	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明行動がグループ行動かどうか、つまり行動に招待者が含まれているか (`true`)、否か (`false`) を示します。
IsPrivate	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明行動の作成者以外のユーザが、行動を作成したユーザのカレンダーを表示した場合に、行動の詳細を表示できるか (`false`)、否か (`true`) を示します。なお、「すべてのデータの参照」または「すべてのデータの編集」権限を持つユーザは、レポートや検索、または他のユーザのカレンダーを参照したときに、非公開の行動を参照できます。非公開の行動を、商談、取引先、ケース、キャンペーン、契約、リードまたは取引先責任者に関連付けることはできません。表示ラベルは [非公開] です。
IsRecurrence	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明 Salesforce Classic の行動が繰り返すようスケジュール指定されているか (`true`)、1 回だけ実行するか (`false`) を示します。これは、レコード作成時ではなく、更新時の参照のみの項目です。この項目の値が `true` である場合、RecurrenceEndDateOnly、RecurrenceStartDateTime、RecurrenceType、および指定された繰り返しタイプが関連付けられている繰り返しの項目には必ず値を入力します。表示ラベルは [定期的な行動を作成] です。
IsRecurrence2	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の行動が繰り返すようスケジュール指定されているか (`true`)、1 回だけ実行するか (`false`) を示します。これは、レコード作成時ではなく、更新時の参照のみの項目です。この項目の値が true である場合、Recurrence2PatternText と Recurrence2PatternVersion に値を入力する必要があります。表示ラベルは [繰り返し (ベータ)] です。
IsRecurrence2Exception	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動のうち、1 つの行動に残りの行動とな異なる繰り返しパターンがあり、例外となるかどうかを示します。
IsRecurrence2Exclusion	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動の繰り返しパターンが更新されたが、影響があるのは将来の行動のみであるかどうかを示します。過去に発生した行動の場合、IsRecurrence2Exception が `true` に設定され、一連の繰り返しパターンから過去の行動が除外されます。
IsReminderSet	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明活動がアラームであるか (`true`)、否か (`false`) を示します。
IsVisibleInSelfService	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明オブジェクトに関連付けられた行動をカスタマーポータルで参照できるか (`true`)、否か (`false`) を示します。組織でコミュニティが有効な場合、IsVisibleInSelfService とマークされた行動は、行動が作成されたレコードへのアクセス権を持つコミュニティ内の外部ユーザに表示されます。この項目は、カスタマーポータルまたはパートナーポータルが有効になっているか、コミュニティが有効になっていて、カスタマーポータルまたはパートナーポータル��イセンスを所有している場合に使用できます。
Location	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明行動の場所が含まれます。
OwnerId	型 reference プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明行動を所有するユーザの ID が含まれます。表示ラベルは [所有者 ID] です。
Recurrence2PatternStartDate	型 dateTime プロパティ Create、Filter、Nillable、Sort 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動が開始する日時を示します。この項目の時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換します。
Recurrence2PatternText	型 textarea プロパティ Create、Nillable、Update 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動の繰り返しパターンを示します。Recurrence2PatternText は、インターネットカレンダーおよびスケジュールのための RFC 5545 標準仕様に従って実装されています。使用例については、このトピックの「一連の行動」セクションを参照してください。この項目には、最大で 512 文字を含めることができます。
Recurrence2PatternTimeZone	型 string プロパティ Filter、Group、Nillable、Sort, 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動が作成または更新されたタイムゾーンを示します。この項目では標準の Java TimeZone ID が使用されます。たとえば、America/Los_Angeles です。
Recurrence2PatternVersion	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明この項目は API バージョン 44.0 以降で使用できます。Lightning Experience の一連の行動の繰り返しパターンの標準仕様を示します。有効値は `1` (RFC 5545 v4 RRULE) のみです。RFC 5545 はインターネットカレンダーおよびスケジュールの標準仕様セットで、IsRecurrence2 は一連の行動の繰り返しパターンについて準拠しています。一連の行動の繰り返しパターンの RFC 5545 仕様は rrule と呼ばれます。rrule の使用例については、このトピックの「一連の行動」セクションを参照してください。
RecurrenceActivityId	型 reference プロパティ Filter、Group、Nillable、Sort 説明参照のみ。create には必須ではありません。Salesforce Classic の定期的な行動の主レコードの ID が含まれます。後続の行動には、この項目の同じ値が指定されます。
RecurrenceDayOfMonth	型 int プロパティ Create、Filter、Group、Nillable、Sort、Update 説明行動を繰り返す日付を示します。
RecurrenceDayOfWeekMask	型 int プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 Salesforce Classic の定期的な行動が繰り返される曜日 (複数可) を示します。この項目にはビットマスクが指定されます。値は次のようになります。日曜日 = `1` 月曜日 = `2` 火曜日 = `4` 水曜日 = `8` 木曜日 = `16` 金曜日 = `32` 土曜日 = `64` 複数の日付は、それらの値の合計で示されます。たとえば、火曜日と木曜日 = 4 + 16 = 20 です。
RecurrenceEndDateOnly	型 date プロパティ Create、Filter、Group、Nillable、Sort、Update 説明行動を繰り返した最終日を示します。複数の日にわたる Salesforce Classic の定期的な行動の場合、これは最後の行動が開始した日付です。この項目には、協定世界時 (UTC) タイムゾーンの午前 0 時に常に設定されている日付項目があります。タイムゾーンの違いを考慮してタイムスタンプを変更しないでください。
RecurrenceInstance	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明 Salesforce Classic の行動の繰り返し頻度を示します。たとえば、`2nd` または `3rd` です。
RecurrenceInterval	型 int プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 Salesforce Classic の定期的な行動間の間隔を示します。
RecurrenceMonthOfYear	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明 Salesforce Classic の定期的な行動を繰り返す月を示します。
RecurrenceStartDateTime	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明 Salesforce Classic の定期的な行動が開始する日時を示します。値は RecurrenceEndDateOnly よりも前の日時にする必要があります。この項目の時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換します。
RecurrenceTimeZoneSidKey	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明 Salesforce Classic の定期的な行動に関連付けられたタイムゾーンを示します。たとえば、太平洋標準時の「UTC-8:00」です。
RecurrenceType	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明 Salesforce Classic の行動を繰り返す頻度を示します。たとえば、毎日、毎週、または n か月ごと (「n か月」は RecurrenceInstance で指定) です。
ReminderDateTime	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明 IsReminderSet が `true` に設定されている場合、アラームが起動するよう指定されている時間を表します。IsReminderSet が `false` に設定されている場合、Salesforce ユーザインターフェースのアラームチェックボックスの選択が解除されているか、またはその値が示す時間にはすでにアラームが起動しています。
ShowAs	型 picklist プロパティ Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明別のユーザがカレンダーを参照した場合にこの行動がどのように表示されるか (予定あり、外出中、空き時間など) を示します。表示ラベルは [予定の公開方法] です。
StartDateTime	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明行動の開始日時を示します。バージョン 13.0 以降で使用できます。行動の IsAllDayEvent フラグが true (終日の行動であることを示す) に設定されると、行動の開始日に関する情報が、StartDateTime 項目で指定されます。この項目の時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換します。行動の IsAllDayEvent フラグが false に設定されると (終日の行動でないことを示す) 行動の開始日に関する情報が、StartDateTime 項目で指定されます。時間の部分は、常に協定世界時 (UTC) に移行されます。必要に応じて、ユーザまたはアプリケーションのローカルタイムゾーンとの間で変換する必要があります。この項目に値が指定されている場合、ActivityDate および ActivityDateTime のいずれかが `null` であるか、この項目の値と一致する必要があります。
Subject	型 combobox プロパティ Create、Filter、Nillable、Sort、Update 説明「電話」、「メール」、または「会議」など、行動の件名行。最大 255 文字です。
Type	型 picklist プロパティ Create、Filter、Nillable、Update 説明電話、メール、またはミーティングなど、行動の種別を示します。
UndecidedEventInviteeIds	型 JunctionIdList プロパティ Create、Update 説明この行動に関して未定の取引先責任者、リード、またはユーザの ID の文字列配列。この JunctionIdList は、UndecidedEventRelation 子リレーションにリンクしています。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
WhatCount	型 int プロパティ Filter、Group、Nillable、Sort 説明組織で Shared Activities が有効化されている場合に使用できます。WhatId に関する関連 EventRelation の件数を示します。WhatId の件数は、`1` 以下である必要があります。
WhatId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 WhatId は、取引先、商談、キャンペーン、ケース、カスタムオブジェクトなど、人以外のオブジェクトを表します。WhatId は、多態的です。多態的とは、WhatId が関連オブジェクトの ID に相当することを意味します。表示ラベルは [関連先 ID] です。
WhoCount	型 int プロパティ Filter、Group、Nillable、Sort 説明 Shared Activities が有効化されている組織で使用できます。WhoId に関する関連 EventRelation の件数を示します。
WhoId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 WhoId は、リードや取引先責任者など、人を表します。WhoId は、多態的です。多態的とは、WhoId が取引先責任者の ID やリードの ID に相当するという意味です。表示ラベルは [名前 ID] です。 Shared Activities が有効な場合、この項目の値は関連するリードまたは主取引先責任者の ID になります。WhoId 項目を追加、更新、または削除した場合、このレコードに関連付けられたトリガ、ワークフロー、およびデータ入力規則で問題が発生する可能性があります。表示ラベルは [名前 ID] です。 JunctionIdList 項目が使用されている場合、リレーションリストにすべての WhoId が含まれます。 API バージョン 37.0 以降、WhoId 項目の取引先責任者またはリード ID が EventWhoIds リストにない場合、エラーは発生せず、EventWhoIds に ID が主 WhoId として追加されます。WhoId が null に設定されている場合、既存の EventWhoIds リスト内のいずれかの ID が最初の位置に移動されます。

使用方法

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

行動のクエリと絞り込み

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

特定の期日を持つ行動にクエリを実行する場合、ActivityDateTime 項目および ActivityDate 項目を絞り込む必要があります。たとえば、期日が 2003 年 2 月 14 日の場合、次の 2 つの条件が必要です。

ActivityDate 項目が協定世界時 (UTC) タイムゾーンの 2003 年 2 月 14 日に等しい。
ActivityDateTime 項目がローカルタイムゾーンの 2003 年 2 月 14 日の午前 0 時以降、かつユーザのローカルタイムゾーンの 2003 年 2 月 15 日午前 0 時以前の値。

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

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

複数日の行動

複数日の行動はバージョン 13.0 以降で使用できます。また、以前のバージョンの SOQL クエリは、複数日の行動を返しません。
複数日の行動を有効にするには、ユーザインターフェースの [設定] から [クイック検索] ボックスに「活動設定」と入力し、[活動設定] を選択します。
複数日の行動機能が有効な場合、API バージョン 13.0 以降では、DurationInMinutes 項目の 1440 を超える値をサポートします。API バージョン 12.0 以前では、DurationInMinutes が 1440 を超える行動オブジェクトにはアクセスできません。
複数日の行動は 14 日を超えることができません。

一連の行動 (ベータ) と定期的な行動

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

ベータ機能である Lightning Experience の一連の行動はプレビューであり、Salesforce とのマスターサブスクリプション契約における「サービス」とはみなされません。一連の行動はお客様各自の裁量で使用し、購入するときは、現在正式にリリースされている製品および機能に基づいて判断してください。Salesforce はこの機能の特定期間内の正式リリースまたはリリースの有無を保証せず、いつでも中止できます。この機能は評価のみを目的とし、本番環境での使用はできません。この機能は現状のまま提供され、サポートの対象外です。この機能に起因あるいは関連して生じた危害または損害に対して Salesforce は一切の責任を負わないものとします。制限、Salesforce の権利の留保、サービスに関するお客様の義務、関連する Salesforce 以外のアプリケーションおよびコンテンツの使用規約はすべて、お客様によるこの機能の使用にも同様に適用されます。

メモ

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

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

Lightning Experience の一連の行動の繰り返しパターンは、インターネットカレンダーおよびスケジュールのための RFC 5545 標準仕様に従って実装されています。一連の行動の繰り返しパターンの RFC 5545 仕様は rrule と呼ばれます。次の表には一般的な rrule の例が含まれます。詳細な仕様については、RFC 5545 標準を参照してください。

繰り返しパターン	rrule の例
5 日間毎日	`RRULE:FREQ=DAILY;INTERVAL=1;COUNT=5`
毎週月曜日、火曜日、水曜日、木曜日、および金曜日	`RRULE:FREQ=WEEKLY;INTERVAL=1;BYDAY=MO,TU,WE,TH,FR`
隔週水曜日と金曜日を 10 回	`RRULE:FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,FR;WKST=SU;COUNT=10`
2020 年 1 月まで毎月 1 日	`RRULE:FREQ=MONTHLY;INTERVAL=1;BYMONTHDAY=1;UNTIL=20200101T190000Z`
毎年 7 月 1 日を 3 回 (この例では、日付は StartDateTime を使用して指定)	`RRULE:FREQ=YEARLY;INTERVAL=1;BYMONTH=1;COUNT=3`

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

RecurrenceType の値	プロパティ	パターンの例
RecursDaily	RecurrenceInterval	1 日おき
RecursEveryWeekday	RecurrenceDayOfWeekMask	土曜、日曜以外のすべての平日
RecursMonthly	RecurrenceDayOfMonth RecurrenceInterval	1 か月おき、月の 3 日目
RecursMonthlyNth	RecurrenceInterval RecurrenceInstance RecurrenceDayOfWeekMask	1 か月おき、月の最終金曜日
RecursWeekly	RecurrenceInterval RecurrenceDayOfWeekMask	2 週間おきの水曜日と金曜日
RecursYearly	RecurrenceDayOfMonth RecurrenceMonthOfYear	毎年 3 月の 26 日
RecursYearlyNth	RecurrenceDayOfWeekMask RecurrenceInstanceRecurrenceMonthOfYear	毎年 10 月の第 1 土曜日

被招集者と招待者

GroupEventType 項目は、ミーティング参加者が行動に含まれていることを示します。Lightning Experience では、この表示ラベルは「被招集者」、Salesforce Classic では、この表示ラベルは「招待者」です。

Lightning Sync による行動の同期

API による EventRelation への変更では、Microsoft® Exchange または Google への同期はトリガされません。ただし、EventRelation は、行動の他の同期項目が変更された場合は同期します。

JunctionIdList

JuncionIdList を使用して行動を作成するため、関連取引先責任者から ID が取得され、行動と EventRelation レコードの両方が 1 つの API コールで作成されます。すべての処理が 1 回の API コールで行われるため、EventRelation に失敗した場合は、行動がロールバックされます。

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}

Salesforce および Lightning プラットフォームのオブジェクトリファレンス

Event

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

項目

使用方法

関連項目: