Inícios rápidos

Visão geral

A seguir estão os links para instruções passo a passo sobre como usar as atividades do Amazon Textract. Esses guias ajudam você a criar uma amostra de trabalho das diferentes atividades para que você possa verificar a conexão com seus recursos da AWS e se familiarizar com os tipos de dados de entrada/saída.

Início rápido	Description
Analyze Single Page Document	Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte: Estabelece uma conexão com seus recursos da AWS (Amazon Scope). Analisa um único arquivo JPEG ou PNG (Analisar Documento de Página Única). Gera os resultados da análise, dependendo do tipo de dados localizados (If). Se o arquivo incluir dados do formulário (FormField[]), os valores PageDetail.FormFields.Items().Key e PageDetail.FormFields.Items().Value são gravados na janela de saída (For Each e Write Line). Se o arquivo incluir dados de tabela (DataTable), os valores PageDetail.Tables são gravados na janela de saída (Tabela de dados de saída e Write Line).
Iniciar e obter análise	Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte: Estabelece uma conexão com seus recursos da AWS (Amazon Scope). Inicia um trabalho de análise do Amazon Textract (Start Document Analysis). Recupera e gera o status do trabalho de análise iniciado (Do While, Get Document Analysis Status, Write Line e Delay). Recupera e gera os resultados da análise se/quando o trabalho de análise for bem-sucedido (If, Get Document Analysis, For Each e Write Line).

Início rápido — analisar documentos de página única

Visão geral

O objetivo deste guia é ajudar você a criar uma amostra de trabalho que use a atividade Analisar documento de página única do Amazon Textract.

Este exemplo de trabalho permite que você verifique rapidamente a conexão com seus recursos da AWS e se familiarize com os tipos de dados de entrada/saída da atividade.

Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte:

1. Estabelece uma conexão com seus recursos da AWS (Amazon Scope).
2. Analisa um único arquivo JPEG ou PNG (Analisar Documento de Página Única).

3. Gera os resultados da análise, dependendo do tipo de dados localizados (If).

   • Se o arquivo incluir dados do formulário (FormFields), os valores PageDetail.FormFields.Items().Name e PageDetail.FormFields.Items().Value são gravados na janela de saída (For Each e Write Line).
   • Se o arquivo incluir dados de tabela (DataTable), os valores PageDetail.Tables são gravados na janela de saída (Tabela de dados de saída e Write Line).
     
     

     

     
     

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de configuração do Amazon Textract.
2. Disponibilize um arquivo JPEG ou PNG, carregando-o em um bucket S3 ou salvando-o localmente.

Etapas

Crie seu projeto

1. Adicione a atividade Amazon Scope ao seu projeto.

2. Insira o ID, osegredoe a região para o usuário de IAM que você deseja usar para as atividades do Amazon Textract.

   • Para obter mais informações, consulte a seção Criar usuário de IAM no Guia de configuração .
3. Adicione a atividade Analisar Documento de Página Única dentro da atividade Amazon Scope .
4. Insira o CaminhoDoDocumento para, ou o Bucket e NomeDoDocumento do arquivo JPEG ou PNG que você deseja analisar.
5. Crie e insira uma variável PageDetail para seu valor de Página (por exemplo, pageDetail).
   • Ao criar sua variável, selecione UiPath.Amazon.Textract.Client.Models.PageDetail como o tipo de variável.
6. Adicione uma atividade If após a atividade Analyze Single Page Document .
7. Na propriedade Condição , insira a variável PageDetail que você criou na etapa acima e .HasFormData.ToString.Equals("True") para determinar se o arquivo contém objetos FormField (por exemplo, pageDetail.HasFormData.ToString.Equals( "Verdadeiro").

8. Na caixa de declaração Then , adicione uma atividade For Each .

   1. Na propriedade ArgumentoDeTipo, selecione _UiPath.Amazon.Textract.Client.Models.FormFields
   2. Na propriedade Valores , insira a propriedade FormFields.Items da variável que você criou para a atividade Get Messages (por exemplo, pageDetail.FormFields.Items).

   3. Na atividade For Each , adicione uma atividade Write Line .

      1. Na propriedade Text , insira item.Name+" | "+item.Value+" | "+item.Confidence para gerar os valores KeyValuePair dos dados do formulário.
   4. Na caixa da instrução Else , adicione uma atividade Write Line .
   5. Na propriedade Texto , insira "Nenhum dado de formulário encontrado."
9. Adicione outra atividade If após a primeira atividade If .,
10. Na propriedade Condição , insira a variável PageDetail que você criou na etapa acima e .HasTableData.ToString.Equals("True") para determinar se o arquivo contém objetos DataTable (por exemplo, pageDetail.HasTableData.ToString.Equals( "Verdadeiro").

11. Na caixa de declaração Then , adicione uma atividade Output Data Table .

    1. Na propriedade DataTable , insira a variável PageDetail que você criou para a atividade Analisar Documento de Página Única e .Tables(0) para especificar o objeto 'DataTable' no arquivo (por exemplo, pageDetail.Tables(0))
    2. Para a propriedade Text , crie e insira uma variável String para o conteúdo DataTable (por exemplo, TabelaDeDados).

    3. Adicione uma atividade Write Line após a atividade Output Data Table .

       1. Na propriedade Texto , insira a variável String que você criou na etapa acima para gerar o conteúdo DataTable .
    4. Na caixa da instrução Else , adicione uma atividade Write Line .
    5. Na propriedade Texto , insira "Nenhum dado de tabela encontrado."

12. Clique em Executar e verifique se a janela Saída inclui os dados esperados do formulário e da tabela.

    
    

    

    
    
    
    

    

    
    

Está feito!

Quando estiver pronto, experimente os outros guias de início rápido para se familiarizar com as diferentes atividades do Amazon Textract.

Para saber mais sobre as atividades do Amazon Textact (incluindo exemplos de entradas/saídas de propriedades), consulte a página Atividades para obter uma lista completa de atividades e links para as páginas de detalhes das atividades.

Início rápido — iniciar e obter análise

Visão geral

O objetivo deste guia é ajudar você a criar uma amostra de trabalho que use as atividades Amazon Textract Start Document Analysis, Get Document Analysis Statuse Get Document Analysis .

Este exemplo de trabalho permite que você verifique rapidamente a conexão com seus recursos da AWS e se familiarize com os tipos de dados de entrada/saída da atividade.

Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte:

1. Estabelece uma conexão com seus recursos da AWS (Amazon Scope).
2. Inicia um trabalho de análise do Amazon Textract (Start Document Analysis).
3. Recupera e gera o status do trabalho de análise iniciado (Do While, Get Document Analysis Status, Write Line e Delay).

4. Recupera e gera os resultados da análise se/quando o trabalho de análise for bem-sucedido (If, Get Document Analysis, For Each, For Each e Write Line).

   
   

   

   
   

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de configuração do Amazon Textract.
2. Disponibilize um arquivo JPEG ou PNG, carregando-o em um bucket S3 ou salvando-o localmente.

Etapas

Crie seu projeto

1. Adicione a atividade Amazon Scope ao seu projeto.

2. Insira o ID, osegredoe a região para o usuário de IAM que você deseja usar para as atividades do Amazon Textract.

   • Para obter mais informações, consulte a seção Criar usuário de IAM no Guia de configuração .
3. Adicione a atividade Start Document Analysis dentro da atividade Amazon Scope .
4. Insira o Bucket e o NomeDoDocumento do arquivo JPEG ou PNG que você deseja analisar.
5. Crie e insira uma variável String para o valor de JobId (por exemplo, jobId).
6. Adicione uma atividade Do While após a atividade Start Document Analysis .
7. Dentro da atividade Do While , adicione a atividade Get Document Analysis Status .
8. Na propriedade ID do trabalho , insira a variável String que você criou para o JobId acima (por exemplo, jobId).
9. Crie e insira uma variável String para o valor de StatusDoTrabalho (por exemplo, StatusDoTrabalho).

10. Na propriedade Condição da atividade Do While , insira a variável JobStatus junto com um valor de condição (por exemplo, jobStatus = "IN_PROGRASS")

    • Para obter uma lista dos possíveis valores de status do trabalho, consulte a seção da propriedade StatusDoTrabalho da página de detalhes Obter status de análise do documento .
11. Adicione uma atividade Write Line após a atividade Get Document Analysis Status .
12. Na propriedade Texto , insira a variável String que você criou para o valor do Status do Trabalho acima (por exemplo, Status do Trabalho).
13. Adicione uma atividade Delay após a atividade Write Line .

14. Na propriedade Duração , insira o tempo estimado que será necessário para processar seu documento. Em nosso exemplo, inserimos 00:00:20 para demonstrar as alterações de valor de saída do Status do Trabalho (para cenários que não sejam de demonstração, inserimos 00:00:55 para um documento de formulário único).

    Observação: no cenário descrito acima, seu Robô recupera e gera o status do trabalho de análise a cada 20 segundos enquanto o status for igual a IN_PROgress. Essa condição permite que o Robô recupere e gere o status até que ele seja alterado.
15. Adicione uma atividade If após a atividade Do While .
16. Na propriedade Condição , insira a variável StatusDoTrabalho com um valor de condição (por exemplo, JobStatus = "SUCCEDED" ou jobStatus="PARTIAL_SUCCESS")

17. Na caixa da instrução Then , adicione a atividade Get Document Analysis .

    1. Na propriedade ID do Trabalho , insira a variável String que você criou para a propriedade IdDoTrabalho na atividade Start Document Analysis . (por exemplo, jobId).
    2. Crie e insira uma variável PageDetail[] para seu valor de Páginas (por exemplo, PageDetails).
    • Ao criar sua variável, selecione UiPath.Amazon.Textract.Client.Models.PageDetail[] como o tipo de variável.
18. No exemplo abaixo, avaliaremos apenas o primeiro documento na matriz PageDetail[] da propriedade Páginas .
    1. Crie e insira uma variável PageDetail para armazenar o primeiro item no array, e use uma atividade Assign após a atividade Get Document Analysis (por exemplo, PageDetail).
    2. Atribua o PageDetail(0) como o valor à variável que você acabou de criar (pageDetail)

19. Adicione uma atividade For Each após a atividade Assign .

    1. Na propriedade ArgumentoDeTipo, selecione UiPath.Amazon.Textract.Client.Models.FormFields
    2. Na propriedade Valores , insira a propriedade FormFields.Items da variável que você criou para a atividade Assign (por exemplo, pageDetail.FormFields.Items).

    3. Na atividade For Each , adicione uma atividade Write Line .

       1. Na propriedade Text , insira item.Name+" | "+item.Value+" | "+item.Confidence para gerar os valores do formulário.
    4. Na caixa da instrução Else , adicione uma atividade Write Line .
    5. Na propriedade Texto , insira uma mensagem para um trabalho com falha (por exemplo, _"Trabalho falhou, tente novamente."")

20. Execute a sequência e verifique se a janela Saída inclui o status do trabalho e os valores de dados do formulário esperados.

    
    

    

    
    
    
    

    

    
    

Está feito!

Quando estiver pronto, experimente os outros guias de início rápido para se familiarizar com as diferentes atividades do Amazon Textract.

Para saber mais sobre as atividades do Amazon Textact (incluindo exemplos de entradas/saídas de propriedades), consulte a página Atividades para obter uma lista completa de atividades e links para as páginas de detalhes das atividades.