Application Integration でサポートされているコネクタをご覧ください。

Doc AI - Operation タスク

Doc AI - オペレーション タスクを使用すると、Document AI プロセッサでの長時間実行オペレーション(LRO)のステータスを確認できます。Document AI プロセッサは、バッチ処理リクエストを送信するたびに LRO を作成します。

Cloud Document AI は、自然言語、コンピュータ ビジョン、翻訳、AutoML などの最先端の Google AI を使用して、非構造化ドキュメントまたは半構造化ドキュメントから構造化された情報を解析できる Google Cloud サービスです。

始める前に

Doc AI - オペレーションタスクを構成する前に、Google Cloud プロジェクトで次のタスクを行う必要があります。

  1. Doc AI - オペレーション タスクを構成する前に、Google Cloud プロジェクトで Cloud Document AI API(documentai.googleapis.com)を有効にします。

    Cloud Document AI API を有効にする

  2. 認証プロファイルを作成します。Apigee Integration は、認証プロファイルを使用して、Doc AI - オペレーション タスクの認証エンドポイントに接続します。

    サービス アカウントへの追加のロールや権限の付与については、アクセス権の付与、変更、取り消しをご覧ください。

Doc AI - オペレーション タスクを構成する

  1. Google Cloud コンソールで [Application Integration] ページに移動します。

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。

    統合デザイナーで統合が開きます。

  4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
  5. 統合デザイナーで [Doc AI - Operation] 要素をクリックして配置します。
  6. デザイナーで [Doc AI - Operation] 要素をクリックして、[Doc AI - Operation] タスク構成ペインを表示します。
  7. [Authentication] に移動し、使用する既存の認証プロファイルを選択します。

    省略可。タスクを構成する前に認証プロファイルを作成していない場合は、[+ New authentication profile] をクリックし、新しい認証プロファイルを作成するに記載されている手順に沿って操作します。

  8. [Task Input] に移動し、次の「タスクの入力パラメータ」の表を使用して表示される入力フィールドを構成します。

    入力フィールドの変更は自動的に保存されます。

タスクの入力パラメータ

次の表に、Doc AI - オペレーション タスクの入力パラメータを示します。

プロパティデータ型説明
Region 文字列プロセッサの Cloud Document AI ロケーション。例: us - 米国。
ProjectsId文字列Google Cloud プロジェクト ID。
OperationId文字列オペレーションの ID。この ID は、オペレーションの名前の最後の要素です。

タスク出力

Doc AI - オペレーション タスクは、次のサンプル出力のような長時間実行オペレーション(LRO)の詳細を返します。

{
    "name": "projects/[PROJECT_ID]/locations/[LOCATION]/operations/[OPERATION_ID]",
    "metadata": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessMetadata",
        "state": "SUCCEEDED",
        "stateMessage": "Processed 1 document(s) successfully",
        "createTime": "TIMESTAMP",
        "updateTime": "TIMESTAMP",
        "individualProcessStatuses": [
        {
            "inputGcsSource": "[INPUT_BUCKET_FOLDER]/DOCUMENT1.ext",
            "status": {},
            "outputGcsDestination": "OUTPUT_BUCKET_FOLDER/[OPERATION_ID]/0",
            "humanReviewStatus": {
            "state": "ERROR",
            "stateMessage": "Sharded document files are not supported for human review."
            }
        }
        ]
    },
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessResponse"
    }
}
    

エラー処理方法

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式の使用方法と、さまざまな種類のエラー処理方式の詳細については、エラー処理の方式をご覧ください。

次のステップ

  1. エッジとエッジの条件を追加する。
  2. インテグレーションをテストして公開する。
  3. トリガーを構成する。
  4. データ マッピング タスクを追加する。
  5. Google Cloud サービス向けのすべてのタスクを確認する。