Skip to main content
メールボックスからメールの添付ファイルを ABBYY Vantage にインポートし、必要に応じてメール本文も含めることができます。Input アクティビティは、Skill ごとに 1 つのメールフォルダーにアクセスします。
Skill の公開後、Vantage は指定されたメールフォルダーを 1 分ごとに確認します。
Vantage は新着メールをそれぞれ次のように処理します。
  • メールに添付ファイルがある場合、そのメール内のすべての添付ファイルに対して 1 つの新しいトランザクションが作成されます。
  • メール本文のインポートが有効な場合、メール本文は HTML に変換され、同じトランザクションに追加されます。Vantage は、第 1 階層の埋め込みメールとその添付ファイルも処理します。
Vantage が 1 回の確認でインポートするメールは最大 50 件です。待機中のメールが 50 件を超える場合は、最も古い 50 件をインポートし、残りは以降の確認時に取り込みます。
処理量がボトルネックになる場合は、それぞれに専用のメールフォルダーを割り当てた 2 つの Skill に作業を分けると、2 つのエージェントが並行してメールを取り込めます。

トランザクション登録パラメーター

Vantage は、次のデータをトランザクション登録パラメーターに保存します。 ** Vantage が保存するのはメールアドレスのみで、送信者名や宛先名は保存されません。*
Vantage では、値が空のパラメーターは作成されません。たとえば、メールに件名がない場合、そのトランザクションには EmailSubject 登録パラメーターは作成されません。
Vantage は、ソースの種類 (MailImport) とソースファイル名を、ドキュメント登録パラメーター SourceType と SourceFileName に保存します。 ドキュメントおよびトランザクションの登録パラメーターを確認するには、Skill Monitor の Transactions セクションで対応する列を追加します。 Vantage はこれらを出力 JSON ファイルにもエクスポートします (Output activity の Exported Data セクションで設定します) 。また、トランザクション登録パラメーターは Vantage API からも利用できます。 ファイル名には次の文字を使用できません。ファイルのアップロード時に、Vantage はこれらの文字をそれぞれアンダースコアに置き換えます: / : ? # [ ] @ ! $ & ' ( ) * + , ; = \。Vantage は元のファイル名をドキュメント登録パラメーターに保存します。カスタム アクティビティのサンプル スクリプトを使用して取得してください。

インポート結果

添付ファイルの形式がサポートされていない場合、トランザクションは失敗し、そのトランザクション内のほかのすべてのドキュメントの処理も停止します。詳細なエラーは、Skill Monitor の Error log セクションで確認してください。 メールに添付ファイルがなく、本文のインポートがオフになっている場合、Vantage はトランザクションを作成しませんが、そのメールは処理済みとしてマークします。 Vantage は、処理済みのメールを完全に削除するか、メールボックス接続の設定時に指定したフォルダーに移動します。インポートできないメールは、指定した例外フォルダーに移動されます。
メールのインポートには成功してもトランザクションが失敗した場合、そのメールは Processed フォルダーに配置されます。
Vantage がインポート フォルダーにアクセスできない場合は、Skill Monitor の Error log セクションにエラーが記録されます。

ABBYY Vantage に Microsoft Graph へのアクセスを許可する

組織内のユーザーが Sign in with Microsoft Graph を使用できるようにするには、事前に Microsoft 365 の管理者が PowerShell スクリプトを 1 回実行する必要があります。このスクリプトは、ABBYY Vantage のエンタープライズ アプリケーションが Microsoft Entra テナントにまだ登録されていない場合に、これを追加します。続いて、テナント内のすべてのユーザーに代わって、ABBYY Vantage に必要な権限を付与します。 Sign in with Microsoft または Sign in with other email account のみを使用する場合、スクリプトを実行する必要はありません。 スクリプトを実行するには、Microsoft Entra ID でクラウド アプリケーション管理者以上のロールを持つアカウントが必要です。詳細については、Grant or revoke API permissions programmatically を参照してください。
1

Microsoft Graph PowerShell SDK をインストールする

コンピューターに SDK がインストールされていない場合は、インストールします。詳細については、Install the Microsoft Graph PowerShell SDK を参照してください。
2

テナント ID を確認する

Microsoft Entra テナントの ID をコピーします。詳細については、How to find your tenant ID を参照してください。
3

スクリプトを実行する

PowerShell で次のスクリプトを実行します。<your-tenant-id> はお使いのテナント ID に置き換えてください。プロンプトが表示されたら、管理者アカウントでサインインし、Microsoft Graph PowerShell が要求する権限を承諾します。
このスクリプトは、ABBYY Vantage に次の委任されたアクセス許可を付与します:openid、profile、email、offline_access、User.Read、Mail.ReadWrite、Mail.ReadWrite.Shared、IMAP.AccessAsUser.All。テナント内に ABBYY Vantage の権限付与が既に存在する場合は、スクリプトによって更新されます。そのため、スクリプトを再実行しても問題はありません。
スクリプトの実行が完了すると、組織内のユーザーは Sign in with Microsoft Graph を使用してメールボックスを接続できるようになります。

メールからのインポートを設定する

1

Input アクティビティを開く

ドキュメント処理フローで Input アクティビティブロックをクリックします。フローに Input アクティビティがまだない場合は、Activities ペインから追加してください。
2

追加のソースとして Email を選択する

操作ペインで Select additional source をオンにし、Email を選択します。
Email オプションが選択された Input アクティビティの操作ペイン

追加の Input ソースとして Email を選択

3

設定を開いてアカウントの種類を選択する

Settings をクリックすると、Input Settings: Email ダイアログが開きます。アカウントの種類を選択し、Continue をクリックします。選択できるアカウントの種類は、Sign in with Microsoft、Sign in with Microsoft Graph、Sign in with other email account です。Sign in with Microsoft Graph は、お使いの環境で Microsoft Graph が有効になっている場合にのみ表示されます。
4

アカウントにサインインする

次のいずれかの方法でサインインします。詳しくは、Microsoft アカウントに接続する、Microsoft Graph で接続する、またはその他のメールアカウントに接続するを参照してください。
5

インポート フォルダーと例外フォルダーを指定する

サインインすると、ダイアログに Select required folders が表示されます。Import folder で、Vantage がメールをインポートする元のフォルダーを選択します。Exception folder for emails that could not be imported で、Vantage がインポートできなかったメールの保存先フォルダーを選択します。Skill を公開すると、指定したインポート フォルダー内に Vantage によって VantageProcessing フォルダーが作成されます。メールはまずこのサービスフォルダーに移動され、その後、設定に従って Vantage で処理されます。
テナント内の別の Process skill で使用しているインポート フォルダーは選択しないでください。複数の Skill で同じインポート フォルダーを共有すると、どの Skill がどのメールを処理するかを制御できなくなります。
6

処理済みメールに対するアクションを選択する

What to do with successfully imported emails で Delete を選択すると、処理済みメールが完全に削除されます。Delete は既定値で、フォルダーを指定する必要はありません。処理済みメールを残しておく場合は、Move to a folder を選択します。必須の field である Folder for successfully imported emails が表示されるので、移動先のフォルダーを選択してください。
Input Settings: Email ダイアログのフォルダーセクション。正常にインポートされたメールに対して Move to a folder が選択され、Folder for successfully imported emails field が表示されている

Input Settings: Email ダイアログのフォルダーおよび処理後の設定

7

(オプション)メール本文のインポートを有効にする

Import mail body は既定でオフになっています。メール本文もインポートする場合はオンにします。本文は Vantage によって HTML に変換され、添付ファイルと同じトランザクションに追加されます。
8

保存する

Save をクリックすると、設定が保存され、ダイアログが閉じます。
Input ブロックを選択すると、アクティビティに接続されているメールアドレスが操作ペインに表示されます。現在のメールからのインポート設定を確認または変更するには、メールアドレスの下にある Settings をクリックします。メールアカウントの接続を解除するには、Input Settings: Email ダイアログで Sign out をクリックします。設定の変更は、Skill を公開するまで反映されません。
メールアカウントからサインアウトすると、すべての設定がリセットされます。

Microsoft アカウントへの接続

Microsoft のサインインダイアログで、すでにサインイン済みの場合は現在のアカウントを選択するか、別のアカウントを使用します。認証に成功すると、サインインダイアログが閉じます。 Microsoft アカウントで初めてサインインする際、Vantage は次の許可を求めます。
  • 仕事用または学校用アカウントでアプリにサインインする。
  • プライマリのメール アドレスと基本的なユーザープロファイル データにアクセスする。
  • ユーザーがアプリを使用していない時でも、ユーザーの詳細にアクセスおよび更新する。
  • ユーザーのメールボックス内のメールにアクセス、更新、作成、削除する (ただし送信はしない) 。
Exchange ハイブリッド構成を使用している場合は、メールボックスをオンプレミスから Exchange Online に移動してください。Microsoft のメールボックス移行ガイドをご覧ください。

Microsoft Graph で接続する

Sign in with Microsoft Graph は、IMAP ではなく Microsoft Graph API を使用して Microsoft 365 のメールボックスに接続します。Microsoft 365 のメールボックスには、この方法をお勧めします。メールサーバーのアドレスやポートを入力する必要はありません。 組織内のユーザーがこのオプションを使用するには、事前に Microsoft 365 の管理者がセットアップスクリプトを 1 回実行しておく必要があります。詳細については、ABBYY Vantage に Microsoft Graph へのアクセスを許可するを参照してください。 メールボックスを所有する Microsoft アカウントにサインインします。認証に成功するとサインインダイアログが閉じ、フォルダーの選択に進みます。 Microsoft Graph でも、他のアカウントの種類と同じ形式の添付ファイルをインポートし、同じ方法で処理します。 サインインには成功したものの Vantage がメールボックスにアクセスできない場合は、ダイアログに HTTP 403 が表示されます。これは、アカウントへのサインインは完了していても、Vantage が必要とするメールボックスの権限がそのアカウントにないことを示しています。 Input Settings: Email ダイアログにこのオプションが表示されない場合は、お使いの環境で Microsoft Graph が有効になっていません。ABBYY アカウントチームにお問い合わせください。

他のメールアカウントに接続する

メールアドレスとパスワード、IMAP サーバーのアドレス、および IMAP ポートを指定します。デフォルトのポートは 993 で、通常は変更する必要はありません。Sign in をクリックします。 Vantage がサーバーに接続できない場合、アカウントのサインインダイアログは開いたままになり、入力フィールドの横にエラーアイコンが表示されます。
接続エラーアイコンが表示された Input Settings: Email ダイアログ

Input Settings: Email ダイアログに表示されるメール接続エラーのインジケーター

入力した情報がすべて正しい場合、接続エラーの原因は通常、次のいずれかです。 認証に成功すると、接続されたメールアドレスが Input Settings: Email ダイアログに表示されます。

インポートの無効化

管理者は、Skill Monitor でドキュメントのインポートを無効にできます。メールからのインポートを無効にしても、API 経由のドキュメントのインポートには影響しません。

Skill 削除時のクリーンアップ

Skill を削除すると、Vantage はその Skill のメールフォルダーの監視を停止します。