ビュー:

動作:
Natif.aiからインテリジェント文書処理(IDP)を呼び出す目的でDocuWareワークフローをセットアップしています。
PDF文書がWorkflow Designer(Web-Serviceタイムアウト=60秒)とNatif.ai(処理タイムアウト=120秒)のデフォルトの時間範囲内で処理されません。
以下のガイドを参照すると、Natif.ai プロセスを非同期で呼び出す DocuWare ワークフローをセットアップできます。
注意：現在、Natif.ai / Intelligent Document Processing はPDF 文書しか処理できません！PDFを含む電子メールは、Natif.aiのエンドポイントに送信する前にPDFに変換する必要があります！

これらのページには、以下のプロセスに関する重要な情報が含まれています：

  1. DocuWare Connect to Intelligent Document Processing
  2. 処理APIエンドポイント
  3. 高度なレスポンス処理
  4. 処理結果と成果物のフェッチ
  5. 同期と非同期の使い分け

解決策：
大きなPDF文書を処理するには、Natif.aiエンドポイントを非同期で呼び出す必要があります。このKBAでは、デフォルトの非同期DocuWare Workflowを示すステップを示します。
「ベストプラクティス」のDocuWare Workflowは次のようになります。

プロセスに応じて、DocuWare Workflow Designerで開始/トリガー条件を定義してください。

「ステータスの設定」タスクは、文書のインデックスフィールド「ステータス」を変更し、プロセスが開始されたことを示すデータ割り当てステップです。


次のデータ割り当て「IDP API-Key WF-ID」内で、Natif.ai API-Key と Natif.ai Workflow-ID の固定値を定義します。

上のスクリーンショットでは、API-Key のフィールド値には接頭辞「ApiKey」が必要であることがわかります。この接頭辞の後に完全な Key をフィールドに貼り付けます。

まだ Natif.ai で API-Key を作成していない場合は、プロセス専用の API-Key を作成してください。
全ての API-Key の概要は https://{yourNatifAI_Portal}.natif.ai/api-keys

Natif.ai のワークフロー ID は、Natif.ai ポータルで定義されたカスタムまたは事前定義されたプロセスを選択した後に確認できます。

ハイライトされて見えない部分が Natif.ai / IDP Workflow ID で、DocuWare Workflow 内で必須です。

「IDP 処理」ステップでは、Web-Service を介して Natif.ai / IDP Workflow を呼び出します。Natif.ai / IDP Workflow を Web-Service 経由で呼び出します。IDP Web-Service の接続方法については、 https://knowledgecenter.docuware.com/docs/connect-to-intelligent-document-processing-with-workflow
Natif.ai の非同期ガイドに従った特殊な部分については、Synchronous vs. Asychronous Usage -

DocuWare Workflow Designer で Natif.ai の要件を適用するには、Web-Service の "Request" タブを開きます。
その後、"Request "タブの "Queries "セクションに移動し、"wait_for "パラメータを固定値として設定します。
これを実現するには、"wait_for "キーを追加し、固定値0を定義します。（下図のように）

この手順を実行すると、Natif.aiワークフローは常にprocessing-IDを返すようになります。 このIDは、次のステップでプロセスを繰り返し呼び出す際に必要となります。

HTTP Headerセクションで、3つの固定値を定義する必要があります。"Accept"、"Content-Type"、および "Authorization "の値は、以下のスクリーンショットを参照してください。

ApiKeyの内容は、前のデータ割り当てステップ"IDP API-Key WF-ID "から取得されます。

Web-Serviceの[Data Assign]タブでは、Intelligent Document Processing / Natif.aiの戻り値をキャプチャすることを指定する必要があります。


「HTTP レスポンス・ステータス・コード」タブでは、「200,201,202,401,402,403,413,415,422,429,500」のすべての潜在的なコードを定義します。
制限時間は、最大60秒以下に設定できます。


次の Web-Service 要素（「結果 ProcessingID」）では、「ProcessingID」で処理エンドポイントを呼び出します。ProcessingID は前の Web-Service"IDP Processing "によって返されます。
このエンドポイントの詳細はこちらをご覧ください:Fetch Processing Results and Artifacts -
このワークフローのステップは、ドキュメントが Natif.ai によって完全に処理されるまで繰り返されます！
下のスクリーンショットでは、それぞれの ID で専用のエンドポイントを呼び出しているのがわかります。


この要素では、"Queries "セクション内の "wait_for "キーをDocuWare Workflow Designerのタイムアウト(<60秒)以下に定義します。

HTTP Headerタブでは、"Accept "と "Authorization "のキーが必要です。

"Data Assign "タブでは、Natif.aiから抽出したい値を定義します。
スクリーンショットに示されている以下の値は、あくまでもダミーであり、お客様のプロセスに応じて充実させることができます！


最後のタブ「HTTPレスポンス・ステータス・コード」では、コードを「200」のみに設定し、制限時間を最大60秒に設定します。


フローの条件部分（"HttpCode 200"）で、前の Web-Service 呼び出し（"Results ProcessingID"）の HTTP コードが "200 "であったかどうかを評価します。該当する場合、ワークフローはループを抜けます。

該当しない場合、Natif.ai ワークフローがドキュメントの処理を完了するまでループを戻ります。

カスタム待機ループを有効にするには、"DateTime "型のグローバル変数 "Delay "を定義する必要があります。
以下のスクリーンショットでは、カスタム待機操作を有効にする方法を説明しています。この例では、現在の時間に15秒を追加することにしました。
10秒未満の値を設定することは避けてください。これは、フローをより頻繁に反復させるだけです！


「Set done status」では、DocuWare Workflow Designerフローの文書に更新を提供することができます。


この「ベストプラクティス」ガイドに従えば、DocuWare WorkflowとNatif.aiで大きなPDF文書を処理できるようになります。

ご注意：この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。
翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。

こちらの記事は右記のDocuWareバージョンで有効です： 7.11 7.12 | IDP Intelligent Document Processing Natif.ai Workflow Designer Workflow Web-Service asynchronous