1通メール送信処理

オペレーション名

1通メール送信

機能概要

SMTPサーバに1通のメールを送信します。

プロパティ

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明
接続先	必須	使用不可	グローバルリソースを選択します。グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
送信元メールアドレス	必須	使用可	送信元のメールアドレスを入力します。
送信先	必須	-	送信先のメールアドレスを入力します。各列は以下のボタンで操作することができます。 [追加]: 列を追加します。 [上へ]: 選択している列の順序を一つ上に上げます。 [下へ]: 選択している列の順序を一つ下に下げます。 [削除]: 列を削除します。
送信先/種類	必須	使用可	送信先の種類を選択します。 [TO]:(デフォルト) [CC]: [BCC]:
送信先/メールアドレス	必須	使用可	メールアドレスを入力します。

認証

項目名	必須/省略可	変数の使用	説明	備考
認証モード	必須	使用不可	メールを送信する際の認証モードを選択します。 [なし]:(デフォルト) 認証を行いません。 [POP before SMTP]: 送信する前にPOP3による認証を行います。 [SMTP認証(LOGIN)]: SMTP認証(LOGIN)方式の認証を行います。 [OAuth 2.0認証]: OAuth 2.0による認証を行います。	[POP before SMTP]を選択した場合、POPサーバとの接続タイムアウトは15秒です。 [OAuth 2.0認証]を選択した場合、[接続先]の[SSL接続]に[SSL/TLS]または[STARTTLS]を選択する必要があります。
ホスト名	必須	使用可	POPメールサーバのホスト名またはIPアドレスを入力します。	[認証モード]に[POP before SMTP]を選択した場合、有効になります。
ポート番号	必須	使用可	POPメールサーバにアクセスするためのポート番号を入力します。	デフォルト値は「110」です。 [認証モード]に[POP before SMTP]を選択した場合、有効になります。
ユーザ名	必須	使用可	POPメールサーバにアクセスするユーザ名、SMTP認証するためのユーザ名またはOAuth 2.0認証するためのユーザ名を入力します。	[認証モード]に[POP before SMTP]、[SMTP認証(LOGIN)]または[OAuth 2.0認証]を選択した場合、有効になります。
パスワード	必須	使用可	POPメールサーバにアクセスするためのパスワード、またはSMTP認証するためのパスワードを入力します。	[認証モード]に[POP before SMTP]または[SMTP認証(LOGIN)]を選択した場合、有効になります。
SSL接続	省略可	使用不可	POPメールサーバにSSL接続を行うかどうかを選択します。 [チェックあり]: SSL接続を行います。 [チェックなし]:(デフォルト) SSL接続は行いません。	[認証モード]に[POP before SMTP]を選択した場合、有効になります。 SSL接続方式はSSL/TLSです。 [チェックあり]を選択した場合、POP3サーバのサーバ証明書がDataSpiderServerの参照するキーストアにインポートされている必要があります。キーストアへのインポート方法については、「証明書のインポート」を参照してください。
認証(OAuth 2.0)	必須	使用不可	認証に使用するグローバルリソースを選択します。グローバルリソースの設定方法については、「グローバルリソースのプロパティ(OAuth 2.0)」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。	[認証モード]に[OAuth 2.0認証]を選択した場合、有効になります。

プロパティアクション

項目名	説明	備考
認証テスト	選択した[認証モード]で認証テストを行います。	[認証モード]に[POP before SMTP]、[SMTP認証(LOGIN)]または[OAuth 2.0認証]を選択した場合、有効になります。以下の場合には[認証テスト]は無効になります。 [認証モード]に[POP before SMTP]または[SMTP認証(LOGIN)]を選択した場合 [ホスト名]または[ポート番号]、[ユーザ名]、[パスワード]が入力されていない場合 [ホスト名]または[ポート番号]、[ユーザ名]、[パスワード]にスクリプト変数が指定された場合 [認証モード]に[OAuth 2.0認証]を選択した場合 [ユーザ名]または[認証(OAuth 2.0)]が入力されていない場合 [ユーザ名]にスクリプト変数が指定された場合

メッセージ

項目名	必須/省略可	変数の使用	説明	備考
件名	省略可	使用可	件名を入力します。
本文	省略可	使用可	本文を入力します。
Content-Type	省略可	使用可	Content-Typeを選択または入力します。 [text/plain]:(デフォルト) [text/html]:	省略した場合には、「text/plain」で送信します。charsetパラメータは[エンコード]の値を設定します。
エンコード	省略可	使用可	メール送信時のエンコードを選択または入力します。 [日本語(JIS)]:(デフォルト) [日本語(シフトJIS)]: [日本語(EUC)]: [US-ASCII]: [ISO 8859-1]: [UTF-8]: [EUC-KR]: 入力する場合は、Java SE Runtime Environment 8でサポートされているエンコードを指定します。詳細については、「Supported Encodings」(http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html)を参照してください。	省略した場合には、「UTF-8」で送信します。

添付ファイル

項目名	必須/省略可	変数の使用	説明	備考
添付ファイル	省略可	-	添付ファイルのファイルパスを指定します。各列は以下のボタンで操作することができます。 [追加]: 列を追加します。 [上へ]: 選択している列の順序を一つ上に上げます。 [下へ]: 選択している列の順序を一つ下に下げます。 [削除]: 列を削除します。
添付ファイル/ファイルパス	必須	使用可	添付ファイルのファイルパスを入力します。	ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。

返信先

項目名	必須/省略可	変数の使用	説明	備考
返信先	省略可	-	返信先のメールアドレスを指定します。各列は以下のボタンで操作することができます。 [追加]: 列を追加します。 [上へ]: 選択している列の順序を一つ上に上げます。 [下へ]: 選択している列の順序を一つ下に下げます。 [削除]: 列を削除します。
返信先/返信先メールアドレス	必須	使用可	メールアドレスを入力します。

ヘッダ

項目名	必須/省略可	変数の使用	説明	備考
ヘッダ一覧	省略可	-	メール送信時に付与するヘッダを指定します。
ヘッダ一覧/ヘッダ	必須	使用可	メール送信時に付与するヘッダのキーを入力します。	ダブルバイトのキー値は対応していません。
ヘッダ一覧/値	必須	使用可	メール送信時に付与するヘッダの値を入力します。	値にダブルバイト文字が含まれる場合には、値はRFC 2047準拠のエンコーディングが行われます。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

スキーマ

入力スキーマ

ありません。

出力スキーマ

ありません。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
count	送信したメールの件数が格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンにより、格納される内容が変わる可能性があります。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。 DataSpider Servistaのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

添付ファイルへのcharsetパラメータ付与設定

テキスト形式の添付ファイルを送信した場合、Content-TypeのcharsetパラメータにOSのデフォルトエンコーディングが設定されます。
以下のプロパティを設定することによって、添付ファイルのContent-Typeにcharsetパラメータを付与しないようにすることができます。

キー	配置場所	説明	備考
mail.mime.setdefaulttextcharset	$DATASPIDER_HOME/server/conf/ system.properties	[true]: テキスト形式のファイルを添付した場合に、デフォルトのcharsetパラメータを付与します。 [false]: テキスト形式のファイルを添付した場合に、デフォルトのcharsetパラメータを付与しません。	デフォルト値は「true」で、省略した場合は「true」が設定されます。

仕様制限

機種依存文字や一部の文字を扱う場合には注意が必要です。

一部の文字
以下の一部の文字を送信する場合には、UTF-8で送信してください。

文字文字コード(Unicode)

― 0x2014

～ 0x301C

∥ 0x2016

－ 0x2212

￠ 0x00A2

￡ 0x00A3

￢ 0x00AC

文字	文字コード(Unicode)
―	0x2014
～	0x301C
∥	0x2016
－	0x2212
￠	0x00A2
￡	0x00A3
￢	0x00AC

機種依存文字(CP932)
以下の機種依存文字を受送信する場合にはUTF-8で受送信を行ってください。

文字	文字コード(Unicode)
①	0x2460;
②	0x2461;
③	0x2462;
④	0x2463;
⑤	0x2464;
⑥	0x2465;
⑦	0x2466;
⑧	0x2467;
⑨	0x2468;
⑩	0x2469;
⑪	0x246A;
⑫	0x246B;
⑬	0x246C;
⑭	0x246D;
⑮	0x246E;
⑯	0x246F;
⑰	0x2470;
⑱	0x2471;
⑲	0x2472;
⑳	0x2473;
Ⅰ	0x2160;
Ⅱ	0x2161;
Ⅲ	0x2162;
Ⅳ	0x2163;
Ⅴ	0x2164;
Ⅵ	0x2165;
Ⅶ	0x2166;
Ⅷ	0x2167;
Ⅸ	0x2168;
Ⅹ	0x2169;
㍉	0x3349;
㌔	0x3314;
㌢	0x3322;
㍍	0x334D;
㌘	0x3318;
㌧	0x3327;
㌃	0x3303;
㌶	0x3336;
㍑	0x3351;
㍗	0x3357;
㌍	0x330D;
㌦	0x3326;
㌣	0x3323;
㌫	0x332B;
㍊	0x334A;
㌻	0x333B;
㎜	0x339C;
㎝	0x339D;
㎞	0x339E;
㎎	0x338E;
㎏	0x338F;
㏄	0x33C4;
㎡	0x33A1;
㍻	0x337B;
〝	0x301D;
〟	0x301F;
№	0x2116;
㏍	0x33CD;
℡	0x2121;
㊤	0x32A4;
㊥	0x32A5;
㊦	0x32A6;
㊧	0x32A7;
㊫	0x32AB;
㈱	0x3231;
㈲	0x3232;
㈹	0x3239;
㍾	0x337E;
㍽	0x337D;
㍼	0x337C;
≒	0x2252;
≡	0x2261;
∫	0x222B;
∮	0x222E;
∑	0x2211;
√	0x221A;
⊥	0x22A5;
∠	0x2220;
∟	0x221F;
⊿	0x22BF;
∵	0x2235;
∩	0x2229;
∪	0x222A;
ⅰ	0x2170;
ⅱ	0x2171;
ⅲ	0x2172;
ⅳ	0x2173;
ⅴ	0x2174;
ⅵ	0x2175;
ⅶ	0x2176;
ⅷ	0x2177;
ⅸ	0x2178;
ⅹ	0x2179;
￢	0xFFE2;
￤	0xFFE4;
＇	0xFF07;
＂	0xFF02;

RFC2231形式のエンコーディングの一部のフォーマットが読めません。添付ファイルのファイル名に日本語が含まれる場合には、RFC2231形式でエンコーディングを行うのですが、ファイル名が長い場合には扱えない場合があります。
例:

filename*1=...
filename*2=...

設定したヘッダの出現順番や位置は保証できません。

ヘッダ値が空文字もしくはnullの場合にはヘッダはメッセージに含まれません。

個々の添付ファイルにContent-Typeを設定することはできません。

テキスト形式の添付ファイルを送信した場合、Content-TypeのcharsetパラメータにOSのデフォルトエンコーディングが設定されます。charsetパラメータの値を個別に設定することはできません。
- このため、添付ファイルのエンコーディングによってはcharsetパラメータのエンコーディングと一致せず、一部メーラーで添付ファイルの内容をプレビューしたときに文字化けが発生することがあります。
  その際、添付ファイルのContent-Typeにcharsetパラメータが付与されないようにすることで文字化けを回避できる場合があります。
  設定方法については、「添付ファイルへのcharsetパラメータ付与設定」を参照してください。

PGP、S/MIMEには対応していません。

APOP認証、CRAM-MD5認証、NTLM認証、Kerberos認証には対応していません。

主な例外

例外名	原因	対策
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[接続先]または[認証(OAuth 2.0)]が指定されていません。	[接続先]または[認証(OAuth 2.0)]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[接続先]または[認証(OAuth 2.0)]で選択されたリソース定義が見つかりません。	[接続先]または[認証(OAuth 2.0)]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
RecipientsNotFoundException	[送信先]が不正です。	以下のことを確認してください。 [送信先]が1つ以上設定されているか [送信先/種類]が正しいか [送信先/メールアドレス]が入力されているか [送信先/メールアドレス]にマルチバイト文字を含むメールアドレスが指定されていないか
java.io.UnsupportedEncodingException	[エンコード]に設定されたエンコードはサポートされません。	[エンコード]で指定したエンコードを確認してください。
javax.mail.AuthenticationFailedException:	[ユーザ名]または[パスワード]が不正です。	[ユーザ名]または[パスワード]を確認してください。
com.sun.mail.util.MailConnectException: ConnectException	[ホスト名]で指定したホストとの接続に失敗しました。	[ホスト名]、[ポート番号]を確認してください。また、[ホスト名]で指定したホストでサービスが提供されているかどうかを確認してください。
com.sun.mail.util.MailConnectException: UnknownHostException	[ホスト名]で指定したホストが見つかりません。	[ホスト名]で指定したホスト名を確認してください。
javax.mail.SendFailedException	送信に失敗しました。	[送信先/メールアドレス]を確認してください。
javax.mail.SendFailedException Invalid Addresses	送信に失敗しました。	[送信先/メールアドレス]を確認してください。メールアドレスが正しい場合でも、メールサーバがエラーを返した場合にこの例外が発生することがあります。
com.sun.mail.smtp.SMTPSendFailedException	送信に失敗しました。	メッセージの内容を確認して対策を行ってください。
javax.mail.MessagingException: SSLHandshakeException	グローバルリソースの[SSL接続]の値に[SSL/TLS]、または[STARTTLS]のどちらかが選択されており、サーバ証明書の信頼性が検証できなかった場合に発生します。	SSL接続を行うサーバの証明書がJavaに登録されているか確認してください。登録されている場合、接続先のサーバがJavaに登録したサーバと同一か、または接続先のサーバ証明書の有効期限が切れていないか確認してください。
OAuth2AuthenticationFailedException OAuth 2.0認証に失敗しました。	[ユーザ名]または[認証(OAuth 2.0)]が不正です。	[ユーザ名]または[認証(OAuth 2.0)]を確認してください。