メール受信(POP3)処理

オペレーション名

メール受信(POP3)

機能概要

GmailのPOP3サーバからメールを受信します。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

プロパティ

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

基本設定

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

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。グローバルリソースの設定方法については、「グローバルリソースのプロパティ(接続先)」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
ユーザ名	必須	使用可	ユーザ名を入力します。	「<Google Workspaceのユーザー名>@<Google Workspaceドメイン名>」の形式で入力してください。
パスワード	必須	使用可	パスワードを入力します。

プロパティアクション

項目名	説明	備考
認証テスト	[ユーザ名]、[パスワード]を使用して認証テストを行います。	以下の場合には[認証テスト]は無効になります。 [ユーザ名]または[パスワード]が入力されていない場合 [ユーザ名]または[パスワード]にスクリプト変数が指定された場合

受信設定

項目名	必須/省略可	変数の使用	説明	備考
エンコード	省略可	使用可	メール受信時のエンコードを選択または入力します。 [日本語自動判別(JISAutoDetect)]:(デフォルト) [日本語(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)を参照してください。	[メッセージのエンコードを優先する]を[チェックあり]にした場合、メッセージのエンコードが優先されます。
メッセージのエンコードを優先する	省略可	使用不可	メール受信時に、メッセージに指定されているエンコードを優先するかどうかを選択します。 [チェックあり]:(デフォルト) メッセージにエンコード(Content-Typeヘッダのcharsetパラメータ)が指定されている場合は、メッセージで指定されたエンコードを使用します。それ以外の場合、[エンコード]の設定を使用します。 [チェックなし]: メッセージにエンコードが指定されているかにかかわらず、[エンコード]の設定を使用します。
新着順に受信する	省略可	使用不可	新着順にメッセージを受信するかどうかを選択します。 [チェックあり]: メッセージをメールサーバに届いた新しい順に取得します。最後に届いたメッセージを最初に取得します。 [チェックなし]:(デフォルト) メッセージをメールサーバに届いた古い順に取得します。最初に届いたメッセージを最初に取得します。
最大受信件数を設定する	省略可	使用不可	メッセージの最大受信件数を指定するかどうかを選択します。 [チェックあり]: 指定された件数を上限としてメッセージを受信します。 [チェックなし]:(デフォルト) すべてのメッセージを受信します。
最大受信件数	必須	使用可	メッセージの最大受信件数を指定します。たとえば、サーバにメッセージが100件格納されており、最大受信件数が10件に設定されている場合、先頭の10件のメッセージのみが受信され、残りの90件は未読の状態のままとなります。	[最大受信件数を設定する]を[チェックあり]にした場合、有効になります。
受信できないメッセージは読み飛ばす	省略可	使用不可	受信できないメッセージを受信した際の動作を選択します。 [チェックあり]: 受信できないメッセージは読み飛ばし、処理を継続します。 [チェックなし]:(デフォルト) 受信できないメッセージを受信した際には、エラーにします。	チェックを入れた場合には、メッセージ受信時にエラーが発生した際に、対象のメッセージの受信をスキップし、処理を継続します。接続できないホストを指定した場合などの接続時のエラーは、本プロパティにチェックを入れた場合でも処理が継続できないため、エラーとなります。受信できなかったメッセージはログレベル「WARN」でログに出力されます。
メールアドレスはアドレスのみ取得する	省略可	使用不可	メールアドレスが含まれるデータ(From、To、Cc、Reply-To)を取得する際に、「説明<メールアドレス>」の形式で取得するか「メールアドレス」の形式で取得するかを選択します。 [チェックあり]: 「メールアドレス」の形式で取得します。 [チェックなし]:(デフォルト) 「説明<メールアドレス>」の形式で取得します。	説明部がない場合には「メールアドレス」のみとなります。

添付ファイル

項目名	必須/省略可	変数の使用	説明	備考
添付ファイルを受信	省略可	使用不可	添付ファイルを受信するかどうかを選択します。 [チェックあり]:(デフォルト) メッセージに添付されたファイルを受信します。 [チェックなし]: メッセージに添付されたファイルを受信しません。
添付ファイル格納先	必須	使用可	添付ファイルを格納するディレクトリを入力します。 [参照]ボタンを押下するとディレクトリチューザが起動し、ディレクトリの選択ができます。格納された添付ファイルのパスは<格納先>/<メッセージID>/添付ファイル名になります。また、<メッセージID>はメールサーバで設定される可変値です。格納先パラメータは/tmpに設定してtest.txtファイルを添付して送った場合、以下のように生成されます。例:/tmp/18926678.1130237227441.JavaMail.account@mail.com/test.txt	デフォルト値は「/tmp」です。 [添付ファイルを受信]を[チェックあり]にした場合、有効になります。添付ファイル名・メッセージIDに「DataSpiderファイルシステムの禁止文字」またはタブが含まれる場合、「_」(半角アンダースコア)に変換して出力します。ファイルパスはDataSpiderファイルシステムの絶対パスで指定してください。パス区切り文字「/」以外のDataSpiderファイルシステムの使用禁止文字は使用できません。
添付ファイルに同じ名前のファイルが存在する場合	必須	使用不可	添付ファイルに同一名のファイルが存在する場合の動作を選択します。 [上書きする]:(デフォルト) ファイルを上書きします。 [連番を振る]: 「<ファイル名>_1.csv」のように連番を付けます。拡張子がある場合は、拡張子の前の名前に連番が付与されます。	[添付ファイルを受信]を[チェックあり]にした場合、有効になります。

ヘッダ

項目名	必須/省略可	変数の使用	説明	備考
ヘッダ一覧	省略可	-	取得するヘッダを指定します。	ヘッダを設定した場合のスキーマ情報はスキーマを参照してください。
ヘッダ一覧/ヘッダ	必須	使用可	取得するヘッダのキーを入力します。	ダブルバイトのキー値は対応していません。ヘッダ値がダブルバイトを含む場合には、ヘッダ値がRFC 2047準拠のエンコーディングがされている必要があります。

データ処理方式

項目名	必須/省略可	変数の使用	説明	備考
データ処理方式	必須	使用不可	データ処理方式を選択します。 [スクリプトの設定を使用する]:(デフォルト) スクリプトプロパティの大容量データ処理の設定をアダプタに使用します。 [大容量データ処理を行わない]: 大容量データ処理を行いません。 [大容量データ処理を行う]: 大容量データ処理を行います。

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

スキーマ

入力スキーマ

ありません。

出力スキーマ

<?xml version="1.0" encoding="UTF-8" ?>
 <table>
   <row>
     <column>メッセージID</column>
     <column>送信日付(受信日付)</column>
     <column>ヘッダ1</column>
     <column>ヘッダ2</column>
       :
     <column>差出人</column>
     <column>宛先</column>
     <column>CC</column>
     <column>BCC</column>
     <column>返信先</column>
     <column>件名</column>
     <column>Contetnt-Type</column>
     <column>本文</column>
     <column>添付ファイルパス</column>
   </row>
   <row>
     :
   </row>
 </table>

列名	説明	備考
メッセージID
送信日付(受信日付)
ヘッダ	[ヘッダ一覧]に定義したキーごとに出力されます。	1つのキーに対して複数の値が存在する場合には、カンマ(,)区切りで出力します。 [ヘッダ一覧]を定義していない場合には出現しません。
差出人		複数存在する場合には、カンマ(,)区切りで出力します。
宛先		複数存在する場合には、カンマ(,)区切りで出力します。
CC		複数存在する場合には、カンマ(,)区切りで出力します。
BCC		複数存在する場合には、カンマ(,)区切りで出力します。
返信先		複数存在する場合には、カンマ(,)区切りで出力します。
件名
Content-Type
本文
添付ファイルパス		複数存在する場合には、カンマ(,)区切りで出力します。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

詳細については、「スキーマ編集」を参照してください。

大容量データ処理

大容量データ処理に対応しています。

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のバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

仕様制限

GmailのPOP3サーバを使用するには、対象ユーザのGmailの設定でPOPを有効にする必要があります。
POPを有効にする方法についてやPOP3サーバの動作については、Gmailのヘルプを参照してください。

受信したメッセージを削除する・既読にするなどの設定は、対象ユーザのGmailの設定で行います。

受信したメッセージを再度受信したい場合は、対象ユーザのGmailの設定でPOPを再度有効にしてください。

分割された添付ファイルを連結することはできません。

添付ファイルはbase64形式のみ対応しています。BinHex形式やuuencode形式には対応していません。

Outlookからリッチテキスト形式の添付ファイル(Content-Type=application/ms-tnef)を送信すると、本アダプタでは正常に受信できません。

マルチパートは一段のみの取り扱いとなります
マルチパートメッセージを扱うことは可能ですが、ネストしたマルチパートメッセージは扱うことはできません。
以下の例1では、本アダプタはマルチパートの1番目を本文(body要素)として扱い、2番目以降を添付(attachedfiles要素の子要素のfile要素)として扱います。これは、受送信ともに同様です。

例1:ネストしていなマルチパート - (通常の添付形式)

----- バウンダリ 1 -----
メッセージ
----- バウンダリ 1 -----
メッセージ
----- バウンダリ 1 -----
メッセージ
------------------------

例2:ネストしたマルチパート - (OutlookでHTML形式 + 添付の場合や一部メーラーの転送メッセージ(message/rfc822))

----- バウンダリ 1 -----
----- バウンダリ 2 -----
メッセージ
----- バウンダリ 2 -----
メッセージ
----- バウンダリ 2 -----
メッセージ
------------------------
----- バウンダリ 1 -----
----- バウンダリ 3 -----
メッセージ
----- バウンダリ 3 -----
メッセージ
----- バウンダリ 3 -----
メッセージ
------------------------
----- バウンダリ 1 -----
----- バウンダリ 4 -----
メッセージ
----- バウンダリ 4 -----
メッセージ
----- バウンダリ 4 -----
メッセージ
------------------------
------------------------

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

一部の文字

文字文字コード(Unicode)

― 0x2014

～ 0x301C

∥ 0x2016

－ 0x2212

￠ 0x00A2

￡ 0x00A3

￢ 0x00AC
- JISメッセージ受信時:上記一部の文字はShift_JISコードにマッピングされます。後続の処理ではShift_JISで処理を行ってください。
- UTF-8メッセージ送信時:上記一部の文字はWindows31-Jコードにマッピングされます。後続の処理ではWindows31-Jで処理を行ってください。

文字	文字コード(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;

ヘッダの出現順番は保証できません。

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

BCCデータは取得できません。

主な例外

例外名	原因	対策
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[接続先]が指定されていません。	[接続先]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[接続先]で選択されたリソース定義が見つかりません。	[接続先]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException <プロパティ名>が指定されていません。	[<プロパティ名>]が指定されていません。	[<プロパティ名>]を指定してください。
java.io.UnsupportedEncodingException	[エンコード]に設定されたエンコードはサポートされません。	[エンコード]で指定したエンコードを確認してください。
javax.mail.AuthenticationFailedException: [SYS/PERM] Your account is not enabled for POP access. Please visit your Gmail settings page and enable your account for POP access.	Gmailの設定でPOPが有効になっていません。	対象ユーザのGmailの設定でPOPを有効にしてください。
javax.mail.AuthenticationFailedException: [AUTH] Username and password not accepted.	[ユーザ名]または[パスワード]が不正です。	[ユーザ名]または[パスワード]を確認してください。
com.sun.mail.util.MailConnectException:	GmailのPOP3サーバとの接続に失敗しました。	ネットワークを確認してください。

注意事項

GmailのPOP3サーバと本アダプタとの通信は、SSLを使用します。