メールサービスからのドキュメントのインポート

電子メールのメールボックスから ABBYY Vantage にメールの添付ファイルをアップロードできます。必要に応じて、メール本文のインポートを有効にすることも可能です。Input アクティビティブロックにより、Vantage は単一のメールフォルダーにアクセスします。 Skill が設定され公開されると、ABBYY Vantage は指定されたメールフォルダーを1分ごとにチェックします。新着メールは次のように処理されます。

• メールに添付ファイルがある場合、メール内のすべての添付ファイルを対象に新しいトランザクションが作成されます。
• メール本文のインポートが有効な場合、メール本文は HTML 形式に変換され、同じトランザクションに追加されます。Vantage は、第一レベルの埋め込みメールおよびそれらの添付ファイルも処理します。

次のデータがトランザクションの登録パラメーターに保存されます: *これらのパラメーターにはメールアドレスのみが保存されます。送信者および受信者の名前は保存されません。

Note: Vantage は空の値のパラメーターを作成しません。たとえば、メールに件名がない場合、そのトランザクションには EmailSubject 登録パラメーターは作成されません。

ソースタイプ（MailImport）およびソースファイル名は、ドキュメント登録パラメーター SourceType と SourceFileName に保存されます。 ドキュメントおよびトランザクションの登録パラメーターの値には、Skill Monitor の Transactions セクションに対応する列を追加するとアクセスできます。これらは、抽出結果の完全なデータを含む出力 JSON ファイルにもエクスポートされます。これは Output アクティビティの Exported Data セクションで設定できます。トランザクション登録パラメーターは Vantage API からも利用可能です。

Note: ファイル名には次の文字は使用できず、アップロード時にアンダースコアに置換されます: / : ? # [ ] @ ! $ & ' ( ) * + , ; = \。元のファイル名はドキュメント登録パラメーターに保存されます。これらはこのスクリプトを使用して取得できます。

添付ファイルのいずれかの形式がサポート対象外の場合、トランザクションはエラーで終了し、その中の他のすべてのドキュメントの処理は中断されます。具体的なエラーメッセージは Skill Monitor の Error log セクションで確認できます。メールに添付ファイルがなく、メール本文のインポートが無効な場合、トランザクションは作成されませんが、そのメールは処理済みと見なされます。 処理済みのメールは完全に削除されるか、ユーザーが指定した専用フォルダーに移動されます。この動作はメールボックス接続の設定時に構成できます。インポートできなかったメールは、ユーザー指定の例外フォルダーに移動されます。

Note: メールが正常にインポートされた後にトランザクションが失敗した場合、そのメールは Processed フォルダーに移動されます。

Tip: ABBYY Vantage は 1 回のインポート手順で最大 50 通のメールをインポートできます。50 通を超える新着メールがある場合、Vantage は最古の 50 通のみをインポートします。残りは後続のメールインポート手順で取り込まれます。インポートは 1 分ごとに実行されます。これがパフォーマンスのボトルネックになる場合は、各自のメールフォルダーを持つ 2 つの Skill を作成することを検討してください。これにより、2 つのエージェントが同時にファイルを取得できます。

Vantage がインポートフォルダーにアクセスできない場合、Skill Monitor の Error log セクションで確認できるエラーが生成されます。

1. ドキュメント処理フローで Input アクティビティブロックを左クリックします。まだ Skill Designer に追加していない場合は、Activities ペインから追加します。
2. Actions ペインで Select additional source を有効にし、Email を選択します。

3. Settings をクリックします。表示されたダイアログでアカウントタイプ（Microsoft／その他のアカウント）を選択し、Continue をクリックします。
4. アカウントにサインインします。

Microsoft アカウントのログインダイアログで、現在のアカウント（すでにサインイン済みの場合）を選択するか、別のアカウントを使用できます。認証に成功すると、ログインダイアログは閉じられます。

重要: Microsoft アカウントに初めてサインインする際、ABBYY Vantage は次の操作の許可を求めます。

• 仕事用または学校用アカウントでアプリにサインインする。
• プライマリのメール アドレスと基本的なユーザープロファイル データにアクセスする。
• ユーザーがアプリを使用していない時でも、ユーザーの詳細にアクセスおよび更新する。
• ユーザーのメールボックス内のメールにアクセス、更新、作成、削除する（ただし送信はしない）。

Tip: Exchange ハイブリッド構成を使用している場合は、メールボックスをオンプレミスから Exchange Online に移動してください。詳細な手順はこちらをご覧ください。

メールの認証情報（アドレスとパスワード）、IMAP サーバーアドレス、および IMAP ポート（既定は 993。通常は変更不要）を指定します。次に、Sign in をクリックします。 Vantage がサーバーに接続できない場合、アカウントのログインダイアログは開いたままで、すべての入力フィールドの横にアイコンが表示されます。 すべての情報が正しく指定されている場合でも、以下の理由により接続エラーが発生している可能性があります。

• メールサーバーが不審なログイン試行をブロックした。
  対処方法: メールを確認してください。ログイン試行のブロックに関する通知を受信している場合は、その試行がご自身によるものか確認してください。
• 2 要素認証を無効にした Google アカウント: 安全性の低いアプリのアクセスが制限されている。
  対処方法: 安全性の低いアプリへのアクセスを許可してください。必要に応じて、Vantage によるアクセス試行がご自身によるものか確認してください。
• アプリ固有のパスワードが必要なため、サーバーがパスワードを受け付けない。
  対処方法: Yahoo や Google（2 要素認証が有効）などの一部サービスでは、サードパーティアプリにアプリ固有のパスワードが必要です。該当サービスの手順に従ってパスワードを生成し、Input アクティビティブロックの設定にそのパスワードを指定してください。

認証に成功すると、ABBYY Vantage が接続したメールアドレスが Input Settings: Email ダイアログに表示されます。

5. Vantage がメールを取り込むフォルダーと、処理できなかったメール用のフォルダーを指定します。テナント内の他の Process skills でインポートフォルダーとして使用されているフォルダーは選択しないでください。複数の Process skills が同じ入力フォルダーにアクセスできる場合、どの Skill がメールを処理するかを制御できません。

注: Skill を公開すると、Vantage は指定したインポートフォルダー内に VantageProcessing フォルダーを作成します。メールは最初にこのサービスフォルダーに移動され、その後設定に従って処理されます。

6. 正常に処理されたメールに対して実行するアクションを選択します。完全に削除（既定）するか、特定のフォルダーに移動できます。Delete を選択した場合、削除されたメールを保存するフォルダーを指定する必要があります。

7. 必要に応じて、メール本文の取り込みを有効にします。
8. Save をクリックして設定を保存し、ダイアログボックスを閉じます。

Input アクティビティブロックを選択すると、当該アクティビティに接続されているメールアドレスが Actions ペインに表示されます。Actions ペインでメールアドレスの下にある Settings をクリックすると、設定ダイアログが開き、現在有効なメール取り込み設定を表示し、必要に応じて変更できます。また、このダイアログからメールアカウントをログアウトすることもできます。ログアウトすると、すべての設定がリセットされます。

重要: 設定の変更は、Skill を公開した後にのみ有効になります。

管理者は Skill Monitor サービスを使用してドキュメントのインポートを無効にできます。インポートを無効にしても、API 経由でこの Skill にドキュメントを取り込む処理には影響しません。 Skill を削除すると、ABBYY Vantage は指定したメールフォルダーのチェックを停止します。