電子メール繰り返し
このステップは、アプリケーションをレコーダー ビューで開き、選択した電子メール フォルダから 1 つのメッセージを表示します。
メッセージのデータは、テーブル ビューとツリー ビューで使用できます。
このステップは、電子メール フォルダ内のメッセージを 1 つずつ反復処理するループ ステップとして機能します。イテレーションを行うたびに、次のメッセージのために抽出されたデータでビューの内容が更新されます。すべてのメッセージのイテレーションが完了する (またはロボットが例外やブレーク ステップによってループを終了する) と、アプリケーションは自動的に閉じます。また、ロボットが実行を停止した場合にもアプリケーションは閉じます。
ロボットは、ループ ステップと同様に、イテレーション変数、および続行ステップとブレーク ステップを使用してループの実行を制御できます。
[電子メール繰り返し] ステップを設定して出力を表示するには、次の手順を実行します。
プロパティ
[電子メール繰り返し] ステップで、次のプロパティを設定します。
| プロパティ | 説明 |
|---|---|
|
アプリケーション名 |
アプリケーションの名前を入力します。 |
|
アクセス |
リストから、電子メール サーバーに接続するためのプロトコルを選択します。 imap+tls オプションは、便宜的な TLS を必要とする電子メール サーバー用です。 |
|
エンドポイント |
MS Graph プロトコルにのみ適用されます。
Microsoft Graph API エンドポイント URL を指定するには、ボックスに URL を入力するか、貼り付けます。 |
|
電子メール サーバー |
POP3 および IMAP プロトコルにのみ適用されます。 電子メール サーバーの名前またはアドレスを入力します。 |
|
電子メール サーバー ポート (オプション) |
POP3 および IMAP プロトコルにのみ適用されます。 電子メール サーバーのポート番号を指定するには、[電子メール サーバー ポート] チェックボックスをオンにします。 指定しない場合は、選択したプロトコルのデフォルトのポートが使用されます。 |
|
メールボックスのパス (オプション) |
MS Graph および IMAP プロトコルにのみ適用されます。 電子メール サーバー上の受信トレイ以外のフォルダを選択するには、このオプションを使用します。
|
|
アカウント |
POP3 および IMAP プロトコルにのみ適用されます。 電子メールの受信に使用する、電子メール サーバー上のアカウント (通常は電子メール アドレス) を入力します。 |
|
認証 |
電子メール サーバーにログインするためのクレデンシャルを設定します。
認証方法を [パスワード] 認証または [OAuth] 認証のいずれかに設定します。 |
|
パスワード |
[パスワード] 認証を選択し、パスワードを入力するか、貼り付けます。 |
|
OAuth |
詳細については、「Vault」と「OAuth クライアント」を参照してください。 [OAuth] 認証を選択します。 [Vault 検索] で、Management Console [Vault] から取得した OAuth アクセス トークンの使用方法を選択します。
|
|
リストから |
Management Console で自動的に取得されたトークンの中から 1 つを選択します。 リストには、ラベルとターゲット システムが表示されます。 たとえば、「user @ box」は、ターゲット システム「box」の「user」というラベルが付いたトークンを表します。 Vault にトークンを追加する際に、更新されたリストを表示するには、Design Studio 内の Management Console を更新する必要がある場合があります。 |
|
手動 |
[ラベル] と [ターゲット システム] を指定して、トークンを手動で定義します。 |
|
ラベル |
アクセス トークンの [ラベル] を入力します。 「ラベル」を参照してください。 |
|
ターゲット システム |
ターゲット システムを入力するか、貼り付けます。 「ターゲット システム」を参照してください。 |
|
取得バッチ サイズ (オプション) |
1 回の呼び出しで電子メール サーバーから取得するメッセージの数を制御します。 デフォルト値は 100 です。 イテレーションごとに 1 つのメッセージを表示するループには影響を及ぼしません。 ステップの実行時にエラーが発生した場合にのみ、設定値を次のように変更してください。
|
|
イテレーション変数 (オプション) |
イテレーション データを格納する変数を指定します。 |
コンポーネント アクション
[電子メール繰り返し] ステップでは、次のコンポーネント アクションを使用できます。
|
アクション |
説明 |
|---|---|
|
メッセージをコピー |
選択したメッセージを指定したターゲット フォルダにコピーします。 「電子メール プロトコルの制限」を参照してください。 |
|
メッセージを削除 |
電子メール メッセージを削除します。 |
|
メッセージの内容を取得 |
RFC 822 形式のメッセージとヘッダーを含む文字列値を返します。 |
|
メッセージを HTML として開く |
Chromium 組み込みブラウザを使用して、電子メールを HTML Web ページとして開きます。 |
|
メッセージを移動 |
選択したメッセージを、指定したターゲット フォルダに移動します。 「電子メール プロトコルの制限」を参照してください。 |
|
メッセージを既読にする |
メッセージに既読または未読のフラグを立てます。 メッセージに既読というマークを付けるには [既読] ボックスをオンにし、未読というマークを付けるにはこのボックスをオフにします。 |
|
添付ファイルを取得 |
添付ファイルのバイナリ データを取得し、変数に保存します。 必要なデータを取得するには、次のプロパティを設定します。
|
電子メール プロトコルの制限
POP3 および POP3S プロトコルを使用する場合は、次の制限があります。
-
ほとんどの POP3 サーバーでは、メッセージをダウンロードするとメッセージが削除されます。
想定される動作では、ロボットを再実行すると、最初の実行で取得されたメッセージはレコーダー ビューには表示されません。ただし、メール プログラムではメッセージが引き続き表示される場合があります。
-
一部の POP3 サーバーには、他のインターフェイスの POP3 接続を介して行われた変更が反映されません。
たとえば、ロボットが POP3 プロトコルを使用して Gmail アカウントからのメッセージを削除した場合でも、Web ブラウザ インターフェイスには引き続きそのメッセージが表示されることがあります。ロボットの場合、メッセージは削除されます。
-
メッセージを削除ステップを実行するとメッセージに削除のマークが付きますが、アプリケーションを閉じるまでメッセージはサーバー上に残ります。
-
「既読」または「未読」フラグ (コンポーネント アクション) は設定できません。
-
メッセージのコピーや移動はサポートされていません。
電子メールの出力
[レコーダー ビュー] で [電子メール繰り返し] ステップの出力を確認します。出力は、次の情報を含む表形式で表示されます。
-
送信者: John Doe <j.doe@organization.com> という形式の送信者。
-
件名: メッセージの件名。
-
受信済み: 2026-05-17T15:27:33+01:00 (ISO-8601) という形式の、メッセージが受信された日付。
-
サイズ: メッセージのサイズはバイトで表記されます。
-
添付ファイルあり: メッセージに添付ファイルがあるかどうかを示します
-
既読: メッセージが既読としてマークされているかどうかを示します。
-
添付ファイルの数: 添付ファイルの数。
メッセージを含むツリーおよびテーブルには、ステップの実行後に発生した電子メール フォルダへの変更 (メッセージの移動や削除など) は反映されません。