Uso de modelos de diferentes ambientes

Ao usar projetos modernos do Document Understanding^TM, você precisa 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íbrida. Nesse caso, os projetos do Document Understanding são configurados no Automation Cloud^TM, enquanto o Orchestrator e os Robôs são implantados localmente.

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 Aplicação na página Aplicativos externos.
   Dica: para obter mais informações sobre como adicionar um aplicativo externo, consulte a página Gerenciamento de aplicativos OAuth externos 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 da 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 para o 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. Configurar os escopo(s) do usuário para conceder permissões dentro de um contexto de usuário.

      Selecione as caixas de seleção correspondentes às permissões lógicas de API que você deseja conceder de acordo com seu requisito na aba Escopo(s) de usuário. 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. Configurar o(s) escopo(s) de aplicativos 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 no nível do aplicativo para o recurso escolhido, conforme necessário. Ao delegar permissões sob o escopo do aplicativo, o aplicativo externo pode acessar dados abrangendo os 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 Redirecionar URL. Essa URL receberá a resposta de autorização. No entanto, se você selecionou apenas escopos de aplicação, 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 segrodo 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 estejam cumpridos:

• Use uma versão compatível do projeto do Windows.
• Certifique-se de que o pacote de atividades 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 obter 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.

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

      
      

      

      
      
3. Instale o pacote IntelligentOCR.Activities para usar atividades como o 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 Extrator do Projeto de Document Understanding.
      
      

      

      
      
   2. Adicione a atividade Classify Document Scope para configurar modelos de classificação e inclua a atividade Document Understanding Project Classifier.
4. Configurar credenciais de tempo de design.
   1. Abra o assistente para Obter Recursos no escopo da atividade.
      O assistente é exibido quando você inclui as atividades do Projeto de Document Understanding dentro desse escopo. Esse assistente permite que você configure as credenciais 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 externo.
      • URL do tenant para o ambiente de destino.
   3. Selecione Buscar projetos e escolha o projeto e a versão necessários.
   4. Encerrar o assistente.
   
   

   

   
   
5. Mapear a taxonomia.
   1. Selecione Configurar Extratores dentro da atividade Data Extraction Scope.
   2. Crie um mapeamento da taxonomia do projeto para a taxonomia do modelo para cada tipo de documento.
      Para executar essa 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 de Document Understanding.
   
   

   

   
   
6. Salve a credencial de tempo de execução 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 aba 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 Credencial na lista suspensa Tipo.
   8. Use o ID do aplicativo e o Segredo do aplicativo criados anteriormente como Nome de usuário e Senha.
   
   

   

   
   
7. Configurar credenciais de tempo de execução no Studio.
   1. Navegue até seu projeto do Studio.
   2. Acesse a atividade Data Extraction Scope.
   3. Configure a propriedade Ativo de Credenciais de Runtime.
      Use esse campo para acessar recursos de projeto modernos do Document Understanding enquanto o robô está 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 de aplicativos externos para acessar o projeto. O formato do caminho deve ser o seguinte: <OrchestratorFolderName>/<AssetName>.
   4. Configurar a propriedade URL do tenant em runtime.
      Use esse campo junto com a propriedade Ativo de Credenciais de Runtime.Insira o URL do tenant ao qual o robô se conectará para executar a extração. O 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, você pode 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 aba 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 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 é implantada em uma pasta especificada, a versão do modelo é 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 de 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.