Gmail 送受信シナリオ作成マニュアル

Copyright© 2022 NTT Advanced Technology Corp. All Rights Reserved.

目次

1. はじめに ............................................................................................. 1

2. 認証情報の設定 .................................................................................. 3

3. 受信シナリオ作成手順 ...................................................................... 7

メール管理タブのメール受信設定 ............................................................. 8
Gmail 受信設定 ............................................................................................ 9

4. 送信シナリオ作成手順 .................................................................... 15

5. ライブラリ・プロパティの一覧..................................................... 19i1.

はじめに

本書では、WinActor を使って Gmail を送受信するための、シナリオ作成手順について説明します。

プロトコル
WinActor を使ってメールを送受信する場合のプロトコルについて、次の表に示します。
表 1-1 プロトコル

No.

プロトコル

説明❶ POP3S (受信時)

POP3 over SSL/TLS。
POP3 の伝送路を、SSL/TLS と組み合わせて暗号化するためのプロトコル。

❷ SMTPS (送信時)SMTP over SSL/TLS。
SMTP の伝送路を、SSL/TLS と組み合わせて暗号化するためのプロトコル。

認証方式
WinActor でサポートしている Gmail の認証方式は、送受信時のいずれも OAuth2 認証です。

制限事項
メール送受信をするにあたっての制限事項は以下の通りです。
•認証方式は OAuth2 に固定されていますので、ユーザ ID とパスワードを使った認証はサポートされておりません。

•Gmail を送受信するには、シナリオを実行する前に、認証の設定が必要です。認証情報はシナリオに含まれませんので、WinActor がインストールされた PC ごとに認証の設定が必要になります。

•認証情報は、WinActor がインストールされた PC ごとに 1 組のみ設定できます。異なるシナリオに異なる認証情報を適用することはできません。

1また、シナリオ実行前の事前準備として認証情報の設定が必要ですが、この時 Windows OSの既定の Web ブラウザが自動的に呼び出されます。
認証情報の設定に対応している Web ブラウザは、以下の通りです。
•Microsoft Edge Chromiun 版•

Google Chrome•

Mozilla Firefox2

2.

認証情報の設定
認証情報の取得

認証情報の取得には、GoogleWorkspace のアカウントと、Google Cloud Platform(GCP)の利用設定、および GCP 上での OAuth2 認証に関する設定が必要です。
詳細は GoogleWorkspace の管理者にお問い合わせください。

認証情報の設定
Steps

1.

WinActor を起動後、メニューバーの［ツール］－［Google サインイン］をクリックします。

3

2.

Google サインイン画面が開きます。
クライアント ID、クライアントシークレット、
ユーザ ID、ユーザ名を入力します。
入力後、［サインイン］をクリックします。

No.

項目名

❶ クライアント ID

入力内容
GoogleWorkspace 管理者から入手した認証情報に含まれます。

❷ クライアントシークレッ GoogleWorkspace 管理者から入手した認証情報に含まれまトす。

❸ ユーザ ID(メールアドレ GoogleWorkspace で利用可能なユーザのメールアドレスでス)❹ ユーザ名(オプション)す。
認証時のアカウントとして参照される他、WinActor がメールを送受信する時の送受信者アドレスとなります。
ユーザ ID に対応するユーザ名です。
メールを送信する時の送信者名として利用されます。
省略することが可能です。省略するとメール送信時に送信者名は空となります。

4

3.

Web ブラウザが起動し、Google の認証画面が表示されます。
Gmail に関する権限を要求されていることを確認し、［許可］をクリックします。

「WinActor OAuth2 認証ツール」の表示は、GoogleWorkspace の設定によって変わりますので、詳細は管理者にお問い合わせください。

5

4.

正常に認証されると、Web ブラウザに『認証を許可、または、キャンセルしました。このウィンドウはこのまま閉じることができます。
』のメッセージが表示されますので、Web ブラウザを閉じます。
エラーが発生する場合は、Google サインイン画面の入力内容に誤りがないか、通信の設定に誤りがないかを確認し、サインインしなおしてください。
通信の設定については、『2.3 認証時の通信』を参照してください。

5.

認証が完了後、Google サインイン画面の［アクセストークン］および［リフレッシュトークン］が『設定済み』と表示されていることを確認します。

認証時の通信認証時の通信は、Web ブラウザを通して行うものと、WinActor 本体を通して行うものが連携します。
Web ブラウザの通信設定は Windows OS の「インターネットオプション」を参照し、WinActor の通信設定は［ツール］―［オプション］―［プロキシ］の設定を参照しますので、それぞれを適切に設定してください。

6

3.

受信シナリオ作成手順
ライブラリの表示

パレットエリアのライブラリタブを選択し、「20_メール関連」とその配下に存在する「03_WinActor メール管理」を順にダブルクリックして展開します。
図 3-1 ライブラリの表示

7

Gmail の受信設定
Gmail 受信を行うには、Gmail 受信設定を下記のいずれかで行う必要があります。
•

メール管理タブのメール受信設定•

Gmail 受信設定ノード

Gmail 受信ノードを実行する前に、Gmail 受信設定が行われていない場合や、メール保存先に指定したフォルダが存在しない場合は、Gmail 受信で失敗となります。

「添付ファイルの保存について」
初期値では添付ファイルを保存しない設定となっています。添付ファイルも受信する場合は、「添付ファイルを保存する」にチェックを付けてください。
また、添付ファイルを保存する場合でも、初期値では「*.exe *.bat *.vbs *.msi *.jar」が保存対象外となっています。
保存する場合は、「次の拡張子の添付ファイルは保存しない」のチェックを外すか、「拡張子入力欄」の指定を変更してください。

メール管理タブのメール受信設定
メール管理タブのメール受信設定については、『WinActor メール受信シナリオ作成マニュアル』の『メール管理タブのメール受信設定』を参照してください。

なお、メール管理タブで設定できる項目のうち、Gmail の受信では、以下の項目が参照されません。
Google サインインで設定した値、または Gmail 受信専用の設定値が適用されます。
•ホスト名

•

ユーザ名

•パスワード

•

認証方式

•

ポート番号

•

接続の保護

8

Gmail 受信設定
この章では、Gmail 受信設定ノードを使用した Gmail 受信設定方法について記載します。
Gmail 受信設定は、シナリオ実行中のみ有効となります。シナリオ実行完了後は、メール管理タブの設定が有効になります。

Steps

1.

Gmail 受信設定ノードを配置します。
ライブラリエリアから「Gmail 受信設定」を選択し、シナリオに配置します。
このライブラリを実行することで、Gmail 受信に関する設定をします。

9

2.

シナリオに配置した Gmail 受信設定ノードをダブルクリックしてプロパティを表示します。
プロパティの「接続設定」タブ、「保存設定」タブ、「取得条件設定」タブの各項目を設定して、［更新］をクリックします。

10プロパティの項目の説明を次の表に示します。
表 3-1 「Gmail 受信設定(接続設定)」のプロパティ項目一覧

No.

プロパティ項目❶ 接続タイムアウト

説明
メール受信サーバに接続する際のタイムアウト時間を設定します。（デフォルトは 10,000 ミリ秒）
※21,000 ミリ秒を超える時間を設定した場合、タイムアウト時間は 21,000 ミリ秒になります。

（デフォ❷ メール受信タイムアウト メール受信する際のタイムアウト時間を設定します。
ルトは 10,000 ミリ秒）
表 3-2 「Gmail 受信設定(保存設定)」のプロパティ項目一覧

No.

プロパティ項目❶ メール保存場所

説明
受信したメールを保存するフォルダを指定します。

❷ 添付ファイルを保存する チェックが入っている場合に添付ファイルを保存します。
❸ 次の拡張子の添付ファイ チェックが入っている場合、該当する拡張子の添付ファイル
ルは保存しないは保存しなくなります。
※「添付ファイルを保存する」にチェックが入っている場合にのみ有効となる項目です。

11No.

プロパティ項目❹ 拡張子入力欄

説明「次の拡張子の添付ファイルは保存しない」で指定する拡張子入力欄です。
拡張子の指定は「*.(任意の拡張子)」で行います。半角スペー
スが区切り文字となり、半角スペースで複数の拡張子を指定できます。

表 3-3 「Gmail 受信設定(取得条件設定)」のプロパティ項目一覧

No.

プロパティ項目❶ 項目

説明
メールの取得条件の項目を下記から選択します。
SUBJECT

メールの件名

TO

メールの宛先アドレス

FROM

メールの送信元アドレス❷ 設定値

条件の内容を 40 文字以内で記載します。

❸ 条件

No1,2 に対する取得条件を下記から選択します。
一致する

完全一致を含む部分一致で始まる

先頭文字列として一致で終わる

末尾文字列として一致

正規表現

正規表現として一致❹ 追加

No1,2,3 の組み合わせをルール一覧に追加します。

❺ 更新

ルール一覧から選択した情報を更新します。

❻ 削除

ルール一覧から選択した情報を削除します。

❼ ルール一覧

追加した取得条件を表示します。
※すべての条件を満たすメールを受信します。

12

Gmail 受信Steps

1.

2.

ライブラリから「Gmail 受信」を選択し、シナリオに配置します。
このライブラリを実行することで、Gmail 受信サーバに対して、メール受信の要求を行います。

シナリオに配置した Gmail 受信ノードをダブルクリックしてプロパティを表示します。
各プロパティ項目を設定して、［更新］をクリックします。

13

プロパティの項目の説明を次の表に示します。
表 3-4 「Gmail 受信」のプロパティ項目一覧

No.

プロパティ項目❶ 取得方式

説明
取得方式について下記より選択します。
1 件ずつ取得

サーバ上にあるメールを 1 件ずつ取得します。

全取得

サーバ上にある全メールを取得します。

メール数取得のみサーバ上にあるメール数のみ取得します。

❷ 取得メール数

取得メール数を格納する「変数名」を指定します。

❸ 受信メールなしの場合受信メールが 0 件だった場合の動作について、下記より選択します。
受信待ち受信があるまで待機します。

エラーを返すエラー応答を返します。

メール数を返すメール数を返します。
（0 件）

以降、操作したい内容に応じて、「20_メール関連」からライブラリをシナリオに配置します。

受信したメールに対する操作は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

14

4.

送信シナリオ作成手順
Gmail 送信設定

Gmail 送信を行うには、Gmail 送信設定を「Gmail 送信設定」ノードで行う必要があります。
Gmail 送信設定ノードを実行する前に、Gmail 送信を行うと、既定の設定で送信が行われます。

Steps

1.

Gmail 送信設定ノードを配置します。
ライブラリエリアから「Gmail 送信設定」を選択し、シナリオに配置します。
このライブラリを実行することで、Gmail 送信に関する設定をします。

15

2.

シナリオに配置した Gmail 送信設定ノードをダブルクリックしてプロパティを表示します。
各プロパティ項目を設定して、［更新］をクリックします。

プロパティの項目の説明を次の表に示します。
表 4-1 「Gmail 送信設定」のプロパティ項目一覧

No.

プロパティ項目❶ 接続タイムアウト

説明
メール送信サーバに接続する際のタイムアウト時間を設定します。（デフォルトは 10,000 ミリ秒）
※21,000 ミリ秒を超える時間を設定した場合、タイムアウト時間は 21,000 ミリ秒になります。

（デフォ❷ メール送信タイムアウト メール送信する際のタイムアウト時間を設定します。
ルトは 10,000 ミリ秒）

メールの送信者情報には、認証設定時に入力したユーザ ID（差出人メールアドレス）およびユーザ名（差出人名）が適用されます。

また、Gmail 送信設定ノード実行前に Gmail 送信を実行した場合、プロパティの値は、それぞれのデフォルト値（10,000 ミリ秒）となります。

16

Gmail 送信
Steps

1.

2.

ライブラリから「Gmail 送信」を選択し、シナリオに配置します。
このライブラリを実行することで、Gmail 送信サーバに対して、メール送信の要求を行います。

シナリオに配置した Gmail 送信ノードをダブルクリックしてプロパティを表示します。
各プロパティ項目を設定して、［更新］をクリックします。

17

プロパティの項目の説明を次の表に示します。
表 4-2 「Gmail 送信」のプロパティ項目一覧

No.

プロパティ項目説明❶ 宛名（オプション）

メール宛先の宛名（名前）のテキストを設定します。
この項目は省略可能です。省略すると、宛先にはメールアドレスだけが設定されます。

❷ 宛先メールアドレス

メール宛先のメールアドレスを設定します。

❸ 件名

メールの件名を設定します。

❹ 本文メールの本文を設定します。

18

5.

ライブラリ・プロパティの一覧
Gmail 受信設定

Gmail 受信に関する設定をさせる際に使用します。プロパティ項目は『3.2.2 Gmail 受信設定』を参照してください。

Gmail 受信
Gmail を受信させる際に使用します。プロパティ項目は『3.3 Gmail 受信』を参照してください。

Gmail 送信設定
Gmail 送信に関する設定をさせる際に使用します。プロパティ項目は『4.1 Gmail 送信設定』を参照してください。

Gmail 送信
Gmail を送信させる際に使用します。プロパティ項目は『4.2 Gmail 送信』を参照してください。

メール選択メール選択は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

メール情報取得
メール情報取得は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

メールフォルダ同期
Gmail 受信は、メールフォルダ同期に対応していません。Gmail 受信ノードを使用してメールを受信してください。

19

メール削除メール削除は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

メール情報コピー
メール情報コピーは、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

メール状態変更
メール状態変更は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

添付ファイル名取得
添付ファイル名取得は、WinActor メールの機能で可能です。
『WinActor メール受信シナリオ作成マニュアル』を参照してください。

20

WinActor Gmail 送受信シナリオ作成マニュアル
Copyright© 2022 NTT Advanced Technology Corp. All Rights Reserved.
本書は著作権法上の保護を受けています。本書の一部あるいは全部を無断で複写、複製することは禁じられています。
本マニュアルの内容は予告なく変更される場合があります。
WA7-Z-20220208