異なる環境からのモデルの使用

Document Understanding^TM モダン プロジェクトを使用する場合、さまざまなテナントや組織にまたがるモデルにアクセスするための外部アプリケーションを設定する必要があります。

この手順では、外部アプリケーションを使用して、異なる環境にデプロイされたモデルにアクセスする方法について、包括的な概要を示します。外部アプリケーションへのアクセス権の設定、これらのモデルを使用するための Studio ワークフローの設定、および運用環境のワークフローの確立に関するステップ バイ ステップの手順が記載されています。

この機能を使用すると、ハイブリッド デプロイ環境でモデルを使用することもできます。この場合、Document Understanding プロジェクトは Automation Cloud^TM 上で構成され、Orchestrator とロボットはオンプレミスでデプロイされます。

1. 外部アプリケーションを設定する
2. UiPath Studio のワークフローを構成する
3. モデル バージョンをパラメーターとして設定する
4. Document Understanding Process テンプレート

外部アプリケーションを設定する

1. Automation Cloud のテナントに移動します。
2. [ 管理 ] ページに移動し、組織を選択します。
3. [ 外部アプリケーション ] ページに移動します。
   
   

   

   
   
4. [ 外部アプリケーション] ページから[アプリケーションを追加] を選択します。
   先端： 外部アプリケーションの追加について詳しくは、『Automation Cloud 管理ガイド』の「 外部 OAuth アプリケーションを管理する 」をご覧ください。
5. [ アプリケーション名 ] フィールドに、アプリケーションの一意の名前を入力します。
6. [ アプリケーションの種類 ] セクションからアプリケーションの種類を選択します。
   • 機密アプリケーション: アプリ シークレット を安全に保存するのに適しています。これは、高度なセキュリティ要件に使用します。
   • 非機密アプリケーション: このオプションは、 アプリ シークレット のセキュリティで保護されたストレージが不要な場合にのみ使用します。
   
   

   

   
   
7. 外部アプリケーションのアクセス範囲を定義します。
   1. [ リソース] セクションから[スコープを追加] を選択します。
   2. [ リソース] ドロップダウン リストから [ Document Understanding] を選択します。
   3. ユーザー スコープを設定して 、ユーザー コンテキスト内で権限を付与します。

      [ ユーザー スコープ ] タブで、要件に従って付与する論理 API 権限に対応するチェックボックスをオンにします。ユーザー スコープでアクセス許可を付与すると、外部アプリケーションはユーザー コンテキスト内でそれらのリソースにアクセスできることが暗黙的に示されます。したがって、対応する権限を持つユーザーがログインする必要があります。

   4. より広範な自動化のニーズに応えるアプリケーション レベルのアクセスを提供するように アプリケーション スコープ を設定します。

      機密アプリケーションを使用している場合は、[ アプリケーション スコープ ] タブに移動し、必要に応じて選択したリソースにアプリケーション レベルの権限を割り当てます。アプリケーション スコープで権限を委任することにより、外部アプリケーションはユーザーの操作なしで、選択したスコープをまたいでデータにアクセスできます。

      非機密アプリケーションは、アプリケーションのスコープにアクセスできません。

      
      

      

      
      
   5. [保存] を選択します。
      手記： 外部アプリケーションをユーザー スコープで登録している場合は、[ リダイレクト URL] を追加します。この URL は認可応答を受け取ります。ただし、アプリケーション スコープのみを選択した場合は、リダイレクト URL の指定は任意です。
8. [追加] を選択して登録を作成します。

   確認のメッセージが表示されます。機密アプリケーションの場合、このメッセージにはアプリ シークレットが含まれます。登録済みの外部アプリケーションは、このシークレットを使用して認可を要求できます。アプリ シークレットは安全な場所に保存してください。再度確認することができないので、必ず安全な場所に保存してください。

   
   

   

   
   

UiPath Studio のワークフローを構成する

開始する前に、次の前提条件が満たされていることを確認してください。

• 互換性のあるバージョンの Windows Project を使用します。
• Intelligent OCR アクティビティ パッケージがインストールされていることを確認します。IntelligentOCR.Activities パッケージは、v6.22.1 以降の Document Understanding モダン プロジェクトの使用をサポートしています。

ヒント:

DocumentUnderstanding.Activities パッケージと IntelligentOCR.Activities パッケージの違いについて詳しく理解、および各パッケージをどのような場合に使用したらよいかについてのガイダンスについては、「Document Understanding のオートメーション」をご覧ください。

1. UiPath Studio プロジェクトを開きます。
2. タクソノミーを定義する
   1. [ タクソノミー マネージャー ] を開き、自動化に関連するドキュメントの種類とフィールドを定義します。

      プロジェクトのタクソノミーには、各ドキュメントの種類と必要なフィールドを含める必要があります。Studio で作成するタクソノミーには、Document Understanding モダン プロジェクトに含まれない追加のドキュメントの種類とフィールドを含めることができます。さまざまなドキュメントの種類に対して [フォーム抽出器 ] や [正規表現抽出 器] などの追加の抽出器を使用する場合、この手順が必要になります。

      
      

      

      
      
3. Document Understanding プロジェクト抽出器 や Document Understanding プロジェクト分類器 などのアクティビティを使用するには、 IntelligentOCR.Activities パッケージをインストールしてください。
   1. [ データ抽出スコープ] アクティビティを追加して抽出モデルを設定し、[Document Understanding プロジェクト抽出器] アクティビティを含めます。
      
      

      

      
      
   2. [ ドキュメント分類スコープ ] アクティビティを追加して分類モデルを設定し、[Document Understanding プロジェクト分類器] アクティビティを含めます。
4. 設計時の資格情報を構成します。
   1. アクティビティ スコープから [ 機能を取得 ] ウィザードを開きます。
      ウィザードは、そのスコープ内に Document Understanding プロジェクトの アクティビティを含めると表示されます。このウィザードでは、モダン プロジェクトのタクソノミー フィールドをマッピングするために必要な設計時の資格情報を設定できます。
   2. 次の情報を入力します。
      • 外部アプリケーションのアプリ ID とアプリ シークレット。
      • ターゲット環境のテナント URL。
   3. [ プロジェクトを取得 ] を選択して、必要なプロジェクトとバージョンを選択します。
   4. ウィザードを閉じます。
   
   

   

   
   
5. タクソノミーをマッピングします。
   1. [ データ抽出スコープ] アクティビティ内で [ 抽出器を設定] を選択します。
   2. 各ドキュメントの種類について、プロジェクトのタクソノミーからモデルのタクソノミーへのマッピングを作成します。
      この手順を実行するには、タクソノミーからドキュメントの種類を選択し、このドキュメントの種類の各フィールドを、Document Understanding プロジェクト用に設計されたモデル内の対応するフィールドに配置します。
   
   

   

   
   
6. 実行時の資格情報を Orchestrator アセットとして保存します。
   1. Automation Cloud のテナントに移動します。
   2. Orchestrator に移動します。
   3. オートメーション フォルダーを選択します。
   4. [ アセット] タブに移動します。
   5. [ アセットの追加 ] を選択し、ドロップダウン リストから [新しいアセットの作成 ] を選択します。
   6. [ アセット名 ] フィールドに名前を入力します。
   7. [ 種類] ドロップダウン リストから [ 資格情報] を選択します。
   8. 以前に作成したアプリ ID とアプリ シークレットを ユーザー名 と パスワードとして使用します。
   
   

   

   
   
7. Studio で実行時の資格情報を設定します。
   1. Studio プロジェクトに移動します。
   2. [データ抽出スコープ] アクティビティに移動します。
   3. [ランタイム資格情報アセット] プロパティを設定します。
      このフィールドを使用して、ロボットがローカルの Orchestrator または別のテナントから接続されているときに、Document Understanding のモダン プロジェクト リソースにアクセスします。認証目的で、以下のいずれかの方法で資格情報アセットを入力できます。

      • ロボットが接続されている Orchestrator のドロップダウン リストから、目的の資格情報アセットを選択します。
      • プロジェクトにアクセスするための外部アプリケーションの資格情報を保存する Orchestrator 資格情報アセットへのパスを入力します。パスの形式は、 <OrchestratorFolderName>/<AssetName>である必要があります。
   4. [ ランタイム テナント URL ] プロパティを設定します。
      このフィールドは、[ ランタイム資格情報アセット ] プロパティと併せて使用します。抽出を実行するロボットが接続するテナントの URL を入力します。URL の形式は、 https://<baseURL>/<OrganizationName>/<TenantName>である必要があります。

外部アプリケーションから、テナント内のすべての Document Understanding プロジェクトにアクセスできます。プロジェクトごとに個別にアクセス権を設定する必要はありません。

モデル バージョンをパラメーターとして設定する

プロジェクトのバージョンをパラメーターとして設定すると、ワークフロー コードを調整せずに、新しいバージョンのプロジェクト用にオートメーション ワークフローを更新できます。

1. Automation Cloud のテナントに移動します。
2. Orchestrator に移動します。
3. オートメーション フォルダーを選択します。
4. [ アセット] タブに移動します。
5. [ アセットの追加 ] を選択し、ドロップダウン リストから [新しいアセットの作成 ] を選択します。
6. [ アセット名 ] フィールドに名前を入力します。
7. [ 種類] ドロップダウン リストから [ テキスト] を選択します。
8. [テキスト] フィールドに名前を入力して、バージョン固有のアセットを定義します。
   
   

   

   
   
9. [作成] を選択します。
   これにより、ワークフロー コードを変更せずに、新しいバージョンのプロジェクトのオートメーション ワークフローを更新できます。オートメーションを指定したフォルダーにデプロイすると、モデルのバージョンが Orchestrator のアセットに従って設定されます。このプロセスは、外部アプリケーションの資格情報をアセットとして保存するのと似ています。
10. Studio プロジェクトに移動します。
11. バージョンのアセットを取得するために、ワークフローに [ アセットを取得 ] アクティビティを追加します。
12. 取得した値を入力変数として Document Understanding プロジェクトの アクティビティに渡します。
    
    

    

    
    

Document Understanding Process テンプレート

Document Understanding Process は、ドキュメント処理フローチャートに基づいた非常に機能的な UiPath® Studio プロジェクト テンプレートです。これを使用して、Document Understanding^TM のデモまたは大規模な実装の作業を開始できます。

このプロセスでは、ログ、例外処理、リトライのメカニズムのほか、Document Understanding ワークフローですぐに使えるあらゆるメソッドを提供します。

詳細については、「 Document Understanding Process テンプレート 」のページをご覧ください。