Escrever Texto

Realiza escrita do arquivo texto

Visão Geral

O objeto Escrever Texto é utilizado para escrever conteúdo em arquivos de texto ou CSV durante a execução de um robô.

Esse objeto permite registrar dados estruturados ou textos simples em arquivos externos, possibilitando a geração de logs, relatórios ou arquivos CSV utilizados em integrações e processamento de dados.

A escrita pode ser realizada utilizando um objeto do tipo arquivo ou informando diretamente o caminho do arquivo, permitindo flexibilidade na manipulação de arquivos dentro da automação.

---

Funcionamento

O objeto Escrever Texto escreve conteúdo em um arquivo definido durante a configuração.

Fluxo de funcionamento:

1. O robô executa o objeto Escrever Texto.

2. O usuário define se o arquivo será informado como Objeto do tipo Arquivo ou Caminho do Arquivo.

3. O campo Conteúdo recebe o texto que será gravado no arquivo.

4. Caso a opção Sobrescrever Conteúdo esteja habilitada, o conteúdo anterior do arquivo será substituído.

5. Caso contrário, o conteúdo será adicionado ao final do arquivo existente.

Após a execução, o arquivo conterá o conteúdo inserido pelo robô.

Quando usar

• Quando for necessário registrar dados em arquivos de texto ou CSV.

• Quando o robô precisar gerar relatórios ou arquivos estruturados.

• Quando processos automatizados exigirem armazenamento de informações para uso posterior.

Quando não usar

Não utilizar quando não houver necessidade de registrar dados em arquivos externos ou quando as informações precisarem ser armazenadas apenas em variáveis internas do robô.

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Define a versão do componente utilizada no objeto.
Título	Nome do objeto dentro do fluxo do robô.
Objeto do tipo Arquivo	Define o objeto de arquivo que será utilizado para escrita do conteúdo.
Caminho do Arquivo	Permite informar diretamente o caminho do arquivo no sistema.
Variáveis	Permite inserir variáveis que podem ser utilizadas no conteúdo do arquivo.
Sobrescrever Conteúdo	Quando habilitado, substitui o conteúdo existente no arquivo.
Conteúdo	Texto que será escrito no arquivo.

---

Exemplos

Exemplo simples

Fluxo básico para escrever conteúdo em um arquivo:

1. Inserir o objeto Criar Texto para gerar o arquivo.

2. Inserir o objeto Escrever Texto no fluxo do robô.

3. Selecionar o Objeto do tipo Arquivo ou informar o Caminho do Arquivo.

4. Informar o texto no campo Conteúdo.

5. Executar o robô.

Após a execução, o conteúdo será registrado no arquivo.

Exemplo aplicado

Cenário: um robô precisa gerar um arquivo CSV com dados processados.

Fluxo:

1. O robô coleta dados de um sistema.

2. Os dados são organizados em formato de texto estruturado.

3. O objeto Escrever Texto grava os dados no arquivo CSV.

4. O arquivo gerado pode ser utilizado para integração com outros sistemas ou análise de dados.

---

Retornos

A documentação oficial não descreve retornos específicos para este objeto.

O objeto executa a ação de escrever conteúdo em um arquivo, permitindo que o arquivo seja utilizado posteriormente no fluxo do robô.

---

Erros comuns e como evitar

Arquivo não definido

Se nenhum arquivo for informado, o conteúdo não poderá ser escrito.

Como evitar:

• Definir corretamente o Objeto do tipo Arquivo ou o Caminho do Arquivo.

Arquivo inexistente

Se o arquivo não existir, a escrita pode falhar.

Como evitar:

• Criar o arquivo previamente utilizando o objeto Criar Texto ou garantir que o caminho seja válido.

Sobrescrita indesejada

Se a opção Sobrescrever Conteúdo estiver habilitada, o conteúdo anterior será apagado.

Como evitar:

• Verificar a configuração antes da execução.

---

Boas práticas

• Criar ou validar o arquivo antes de realizar a escrita.

• Utilizar variáveis no conteúdo para registrar dados dinâmicos.

• Utilizar nomes claros para arquivos de saída.

• Utilizar a opção Sobrescrever Conteúdo apenas quando necessário.