Compartilhar via

Ações de arquivo

  • Artigo

Importante

Para evitar o acesso não autorizado, o Windows exige direitos de administrador para acessar arquivos protegidos. Para acessar esses recursos usando as ações do arquivo, execute o Power Automate com direitos de administrador. Para obter mais informações sobre como executar o Power Automate como administrador, acesse Executar o Power Automate com direitos elevados.

Manipular arquivos e seu conteúdo é essencial para a maioria dos cenários de automação. Você pode usar as ações de arquivo para gerenciar arquivos, recuperar suas propriedades, ler e gravar dados e os convertê-los em outros tipos.

A maioria das ações de arquivo exigem caminhos que especificam os arquivos que você deseja manipular. Esses caminhos podem ser valores codificados ou variáveis de tipo de dados de arquivo.

Observação

Para fornecer muitos arquivos como entrada, use uma variável de lista com itens de arquivo. Um método para criar uma lista de arquivos é a ação Obter arquivos na pasta.

Da mesma forma, você pode preencher um valor codificado ou uma variável de tipo de dados de pasta para especificar uma pasta de destino nas ações que precisam de uma.

Captura de tela da ação Mover arquivos.

Algumas ações de arquivo fornecem uma configuração extensa, permitindo automatizar praticamente qualquer cenário. Por exemplo, a ação Renomear arquivo(s) inclui opções para definir um novo nome ou adicionar, substituir ou remover uma cadeia de texto no nome do arquivo existente.

Captura de tela da ação Renomear arquivos.

Para anexar conteúdo de texto ou substituir arquivos de texto, implante a ação Gravar texto em arquivo. Para ler o conteúdo de um arquivo de texto, use a ação Ler texto do arquivo.

Da mesma forma, se você precisar ler ou gravar conteúdo em arquivos CSV, use as ações Ler do arquivo CSV e Gravar em arquivo CSV. Você pode encontrar um exemplo de fluxo da área de trabalho que lida com arquivos CSV em Converter um arquivo CSV em uma planilha do Excel.

Se desejar verificar se um arquivo existe em uma pasta específica, use a ação Se o arquivo existir. Essa ação é condicional e permite que você execute blocos de código distintos dependendo da existência do arquivo. Para encontrar mais informações sobre condicionais, vá para Usar condicionais.

Se o arquivo existir

Marca o início de um bloco de ações condicional dependendo se um arquivo existe ou não.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Se o arquivo N/D Existe, Não existe Existe O estado do arquivo a ser verificado
Caminho do arquivo Não Arquivo O caminho completo para procurar o arquivo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Aguardar o arquivo

Suspende a execução da automação até que um arquivo seja criado ou excluído.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Aguardar o arquivo ser N/D Criado, Excluído Criado em Especifica se o fluxo deve ser pausado na criação ou exclusão de um determinado arquivo
Caminho do arquivo Não Arquivo O caminho completo para procurar o arquivo

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Essa ação não inclui exceções.

Copiar arquivos

Copie um ou mais arquivos para uma pasta de destino.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Arquivos a serem copiados Não Lista de Arquivos Os arquivos a serem copiados. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo, uma lista de arquivos, um caminho textual ou uma lista de caminhos textuais. Use a ação "Obter arquivos na pasta" para preencher uma variável com uma lista de arquivos.
Pasta de destino Não Pasta A pasta de destino dos arquivos copiados
Se o arquivo existir N/D Não faça nada, Substituir Não faça nada Especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Argumento Type Description
CopiedFiles Lista de Arquivos Os arquivos copiados como uma lista de arquivos

Exceções

Exceção Descrição
Pasta de origem não existe Indica que a pasta de origem não existe
A pasta de destino não existe Indica que a pasta de destino não existe
Arquivo não encontrado Indica que o arquivo não existe
Não é possível copiar arquivo Indica um problema ao copiar o arquivo

Mover arquivos

Mova um ou mais arquivos para uma pasta de destino.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Arquivos a serem movidos Não Lista de Arquivos Os arquivos a serem movidos. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo, uma lista de arquivos, um caminho textual ou uma lista de caminhos textuais. Use a ação "Obter arquivos na pasta" para preencher uma variável com uma lista de arquivos.
Pasta de destino Não Pasta A pasta de destino dos arquivos movidos
Se o arquivo existir N/D Não faça nada, Substituir Não faça nada Especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Argumento Type Description
MovedFiles Lista de Arquivos Os arquivos movidos como uma lista de arquivos

Exceções

Exceção Descrição
Pasta de origem não existe Indica que a pasta de origem não existe
A pasta de destino não existe Indica que a pasta de destino não existe
Arquivo não encontrado Indica que o arquivo não existe
Não é possível mover arquivo Indica um problema ao mover o arquivo

Excluir arquivos

Exclua um ou mais arquivos.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Arquivos a serem excluídos Não Lista de Arquivos Os arquivos a serem excluídos. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo, uma lista de arquivos, um caminho textual ou uma lista de caminhos textuais. Use "Obter arquivos na pasta" para preencher uma variável com uma lista de arquivos

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Caminho do arquivo não existe Indica que o caminho do arquivo não existe
Arquivo não encontrado Indica que o arquivo não existe
Não é possível excluir arquivo Indica um problema ao excluir o arquivo

Renomear arquivos

Altere o nome de um ou mais arquivos.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Arquivo a ser renomeado Não Lista de Arquivos Os arquivos a serem renomeados. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo, uma lista de arquivos, um caminho textual ou uma lista de caminhos textuais. Use a ação "Obter arquivos na pasta" para preencher uma variável com uma lista de arquivos.
Adicionar número a N/A Valor booliano Verdadeiro Especifica se deve adicionar o número aos nomes de arquivo existentes ou a um novo nome
Renomear esquema N/D Definir novo nome, Adicionar texto, Remover texto, Substituir texto, Alterar extensão, Adicionar data e hora, Tornar sequencial Definir novo nome Especifica como renomear os arquivos
Novo nome do arquivo Não Valor do texto O novo nome dos arquivos
Nova extensão Sim Valor do texto O texto a ser adicionado como nova extensão dos arquivos
Novo nome do arquivo Não Valor do texto O novo nome dos arquivos
Adicionar número a N/D Depois do nome, Antes do nome Após o nome Especifica se deve adicionar o número antes ou depois dos nomes originais ou de um novo nome de base
Texto a ser adicionado Sim Valor do texto O texto a ser adicionado aos nomes de arquivo originais
Texto a ser removido Sim Valor do texto O texto a ser removido dos nomes de arquivo originais. Esse esquema de renomeação pesquisa cada nome de arquivo e remove o texto inserido em qualquer lugar do nome toda vez que ele ocorre.
Texto a ser substituído Não Valor do texto O texto a ser substituído nos nomes de arquivo originais. Este esquema de renomeação pesquisa cada nome de arquivo e substitui o texto inserido em qualquer lugar do nome toda vez que ele ocorre
Usar datetime personalizado N/D Valor booliano Falso Especifica se deve usar um datetime personalizado
Datetime a ser adicionado N/D Data e hora atual, Hora de criação, Último acesso, Última modificação Datetime atual Especifica o valor de datetime a ser adicionado aos nomes dos arquivos
Manter extensão N/D Valor booliano Verdadeiro Especifica se a extensão anterior deve ser incluída com os nomes dos arquivos. Desabilite essa opção para adicionar a extensão aos arquivos manualmente.
Substituir por Sim Valor do texto O texto pelo qual o texto original será substituído
Iniciar a numeração em Não Valor numérico O valor do número inicial
Adicionar texto N/D Depois do nome, Antes do nome Após o nome Especifica se deve adicionar o texto antes ou depois dos nomes originais
Datetime personalizado Não Data/hora O datetime a ser adicionado aos nomes de arquivo
Aumentar em Não Valor numérico O número a ser incrementado ao valor inicial
Adicionar datetime N/D Depois do nome, Antes do nome Após o nome Especifica se deve adicionar o datetime antes ou depois dos nomes originais
Separador N/D Nada, Espaço, Traço, Ponto, Sublinhado Espaço Especifica o que usar para separar o nome do arquivo original e o número adicionado, incluindo a opção de não usar um separador
Separador N/D Nada, Espaço, Traço, Ponto, Sublinhado Espaço Especifica o que usar para separar o nome do arquivo original e o valor de datetime adicionado, incluindo a opção de não usar um separador
Usar preenchimento N/D Valor booliano Falso Especifica se o preenchimento deve ser usado
Formato de datetime Não Valor do texto aaaaMMdd O formato do valor de datetime a ser adicionado ao nome do arquivo, como MM/dd/aaaa para data e hh:mm:sstt para hora
Tornar cada número pelo menos Sim Valor numérico 3 O comprimento mínimo de cada número adicionado
Se o arquivo existir N/D Não faça nada, Substituir Não faça nada Especifica o que fazer se um arquivo com o mesmo nome já existir na pasta

Variáveis produzidas

Argumento Type Description
RenamedFiles Lista de Arquivos Os arquivos renomeados como uma lista de arquivos

Exceções

Exceção Descrição
Diretório não encontrado Indica que o diretório não foi encontrado
Arquivo não encontrado Indica que o arquivo não existe
Não é possível renomear arquivo Indica um problema ao renomear o arquivo

Ler texto do arquivo

Leia o conteúdo de um arquivo de texto.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O arquivo a ser lido
Armazenar conteúdo como N/D Valor de texto único, Lista (cada um é um item de lista) Valor de texto único Especifica como armazenar o texto. Escolha "Valor de texto único" para armazenar todo o texto como um valor de texto único. Escolha "Lista" para armazenar cada linha do texto original como um item de texto em uma lista.
Codificação N/A Padrão do sistema, ASCII, Unicode, Unicode (big-endian), UTF-8 UTF-8 A codificação com a qual ler o texto especificado do arquivo de texto.

Variáveis produzidas

Argumento Type Description
FileContents Valor do texto O conteúdo como um texto
FileContents Lista de Valores do texto O conteúdo como uma lista de textos

Exceções

Exceção Descrição
Diretório não encontrado Indica que o diretório não foi encontrado
Arquivo não encontrado Indica que o arquivo não existe
Falha ao ler do arquivo Indica um problema ao ler do arquivo

Gravar texto em arquivo

Grave ou acrescente texto a um arquivo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O arquivo para gravar o texto. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo ou um caminho textual.
Texto a ser gravado Sim Valor geral O texto a ser gravado no arquivo especificado
Acrescentar nova linha N/D Valor booliano Verdadeiro Especifica se deve acrescentar uma nova linha ao final do texto geral para gravar no arquivo
Se o arquivo existir N/D Substituir conteúdo existente, Acrescentar conteúdo Substituir conteúdo existente Especifica se o conteúdo existente deve ser substituído ou acrescentado ao final do conteúdo existente. Se o arquivo não existir, essa ação o criará automaticamente.
Codificação N/A Padrão do sistema, ASCII, Unicode, Unicode (big-endian), UTF-8, Unicode (sem máscara de ordem de byte), UTF-8 (sem máscara de ordem de byte) Unicode A codificação a ser usada para gravar o texto especificado no arquivo de texto

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao gravar texto no arquivo Indica um problema ao gravar no arquivo
Diretório inválido para o arquivo Indica que o diretório é inválido

Ler do arquivo CSV

Leia um arquivo CSV em uma tabela de dados.

Você pode usar a ação Ler do arquivo CSV para criar uma variável de tabela de dados com o conteúdo do arquivo. Você precisa definir o caminho para o arquivo CSV e a codificação a ser usada para lê-lo, enquanto também pode cortar quaisquer espaços em branco das células extraídas, tratar a primeira linha como cabeçalhos de coluna e especificar o separador de colunas.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O arquivo CSV a ser lido. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo ou um caminho textual
Codificação N/D UTF-8, Unicode, Unicode (big-endian), UTF-8 (sem marca de ordem de byte), Unicode (sem marca de ordem de byte), padrão do sistema, ASCII UTF-8 A codificação a ser usada para ler o arquivo CSV especificado
Cortar campos N/A Valor booliano Verdadeiro Especifica se deve cortar automaticamente os espaços em branco à direita e à esquerda das células extraídas
A primeira linha contém os nomes das colunas N/D Valor booliano Falso Especifica se deve ser usada a primeira linha do recurso CSV para definir os nomes das colunas da variante da tabela de dados resultante. Habilite essa opção para evitar a leitura dos nomes como dados na tabela. As ações subsequentes podem acessar os dados mantidos pela tabela de dados usando-se nomes de coluna (em vez de números de coluna).
Separador de colunas N/A Predefinida, Personalizada, Larguras de coluna fixas Predefinida Especifica se deve usar um separador de colunas predefinido, um personalizado ou larguras de coluna fixas
Separador N/D Padrão do sistema, Vírgula, Ponto e vírgula, Tabulação Padrão do sistema O separador de colunas para analisar o arquivo CSV
Separador personalizado Não Valor do texto O separador de colunas personalizado a ser usado para analisar o recurso CSV especificado
Larguras de coluna fixas Não Valor do texto As larguras de coluna fixas a serem usadas para analisar o recurso CSV especificado. Separe as larguras usando vírgulas, espaços, tabulações ou novas linhas.

Variáveis produzidas

Argumento Type Description
CSVTable Datatable O conteúdo do arquivo CSV como uma tabela de dados

Exceções

Exceção Descrição
Falha ao ler do CSV Indica um problema ao ler do arquivo CSV

Gravar no arquivo CSV

Grave uma tabela de dados, linha de dados ou lista em um arquivo CSV.

Use a ação Gravar em arquivo CSV para gravar uma tabela de dados, linha de dados ou variável de lista em um arquivo CSV de destino. No parâmetro Caminho do arquivo, especifique o caminho do arquivo ou a variável que contém um arquivo ou caminho textual para onde os dados serão exportados.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Variável a ser gravada Não Valor geral A tabela de dados, variável de linha de dados ou variável de lista a ser gravada no arquivo CSV de destino
Caminho do arquivo Não Arquivo O arquivo CSV para onde a variável será exportada. Este valor pode ser um caminho do arquivo ou uma variável que contenha um arquivo ou um caminho textual.
Codificação N/A UTF-8, Unicode, Unicode (big-endian), UTF-8 (sem marca de ordem de byte), Unicode (sem marca de ordem de byte), padrão do sistema, ASCII UTF-8 A codificação a ser usada para gravar o arquivo CSV especificado
Incluir nomes das colunas N/D Valor booliano Falso Especifica se os nomes das colunas da variante especificada devem se tornar a primeira linha do arquivo CSV. Essa opção entrará em vigor se e somente se o arquivo CSV de destino não existir inicialmente ou se existir mas estiver sem texto.
Se o arquivo existir N/A Substituir conteúdo existente, Acrescentar conteúdo Substituir conteúdo existente Especifica o comportamento desejado quando o arquivo CSV de destino já existe no sistema de arquivos
Separador N/D Padrão do sistema, Vírgula, Ponto e vírgula, Tabulação Padrão do sistema O separador de colunas a ser usado no arquivo CSV especificado
Separador de colunas personalizado Não Valor do texto O separador de colunas personalizado a ser usado no arquivo CSV
Usar separador de colunas personalizado N/D Valor booliano Falso Especifica se deve usar um separador de colunas personalizado ou um predefinido

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Falha ao gravar Indica um problema ao gravar no arquivo CSV

Obter parte do caminho do arquivo

Recupere uma ou mais partes (diretório, nome de arquivo, extensão etc.) de um texto que representa um caminho do arquivo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O caminho do arquivo a ser usado como origem

Variáveis produzidas

Argumento Type Description
RootPath Arquivo O caminho de raiz do arquivo de origem
Diretório Pasta O diretório do arquivo de origem
FileName Valor do texto O nome do arquivo de origem
FileNameNoExtension Valor do texto O nome do arquivo (sem a extensão) do arquivo de origem
FileExtension Valor do texto A extensão (por exemplo, .doc) do arquivo de origem

Exceções

Exceção Descrição
O caminho do arquivo contém caracteres inválidos Indica que o caminho do arquivo não existe

Obter arquivo temporário

Crie um arquivo temporário vazio com um nome exclusivo no disco e obtenha o objeto de arquivo (que é uma representação e pode acessar o arquivo e respectivas informações).

Parâmetros de entrada

Essa ação não requer entradas.

Variáveis produzidas

Argumento Type Description
TempFile Arquivo O objeto do arquivo temporário

Exceções

Exceção Descrição
Falha ao criar arquivo temporário Indica um problema ao criar um arquivo temporário

Converter arquivo em Base64

Converta um arquivo em texto codificado em Base64.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O caminho do arquivo a ser lido

Variáveis produzidas

Argumento Type Description
Base64Text Valor do texto O texto codificado em Base64

Exceções

Exceção Descrição
Arquivo não encontrado Indica que o arquivo não existe
Não é possível converter o arquivo em Base64 Indica que o arquivo fornecido não pode ser convertido em texto codificado em Base64

Converter Base64 em arquivo

Converta um texto codificado em Base64 em arquivo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Texto codificado em Base64 Não Valor do texto O texto codificado em Base64
Caminho do arquivo Não Arquivo O arquivo no qual gravar
Se o arquivo existir N/A Não faça nada, Substituir Não faça nada Especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Diretório inválido para o arquivo Indica que o diretório é inválido
Não é possível converter Base64 em arquivo Indica que o texto codificado em Base64 fornecido não pode ser convertido em um arquivo

Converter arquivo em dados binários

Converte um arquivo em dados binários.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Caminho do arquivo Não Arquivo O arquivo a ser lido

Variáveis produzidas

Argumento Type Description
BinaryData Valor do texto Os dados binários a serem gravados

Exceções

Exceção Descrição
Arquivo não encontrado Indica que o arquivo não existe
Não é possível converter o arquivo em dados binários Indica que não é possível converter o arquivo fornecido em dados binários

Converter dados binários em arquivo

Converte dados binários em arquivo.

Parâmetros de entrada

Argumento Opcional Aceita Valor padrão Description
Dados binários Não Valor do texto Os dados binários
Caminho do arquivo Não Arquivo O arquivo no qual gravar
Se o arquivo existir N/A Não faça nada, Substituir Não faça nada Especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Essa ação não produz variáveis.

Exceções

Exceção Description
Diretório inválido para o arquivo Indica que o diretório é inválido
Não é possível converter arquivo binário em arquivo Indica que não é possível converter os dados binários fornecidos em um arquivo