Ações de arquivo
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.
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.
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 |