Conecta-seEntrar na plataforma

Ler arquivo

Ler e interpretar um ou vários arquivos para que o conteúdo seja usado pelo fluxo.

Lógica e processamentoArquivos e documentosConexão: Sem conexão externa obrigatória

O que faz

Integre arquivos ao fluxo. Permite enviar um arquivo manualmente ou informar a URL de um arquivo.

Quando usar: Use quando o seu fluxo precisar ler e interpretar um ou vários arquivos para que o conteúdo seja usado pelo fluxo.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: Sem conexão externa obrigatória.

Nenhuma conta externa é obrigatória para usar este bloco.

Passo a passo

  1. Adicione Ler arquivo ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Nenhuma conta externa é obrigatória para usar este bloco.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Campos

  • Origem do arquivo

    Escolhe uma das opções aceitas por este campo.

    Opções:
    URL do arquivo · Arquivos enviados
    Exemplo:
    URL do arquivo
  • Caminho do arquivo

    Informe a URL de um arquivo (https://exemplo.com/documento.pdf).

    Quando aparece:
    Quando o campo “Origem do arquivo” for “URL do arquivo”
    Exemplo:
    /documentos/exemplo.pdf
  • Arquivo

    Informa ou seleciona o arquivo usado nesta operação.

    Quando aparece:
    Quando o campo “Origem do arquivo” for “Arquivos enviados”
    Exemplo:
    (selecione um arquivo de teste)

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <lerarquivo.files>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<lerarquivo.files>file[]Lista de arquivos processados, com conteúdo, metadados e propriedades do arquivo.
<lerarquivo.combinedContent>stringConteúdo de todos os arquivos reunido em um único texto.
<lerarquivo.processedFiles>file[]Lista de objetos UserFile para uso nos blocos seguintes (anexos, envios etc.).

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioLer arquivopróxima etapa
Origem do arquivo
URL do arquivo
Caminho do arquivo
/documentos/exemplo.pdf
Arquivo
(selecione um arquivo de teste)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <lerarquivo.files>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Blocos relacionados