Inícios rápidos

Build working samples of Amazon Textract activities to verify your AWS connection and explore input and output data types.

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 ( AmaPath 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 encontrado ( If ). Se o arquivo incluir dados do formulário ( FormField[] ), os valores PageDetail.FormFields.Items().Key e PageDetail.FormFields.Items().Value serão escritos na janela de saída ( For Each e Write Line ). Se o arquivo incluir dados de tabela ( DataTable ), os valores PageDetail.Tables serã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 ( AmaPath Scope ). Inicia um trabalho de análise do Amazon Textract ( Iniciar análise do documento ). 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 usa a atividade Amazon Textract Analyze Single Page Document .

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 (AmaPath 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 encontrado (If).

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

   • Se o arquivo incluir dados de tabela (DataTable), os 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. Enter the Id, Secret, and Region for the IAM user that you want to use for the Amazon Textract activities.

   • 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 único dentro da atividade Escopo do Amazon .

4. Enter the DocumentPath to, or the Bucket and DocumentName of, the JPEG or PNG file that you want to analyze.

5. Crie e insira uma variável PageDetail para seu valor de Página (por exemplo, pageDetail).

   • When creating your variable, select *UiPath.Amazon.Textract.Client.Models.PageDetail
   • como o tipo da variável.

6. Adicione uma atividade If após a atividade Analisar documento de página única .

7. Na propriedade Condição , digite a variável PageDetail criada 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 TypeArgument , selecione _UiPath.Amazon.Textract.Client.Models.FormFields
   2. Na propriedade Valores , digite 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 , digite item.Name+" | "+item.Value+" | "+item.Confidence para gerar os valores KeyValuePair dos dados do formulário.
   4. In the Else statement box, add a Write Line activity.
   5. Na propriedade Text , digite "Nenhum dado de formulário encontrado."

9. Adicione outra atividade If após a primeira atividade If .,

10. Na propriedade Condição , digite a variável PageDetail criada 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 , digite 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 digite uma variável para o conteúdo String ( DataTable exemplo TabelaDeDados).
    3. Adicione uma atividade Write Line abaixo da atividade Output Data Table .
       1. Na propriedade Text , digite a variável String que você criou na etapa acima para gerar o conteúdo DataTable .
    4. In the Else statement box, add a Write Line activity.
    5. Na propriedade Text , digite "Nenhum dado de tabela encontrado."

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

    

    

Está feito!

Quando você estiver pronto, tente os outros guias de Início rápido para se familiarizar mais com as diferentes atividades do Amazon Textract.

To learn more about the Amazon Textract activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.

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 usa as atividades Start Document Analysis, Get Document Analysis Status e Get Document Analysis 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 (AmaPath Scope).

2. Inicia um trabalho de análise do Amazon Textract (Iniciar análise do documento).

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. Enter the Id, Secret, and Region for the IAM user that you want to use for the Amazon Textract activities.

   • 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. Enter the Bucket and DocumentName of, the JPEG or PNG file that you want to analyze.

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 , digite 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 do StatusDoTrabalho (por exemplo, JobStatus).

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

    • Para obter uma lista dos possíveis valores de status do trabalho, consulte a seção de 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 Text , digite a variável String que você criou para o valor do JobStatus acima (por exemplo, jobStatus).

13. Adicione uma atividade Delay após a atividade Write Line .

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

    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 é igual a IN_PROGRESS. Essa condição permite que o Robô recupere e gere o status até que ele mude.

15. Adicione uma atividade If após a atividade Do While .

16. Na propriedade Condição , insira a variável JobStatus junto com um valor de condição (por exemplo, jobStatus = "SuCCESS")

17. Na caixa de declaraçã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 ID do trabalho na atividade Start Document Analysis . (por exemplo, jobId).
    2. Crie e insira uma variável PageDetail[] para seu valor de Páginas (por exemplo, DetalhesDaPágina).
    • When creating your variable, select *UiPath.Amazon.Textract.Client.Models.PageDetail[]
    • como o tipo da 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 TypeArgument , selecione UiPath.Amazon.Textract.Client.Models.FormFields
    2. Na propriedade Valores , digite 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 , digite item.Name+" | "+item.Value+" | "+item.Confidence para gerar os valores do formulário.
    4. In the Else statement box, add a Write Line activity.
    5. Na propriedade Texto , digite uma mensagem para um trabalho com falha (por exemplo, _"O 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 esperados do formulário.

    

    

Está feito!

Quando você estiver pronto, tente os outros guias de Início rápido para se familiarizar mais com as diferentes atividades do Amazon Textract.

To learn more about the Amazon Textract activities (including example property inputs/outputs), see the Activities page for a complete activity list and links to the activity detail pages.