POP3 New transporter

POP3 New transporter( server : Object ) : 4D.POP3Transporter

引数	型		説明
server	Object	→	メールサーバー情報
戻り値	4D.POP3Transporter	←	POP3 transporter オブジェクト

履歴

リリース	内容
18 R2	追加

説明

POP3 New transporter コマンドは、新規のPOP3 接続を設定します。このPOP3 接続は、server 引数の指定に応じて設定され、コマンドは新しいPOP3 transporter オブジェクトを返します。 返される transporter オブジェクトは通常、メールの受信に使用されます。

server 引数として、以下のプロパティを持つオブジェクトを渡します:

server	デフォルト値 (省略時)
.acceptUnsecureConnection : Boolean 暗号化されていない接続の確立が許可されてれば true	false
.accessTokenOAuth2: Text .accessTokenOAuth2: Object OAuth2 認証の資格情報を表すテキスト文字列またはトークンオブジェクト。 authenticationMode が OAUTH2 の場合のみ使用されます。 accessTokenOAuth2 が使用されているが authenticationMode が省略されていた場合、OAuth2 プロトコルが使用されます (サーバーで許可されていれば)。 これは*SMTP transporter* オブジェクトでは返されません。	なし
.authenticationMode : Text メールサーバーのセッションを開くのに使用される認証モード	サーバーがサポートするもっともセキュアな認証モードが使用されます
.connectionTimeOut : Integer サーバー接続の確立までに待機する最長時間 (秒単位)	30
.host : Text ホストサーバーの名前または IPアドレス	mandatory
.logFile : Text メール接続に対して定義された拡張ログファイル (あれば) へのフルパス	なし
.password : Text サーバーとの認証のためのユーザーパスワード。 これは*SMTP transporter* オブジェクトでは返されません。	なし
.port : Integer メール通信に使用されるポート番号	995
.user : Text メールサーバーでの認証に使用されたユーザー名	なし

戻り値

この関数はPOP3 transporter オブジェクト を返します。 返されるプロパティはすべて 読み取り専用 です。

POP3接続は、transporter オブジェクトが消去された時点で自動的に閉じられます。

例題

 var $server : Object
 $server:=New object
 $server.host:="pop.gmail.com" // 必須
 $server.port:=995
 $server.user:="4d@gmail.com"
 $server.password:="XXXXXXXX"
 $server.logFile:="LogTest.txt" // Logsフォルダーに保存するログ

 var $transporter : 4D.POP3Transporter
 $transporter:=POP3 New transporter($server)

 $status:=$transporter.checkConnection()
 If(Not($status.success))
    ALERT("メール受信中にエラーが発生しました: "+$status.statusText)
 End if