intra-mart Accel Platform / 設定ファイルリファレンス

第7版 2014-05-30

«  メールモジュール   ::   コンテンツ   ::   Webモジュール  »

メール設定

概要

メール送信に関する設定です。
デフォルトの設定としてjavamail-config.xmlが用意されています。
多言語対応として、javamail-config_{ロケールID}.xmlが存在します。

モジュール メールモジュール
フォーマットファイル(xsd) WEB-INF/schema/javamail-config.xsd
設定場所
WEB-INF/conf/javamail-config/javamail-config.xml
WEB-INF/conf/javamail-config/{任意のファイル名}.xml

<?xml version="1.0" encoding="UTF-8"?>
<javamail-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://intra-mart.co.jp/system/mail/javamail/config/javamail-config"
    xsi:schemaLocation="http://intra-mart.co.jp/system/mail/javamail/config/javamail-config ../../schema/javamail-config.xsd ">

  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      <smtps enable="false" starttls="false"/>
      <auth enable="false">
        <user/>
        <password/>
      </auth>
      <x-mailer>intra-mart MailSender ver 8.0</x-mailer>
      <debug>false</debug>
      <connection-timeout>-1</connection-timeout>
      <timeout>-1</timeout>
    </smtp-server>
  </smtp>

  <content-type>
    <file extension=".txt" content-type="text/plain"/>
    <file extension=".gif" content-type="image/gif"/>
    <file extension=".jpg" content-type="image/jpeg"/>
    <file extension=".png" content-type="image/png"/>
  </content-type>

  <listener>
    <listener-class>jp.co.intra_mart.foundation.mail.javamail.listener.impl.HalfKanaTransrateListener</listener-class>
  </listener>

  <encode>
    <charset>UTF-8</charset>
    <mime-encoding>B</mime-encoding>
    <content-transfer-encoding>7bit</content-transfer-encoding>
  </encode>

</javamail-config>

リファレンス

SMTPの設定

タグ名 smtp-server
SMTPの設定を行います。
メールの送信時に使用するSMTPの設定を行います。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ....
    </smtp-server>
  </smtp>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 SMTPの各種設定を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ javamail-config

SMTPサーバ設定

タグ名 smtp-server
SMTPサーバの設定を行います。

複数のSMTPサーバの定義を行うことが可能です。
APIからのメール送信時にSMTPサーバが指定されていない場合、テナントIDと同じIDのSMTPサーバを利用します。
テナントIDと同じIDのSMTPサーバの設定が存在しない場合に利用されるため、必ず一つ、id属性に default を指定したSMTPサーバを設定してください。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ....
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定
設定値・設定する内容 SMTPサーバの設定を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ smtp

【属性】

属性名 説明 必須 デフォルト値
id
このSMTPサーバの設定を特定する一意のIDです。
APIからのメール送信時にこのIDを指定することで、利用するSMTPサーバを選択することができます。APIからのメール送信時にIDを指定しなかった場合、テナントIDと同じIDのSMTPサーバを利用します。テナントIDと同じIDの設定が存在しない場合は、標準設定(default)が有効になります。
なし
host SMTPサーバのホスト名またはIPアドレスを指定します。 なし
port SMTPサーバのポート名を指定します。 なし

SMTPS(SMTP over SSL)設定

タグ名 smtps
SMTPS(SMTP over SSL)の設定を行います。
SMTPSを利用するにはJavaランタイムがSMTPサーバのSSL証明書を信頼済みである必要があります。
SSL証明書が信頼されていない場合、javax.net.ssl.SSLHandshakeExceptionがスローされSMTPサーバに接続することができません。
JavaランタイムがSMTPサーバのSSL証明書を信頼済みであることを確認して使用してください。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      <smtps enable="true" starttls="false"/>
      ....
    </smtp-server>
  </smtp>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 SMTPS(SMTP over SSL)の設定を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ smtp-server

【属性】

属性名 説明 必須 デフォルト値
enable
SMTPサーバとの通信をSSLによる暗号化通信を利用して行います。SSLを利用する場合はtrue、利用しない場合はfalseを設定してください。

× false
starttls
TLS/STARTTLSによる暗号化通信を行います。TLS/STARTTLSを利用する場合はtrue、利用しない場合はfalseを設定してください。
この設定を有効にする場合はenable属性も有効に設定してください。
× false

SMTP Authentication設定

タグ名 auth
SMTP Authenticationを利用する場合に指定する要素です。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      <auth enable="false">
        ....
      </auth>
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容 SMTP Authenticationを利用する際の設定を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ smtp-server

【属性】

属性名 説明 必須 デフォルト値
enabled SMTP Authenticationの利用設定を行います。SMTP Authenticationを利用する場合はtrue、利用しない場合はfalseを設定してください。 × false

SMTP Authenticationユーザ設定

タグ名 user
SMTP Authenticationを利用する際のユーザを設定します。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      <auth enable="true">
        <user>USER</user>
        ...
      </auth>
    </smtp-server>
  </smtp>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 SMTP Authenticationを利用する際のユーザを設定します。
単位・型 文字列
省略時のデフォルト値 なし
親タグ auth

SMTP Authenticationパスワード設定

タグ名 password
SMTP Authenticationを利用する際のパスワードを設定します。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      <auth enable="true">
        ....
        <password>PASSWORD</password>
      </auth>
    </smtp-server>
  </smtp>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 SMTP Authenticationを利用する際のパスワードを設定します。
単位・型 文字列
省略時のデフォルト値 なし
親タグ auth

メールヘッダ設定

タグ名 x-mailer
X-Mailerメールヘッダに指定する値の設定を行います。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ...
      <x-mailer>intra-mart MailSender ver 8.0</x-mailer>
      ...
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容 メール送信時にX-Mailerヘッダとして送信する値を設定します。
単位・型 文字列
省略時のデフォルト値 なし
親タグ smtp-server

デバッグ設定

タグ名 debug
JavaMailにデバックオプションを設定します。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ...
      <debug>false</debug>
      ...
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容
false デバッグ設定を行いません。
true デバッグ設定を行います。
単位・型 真偽値 (true/false)
省略時のデフォルト値 なし
親タグ smtp-server

コネクションタイムアウト設定

タグ名 connection-timeout
SMTPサーバ接続時のコネクションタイムアウト値を設定します。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ...
      <connection-timeout>-1</connection-timeout>
      ...
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容
SMTPサーバ接続時のコネクションタイムアウト値を設定します。
-1が設定された場合はコネクションタイムアウトは発生しません。
設定可能な数値の単位はミリ秒です。
単位・型 数値(1以上 または -1)
省略時のデフォルト値 なし
親タグ smtp-server

タイムアウト設定

タグ名 timeout
メール送信時におけるタイムアウト値を設定します。

【設定項目】

<javamail-config>
  <smtp>
    <smtp-server id="default" host="localhost" port="25">
      ...
      <timeout>-1</timeout>
      ...
    </smtp-server>
  </smtp>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容
メール送信時におけるタイムアウト値を設定します。
-1が設定された場合はタイムアウトは発生しません。
設定可能な数値の単位はミリ秒です。
単位・型 数値(1以上 または -1)
省略時のデフォルト値 なし
親タグ smtp-server

コンテンツタイプ群

タグ名 content-type
メール送信時に添付するファイルのコンテンツタイプ群の設定を行います。

【設定項目】

<javamail-config>
  <content-type>
    ...
  </content-type>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 メール送信時に添付するファイルのコンテンツタイプ群を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ javamail-config

コンテンツタイプ設定

タグ名 file
メール送信時に添付するファイルのコンテンツタイプの設定を行います。
コンテンツタイプの設定は添付ファイルの拡張子に対しての設定となります。

【設定項目】

<javamail-config>
  <content-type>
    <file extension=".txt" content-type="text/plain"/>
    <file extension=".gif" content-type="image/gif"/>
    <file extension=".jpg" content-type="image/jpeg"/>
    <file extension=".png" content-type="image/png"/>
  </content-type>
</javamail-config>

必須項目
複数設定
設定値・設定する内容 メール送信時に添付するファイルのコンテンツタイプを指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ content-type

【属性】

属性名 説明 必須 デフォルト値
extension 拡張子を指定します。必ず.で始まる形式で記述してください。 なし
content-type コンテンツタイプ属性です。拡張子に対応したコンテンツタイプを設定します。 なし

リスナ群設定

タグ名 listener
メール送信時に動作するリスナ群を指定します。

【設定項目】

<javamail-config>
  <listener>
    <listener-class></listener-class>
  </listener>
</javamail-config>

必須項目 ×
複数設定 ×
設定値・設定する内容 メール送信時に動作するリスナ群を指定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ javamail-config

リスナ設定

タグ名 listener-class
メール送信時に動作するリスナを指定します。
指定するリスナは、jp.co.intra_mart.foundation.mail.javamail.listener.MailSendListenerインタフェースを実装する必要があります。
デフォルトでは、半角カナを全角カナに変換する為のリスナ(jp.co.intra_mart.foundation.mail.javamail.listener.impl.HalfKanaTransrateListener)が設定されています。

【設定項目】

<javamail-config>
  <listener>
    <listener-class></listener-class>
  </listener>
</javamail-config>

必須項目
複数設定
設定値・設定する内容 メール送信時に動作するリスナを指定します。
単位・型 文字列
省略時のデフォルト値 なし
親タグ listener

メールエンコード設定

タグ名 encode
ロケールに対応したメールエンコードに関する設定を行います。
locale属性が設定されていない要素は、ロケールに対応したメールエンコードが定義されていない場合に利用されるデフォルトの設定となります。

【設定項目】

<javamail-config>
  <encode>
    <charset>UTF-8</charset>
    <mime-encoding>B</mime-encoding>
    <content-transfer-encoding>7bit</content-transfer-encoding>
  </encode>
</javamail-config>

必須項目 ×
複数設定
設定値・設定する内容 ロケールに対応したメールエンコードに関する設定を行います。
親タグ javamail-config

【属性】

属性名 説明 必須 デフォルト値
locale ロケールIDを指定します。 × なし

文字コード設定

タグ名 charset
文字コードの指定を行います。

【設定項目】

<javamail-config>
  <encode>
    <charset>UTF-8</charset>
    ...
  </encode>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容 文字コードの指定を行います。
単位・型 文字列
省略時のデフォルト値 なし
親タグ encode

MIMEエンコード設定

タグ名 mime-encoding
MIMEエンコードの指定を行います。
指定可能な値は B または Q です。

【設定項目】

<javamail-config>
  <encode>
    ...
    <mime-encoding>B</mime-encoding>
    ...
  </encode>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容 MIMEエンコードの指定を行います。
単位・型 文字列
省略時のデフォルト値 なし
親タグ encode

ボディエンコード設定

タグ名 content-transfer-encoding
ボディのエンコードの指定を行います。
7bit または 8bit 、 Quoted Printable等の値を指定します。

【設定項目】

<javamail-config>
  <encode>
    ...
    <content-transfer-encoding>7bit</content-transfer-encoding>
  </encode>
</javamail-config>

必須項目
複数設定 ×
設定値・設定する内容 ボディのエンコードの指定を行います。
単位・型 文字列
省略時のデフォルト値 なし
親タグ encode

«  メールモジュール   ::   コンテンツ   ::   Webモジュール  »