Use o componente Formatar texto

Formate o texto usando espaços reservados de variáveis e variáveis de linha e guia com o componente Formatar texto em Design studio de RPA para desktop. Você pode atualizar o texto e suas posições facilmente apenas atualizando os espaços reservados de variáveis e as variáveis de linha e guia.

Antes de Iniciar

Função necessária: nenhuma

Por Que e Quando Desempenhar Esta Tarefa

Dicas essenciais a serem lembradas ao usar o componente Formatar texto para evitar as exceções a seguir.

Argumentos ausentes

Este problema ocorre quando a cadeia de caracteres de formato contém mais espaços reservados do que o número de argumentos fornecidos.

Por exemplo,

• Cadeia de caracteres de formato: (0) (1)
• Argumentos fornecidos: "Olá"

A mensagem de erro exibida para este problema é "Ocorreu um erro durante a execução. Componente "Formatar texto" falhou ao executar na atividade "Nova atividade"."

O índice (baseado em zero) deve ser maior ou igual a zero e menor que o tamanho da lista de argumentos.

A solução é garantir que o número de argumentos corresponda ao número de espaços reservados na cadeia de caracteres de formato:

"Olá"

"Mundo"

Posicionamento correto do argumento

O índice (baseado em zero) deve ser maior ou igual a zero e menor que o tamanho da lista de argumentos.

Solução:

A solução é garantir que o número de argumentos corresponda ao número de espaços reservados na cadeia de caracteres de formato. Por exemplo:

• Cadeia de caracteres do formato: "Olá"
• Argumento: "Mundo"

Nesse caso, a cadeia de caracteres de formato não contém espaços reservados, portanto, nenhum argumento é necessário. Se você tiver uma cadeia de caracteres de formato como "Olá, (0)! (Bem-vindo(a) a (1)." você precisaria fornecer dois argumentos, como "Mundo" e. "ServiceNow" .

Uso de chaves literais em cadeias de caracteres de formato

Chaves têm significado especial na formatação de cadeia de caracteres e devem ser escapadas quando usadas como caracteres literais.

Exemplo de uso incorreto:

Cadeia de caracteres do formato:

{
{0}
{1}
},

Mensagem de erro: Ocorreu um erro durante a execução. Componente "Formatar texto" falhou ao executar na atividade "Nova atividade".

A cadeia de caracteres de entrada não estava no formato correto

A solução é usar chaves duplas para representar chaves literais:

{{
{0}
{1}
}},

Regra a ser lembrada:

• . representa um literal .
• . representa um literal .

Você pode configurar as propriedades do componente Formatar texto. Para mais obter mais informações sobre essas propriedades, confira Propriedades dos Componentes gerais.

Procedimento

1. No painel Caixa de ferramentas, navegue até Geral > Formatar texto.
2. Arraste o componente Formatar texto para a superfície de design.
3. Para definir a variável de espaço reservado de texto, siga as etapas a seguir.
   1. Clique no ícone adicionar variável ( ).
      Uma porta de entrada de dados é adicionada para cada variável adicionada.
   2. Para configurar o valor da variável, consulte Configure as propriedades da porta.
   3. Opcional: Repita as etapas para adicionar mais variáveis e valores.
4. Clique no ícone Configurações do componente ( ).
5. Insira o texto no EDITOR DE FORMATO DE TEXTO.
6. Insira o texto.
7. Opcional: Insira a variável do separador de linha ou do separador de tabulação em locais apropriados no texto.
8. Insira os espaços reservados da variável de texto no corpo do texto, onde apropriado.
   Dica:

   Para atualizar o texto, atualize o valor do espaço reservado.
9. Conecte as portas de dados e controle do componente Formatar texto às portas correspondentes do outro componente, conforme descrito na tabela a seguir.

   Tipo da porta	Finalidade da conexão	Obrigatório?
   Dados em (Variável)	Usa o valor da variável de um componente executado anteriormente.	Sim
   Saída de dados (saída formatada)	Retorna o texto formatado e passa para o próximo componente.	Sim. Para exibir a saída, clique com o botão direito do mouse em Retornar e clique Visualizar dados .
   Controle em	Passa o controle do componente executado anteriormente.	Sim
   Saída de controle	Passa o controle para o próximo componente.	... A conexão da porta é opcional.

10. Opcional: Para testar o componente, em DESIGN clique em Executar .