電子メール繰り返し

このステップは、アプリケーションをレコーダー ビューで開き、選択した電子メール フォルダから 1 つのメッセージを表示します。

メッセージのデータは、テーブル ビューとツリー ビューで使用できます。

このステップは、電子メール フォルダ内のメッセージを 1 つずつ反復処理するループ ステップとして機能します。イテレーションを行うたびに、次のメッセージのために抽出されたデータでビューの内容が更新されます。すべてのメッセージのイテレーションが完了する (またはロボットが例外やブレーク ステップによってループを終了する) と、アプリケーションは自動的に閉じます。また、ロボットが実行を停止した場合にもアプリケーションは閉じます。

ロボットは、ループ ステップと同様に、イテレーション変数、および続行ステップとブレーク ステップを使用してループの実行を制御できます。

[電子メール繰り返し] ステップを設定して出力を表示するには、次の手順を実行します。

プロパティ

[電子メール繰り返し] ステップで、次のプロパティを設定します。

プロパティ 説明

アプリケーション名

アプリケーションの名前を入力します。

アクセス

リストから、電子メール サーバーに接続するためのプロトコルを選択します。

imap+tls オプションは、便宜的な TLS を必要とする電子メール サーバー用です。

エンドポイント

MS Graph プロトコルにのみ適用されます。

  • デフォルトでは、標準エンドポイントが表示されます。

  • エンドポイントを別の Graph クラスタに設定するか、URL 内の「me」を、事前定義されたユーザー ID に置き換えることもできます。

Microsoft Graph API エンドポイント URL を指定するには、ボックスに URL を入力するか、貼り付けます。

電子メール サーバー

POP3 および IMAP プロトコルにのみ適用されます。

電子メール サーバーの名前またはアドレスを入力します。

電子メール サーバー ポート (オプション)

POP3 および IMAP プロトコルにのみ適用されます。

電子メール サーバーのポート番号を指定するには、[電子メール サーバー ポート] チェックボックスをオンにします。

指定しない場合は、選択したプロトコルのデフォルトのポートが使用されます。

メールボックスのパス (オプション)

MS Graph および IMAP プロトコルにのみ適用されます。

電子メール サーバー上の受信トレイ以外のフォルダを選択するには、このオプションを使用します。

  • 受信メールが保管されているフォルダを自動的に開くには、このチェックボックスをオフにします。

  • 電子メール サーバー上で開くフォルダの名前を指定するには、[メールボックスのパス] チェックボックスをオンにし、ネストされたフォルダのパスを、パス内の各要素をスラッシュで区切って入力します。

    例: Junk E-Mail、Subscriptions/Mailing lists.

アカウント

POP3 および IMAP プロトコルにのみ適用されます。

電子メールの受信に使用する、電子メール サーバー上のアカウント (通常は電子メール アドレス) を入力します。

認証

電子メール サーバーにログインするためのクレデンシャルを設定します。

  • IMAP プロトコルは、電子メール プロバイダの要件に適合するパスワード認証および OAuth 認証をサポートしています。

  • POP3 プロトコルはパスワード認証のみをサポートしています。

  • MS Graph API は OAuth のみをサポートしています。

認証方法を [パスワード] 認証または [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 ページとして開きます。

メッセージを移動

選択したメッセージを、指定したターゲット フォルダに移動します。

「電子メール プロトコルの制限」を参照してください。

メッセージを既読にする

メッセージに既読または未読のフラグを立てます。

メッセージに既読というマークを付けるには [既読] ボックスをオンにし、未読というマークを付けるにはこのボックスをオフにします。

添付ファイルを取得

添付ファイルのバイナリ データを取得し、変数に保存します。

必要なデータを取得するには、次のプロパティを設定します。

  • インデックス: 抽出する添付ファイルの、0 から始まるインデックス。

  • 添付ファイル データ: 結果の添付ファイル データを格納するバイナリ変数。

電子メール プロトコルの制限

POP3 および POP3S プロトコルを使用する場合は、次の制限があります。

  • ほとんどの POP3 サーバーでは、メッセージをダウンロードするとメッセージが削除されます。

    想定される動作では、ロボットを再実行すると、最初の実行で取得されたメッセージはレコーダー ビューには表示されません。ただし、メール プログラムではメッセージが引き続き表示される場合があります。

  • 一部の POP3 サーバーには、他のインターフェイスの POP3 接続を介して行われた変更が反映されません。

    たとえば、ロボットが POP3 プロトコルを使用して Gmail アカウントからのメッセージを削除した場合でも、Web ブラウザ インターフェイスには引き続きそのメッセージが表示されることがあります。ロボットの場合、メッセージは削除されます。

  • メッセージを削除ステップを実行するとメッセージに削除のマークが付きますが、アプリケーションを閉じるまでメッセージはサーバー上に残ります。

  • 「既読」または「未読」フラグ (コンポーネント アクション) は設定できません。

  • メッセージのコピーや移動はサポートされていません。

電子メールの出力

[レコーダー ビュー] で [電子メール繰り返し] ステップの出力を確認します。出力は、次の情報を含む表形式で表示されます。

  • 送信者: John Doe <j.doe@organization.com> という形式の送信者。

  • 件名: メッセージの件名。

  • 受信済み: 2026-05-17T15:27:33+01:00 (ISO-8601) という形式の、メッセージが受信された日付。

  • サイズ: メッセージのサイズはバイトで表記されます。

  • 添付ファイルあり: メッセージに添付ファイルがあるかどうかを示します

  • 既読: メッセージが既読としてマークされているかどうかを示します。

  • 添付ファイルの数: 添付ファイルの数。

メッセージを含むツリーおよびテーブルには、ステップの実行後に発生した電子メール フォルダへの変更 (メッセージの移動や削除など) は反映されません。