RPAAPIs

AWS

AWS

O módulo AWS é responsável por ações que integram a ferramenta Amazon Web Service.

Métodos

Textract

Método responsável por reconhecer e obter os caracteres que existem em uma imagem passada pelo usuário utilizando a ferramenta Textract da Amazon Web Service. Por exemplo: Se na imagem passada pelo usuário existir a palavra "Roberty", esta ação tentará reconhecer caractere por caractere e retorná-los.

js

const textract = await API.AWS.textract["v2_0_0"]({
    filePath: `C:\\Roberty\\documento.pdf`,
    featureType: ["FORMS", "TABLES", "QUERIES"],
    queries: [`Qual a data de vencimento?`],
    pageRanges: `1-3`,
    credentials: {
        accessKeyId: `asd`,
        secretAccessKey: `dsa`,
    },
    region: `us-east-1`,
    bucket: `qwe`,
    timeout: 120,
});

Parâmetros obrigatórios

• filePath: String - espera uma string para indicar o caminho em que o arquivo (imagem ou PDF) está salvo. Arquivos PDF são convertidos em imagens, uma por página, antes da análise.
• featureType: String[] - espera um array de strings com os tipos de análise desejados: FORMS, TABLES e/ou QUERIES. Se for passado um array vazio ([]), é feita apenas a detecção de texto (palavras e linhas).

Parâmetros opcionais

• queries: String[] - caso em featureType seja passado o valor QUERIES, espera um array de strings com as perguntas que deverão ser respondidas pela análise do documento.
• pageRanges: String - espera as páginas do PDF a serem analisadas, separadas por vírgula e/ou em intervalos (ex.: 1-3, 5). Caso não seja passado, todas as páginas são analisadas.
• credentials: Object - espera um objeto contendo accessKeyId: String e secretAccessKey: String, com as credenciais da AWS a serem utilizadas.
• region: String - espera a região da AWS a ser utilizada. Caso não seja passado, o valor padrão é us-east-1.
• bucket: String - espera o nome do Bucket criado na S3 para armazenar os arquivos temporariamente. Recomendado para arquivos grandes.
• timeout: Number - espera um valor em segundos para indicar o tempo máximo de espera pela análise. Caso não seja passado, o valor padrão é 120 segundos.

Retorno

A constante ou variável criada, como a textract do exemplo mostrado anteriormente, receberá um objeto que dará acesso as seguintes propriedades:

• textract.content: String - Retorna todo o texto encontrado, com as linhas separadas por quebra de linha.
• textract.words: Array - Retorna todas as palavras encontradas pela análise.
• textract.lines: Array - Retorna todas as linhas de palavras encontradas pela análise.
• textract.forms: Array - Retorna as informações obtidas durante a análise como formulários de informações.
• textract.tables: Array - Retorna as tabelas encontradas durante a análise.
• textract.queries: Array - Retorna perguntas e respostas que foram feitas e obtidas pelo usuário e análise.