Ações do Word
A caraterística de automatização do Word permite interagir na perfeição com ficheiros do Word armazenados localmente ou na cloud. Para começar, precisa de criar uma instância do Word usando a ação ‘Iniciar Word’ ou ‘Anexar ao Word em execução’. Esta instância serve como parâmetro de entrada para o resto das ações do grupo, permitindo executar facilmente ações no ficheiro Word pretendido.
Atualmente, estão disponíveis as ações abaixo:
- Iniciar Word: quando esta ação é acionada no Power Automate para ambiente de trabalho, abre um documento do Word e cria uma instância do Word que pode ser usada em ações subsequentes do Word no mesmo fluxo de ambiente de trabalho. O utilizador pode optar por abrir um novo documento do Word em branco ou um existente localizado na máquina local ou na cloud (através do OneDrive ou do SharePoint). Dependendo da configuração da ação, a aplicação Word pode ser iniciada de forma visível ou invisível, e o documento pode ser aberto no modo só de leitura. É importante notar que se o documento for aberto no modo só de leitura, não poderá ser editado através de ações do Power Automate para ambiente de trabalho ou manualmente.
- Anexar ao Word em execução: esta ação fornece a capacidade de anexar um documento do Word existente que está aberto no momento e cria uma instância do Word que pode ser usada em ações subsequentes do Word no mesmo fluxo de ambiente de trabalho. O utilizador tem a opção de inserir um documento Word que já esteja aberto na mesma máquina no momento do design através de um menu pendente, ou selecionar um documento Word existente localizado na máquina local ou na cloud (através do OneDrive ou SharePoint).
- Guardar Word: esta ação permite ao utilizador salvar um documento do Word em qualquer formato compatível atualmente com a aplicação Word. O formato de documento predefinido é 'Predefinição (a partir da extensão)', o que significa que o utilizador deve definir o formato do documento no parâmetro Caminho do documento, como definir o valor como C:\TestWord.pdf para o guardar como PDF.
- Fechar Word: esta ação fecha um documento do Word e torna a instância específica do Word inativa no Power Automate. O utilizador pode guardar o documento do Word antes de o fechar em qualquer formato atualmente suportado pela aplicação Word. Note que o formato de documento predefinido é 'Predefinição (a partir da extensão)', o que significa que o utilizador deve definir o formato do documento no parâmetro 'Caminho do documento', como definir o valor como C:\TestWord.pdf para o guardar como PDF.
- Ler a partir do documento do Word: esta ação permite que os utilizadores recuperem o conteúdo de um documento do Word e o utilizem numa ação subsequente do fluxo. Tem a flexibilidade de ler o documento inteiro, páginas específicas ou o conteúdo de um marcador. No que respeita às páginas, pode indicar uma página específica ou uma lista de páginas. Por exemplo, pode introduzir o valor 2-5 no respetivo parâmetro Páginas para recuperar o conteúdo das páginas dois a cinco, por exemplo páginas 2, 3, 4 e 5, ou inserir o valor 3,5,6,7 para recuperar o conteúdo das respetivas páginas ou usar uma combinação das duas formas, como 2-4,6,8,9. É importante observar que o formato do documento do Word não pode ser recuperado e o parâmetro de saída está em texto simples.
- Localizar e substituir palavras em documentos do Word: os utilizadores podem aplicar uma nova funcionalidade com esta ação, que é a capacidade de localizar e substituir texto específico num documento do Word. Os utilizadores têm a opção de substituir apenas a primeira ocorrência do texto ou todas as correspondências. Além disso, o uso de carateres universais permite a localização dinâmica de texto, com o caráter universal a ser inserido no parâmetro de entrada Texto a procurar . Para refinar ainda mais a pesquisa, configure a ferramenta para corresponder a maiúsculas e minúsculas do texto ou apenas palavras inteiras. Estas definições estão disponíveis quando o parâmetro Usar carateres universais está desativado.
- Escrever em documento do Word: esta ação permite que os utilizadores introduzam texto em posições específicas num documento do Word. Isto pode ser feito no início ou no fim do ficheiro, ou antes ou depois de um marcador específico. Além disso, os utilizadores têm a opção de acrescentar ou não uma nova linha antes do texto introduzido, dependendo das suas preferências.
- Inserir imagem num documento do Word: esta ação permite que os utilizadores insiram imagens em posições específicas num documento do Word. Isto pode ser feito no início ou no fim do ficheiro, antes ou depois de um marcador específico ou antes ou depois de um texto específico. Note que nenhum espaço ou novas linhas são adicionados. Os utilizadores têm a opção de recuperar a imagem como um ficheiro armazenado na sua máquina local ou como conteúdo da área de transferência.
Nota
As ações do Word no Power Automate para ambiente de trabalho são compatíveis com o Microsoft Word 2013 ou versões posteriores.
Iniciar o Word
Abre uma nova instância do Word ou abre um documento do Word.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Iniciar o Word | N/A | Com um documento em branco e abrir o seguinte documento | Com um documento em branco | Especifique se pretende abrir um novo documento do Word ou um documento existente |
| Caminho do documento | Não | Ficheiro | O caminho completo do documento do Word existente a abrir | |
| Tornar a instância visível | N/A | Valor booleano | Verdadeiro | Especifique se pretende tornar a janela do Word visível ou ocultá-la |
| Abrir como ReadOnly | N/A | Valor booleano | Falso | Especifique se o documento armazenado deve ser aberto no modo só de leitura |
| Palavra-passe de proteção contra leitura | Sim | Entrada direta encriptada ou Valor de texto | A palavra-passe de proteção contra leitura do documento do Word, se este estiver protegido por palavra-passe | |
| Palavra-passe de proteção contra escrita | Sim | Entrada direta encriptada ou Valor de texto | A palavra-passe de proteção contra escrita do documento do Word, se este estiver protegido por palavra-passe |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
WordInstance |
Instância do Word | A instância específica do Word a utilizar com ações posteriores do Word. Isto permite ao utilizador especificar a que documentos do Word aceder |
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao iniciar o Word | Indica um problema ao iniciar uma instância do Word |
| O documento do Word não foi encontrado | Indica que não foi possível encontrar o documento do Word específico na localização fornecida |
| Falha ao abrir documento do Word existente | Indica um problema ao abrir ao documento do Word especificado |
| Falha ao iniciar a aplicação Word | Indica que a aplicação Word não pôde ser iniciado devido a um erro interno |
| A aplicação Word não está instalada | Indica que a aplicação Word não está instalada na máquina específica |
Anexar a uma instância do Word em execução
Anexa a um documento do Word que já está aberto.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Nome do documento | Não | Ficheiro | O nome ou caminho do documento do Word ao qual anexar |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
WordInstance |
Instância do Word | A instância do Word de destino desta ação de anexar, para utilização com ações posteriores do Word |
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao anexar ao documento do Word | Indica um problema ao anexar ao documento do Word especificado |
| Documento do Word especificado não encontrado | Indica que não foi possível encontrar o documento do Word específico na localização fornecida |
| Falha ao iniciar o Word | Indica que a aplicação Word não pôde ser iniciada devido a um erro interno |
Guardar instância do Word
Guarda uma instância do Word anteriormente iniciada.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Word a guardar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução. | |
| Modo de guardar | N/A | Guardar documento, Guardar documento como | Guardar documento | Como guardar o documento desta instância. |
| Formato do documento | N/A | Todos os formatos disponíveis na aplicação Word | Predefinição (A partir da Extensão) | O formato do documento. |
| Caminho do documento | Não | Ficheiro | O caminho completo do documento. Insira a extensão de ficheiro do documento desejada de acordo com a seleção no parâmetro Formato do documento . |
Variáveis produzidas
Esta ação não produz quaisquer variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao guardar o Word | Indica um problema ao guardar o documento do Word |
| A instância do Word ou o documento do Word não foi inicializado | Indica que a instância do Word ou documento do Word especificado na ação não foi inicializado |
| Não é possível executar a operação num documento só de leitura | Indica que o documento do Word não pode ser guardado porque está aberto como só de leitura |
Fechar Word
Fecha uma instância do Word.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Word a fechar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução. | |
| Antes de fechar o Word | N/A | Não guardar documento, Guardar documento, Guardar documento como | Não guardar documento | Especifique se e como deve ser guardado o documento existente nesta instância antes de a fechar. |
| Formato do documento | N/A | Todos os formatos disponíveis na aplicação Word | Predefinição (A partir da Extensão) | O formato do documento. |
| Caminho do documento | Não | Ficheiro | O caminho completo do documento. Insira a extensão de ficheiro do documento desejada de acordo com a seleção no parâmetro Formato do documento . |
Variáveis produzidas
Esta ação não produz quaisquer variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao fechar o Word | Indica um problema ao fechar o documento do Word |
| Falha ao guardar o Word | Indica um problema ao guardar o documento do Word |
| Não é possível executar a operação num documento só de leitura | Indica que o documento do Word não pode ser guardado porque está aberto como só de leitura |
Ler a partir de documento do Word
Lê o conteúdo do texto de um documento de uma instância do Word.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Work com a qual vai trabalhar | Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução |
| Obter | N/A | Documento inteiro/Páginas/Marcador | Documento inteiro | Indica se pretende obter o conteúdo do documento completo, páginas específicas ou um marcador |
| Página | Não | Valor numérico | 1 | As páginas do documento Word a ler. Um intervalo de páginas ou uma lista pode ser fornecida como 2-5, que recuperará o conteúdo da página 2 à página 5 ou 2,3,7, que irá recuperar o conteúdo das páginas 2,3,7 |
| Marcador | Não | Valor de texto | O marcador do documento do Word a ler |
Variáveis produzidas
| Argumento | Tipo | Descrição |
|---|---|---|
| WordData | Valor de texto | O valor do conteúdo obtido |
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao ler o conteúdo de um documento do Word | Indica um problema ao recuperar o conteúdo do documento do Word especificado |
| A instância do Word ou o documento do Word não foi inicializado | Indica que a instância do Word ou documento do Word especificado na ação não foi inicializado |
Escrever num documento do Word
Escrever ou acrescentar texto a um ficheiro do Word.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Work com a qual vai trabalhar | Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução |
| Texto a escrever | Sim | Valor geral | O texto a escrever no documento do Word especificado | |
| Acrescentar nova linha | N/A | Valor booleano | Verdadeiro | Especifica se deve ser acrescentada uma nova linha no início do texto global a escrever no documento |
| Escrever texto em | N/A | Início do ficheiro do Word/Fim do ficheiro do Word/Antes do Marcador/Depois do Marcador | Início do ficheiro do Word | Especifica a posição do documento Word onde o texto será anexado |
| Marcador | Não | Valor de texto | O marcador de destino no documento Word onde o texto será anexado | Esta ação anexa texto antes ou depois do marcador especificado no documento do Word |
Variáveis produzidas
Esta ação não produz quaisquer variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| A instância do Word ou o documento do Word não foi inicializado | Indica que a instância do Word ou documento do Word especificado na ação não foi inicializado |
| Não é possível executar a operação num documento só de leitura | Indica que o documento do Word não pode ser editado porque está aberto como só de leitura |
| A operação de gravação na instância do documento do Word falhou | Indica um problema ao escrever conteúdo no documento do Word especificado |
Inserir imagem em documento do Word
Inserir uma imagem num ficheiro do Word.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Work com a qual vai trabalhar | Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução |
| Inserir imagem em | N/A | Início do ficheiro do Word/Fim do ficheiro do Word/Antes do Marcador/Depois do Marcador/Antes do texto específico/Depois do texto específico | Início do ficheiro do Word | Especifica a posição do documento do Word em que a imagem será acrescentada |
| Inserir imagem de | N/A | Ficheiro/Área de Transferência | Ficheiro | A localização da imagem a inserir no documento do Word especificado |
| Caminho da imagem | Não | Ficheiro | O caminho completo da imagem a inserir | |
| Texto a analisar | Não | Valor de texto | O texto a localizar no documento do Word para inserção de imagem | A imagem será anexada antes ou depois de qualquer ocorrência do texto especificado |
| Marcador | Não | Valor de texto | O marcador de destino no documento do Word em que a imagem será acrescentada |
Variáveis produzidas
Esta ação não produz quaisquer variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| A instância do Word ou o documento do Word não foi inicializado | Indica que a instância do Word ou documento do Word especificado na ação não foi inicializado |
| Não é possível executar a operação num documento só de leitura | Indica que o documento do Word não pode ser editado porque está aberto como só de leitura |
| Falha ao inserir imagem | Indica um problema ao inserir a imagem no documento do Word especificado |
Localizar e substituir palavras num documento do Word
Localiza texto e substitui-o por outro texto na folha de cálculo ativa de uma instância do Excel.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor Predefinido | Descrição |
|---|---|---|---|---|
| Instância do Word | Não | Instância do Word | A instância do Work com a qual vai trabalhar | Esta variável tem de ter sido previamente especificada numa ação Iniciar Word ou Anexar ao Word em execução |
| Todas as correspondências | N/A | Valor booleano | Falso | Indica se o texto deve ser localizado/substituído em todas as ocorrências correspondentes encontradas ou apenas na primeira ocorrência correspondente |
| Texto a analisar | Não | Valor de texto | O texto a localizar na folha de cálculo | |
| Texto para substituir | Não | Valor de texto | O texto utilizado para substituir as células correspondentes | |
| Utilizar carateres universais | N/A | Valor booleano | Falso | Indica se pretende utilizar carateres universais para o texto a localizar |
| Maiúsculas/Minúsculas | N/A | Valor booleano | Falso | Indica se pretende procurar dados sensíveis às maiúsculas e minúsculas |
| Corresponder apenas palavras inteiras | N/A | Valor booleano | Falso | Indica se pretende procurar palavras que são iguais ao texto especificado |
Variáveis produzidas
Esta ação não produz quaisquer variáveis.
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao substituir texto no documento do Word | Indica um problema ao substituir o texto especificado com a entrada fornecida |
| A instância do Word ou o documento do Word não foi inicializado | Indica que a instância do Word ou documento do Word especificado na ação não foi inicializado |
| Não é possível executar a operação num documento só de leitura | Indica que o documento do Word não pode ser editado porque está aberto como só de leitura |
Limitações conhecidas
Utilizar ficheiros Word sincronizados através do OneDrive ou do SharePoint
A interação com ficheiros do Microsoft Word contidos em pastas sincronizadas no OneDrive ou no SharePoint poderá resultar num fluxo erróneo. O Power Automate para ambiente de trabalho utiliza objetos COM para interações com o Word. O OneDrive e o SharePoint não são totalmente compatíveis com instâncias do Word lançadas através de COM.
Por este motivo, quando tenta abrir um ficheiro do Word armazenado num diretório do OneDrive ou do SharePoint, poderá encontrar um erro de ficheiro não encontrado. Para resolver este problema, utilize uma das seguintes alternativas:
Alternativa 1
- Faça uma cópia local do respetivo ficheiro do Word.
- Modifique a cópia local do ficheiro do Word utilizando as ações de automatização do Word do Power Automate para ambiente de trabalho.
- Substitua a cópia do ficheiro do Word sincronizada através do OneDrive ou do Sharepoint com a cópia local que inclui as alterações mais recentes.
Alternativa 2
- Abra uma nova instância do Word utilizando a ação Executar aplicação. Certifique-se de que fornece tempo de espera suficiente entre as ações, permitindo que o processo do Word seja carregado por completo, incluindo quaisquer suplementos.
- Utilize a a ação Anexar ao Word em execução para anexar ao novo processo.
Nota
Esta solução pode ser utilizada em geral quando a ação Iniciar Word falha a execução.