比較バージョン

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。

メール連携設定ファイルは、電子メールからのデータ登録機能を利用する場合に作成します。メールの内容をLMISに取り込むための設定を記述します。

...

項目

内容

ファイル名

使用するメールアドレス.ini

例:sample@a1b2c3d4e5f6g7h8i9j0.apex.salesforce.com.ini

情報

組織のアドレスにお客様ドメインのメールアドレスを登録している場合は、「お客様ドメインのメールアドレス.ini」としてください。

ファイル名(CC取り込み用の場合)

使用するメールアドレス.cc

例:sample2@a1b2c3d4e5f6g7h8i9j0.apex.salesforce.com.cc

ファイル保管先

LMISドキュメントフォルダ

フォーマット

テキスト形式ファイル

文字コード

UTF-8(BOMなし)

ファイル反映のタイミング

本ファイルをLMIS上に配置したときに反映します。

アンカー
記述形式
記述形式

記述形式

...

  • パラメータの値の1文字目には記号を指定します。指定した記号によって、値が以下のとおりに変換されます。
    なお、特記事項に記載がない場合、大文字/小文字を区別しません。

記号

変換方法

特記事項

$

文字列に変換します。
例:ox_sel_inquiry__c=$メール

指定された文字列は大文字/小文字を区別します。

#

数値に変換します。

例:commentkeyLine=#3


_

(アンダーバー)

TRUE、FALSEのいずれかに変換します。

例:approvalMail=_TRUE


@

メール項目から、パラメータに設定可能な値に変換します。指定できるのは以下の項目です。

  • TOMAIL:メールの送信先アドレス

  • CCMAIL:メールのCCアドレス

  • SUBJECT:メールの件名

  • BODY:メールの本文

  • MAIL:メールのFromに含まれるメールアドレス

  • DATE:メールの送信日時

  • DATE_VALUE:メールの送信日

例:
  • HEADER(ヘッダ名):メールのヘッダ

例1:ox_txt_subject__c=@subject 

上記のように指定した場合、メールの件名から値を取得しレコードの件名に設定されます。

例2:ox_txt_subject__c=@header(Message-ID)

上記のように指定した場合、メールヘッダのMassage-IDの値を取得します。

  • パラメータの大文字/小文字を区別しません。(@subject、@SUBJECTは同じパラメータとして認識されます。

  • TOアドレスはメールサービスのアドレスが含まれるため、代入先へメール型項目(最大文字数:80文字)を指定することはできません。

  • HEADER(ヘッダ名)使用例:メールヘッダにあるMessage-IDの値を例2のように取得してレコードに保存しておくことで、実際に送信されたメールのMessage-IDとレコードに保存されているMessage-IDを比較し、メールの漏れがないかを確認できます。

?

メール本文または件名から特定キーワード間の値を取得します。以下の形式で記述します。

?(開始キーワード,終了キーワード,取得場所)

終了キーワードに以下の値が設定可能です。省略値は¥nです。

  • @endbody:開始キーワードから末尾までの値を取得します。

取得場所に以下の値が設定可能です。省略値は@bodyです。

  • @body:メール本文から値を取得します。

  • @subject:メール件名から値を取得します。

例1:?(START,END,@body)

上記のように指定した場合、メール本文中のSTARTという文字列からENDという文字列間の値を取得します。

終了キーワードを指定しない、または¥nを指定すると、開始キーワードから改行までの値を取得します。

例2:?(START,¥n,@body) または ?(START,,@body)

上記のように指定した場合、メール本文中のSTARTという文字列から次の改行までの文字列の値を取得します。

例3:?(START,@endbody,@body)

上記のように指定した場合、メール本文中のSTARTという文字列からメール本文の末尾(改行含む)までの文字列の値を取得します。

  • 開始キーワード、終了キーワードが見つからない場合は、値取得は行われません。

  • 開始キーワードに、カンマ「,」を含めることはできません。

  • 終了キーワードを「文字列¥n」と指定した場合、¥nは文字列として扱われます。改行までを取得したい場合は、「¥n」単体で指定してください。

  • 開始キーワードは省略できません。

  • 開始キーワードおよび終了キーワードが取得場所(本文または件名)に複数ある場合は、最初に見つかった開始キーワードから、それ以降で最初に見つかった終了キーワードまでの値を取得します。

&

オブジェクトを指定し、対象項目の値を取得します。条件値には、データの値を直接指定するか、@マーク、?マーク、変数名、API参照名の併用が可能です。

以下の形式で記述します。

&オブジェクト名(条件項目名,条件値,取得項目)

例1:&User(Username,xxx@unirita.co.jp,ID)
上記のように指定した場合、「xxx@unirita.co.jp」という値でユーザ(User)を検索し、ユーザ名が一致したユーザのIDを取得します。

例2:&Contact(Email,@MAIL,NAME)
上記のように指定した場合、送信元のメールアドレスで取引先責任者(Contact)を検索し、メールアドレスが一致した取引先責任者の名前を取得します。

  • 条件値には、@BODYを使用できません。

  • 条件値に英数が設定されている場合は、全半角/大小文字を区別しません。記号、カナは全半角が別の文字として区別されます。

API参照名

すでに項目に設定した値を使用したい場合は、API参照名を設定することで、同一の値を取得できます。

以下の形式で記述します。

例:

ox_txt_subject__c = @SUBJECT

ox_ltx_content__c = ox_txt_subject__c

上記のように指定した場合、メール件名がレコードの件名に設定され、レコードの件名に設定された値が内容に設定されます。

  • 代入元と代入先のデータ型は一致させる必要があります。

  • API参照名については、「API参照名一覧」を参照してください。

:(変数名)

複数の項目に同じ値を使用したい場合は、変数を使用することで、同一の値を取得できます。

以下の形式で記述します。

例:

ox_txt_subject__c=:VARSUBJECT

ox_ltx_content_c=:VARSUBJECT


[VARIABLE]

VARSUBJECT=@SUBJECT

上記のように指定した場合、メールの件名がレコードの件名、および内容にそれぞれ設定されます。

  • 変数定義セクションに変数を定義する必要があります。

  • 定義した変数の前に、コロン「:」を記述して使用します。

  • 代入元と代入先のデータ型は一致させる必要があります。

  • 変数名は、大文字/小文字を区別します。変数名は、大文字/小文字を区別しません。

  • 変数については、「変数定義セクション」を参照してください。

date

日付型に変換します。条件値には、@SUBJECT、@BODY、?マーク、変数名、API参照名の併用が可能です。

以下の形式で記述します。

date(条件値,フォーマット)

例:date(@BODY,yyyy年MM月dd日)

1つ目の引数には、条件値として変換前の文字列を指定します。
例では、メール本文(@BODY)
上記のように指定した場合、メール本文にフォーマットで指定している文字列を日付型に変換します。を指定しています。この例では「2024年11月11日」のような形式で、日付の文字列がメール本文に入力されるものとします。

2つ目の引数には、条件値で指定される文字に対応するフォーマットを指定します。
この例では、本文の内容「20241111」に合わせた「yyyyMMdd」をフォーマットとして指定します。

  • フォーマットは省略できません。

  • 使用できるフォーマットについては「指定する条件値とフォーマットについては「日付型フォーマット変換表」を参照してください。

  • フォーマットに固定値を使用できません。

  • フォーマットは大文字/小文字を区別します。

  • 条件値に日付型、日時型の値を持つ変数名は使用できません。

  • 条件値に日付型、日時型の項目のAPI参照名は使用できません。

注意

条件値で日付ではない値を変換しようとした場合、メール連携が失敗する可能性があるのでご注意ください

datetime

日付/時間型に変換します。条件値には、@SUBJECT、@BODY、?マーク、変数名、API参照名の併用が可能です。

以下の形式で記述します。

datetime(条件値,フォーマット)

例:datetime(@BODY,yyyy年MM月dd日 HH時mm分)

1つ目の引数には、条件値として変換前の文字列を指定します。
例では、メール本文(@BODY)
上記のように指定した場合、メール本文にフォーマットで指定している文字列を日付/時間型に変換します。を指定しています。この例では「2024年11月11日 12時23分」のような形式で、日付と時間の文字列が本文に入力されるものとします。

2つ目の引数には、条件値で指定される文字に対応するフォーマットを指定します。
この例では、本文の内容「20241111 1223」に対応した「yyyyMMdd HHmm」をフォーマットとして指定します。

  • フォーマットは省略できません。

  • 使用できるフォーマットについては「指定する条件値とフォーマットについては「日付型フォーマット変換表」を参照してください。

  • フォーマットに固定値を使用できません。

  • フォーマットは大文字/小文字を区別します。

  • 条件値に日付型、日時型の値を持つ変数名は使用できません。

  • 条件値に日付型、日時型の項目のAPI参照名は使用できません。

注意

条件値で日付/時間ではない値を変換しようとした場合、メール連携が失敗する可能性があるのでご注意ください

number

数値型に変換します。条件値には@SUBJECT、@BODY、?マーク、変数名、API参照名の併用が可能です。

以下の形式で記述します。

number(条件値)

:number(?(START,END,@body))

上記のように指定した場合、メール本文中のSTARTという文字列からENDという文字列間の値を取得し、数値型に変換します。

  • 条件値は省略できません。

  • 条件値については「記述形式」を参照してください。

注意

条件値で数値ではない値を変換しようとした場合、メール連携が失敗する可能性があるのでご注意ください。

定義内容

...

メール連携設定ファイルは、以下の設定、セクションで構成されます。

...

タグ

タグの用途

開始時挿入

終了時挿入

hr

横罫線

改行


br

改行

改行


td

テーブルセル


半角スペース

th

テーブルヘッダーセル


半角スペース

label

ラベル


半角スペース

div

ブロック


改行

tr

テーブル行


改行

p

段落


改行

li

リスト


改行

h1

見出し


改行

h2

見出し


改行

h3

見出し


改行

h4

見出し


改行

h5

見出し


改行

h6

見出し


改行

ルーティング設定

メールルーティングの追加設定(ルーティング先の指定ルーティング先の指定および送信元の指定)を実施したい場合は、以下のルーティング設定の属性を記述します。

...

属性

説明

省略可否

省略値

successRouting

メールサービス受信時、処理が成功した場合のルーティング先を指定します。
例:successRouting=zzzz@unirita.co.jp

複数のアドレスを指定する場合は、「;」区切りで指定します。
送信しない場合は空白を指定してください。

なし

errorRouting

メールサービス受信時、処理が失敗した場合のルーティング先を指定します。
例:errorRouting=@mail

複数のアドレスを指定する場合は、「;」区切りで指定します。
送信しない場合は空白を指定してください。

@mail(送信元)

routingFrom

メールサービスの受信時、ルーティング先に送るメールの送信元を指定します。

:routingFrom=zzzz@unirita.co.jp

組織のアドレスとして登録されているアドレスのみ指定可能です。

メールサービスアドレスで指定した「コンテキストユーザ」※1

情報

※1:メールサービスアドレスのコンテキストユーザについては、「メールサービスを登録する」を参照してください。

活動履歴情報登録セクション

メール送信によって作成される活動履歴内容を変更したい場合は、以下の活動履歴情報登録セクションの属性を記述します。

...

メール連携設定ファイルの評価の流れを、以下に説明します。

...

1.基本的な設定の評価

...

 a.メール承認設定の評価

...

 b.ルーティング設定の評価

...

 c.メール処理形式設定の評価

...

 d.HTMLメール解析設定の評価

...

 e.入力値の切り捨て設定の評価

...

2.変数定義セクションの評価
以降の処理で使用する、変数を評価します。

...

3.レコード更新セクションの評価
レコード更新セクションが初めに評価されます。
更新対象レコードが存在しない場合は、次の評価に移ります。

...

4.レコードの新規登録、または活動履歴情報の登録
メールの件名を評価して、レコードを新規登録するか、活動履歴情報を登録するかが評価されます。
評価後、該当のセクションの内容が評価されて、処理が実施されます。

...

 a.レコード新規登録設定の評価

...

 レコード新規登録設定の内容に従って、レコードが登録されます。

...

 b.活動履歴情報登録セクションの評価

...

 活動履歴情報登録セクションの内容に従って、活動履歴情報が主レコードに関連付けて登録されます。

注意事項

...

  • 必ずUTF-8形式で保存してください。UTF-8形式以外の文字コードで保存した場合、正しく設定されないことがあります。

  • パラメータを省略する場合には、属性を削除するか値を空白にします。

  • レコード更新セクションによってレコードが更新された場合、メールの対となるレコード(メールを受信したことの証跡)がいずれのレコードにも残りません。

...