Uso de modelos de diferentes ambientes

When using Document Understanding^TM modern projects, you need to configure an external application to access models across various tenants and organizations.

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.

This functionality also allows you to use models in hybrid deployment environments. In this case, Document Understanding projects are configured on Automation Cloud^TM, while Orchestrator and Robots are deployed on-premises.

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:

   For more information on adding an external application, check the Managing external OAuth applications page from the Automation Cloud admin guide.

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:

   • Confidential application: suitable for storing the App Secret securely. Use this for high-security requirements.

   • 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:

      If you have registered the external application with user scopes, add a Redirect URL. This URL will receive the authorization response. However, if you selected only application scopes, providing a redirect URL is optional.

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 this field together with the Runtime Credentials Asset property. Enter the URL of the tenant to which the robot will connect to execute the extraction. The URL must have the following format: 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

Document Understanding Process is a fully functional UiPath® Studio project template based on a document processing flowchart. You can use it to get started with working on either a demo, or a large-scale implementation of 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.