Partilhar via

Ações de Ficheiros

  • Artigo

Importante

Para evitar o acesso não autorizado, o Windows requer direitos de administrador para aceder aos ficheiros protegidos. Para aceder a estes recursos através de ações de ficheiro, execute o Power Automate com direitos de administrador. Para mais informações sobre a execução do Power Automate como um administrador, aceda a Executar o Power Automate com direitos elevados.

O processamento de ficheiros e do respetivo conteúdo é essencial para a maior parte dos cenários de automatização. Pode utilizar as ações do ficheiro para gerir ficheiros, obter as respetivas propriedades, ler e escrever dados e convertê-los noutros tipos.

A maioria das ações de ficheiro requerem caminhos que especifiquem os ficheiros que pretende manipular. Estes caminhos podem ser valores codificados ou variáveis de tipos de dados de ficheiro.

Nota

Para fornecer muitos ficheiros como entrada, utilize uma variável de lista com itens de ficheiro. Um método de criar a lista de ficheiros é a ação Obter ficheiros na pasta.

De forma semelhante, pode preencher um valor codificado ou uma variável de tipo de dados de ficheiro para especificar uma pasta de destino nas ações que necessitam de uma.

Captura de ecrã da ação Mover ficheiros.

Algumas ações de ficheiro fornecem uma configuração abrangente, permitindo-lhe automatizar virtualmente qualquer cenário. Por exemplo, a ação Mudar o nome de ficheiros inclui opções para definir um novo nome ou adicionar, substituir ou remover uma cadeia de texto ao nome de ficheiro existente.

Captura de ecrã da ação Renomear ficheiros.

Para anexar conteúdo de texto ou substituir ficheiros de texto, implemente a ação Escrever texto para ficheiro. Para ler o conteúdo de um ficheiro de texto, utilize a ação Ler texto do ficheiro.

De forma semelhante, se precisar de ler ou escrever conteúdo para ficheiros CSV, utilize as ações Ler do ficheiro CSV e Escrever para ficheiro CSV. Pode encontrar um exemplo de fluxo de ambiente de trabalho que processa ficheiros CSV em Converter um ficheiro CSV numa folha de cálculo do Excel.

Se pretender verificar se existe um ficheiro numa pasta específica, utilize a ação Se o ficheiro existir. Esta ação é uma condicional e permite-lhe executar diferentes blocos de código, dependendo se o ficheiro existe ou não. Para encontrar mais informações sobre condicionais, aceda a Utilizar condicionais.

Se o ficheiro existir

Marca o início de um bloco de ações condicional consoante um ficheiro existe ou não.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
If file N/D Existe, Não existe Existe O estado do ficheiro a verificar
Caminho do ficheiro Não Ficheiro O caminho completo para procurar o ficheiro

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Esperar por ficheiro

Suspender a execução da automatização até um ficheiro ser criado ou eliminado.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Wait for file to be N/D Criado, Eliminado Criada Especifica se o fluxo deve ser colocado em pausa durante a criação ou eliminação de um determinado ficheiro
Caminho do ficheiro Não Ficheiro O caminho completo para procurar o ficheiro

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Esta ação não inclui quaisquer exceções.

Copiar ficheiro(s)

Copiar um ou mais ficheiros para uma pasta de destino.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
File(s) to copy Não Lista de Ficheiros Os ficheiros a copiar. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro, uma lista de ficheiros, um caminho de texto, ou caminhos de texto. Utilize a ação "Obter ficheiros na pasta" para preencher uma variável com uma lista de ficheiros.
Pasta de destino Não Pasta A pasta de destino para os ficheiros copiados
If file exists N/D Não fazer nada, Substituir Não fazer nada Especifica o que fazer se um ficheiro com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Argumento Tipo Descrição
CopiedFiles Lista de Ficheiros Os ficheiros copiados como uma lista de ficheiros

Exceções

Exceção Descrição
A 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
Ficheiro não encontrado Indica que o ficheiro não existe
Não é possível copiar o ficheiro Indica um problema ao copiar o ficheiro

Mover ficheiro(s)

Mover um ou mais ficheiros para uma pasta de destino.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
File(s) to move Não Lista de Ficheiros Os ficheiros a mover. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro, uma lista de ficheiros, um caminho de texto, ou caminhos de texto. Utilize a ação "Obter ficheiros na pasta" para preencher uma variável com uma lista de ficheiros.
Pasta de destino Não Pasta A pasta de destino para os ficheiros movidos
If file exists N/D Não fazer nada, Substituir Não fazer nada Especifica o que fazer se um ficheiro com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Argumento Tipo Descrição
MovedFiles Lista de Ficheiros Os ficheiros movidos como uma lista de ficheiros

Exceções

Exceção Descrição
A 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
Ficheiro não encontrado Indica que o ficheiro não existe
Não é possível mover o ficheiro Indica um problema ao mover o ficheiro

Eliminar ficheiro(s)

Eliminar um ou mais ficheiros.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
File(s) to delete Não Lista de Ficheiros Os ficheiros a eliminar. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro, uma lista de ficheiros, um caminho de texto, ou caminhos de texto. Utilize "Obter ficheiros na pasta" para preencher uma variável com uma lista de ficheiros

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
O caminho do ficheiro não existe Indica que o caminho do ficheiro não existe
Ficheiro não encontrado Indica que o ficheiro não existe
Não é possível eliminar o ficheiro Indica um problema ao eliminar o ficheiro

Mudar nome de ficheiros

Alterar o nome de um ou mais ficheiros.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Ficheiro a mudar o nome Não Lista de Ficheiros O(s) ficheiro(s) a mudar o nome. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro, uma lista de ficheiros, um caminho de texto, ou caminhos de texto. Utilize a ação "Obter ficheiros na pasta" para preencher uma variável com uma lista de ficheiros.
Add number to N/A Valor booleano Verdadeiro Especifica se o número deve ser adicionado aos nomes de ficheiro existentes ou a um novo nome
Rename scheme N/D Definir novo nome, Adicionar texto, Remover texto, Substituir texto, Alterar extensão, Adicionar data, Tornar sequencial Definir novo nome Especifica como mudar o nome dos ficheiros
New file name Não Valor de texto O novo nome dos ficheiros
New extension Sim Valor de texto O texto a adicionar como nova extensão aos ficheiros
New file name Não Valor de texto O novo nome dos ficheiros
Add number to N/D Depois do nome, Antes do nome Depois do nome Especifica se o número deve ser adicionado antes ou depois dos nomes originais ou de um novo nome de base
Text to add Sim Valor de texto O texto a adicionar aos nomes de ficheiro originais
Text to remove Sim Valor de texto O texto a remover dos nomes de ficheiro originais. Este esquema de mudança de nome pesquisa cada nome de ficheiro e remove o texto introduzido em qualquer lugar do nome, sempre que este ocorre.
Text to replace Não Valor de texto O texto a substituir nos nomes de ficheiro originais. Este esquema de mudança de nome pesquisa cada nome de ficheiro e substitui o texto introduzido em qualquer lugar do nome, sempre que este ocorre
Use custom datetime N/D Valor booleano Falso Especifica se deve ser utilizado um datetime personalizado
Datetime to add N/D Data atual, Hora de criação, Último acesso, Última modificação Datetime atual Especifica o valor de datetime a adicionar aos nomes dos ficheiros
Keep extension N/D Valor booleano Verdadeiro Especifica se deve incluir a extensão anterior com os nomes dos ficheiros. Desative esta opção para adicionar manualmente a extensão aos ficheiros.
Replace with Sim Valor de texto O texto pelo qual o texto original deve ser substituído
Start numbering at Não Valor numérico O valor do número inicial
Add text N/D Depois do nome, Antes do nome Depois do nome Especifica se o texto deve ser adicionado antes ou depois dos nomes originais
Custom datetime Não Datetime O datetime a adicionar aos nomes dos ficheiros
Increment by Não Valor numérico O número pelo qual o valor inicial deve ser incrementado
Add datetime N/D Depois do nome, Antes do nome Depois do nome Especifica se o datetime deve ser adicionado antes ou depois dos nomes originais
Separator N/D Nada, Espaço, Traço, Ponto, Sublinhado Espaço Especifica o que deve ser utilizado para separar o nome do ficheiro original e o número adicionado, incluindo a opção de não utilizar um separador
Separator N/D Nada, Espaço, Traço, Ponto, Sublinhado Espaço Especifica o que deve ser utilizado para separar o nome do ficheiro original e o valor de datetime adicionado, incluindo a opção de não utilizar um separador
Use padding N/D Valor booleano Falso Especifica se deve ser utilizado preenchimento
Formato datetime Não Valor de texto aaaaMMdd O formato do valor de datetime a adicionar ao nome do ficheiro, como dd/MM/aaaa para a data, e hh:mm:sstt para a hora
Make each number at least Sim Valor numérico 3 O comprimento mínimo de cada número adicionado
If file exists N/D Não fazer nada, Substituir Não fazer nada Especifica o que fazer se um ficheiro com o mesmo nome já existir na pasta

Variáveis produzidas

Argumento Tipo Descrição
RenamedFiles Lista de Ficheiros Os ficheiros cujos nomes foram mudados como uma lista de ficheiros

Exceções

Exceção Descrição
Diretório não encontrado Indica que o diretório não foi encontrado
Ficheiro não encontrado Indica que o ficheiro não existe
Não é possível mudar o nome do ficheiro Indica um problema ao mudar o nome do ficheiro

Ler texto a partir de ficheiro

Ler o conteúdo de um ficheiro de texto.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
File path Não Ficheiro O ficheiro a ler
Store content as N/D Valor de texto único, Lista (cada linha é um item de lista) Valor de texto único Especifica como armazenar o texto. Escolha 'Valor de texto único' para armazenar o texto todo como um valor único de texto. Escolha 'Lista' para armazenar cada linha do texto original como um item de texto numa lista.
Codificação N/A Predefinição do sistema, ASCII, Unicode (big-endian), UTF-8 UTF-8 A codificação para ler o texto especificado no ficheiro de texto.

Variáveis produzidas

Argumento Tipo Descrição
FileContents Valor de texto O conteúdo como texto
FileContents Lista de valores de 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
Ficheiro não encontrado Indica que o ficheiro não existe
Falha ao ler o ficheiro Indica um problema ao ler a partir do ficheiro

Escrever texto em ficheiro

Escrever ou acrescentar texto a um ficheiro.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O ficheiro para escrever o texto. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro ou um caminho de texto.
Texto a escrever Sim Valor geral O texto a escrever no ficheiro especificado
Acrescentar nova linha N/D Valor booleano Verdadeiro Especifica se deve ser acrescentada uma nova linha no final do texto global a escrever no ficheiro
If file exists N/D Substituir conteúdo existente, Anexar conteúdo Substituir conteúdo existente Especifica se deve acrescentar o conteúdo existente ou anexar no final do conteúdo existente. Se o ficheiro não existir, esta ação cria-o automaticamente.
Codificação N/A Predefinição do sistema, ASCII, Unicode, Unicode (big-endian), UTF-8, Unicode (sem máscara de ordem de bytes), UTF-8 (sem máscara de ordem de bytes) Unicode A codificação a utilizar para o texto especificado a escrever no ficheiro de texto

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao escrever texto no ficheiro Indica um problema ao escrever no ficheiro
Diretório inválido para o ficheiro Indica que o diretório é inválido

Ler a partir de ficheiro CSV

Ler um ficheiro CSV para uma tabela de dados.

Pode utilizar a ação Ler a partir do ficheiro CSV para criar uma variável de tabela de dados com o conteúdo do ficheiro. É necessário definir o caminho para o ficheiro CSV e a codificação a utilizar para o ler, ao mesmo tempo que também pode cortar quaisquer espaços em branco das células extraídas, processar a primeira linha como cabeçalhos de coluna e especificar o separador de colunas.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O ficheiro CSV a ler. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro ou um caminho de texto
Encoding N/D UTF-8, Unicode, Unicode (big-endian), UTF-8 (Sem marca de ordem de bytes), Unicode (sem marca de ordem de bytes), Predefinição do sistema, ASCII UTF-8 A codificação a ser utilizada para ler o ficheiro CSV especificado
Trim fields N/A Valor booleano Verdadeiro Especifica se os espaços em branco à direita e à esquerda das células extraídas devem ser automaticamente cortados
First line contains column names N/D Valor booleano Falso Especifica se deve utilizar a primeira linha do recurso CSV para definir os nomes das colunas da variante do quadro de dados resultante. Ative esta opção para evitar a leitura dos nomes como dados na tabela. As ações subsequentes podem aceder aos dados detidos pela tabela de dados utilizando nomes de colunas (em vez de números de coluna).
Columns separator N/A Larguras de coluna predefinidas, personalizadas e fixas Predefinido Especifica se pretende utilizar o separador de colunas predefinido, uma separador personalizado ou colunas de largura fixa
Separator N/D Sistema predefinido, Vírgula, Ponto e vírgula, Tabulação Predefinição do sistema O separador de colunas para analisar o ficheiro CSV
Custom separator Não Valor de texto O separador de colunas personalizado a utilizar para analisar o recurso CSV especificado
Fixed column widths Não Valor de texto As larguras fixas das colunas a utilizar para analisar o recurso CSV especificado. Separar as larguras usando vírgulas, espaços, separadores ou linhas novas.

Variáveis produzidas

Argumento Tipo Descrição
CSVTable Tabela de dados O conteúdo do ficheiro CSV como uma tabela de dados

Exceções

Exceção Descrição
Falha ao ler a partir de CSV Indica um problema ao ler a partir do ficheiro CSV

Escrever num ficheiro CSV

Escrever uma tabela de dados, linha de dados ou lista num ficheiro CSV.

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Variable to write Não Valor geral A tabela de dados, variável de linha de dados ou variável de lista a escrever no ficheiro CSV de destino
Caminho do ficheiro Não Ficheiro O ficheiro CSV para onde exportar a variável. Este valor pode ser um caminho de ficheiro ou uma variável que contenha um ficheiro ou um caminho de texto.
Codificação N/A UTF-8, Unicode, Unicode (big-endian), UTF-8 (Sem marca de ordem de bytes), Unicode (sem marca de ordem de bytes), Predefinição do sistema, ASCII UTF-8 A codificação a utilizar para escrever no ficheiro CSV especificado
Include column names N/D Valor booleano Falso Especifica se os nomes das colunas da variante especificada devem tornar-se a primeira linha do ficheiro CSV. Esta opção produz efeitos se e apenas se o ficheiro CSV alvo não existir inicialmente ou existir mas estiver sem texto.
Se o ficheiro existir N/A Substituir conteúdo existente, Anexar conteúdo Substituir conteúdo existente Especifica o comportamento pretendido quando o ficheiro CSV de destino já existe no sistema de ficheiros
Separator N/D Sistema predefinido, Vírgula, Ponto e vírgula, Tabulação Predefinição do sistema O separador de colunas a utilizar no ficheiro CSV especificado
Custom columns separator Não Valor de texto O separador de colunas personalizado a utilizar no ficheiro CSV
Use custom columns separator N/D Valor booleano Falso Especifica se pretende utilizar um separador de colunas personalizado ou predefinido

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Falha ao escrever Indica um problema ao escrever no ficheiro CSV

Obter parte do caminho do ficheiro

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

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O caminho de ficheiro a utilizar como origem

Variáveis produzidas

Argumento Tipo Descrição
RootPath Ficheiro O caminho raiz do ficheiro de origem
Directory Pasta O diretório do ficheiro de origem
FileName Valor de texto O nome do ficheiro de origem
FileNameNoExtension Valor de texto O nome de ficheiro (sem a extensão) do ficheiro de origem
FileExtension Valor de texto A extensão (por exemplo, .doc) do ficheiro de origem

Exceções

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

Obter ficheiro temporário

Criar um ficheiro temporário vazio com um nome exclusivo no disco e obter o objeto de ficheiro (que é uma representação e pode aceder ao ficheiro e a todas as informações deste).

Parâmetros de entrada

Esta ação não exige qualquer entrada.

Variáveis produzidas

Argumento Tipo Descrição
TempFile Ficheiro O objeto de ficheiro temporário

Exceções

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

Converter ficheiro em Base64

Converter um ficheiro em texto codificado em Base64.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O caminho do ficheiro de origem

Variáveis produzidas

Argumento Tipo Descrição
Base64Text Valor de texto O texto codificado em Base64

Exceções

Exceção Descrição
Ficheiro não encontrado Indica que o ficheiro não existe
Não é possível converter o ficheiro em Base64 Indica que não é possível converter o ficheiro fornecido em texto codificado em Base64

Converter Base64 para ficheiro

Converter um texto codificado em Base64 em ficheiro.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Texto codificado em Base64 Não Valor de texto O texto codificado em Base64
Caminho do ficheiro Não Ficheiro O ficheiro de destino
Se o ficheiro existir N/A Não fazer nada, Substituir Não fazer nada Especifica o que fazer se um ficheiro com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção Descrição
Diretório inválido para o ficheiro Indica que o diretório é inválido
Não é possível converter Base64 em ficheiro Indica que não é possível converter o texto codificado em Base64 num ficheiro

Converter ficheiro em dados binários

Converter um ficheiro em dados binários.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Caminho do ficheiro Não Ficheiro O ficheiro de origem

Variáveis produzidas

Argumento Tipo Descrição
BinaryData Valor de texto Os dados binários a escrever

Exceções

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

Converter dados binários em ficheiro

Converter dados binários em ficheiro.

Parâmetros de entrada

Argumento Opcional Aceita Valor Predefinido Descrição
Dados binários Não Valor de texto Os dados binários
Caminho do ficheiro Não Ficheiro O ficheiro de destino
Se o ficheiro existir N/A Não fazer nada, Substituir Não fazer nada Especifica o que fazer se um ficheiro com o mesmo nome já existir na pasta de destino

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

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