Pegar Subtexto

Extrai um trecho de um texto com base na posição e tamanho do caractere.

Visão Geral

O objeto Pegar Subtexto é utilizado para extrair uma parte específica de um texto durante a execução de um robô.

Esse objeto permite selecionar um trecho do texto com base em uma posição inicial e um tamanho definido, retornando apenas a parte correspondente ao intervalo especificado. Essa funcionalidade é útil em automações que precisam isolar partes específicas de um valor textual, como códigos, identificadores ou trechos estruturados de dados.

---

Funcionamento

O objeto Pegar Subtexto extrai um trecho específico de um texto com base em uma posição inicial e um tamanho definido.

Fluxo de funcionamento:

1. O robô executa o objeto Pegar Subtexto.

2. O campo Texto recebe o conteúdo que será processado.

3. O campo Posição inicial do subtexto define a posição onde a extração começará.

4. O campo Tamanho do subtexto define quantos caracteres serão extraídos a partir da posição inicial.

5. O sistema retorna o trecho correspondente ao intervalo definido.

Após a execução, o subtexto obtido pode ser utilizado nas próximas etapas da automação.

Quando usar

• Quando for necessário extrair uma parte específica de um texto.

• Quando o robô precisar isolar códigos, identificadores ou sequências específicas de caracteres.

• Quando processos automatizados exigirem manipulação de partes específicas de um conteúdo textual.

Quando não usar

Não utilizar quando for necessário analisar padrões complexos no texto, sendo mais adequado utilizar objetos baseados em Regex.

---

Configuração

CAMPO	DESCRITIVO
Título	Nome do objeto dentro do fluxo do robô.
Nome Identificador do Objeto	Identificador único do objeto dentro do robô.
Texto	Conteúdo textual que será utilizado para extrair o subtexto.
Posição inicial do subtexto	Define a posição inicial da extração dentro do texto.
Tamanho do subtexto	Define a quantidade de caracteres que serão extraídos a partir da posição inicial.

---

Exemplos

Exemplo simples

Fluxo básico para extrair parte de um texto:

1. Inserir o objeto Pegar Subtexto no fluxo do robô.

2. Informar o texto no campo Texto (ex.: "ABC12345XYZ").

3. Definir a Posição inicial do subtexto como 3.

4. Definir o Tamanho do subtexto como 5.

5. Executar o robô.

Após a execução, o valor retornado será:

12345

Exemplo aplicado

Cenário: um robô recebe um código composto por diferentes informações e precisa extrair apenas o identificador numérico.

Fluxo:

1. O robô recebe o valor "PED-987654-2024".

2. O objeto Pegar Subtexto extrai o trecho correspondente ao identificador.

3. O valor "987654" é retornado.

4. O robô utiliza esse valor em validações ou integrações.

---

Retornos

---

Erros comuns e como evitar

Posição inicial incorreta

Se a posição inicial estiver fora do intervalo do texto, o resultado pode ser vazio ou incorreto.

Como evitar:

• Garantir que a posição inicial esteja dentro do tamanho do texto.

Tamanho do subtexto inválido

Se o tamanho informado ultrapassar o limite do texto, a extração pode não retornar o resultado esperado.

Como evitar:

• Verificar o tamanho do texto antes de definir o intervalo.

---

Boas práticas

• Validar o conteúdo do texto antes de realizar a extração.

• Utilizar posições e tamanhos coerentes com a estrutura do texto.

• Utilizar nomes claros no campo Título para facilitar a manutenção da automação.

• Utilizar o objeto em conjunto com outros objetos de manipulação de texto para tratamento de dados.