機械翻訳について
  1. Oracle Content Managementでのコンテンツのキャプチャ
  2. プロシージャの設定
  3. キャプチャ設定の構成
  4. インポート・プロセッサ・ジョブの構成
  5. 電子メール・インポート用のGoogle Mail (OAuth)の設定

電子メール・インポート用のGoogle Mail (OAuth)の設定

Google Mail OAuthを使用して受信電子メール・メッセージに添付されているファイルを件名や本文テキストなどの電子メール・メッセージ要素とともにコンテンツ・キャプチャにインポートするようにインポート・プロセッサを構成できます。 インポートされた各電子メール・メッセージはバッチとなり、バッチ内の別のドキュメントとして作成された添付、メッセージ本文や電子メール・メッセージ全体などの電子メール要素を持ちます。

Google (OAuth)電子メール・インポートを設定するために必要なことは次のとおりです:

Google Mailアプリケーションの作成用のリダイレクトURLの取得

Google Mailアプリケーションを構成するには、接続先のOracle Content Managementインスタンスのコンテンツ取得ホスト名および認可URLの詳細が必要です。

リダイレクトURLを取得するには:

  1. 管理者としてOracle Content Managementにサインインし、左側のナビゲーション・メニューで「取得」をクリックします。
  2. 「プロシージャの取得」ページでプロシージャを選択し、「取得」タブに移動します。

  3. 「プロセッサ・ジョブのインポート」表で、インポート・プロセッサ・ジョブの追加をクリックして「新規ジョブの作成」をクリックします。

  4. 「一般設定」ページで次のようにします:
    1. 「インポート・ジョブ名」フィールドに名前を、「バッチ接頭辞」フィールドに接頭辞を入力します。 インポートされたバッチはこの接頭辞を使用して名前が付けられ、その名前の後に、新たなバッチごとに増分される数字が続きます。
    2. 「インポート・ソース」フィールドで、「電子メール・ソース」が選択されていることを確認します。
  5. 「インポート・ソース設定」ページの「接続プロトコル」セクションで、Google Mail (OAuth)を選択します。

    リダイレクトURLが表示されます。 フォーマットがhttps://<hostname>.<domainname>:<port>/capture/admin/faces/completeAuthorizationであるこのURLをコピーします。 URLにポートが含まれている場合も含まれていない場合もあります。 ポートがない場合、URLは次の形式になります : https://<hostname>.<domainname>/capture/admin/faces/completeAuthorization

    ノート:

    入力内容を送信したり、このページから移動したりしないでください。 Google Mailアプリケーションを作成し、クライアントIDとクライアント・シークレットを取得した後、このページを「Googleメールの構成OAuth」に戻す必要があります。 これらを「クライアントID」および「クライアント・シークレット」フィールドに入力するためです。

電子メール・インポート用のGoogle Mailアプリケーションの構成

Google Mailアプリケーションを構成するには:

  1. 別のブラウザ・ウィンドウの「Google APIコンソール」に移動します。
  2. Google開発者コンソールですでに作成している場合、「Manage resources」ページにプロジェクトのリストが表示されます。 まだ行っていない場合、次を実行します:
    1. CREATE PROJECTをクリックします。
    2. プロジェクト名を入力します。
    3. コンソールでプロジェクトを簡単に識別できるように、EDITをクリックして意味のあるIDを入力して、「プロジェクトID」を編集します。
    4. 組織のリソースまたはフォルダを定義している場合、場所を選択する必要があります。 そうでない場合、デフォルトを受け入れ、「CREATE」をクリックします。

      プロジェクトが作成され、コンソールのプロジェクト・リストにリダイレクトされます。

  3. 左上隅にあるGoogle開発者ナビゲーション・アイコンをクリックし、「APIs &サービス」を選択してから、「ダッシュボード」を選択します。

    ノート:

    最近作成したプロジェクトのダッシュボードが表示されない場合、左上隅のドロップダウン・リストからプロジェクトを選択します。
  4. 左側のサイドバーで、「ライブラリ」をクリックして「APIライブラリ」ページに移動します。 次に、「Gmail API」ライブラリを検索し、これを有効にします。
  5. 左上隅のGoogle開発者ナビゲーション・アイコンをクリックし、「APIs &サービス」、「OAuth承諾画面」の順に選択します。 OAuth承諾画面でターゲット・ユーザーを選択して、「CREATE」をクリックします。
  6. アプリケーション登録の編集ページで、「OAuth consent screen」タブで次のようにします:
    • 「App name」フィールドで、製品名(Gmail Appなど)を入力します。
    • 「User support email」ドロップダウン・リストで、ユーザー・サポート用の電子メール・アドレスを選択します。
    • 「開発者の連絡先情報」セクションまでスクロール・ダウンし、「Eメール・アドレス」フィールドに電子メール・アドレスを入力します。
    • 「保存と連絡先」をクリックします。
  7. 「Scopes」タブで、次のようにします:
    1. 「SCOPESの追加または削除」をクリックします。
    2. 「選択したスコープの更新」セクションで、次のGMail APIスコープのチェック・ボックスを選択するか、「スコープの手動追加」ボックスにこれらのスコープを手動で入力し、ADD TO TABLEをクリックします。 次に、UPDATEをクリックします。
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/gmail.modify
      • https://www.googleapis.com/auth/userinfo.profile
    3. 「保存と連絡先」をクリックします。

      userinfo.emailおよびuserinfo.profileスコープが「非機密スコープ」セクションに表示され、gmail.modifyスコープが「スコープ」タブの「制限されたスコープ」セクションに表示されます。

  8. 「テスト・ユーザー」タブで、「保存と連絡先」をクリックします。
  9. 「サマリー」タブで、設定を確認して「ダッシュボードに戻る」をクリックできます。
  10. 「ステータスのパブリッシュ」で、「テスト中」セクションで「公開アプリ」をクリックし、「本番環境にプッシュしますか。」ダイアログで「確認」をクリックしてアプリケーションを公開します。
  11. 左側のバーで「Credentials」をクリックして、次を実行します:
    1. 「資格証明」ページで、CREATE CREDENTIALSをクリックし、「OAuthクライアントID」を選択します。
    2. 「アプリケーション・タイプ」ドロップダウン・リストで、「Webアプリケーション」を選択します。
    3. Gmail OAuth App Clientなど、クライアントに名前を付けます。
    4. 「許可されたリダイレクトURI」で、ADD URIをクリックし、取得プロシージャからコピーしたリダイレクトURLを貼り付けます。
    5. 「承認済JavaScript起点」で、ADD URIをクリックしてリダイレクトURLを貼り付けますが、URIにポートが含まれている場合は、ドメインの後またはポートの後にすべてを削除します。
    6. 「作成」をクリックします。

      クライアントIDおよびクライアント・シークレット値が「OAuth client created」ダイアログに表示されます。 これらの値をメモして「OK」をクリックします。

      次に、Oracle Content ManagementのContent Captureに戻り、離れた場所を開始します。 つまり、クライアントIDとシークレットを「Googleメールの構成OAuth」に入力することから始めます。

キャプチャ電子メール・インポートのためのGoogleメールOAuth

GoogleメールOAuthの電子メール・インポート・プロセッサ・ジョブ設定を構成するには:

  1. プロシージャおよび「左から開始」に戻ります。
  2. 「電子メール・アカウント」タブで、Google Mail (OAuth)接続プロトコルを選択しました。 次に、「クライアントID」および「クライアント・シークレット」フィールドに、「Googleメール・アプリケーションの構成」時にコピーしたクライアントIDとシークレットを入力します。

  3. 「処理する電子メール・アカウント」表で、電子メール・アカウントの追加をクリックします。

  4. 電子メール・プロセッサ・ジョブに電子メール・アカウントへのアクセス権を付与するには、Googleメールのサインイン・ページで、使用する電子メールIDの電子メール・アドレスとパスワードを入力します。

  5. 「許可」をクリックして、選択した内容を確認します。

    電子メールIDは、「電子メール・アドレス」列の「処理する電子メール・アカウント」表に表示されます。 そのステータスは「検証済」になっているはずです。

    ここまでに実行したステップを使用して、この表に別のGoogleメールIDを追加できます。 EメールIDを削除するには、表内の行を選択し、電子メールIDの削除をクリックします。

  6. 「メッセージ・フィルタ」タブで、電子メール・メッセージおよび/または添付の場所およびその検索方法を指定します。

    1. 「処理するフォルダ」フィールドで、指定された電子メール・アカウントで検索する1つ以上のフォルダを入力します。 デフォルト値はサーバーの受信トレイです。 複数のフォルダを指定するには、フォルダを; (セミコロン)で区切ります。 サブフォルダを指定するには、/ (スラッシュ)やフォルダ/サブフォルダなど、メール・サーバーに適用可能なパス・デリミタを含めます。

    2. メッセージ・フィルタがジョブに適用されていないかぎり、デフォルトでコンテンツ・キャプチャは、指定されたフォルダ内のすべての電子メールを処理します。 必要に応じて、「メッセージ・フィルタ」表で、検索する電子メール要素ごとに「有効」フィールドを選択し、「フィールドの内容」フィールドに検索する文字を入力します。

      たとえば、件名またはメッセージ本文にpaymentという単語が含まれる電子メールを検索するには、両方の検索フィールドに「有効」を選択し、各「フィールドの内容」エントリにpaymentを含めて、「OR」検索演算子を選択します。

    3. 「検索演算子」フィールドで、指定されたメッセージ・フィルタに使用する検索演算子を選択します: And (デフォルト)は、すべての検索基準に一致する場合にのみインポートし、Orは、任意の検索基準に一致する場合にインポートします。

  7. 「処理」タブで、電子メール・メッセージとその添付の処理方法を指定します。 含める情報を指定し、電子メール優先度に基づいて、バッチに割り当てる優先度を指定します。

    1. 「電子メール・メッセージ・オプション」で、メッセージ本文ファイルをインポートするかどうかを指定します。 そのインポート形式(テキストまたはEML)と、添付が存在しない場合にそれを含めるかどうか、および電子メール・メッセージ全体(添付を含む)をEMLファイルとしてインポートするかどうかを指定します。

    2. 「これらのマスクと一致する添付を含める」フィールドで、ファイル・マスクに基づいて添付ファイルを指定します。 複数のファイル・マスクをカンマまたはセミコロンで区切って入力できます。 たとえば、すべてのPDFファイル(*.pdf)を含めることができます。

    3. 「これらのマスクと一致する添付ファイルを除外する」フィールドで、ファイル・マスクに基づいて除外する添付ファイルを指定します。 複数のファイル・マスクをカンマまたはセミコロンで区切って入力できます。

    4. オプションで、「添付がマスクと一致しない場合に常に後処理」、「これらのマスクに一致する添付を含める」および「これらのマスクに一致する添付を除外」を選択します。 このフィールドが有効で、添付ファイルが指定されたマスクと一致しない場合、電子メールのインポートは失敗とみなされ、Post-Processingタブの「インポート失敗時」フィールドで指定した設定に従って後処理が行われます。

      ノート:

      「添付がマスクと一致しない場合は、常に後処理する」フィールドは、「メッセージ本文ファイルのインポート」フィールドと「添付が存在しない場合に含める」フィールドの両方が有効になっている場合、無効になります。

    5. 「ドキュメントの順序付け」で、電子メール・メッセージからの要素(メッセージ本文や添付など)をインポート済バッチ内でドキュメントとして並べる順序を指定します。

    6. 「バッチ・ノートに含める」で、メッセージ要素(「受信日時」、「送信元アドレス」、「送信先アドレス」、「件名」、「メッセージ本文」など)を選択します。

    7. 「バッチ優先度」で、必要に応じて、電子メール優先度に基づいて新しい各バッチに優先度(低、中、高)を割り当てます。 たとえば、コンテンツ・キャプチャで優先度の高い電子メールにバッチ優先度8を割り当てる場合は、「高」フィールドに8を入力します。 優先度が割り当てられていない電子メールは中優先度とみなされます。

  8. 「後処理」タブで、インポートが成功または失敗した後の電子メール・メッセージの処理を指定します。 メッセージを削除したり、電子メール・アカウント内の指定のフォルダに移動したり、インポートが失敗した場合にメッセージが削除されないようにすることができます。 たとえば、ジョブを定期的に実行する場合は、正常にインポートされた電子メールを指定のフォルダに移動して、再度インポートされることがないようにします。

  9. 「インポート・プロセッサ・ジョブの追加または編集」の説明に従って、他のインポート・プロセッサ・ジョブ・ページを完了します。

これで、電子メール・インポート・ジョブをテストできます。 インポート・プロセッサによって、構成した電子メール・アカウントのメッセージがチェックされ、フォルダ内で一致する電子メールが検索されます。 一致するEメールが見つかった場合、インポート・プロセッサは、Eメール・メッセージからインポートされる文書ごとにバッチおよび文書を作成します。 オプションで、インポート・プロセッサによりメタデータ・フィールドに電子メール・メタデータが入力され、正常にインポートされたメッセージが削除されるか、フォルダに移動されます。

コンテンツ・キャプチャによって、「電子メール・アカウント」タブで構成した電子メール・アカウントから電子メールが定期的にフェッチされます。 ただし、特定の時点で電子メール・インポートをトリガーする場合は、「プロセッサ・ジョブのインポート」表で電子メール・インポート・ジョブを選択し、電子メールの確認アイコンをクリックします。 電子メール・インポート・ジョブがオフラインの場合、このアイコンは無効になります。