Consumo de modelos de diferentes ambientes

Ao usar projetos modernos do Document Understanding^TM , é necessário configurar um aplicativo externo para acessar modelos em vários tenants e organizações.

Esse procedimento oferece uma visão geral abrangente sobre como acessar modelos implantados em diferentes ambientes usando aplicativos externos. Inclui instruções passo a passo sobre como configurar um aplicativo externo para direitos de acesso, configurar o fluxo de trabalho do Studio para consumir esses modelos e estabelecer fluxos de trabalho de produção.

Essa funcionalidade também permite que você use modelos em ambientes de implantação híbridos. Nesse caso, os projetos do Document Understanding são configurados no Automation Cloud^TM, enquanto o Orchestrator e os Robôs são implantados no local.

1. Configurar um aplicativo externo
2. Configurar o fluxo de trabalho do UiPath Studio
3. Configurar versões do modelo como parâmetros
4. Modelo de processo do Document Understanding

Configurar um aplicativo externo

1. Navegue até seu tenant do Automation Cloud.
2. Acesse a página Administração e selecione sua organização.
3. Acesse a página Aplicativos externos .
   
   

   

   
   
4. Selecione Adicionar aplicativo na página Aplicativos externos .
   Dica: para obter mais informações sobre como adicionar um aplicativo externo, consulte a página Gerenciamento de aplicativos externos do OAuth no guia do administrador do Automation Cloud.
5. Digite um nome exclusivo para o aplicativo no campo Nome do aplicativo .
6. Selecione um tipo de aplicativo na seção Tipo de aplicativo :
   • Aplicativo confidencial: adequado para armazenar o Segredo do Aplicativo com segurança. Use isso para requisitos de alta segurança.
   • Aplicativo não confidencial: use essa opção apenas quando o armazenamento seguro do Segredo do Aplicativo não for necessário.
   
   

   

   
   
7. Defina os escopos de acesso para seu aplicativo externo.
   1. Selecione Adicionar escopos na seção Recursos .
   2. Selecione Document Understanding na lista suspensa Recurso .
   3. Configure os escopos do usuário para conceder permissões em um contexto de usuário.

      Marque as caixas de seleção correspondentes às permissões de API lógica que você deseja conceder de acordo com seu requisito na guia Escopo(s) do(s) usuário(s) . Se você conceder permissões no escopo do usuário, está implícito que o aplicativo externo pode acessar esses recursos dentro de um contexto de usuário. Portanto, um usuário com as permissões correspondentes deve estar logado.

   4. Configure escopos do aplicativo para fornecer acesso no nível do aplicativo para necessidades de automação mais amplas.

      Se você estiver usando um aplicativo confidencial, navegue até a aba Escopo(s) do aplicativo para alocar permissões de nível de aplicativos para o recurso escolhido, conforme a necessidade. Ao delegar permissões no escopo do aplicativo, o aplicativo externo pode acessar dados nos escopos selecionados sem qualquer interação do usuário.

      Os aplicativos não confidenciais não podem acessar o escopo do aplicativo.

      
      

      

      
      
   5. Selecione Salvar.
      Observação: se você registrou o aplicativo externo com escopos de usuário, adicione uma URL de redirecionamento. Esta URL receberá a resposta de autorização. No entanto, se você selecionou apenas escopos de aplicativos, fornecer uma URL de redirecionamento é opcional.
8. Selecione Adicionar para criar o registro.

   Uma mensagem de confirmação é exibida. Para aplicativos confidenciais, essa mensagem inclui o segredo do aplicativo. O aplicativo externo registrado pode usar esse segredo para solicitar autorização. Certifique-se de salvar o segredo do aplicativo em um local seguro, pois você não poderá vê-lo novamente.

   
   

   

   
   

Configurar o fluxo de trabalho do UiPath Studio

Antes de começar, certifique-se de que os seguintes pré-requisitos sejam atendidos:

• Use uma versão do Projeto do Windows compatível.
• Certifique-se de que o pacote de atividades do IntelligentOCR esteja instalado. O pacote IntelligentOCR.Activities é compatível com o consumo de projetos modernos do Document Understanding a partir da v6.22.1.

Dica:

Para uma compreensão mais detalhada das diferenças entre os pacotes DocumentUnderstanding.Activities e IntelligentOCR.Activities , bem como orientações sobre quando usar cada um deles, consulte a página Automações no Document Understanding .

1. Abra seu projeto do UiPath Studio .
2. Defina a taxonomia.
   1. Abra o Gerenciador de Taxonomia para definir os tipos de documento e campos relevantes para sua automação.

      A taxonomia do seu projeto deve abranger cada tipo de documento e os campos necessários. A taxonomia que você criar no Studio pode conter tipos de documentos e campos adicionais que não fazem parte dos projetos modernos do Document Understanding. Se você deseja usar extratores adicionais como o Form Extractor ou o Regex Extractor para vários tipos de documentos, esta etapa será necessária.

      
      

      

      
      
3. Instale o pacote IntelligentOCR.Activities para usar atividades como Document Understanding Project Extractor e Document Understanding Project Classifier.
   1. Adicione a atividade Data Extraction Scope para configurar modelos de extração e inclua a atividade Document Understanding Project Extractor.
      
      

      

      
      
   2. Adicione a atividade Classify Document Scope para configurar modelos de classificação e inclua a atividade Document Understanding Project Classifier.
4. Configure as credenciais de tempo de design.
   1. Abra o assistente Obter Recursos do escopo da atividade.
      O assistente é exibido quando você inclui as atividades do Projeto do Document Understanding nesse escopo. Este assistente permite configurar as credenciais de tempo de design necessárias para mapear os campos de taxonomia de um projeto moderno.
   2. Preencha as seguintes informações:
      • ID do aplicativo e Segredo do aplicativo do aplicativo externo.
      • URL do tenant para o ambiente de destino.
   3. Selecione Obter projetos e escolha o projeto e a versão necessários.
   4. Feche o assistente.
   
   

   

   
   
5. Mapeie a taxonomia.
   1. Selecione Configurar extratores dentro da atividade Escopo da Extração de Dados .
   2. Crie um mapeamento da taxonomia do projeto para a taxonomia do modelo para cada tipo de documento.
      Para executar esta etapa, escolha um Tipo de documento na taxonomia e alinhe cada campo desse Tipo de documento com um campo correspondente no modelo projetado para o Projeto do Document Understanding.
   
   

   

   
   
6. Salve a credencial de runtime como um ativo do Orchestrator.
   1. Navegue até seu tenant do Automation Cloud.
   2. Acesse o Orchestrator.
   3. Escolha sua pasta de automação.
   4. Acesse a guia Ativos .
   5. Selecione Adicionar ativo e escolha Criar um novo ativo na lista suspensa.
   6. Digite um nome no campo Nome do ativo .
   7. Selecione Credential na lista suspensa Tipo .
   8. Use o ID do aplicativo e Segredo do aplicativo criados anteriormente como Nome de usuário e Senha.
   
   

   

   
   
7. Configure credenciais de runtime no Studio.
   1. Navegue até seu projeto do Studio.
   2. Acesse a atividade Escopo da Extração de Dados.
   3. Configure a propriedade do ativo Credenciais de runtime .
      Use esse campo para acessar os recursos de projeto modernos do Document Understanding enquanto o robô estiver conectado a um Orchestrator local ou de um tenant diferente. Você pode optar por inserir um Ativo de credencial, para fins de autenticação, de uma das seguintes maneiras:

      • Selecione o ativo de credencial desejado do Orchestrator ao qual o robô está conectado na lista suspensa.
      • Insira o caminho para o Ativo de Credenciais do Orchestrator onde você armazena as credenciais do aplicativo externo para acessar o projeto. O formato do caminho deve ser o seguinte: <OrchestratorFolderName>/<AssetName>.
   4. Configure a propriedade URL do tenant de runtime .
      Use esse campo junto com a propriedade do Ativo Credenciais de Runtime . Insira a URL do tenant ao qual o robô se conectará para executar a extração. A URL deve ter o seguinte formato: https://<baseURL>/<OrganizationName>/<TenantName>.

O aplicativo externo fornece acesso a todos os projetos do Document Understanding dentro do tenant. Você não precisa configurar o acesso para cada projeto individualmente.

Configurar versões do modelo como parâmetros

Se você configurar versões do projeto como parâmetros, poderá atualizar fluxos de trabalho de automação para novas versões do projeto sem ajustar o código do fluxo de trabalho.

1. Navegue até seu tenant do Automation Cloud.
2. Acesse o Orchestrator.
3. Escolha sua pasta de automação.
4. Acesse a guia Ativos .
5. Selecione Adicionar ativo e escolha Criar um novo ativo na lista suspensa.
6. Digite um nome no campo Nome do ativo .
7. Selecione Texto na lista suspensa Tipo .
8. Digite um nome no campo Texto para definir um ativo específico da versão.
   
   

   

   
   
9. Selecione Criar.
   Isso permite que você atualize os fluxos de trabalho de automação para novas versões do projeto sem alterar o código do fluxo de trabalho. Quando a automação for implantada em uma pasta especificada, a versão do modelo será definida de acordo com o ativo no Orchestrator. Esse processo é semelhante a salvar credenciais de aplicativos externos como ativos.
10. Navegue até seu projeto do Studio.
11. Adicione uma atividade Obter Ativo em seu fluxo de trabalho para recuperar o ativo de versão.
12. Passe o valor recuperado como uma variável de entrada para as atividades do Projeto do Document Understanding .
    
    

    

    
    

Modelo de processo do Document Understanding

O Processo do Document Understanding é um modelo de projeto do UiPath® Studio totalmente funcional baseado em um fluxograma de processamento de documentos. Você pode usá-lo para começar a trabalhar em uma demonstração ou uma implementação em larga escala do Document Understanding^TM.

O processo fornece log, tratamento de exceção, mecanismos de repetição e todos os métodos que devem ser usados em um fluxo de trabalho do Document Understanding, pronto para uso.

Para obter mais informações, consulte a página Modelo de processo do Document Understanding .