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

EmailMessage

Salesforce のメールを表します。

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

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

特別なアクセスルール

EmailMessage は、メール-to-ケースまた��拡張メールを使用している組織でのみ使用可能です。これらは、ほとんどのお客様で自動的に有効になっています。

返信および転送機能を使用するには、EmailMessageRelation に存在するメールアドレスを FromAddress に指定し、RelationType を FromAddress にする必要があります。

カスタマーポータルユーザには、ParentID 項目の値がケースに関連付けられていれば、EmailMessage への参照アクセス権があります。それ以外の場合、アクセス権は関連付けられた ToDo の共有アクセス権によって決まります。

Status 項目はほとんどの場合、参照のみです。状況を New から Read に変更することのみ可能です。

update() がサポートされるのは、メールレコードが Draft 状況で IsPrivateDraft が false の場合です。また、Status と IsPrivateDraft が true で CreatedBy が現在のユーザに関連付けられている場合もサポートされます。メールレコードの状況が Draft でない場合は、IsExternallyVisible 項目とカスタム項目のみを更新できます。

項目

項目	詳細
ActivityId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明メールに関連付けられている活動の ID。通常、読み取られていない新しいメールメッセージが受信された場合にケース所有者に対して作成される進行中の ToDo を表します。ケースのメールに対してのみ ActivityId を指定できます。他のエンティティではこれは自動作成されます。
BccAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージの BCC が送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けられていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを BccAddress 項目に追加するのではなく、ID を BccIds 項目に追加します。そうすることで、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。
BccIds	型 JunctionIdList プロパティ Create、Update 説明メールメッセージの BCC が送信された取引先責任者、リード、およびユーザの ID の文字列配列。各 ID は EmailMessageRelation レコードにリンクされます。このレコードは、メールメッセージと取引先責任者、リード、またはユーザレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
CcAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージの CC が送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けられていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを CcAddress 項目に追加するのではなく、ID を CcIds 項目に追加します。そうすることで、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。
CcIds	型 JunctionIdList プロパティ Create、Update 説明メールメッセージの CC が送信された取引先責任者、リード、およびユーザの ID の文字列配列。各 ID は EmailMessageRelation レコードにリンクされます。このレコードは、メールメッセージと取引先責任者、リード、またはユーザレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
ContentDocumentIds	型 JunctionIdList プロパティ Create、Update 説明メールに関連付けられた、ファイルや添付ファイルなどのコンテンツドキュメントの ID の文字列配列。ID はそれぞれ ContentDocumentLink レコードにリンクされます。このレコードはメールメッセージとコンテンツドキュメントレコード間のリレーションを表します。 JunctionIdList 項目名を fieldsToNull プロパティに追加すると、関連するすべての連結レコードが削除されます。このアクションは元に戻すことができません。警告
Division	型 picklist プロパティ Defaulted on create、Filter、Group、Restricted picklist、Sort 説明
EmailTemplateId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明メールに選択されたメールテンプレート (存在する場合)。この項目は、Lightning Experience でのみ入力されます。
FirstOpenedDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが最初に開封された日付。この項目を表示するには、組織でメール追跡を有効にします。メモ
FromAddress	型 email プロパティ Create、Filter、Nillable、Sort、Update 説明メールが作成されたアドレス。この項目を使用する場合、EmailMessageRelation に存在するメールアドレスを指定し、RelationType を `FromAddress` にします。
FromName	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明送信者の名前。この項目を使用する場合、EmailMessageRelation に存在するメールアドレスを指定し、RelationType を `FromAddress` にします。
HasAttachment	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明メールがファイルを添付して送信されたか (`true`)、否か (`false`) を示します。
Headers	型 textarea プロパティ Create、Nillable、Update 説明受信メールのインターネットメッセージのヘッダー。デバッグおよび追跡の目的で使用されます。送信メールには適用されません。
HtmlBody	型 textarea プロパティ Create、Nillable、Update 説明メールの本文 (HTML 形式)。
Incoming	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明メールが受信されたか (`true`)、送信されたか (`false`) を示します。
IsBounced	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明メールがバウンスしたかどうかを示します。この項目を表示するには、組織で不達管理を有効にします。メモ
IsClientManaged	型 boolean プロパティ Create、Defaulted on create、Filter、Group 説明 IsClientManaged が true に設定されて EmailMessage が作成された場合、EmailMessage の Status が `Draft` に設定されている場合でも、ユーザは EmailMessage.ContentDocumentIds を変更して添付ファイルをリンクできます。
IsDeleted	型 boolean プロパティ Defaulted on create、Filter 説明オブジェクトがごみ箱に移動したか (`true`)、否か (`false`) を示します。表示ラベルは Deleted です。
IsExternallyVisible	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明コミュニティケースフィードが有効化されている場合、IsExternallyVisible によってコミュニティでのメールの外部表示が制御されます。IsExternallyVisible がデフォルト値の true に設定されている場合、ケースフィードでメールメッセージは外部ユーザに表示されます。 ParentId 項目にデータが入力されているメールのみをコミュニティで外部表示できます。メールの Status が `Draft` に設定されている場合、この項目は更新できません。
IsOpened	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明メールが開封されたかどうかを示します。この項目を表示するには、組織でメール追跡を有効にします。メモ
IsPrivateDraft	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort 説明 IsPrivateDraft が true に設定されている場合、CreatedById ユーザのみがこのメールドラフトを表示、更新、および送信できます。IsPrivateDraft が false に設定されている場合、ケースで作業するための権限を持つすべてのユーザがこのドラフトを表示できます。メールが送信されると (メールの Status = Draft)、この項目は false に更新されます。公開ドラフトは Salesforce Classic に読み込まれて表示されますが、非公開ドラフトは Lightning Experience でのみ使用されます。
IsTracked	型 boolean プロパティ Create、Defaulted on create、Filter、Group、Sort、Update 説明メールが追跡されているかどうかを示します。この項目を表示するには、組織でメール追跡を有効にします。メモ
LastOpenedDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが最後に開封された日付。この項目を表示するには、組織でメール追跡を有効にします。メモ
MessageDate	型 dateTime プロパティ Create、Filter、Nillable、Sort、Update 説明メールが作成された日付。
MessageIdentifier	型 string プロパティ Create、Filter、Group、idLookup、Nillable、Sort、Update 説明メールメッセージの ID。
ParentId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明メールに関連付けられたケースの ID。
RelatedToId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明 RelatedToId は、取引先、商談、キャンペーン、ケース、カスタムオブジェクトなど、人以外のオブジェクトを表します。RelatedToIds は多態的です。多態的とは、RelatedToId が関連オブジェクトの ID に相当することを意味します。
ReplyToEmailMessageId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明現在の EmailMessage の返信先である受信または送信 EmailMessage の ID。Status が `Draft` であるメッセージに返信することはできません。
Status	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明メールの状況。 Status 項目はほとんどの場合、参照のみです。状況を `New` から `Read` に変更することのみ可能です。値は次のとおりです。 `0` (新規) `1` (既読) `2` (返信済み) `3` (送信済み) `4` (転送済み) `5` (下書き) ケースの一部として送信されないメールでは、`3` (送信済み) のみが有効です。
Subject	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールの件名行。
TextBody	型 textarea プロパティ Create、Nillable、Update 説明メールの本文 (平文テキスト形式)。TextBody が設定されていない場合、HtmlBody から抽出されます。
ThreadIdentifier	型 string プロパティ Create、Filter、Group、idLookup、Nillable、Sort、Update 説明メールメッセージが属しているメールスレッドの ID。
ToAddress	型 string プロパティ Create、Filter、Nillable、Sort、Update 説明メールメッセージが送信された受信者のメールアドレスの文字列配列。Salesforce の取引先責任者、リード、またはユーザレコードに関連付けられていないメールアドレスのみを含めます。受信者が取引先責任者、リード、またはユーザの場合、そのメールアドレスを ToAddress 項目に追加するのではなく、ID を ToIds 項目に追加します。そうすることで、メールメッセージが自動的に取引先責任者、リード、またはユーザに関連付けられます。
ValidatedFromAddress	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明送信者のアドレス、メールが作成された検証済みの組織の共有メールアドレス、またはメール-to-ケースのルーティングアドレスが含まれる選択リスト値。 ValidatedFromAddress は、Group By または Sort By ステートメントでの使用には適していません。代わりに FromAddress を使用します。メモ

使用方法

組織でメール-to-ケースを使用している場合、メールが会社のアドレスのいずれかに送信されるとケースが作成されます。メールは、ParentID 項目によってケースに関連付けられ、EmailMessage レコードに保存されます。ユーザがメールを参照すると、EmailMessage レコードが表示されます。

組織で拡張メールを使用している場合、各メールは EmailMessage レコードおよび ToDo レコードとして保存されます。ユーザがメールを参照すると、EmailMessage レコードが表示されます。

サンプルコード —Apex

このサンプルログでは、Salesforce での活動をメールで送信します。

1// if EnhancedEmail Perm is not enabled, continue logging the email as a task
2
3// if EnhancedEmail Perm is enabled, create an EmailMessage object
4EmailMessage emailMessage = new EmailMessage();
5emailMessage.status = '3'; // email was sent
6emailMessage.relatedToId = '006B0000003weZGIAY'; // related to record e.g. an opportunity
7emailMessage.fromAddress = 'sender@example.com'; // from address
8emailMessage.fromName = 'Dan Perkins'; // from name
9emailMessage.subject = 'This is the Subject!'; // email subject
10emailMessage.htmlBody = '<html><body><b>Hello</b></body></html>'; // email body
11// Contact, Lead or User Ids of recipients
12String[] toIds = new String[]{'003B000000AxcEjIAJ'}; 
13emailMessage.toIds = toIds;
14// additional recipients who don’t have a corresponding contact, lead or user id in the Salesforce org (optional)
15emailMessage.toAddress = 'emailnotinsalesforce@toexample.com, anotherone@toexample.com';
16insert emailMessage; // insert
17
18// Add Email Message Relation for id of the sender
19EmailMessageRelation emr = new EmailMessageRelation();
20emr.emailMessageId = emailMessage.id;
21emr.relationId = '005B0000003qHvOIAU'; // user id of the sender
22emr.relationType = 'FromAddress';
23insert emr;

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

EmailMessage

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

特別なアクセスルール

項目

使用方法

サンプルコード —Apex

関連項目: