Funções de transformação de cadeia de caracteres

Use funções de transformação de cadeia de caracteres para reformatar ou executar cálculos em cápsulas de dados de cadeia de caracteres.

As funções de transformação de cadeia de caracteres exigem uma cápsula de dados de entrada de cadeia de caracteres. Certifique-se de usar o tipo de cápsula de dados de entrada correto ao aplicar funções de transformação de cadeia de caracteres. Se uma função de transformação de cadeia de caracteres for aplicada a um tipo de dados impróprio, os dados não serão transformados no tempo de execução e o valor de entrada será retornado. Para obter mais informações sobre como confirmar os valores de tempo de execução do fluxo, consulte Testar um fluxo.

Converter cadeia de caracteres em número

Converte uma cadeia de caracteres em um número.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	Número - número convertido de uma cadeia de caracteres.

Figura 1. Exemplo

• Entrada: "500"
• Saída: 500

Contém

Retorna verdadeiro quando a cadeia de caracteres de entrada contém uma determinada sequência de caracteres.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Caracteres a serem pesquisados.	Booliano que indica se existe uma sequência de caracteres na cadeia de caracteres de entrada

Figura 2. Exemplo

• Entrada: pizza de queijo
• Parâmetro: queijo
• Saída: verdadeiro

Não contém

Retorna verdadeiro quando a cadeia de caracteres de entrada não contém uma determinada sequência de caracteres.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Caracteres a serem pesquisados.	Booliano que indica se uma sequência de caracteres não existe na cadeia de caracteres de entrada

Figura 3. Exemplo

• Entrada: pizza de queijo
• Parâmetro: Joey
• Saída: verdadeiro

Termina com

Retorna verdadeiro quando a cadeia de caracteres de entrada termina com uma determinada sequência de caracteres.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Caracteres a serem pesquisados.	Booliano que indica se a cadeia de caracteres de entrada termina com a sequência de caracteres fornecida

Figura 4. Exemplo

• Entrada: pizza de queijo
• Parâmetro: Pizza
• Saída: verdadeiro

Primeiro caractere

Retorna o primeiro caractere da cadeia de caracteres de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	Cadeia de caracteres: cadeia de caracteres transformada como o primeiro caractere da cadeia de caracteres de entrada.

Figura 5. Exemplo

• Entrada: Madri
• Saída: M

Neste exemplo, o fluxo é acionado quando um registro de Usuário [sys_user] é criado. O fluxo atualiza o campo Cidade do registro de Usuário [sys_user] com um código que é representado como o primeiro caractere do nome da cidade.

Último caractere

Retorna o último caractere da cadeia de caracteres de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	Cadeia de caracteres: cadeia de caracteres transformada como o último caractere da cadeia de caracteres de entrada.

Figura 6. Exemplo

• Entrada: Madri
• Saída: d

Substituir cadeia de caracteres

Retorna uma cadeia de caracteres substituída da cadeia de caracteres de entrada com base na expressão regular (regex) e na cadeia de caracteres de substituição fornecidas. Use o formato de expressão regular do JavaScript.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Regex - Expressão regular a ser correspondida para substituição Replace String - Cadeia de caracteres de substituição	Cadeia de caracteres resultante após a substituição por determinados parâmetros

Figura 7. Exemplo

• Entrada: "Exemplo de cadeia de caracteres de entrada."
• Parâmetros:
  • Regex: ""
  • Cadeia de caracteres de substituição: \\\
• Saída: "Exemplo de cadeia de caracteres de entrada".

Tamanho

Retorna o número total de caracteres na cadeia de caracteres de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	Inteiro

Figura 8. Exemplo

• Entrada: exemplo de cadeia de caracteres de entrada.
• Saída: 21

Divisão

Retorna uma Array.String com base em um separador fornecido que divide a cadeia de caracteres de entrada. Se o campo Separador for deixado em branco, a transformação será ignorada e o sistema retornará a cadeia de caracteres de entrada. Se inserir qualquer tipo de dados diferente de uma cadeia de caracteres como o separador, o sistema converterá o valor fornecido em uma cadeia de caracteres.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Separator - Insira um delimitador que especifique onde a cadeia de caracteres de entrada deve ser dividida. Se for deixado em branco, a cadeia de caracteres de entrada não será transformada no tempo de execução.	Array.String uma matriz de substrings da cadeia de caracteres de entrada.

Figura 9. Exemplo

• Entrada: exemplo, entrada, cadeia de caracteres.
• Separador: ,
• Saída: ["Exemplo", "entrada", "cadeia de caracteres".]

Começa com

Retorna verdadeiro quando a cadeia de caracteres de entrada começa com uma determinada sequência de caracteres.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Caracteres a serem pesquisados.	Booliano que indica se a cadeia de caracteres de entrada começa com a sequência de caracteres fornecida

Figura 10. Exemplo

• Entrada: pizza de queijo
• Parâmetro: Chees
• Saída: verdadeiro

Substring

Retorna uma subcadeia de caracteres da cadeia de caracteres de entrada que se baseia no Índice Inicial e no Índice Finalfornecidos. O índice da cadeia de caracteres de entrada começa em 0.

Cápsula de dados de entrada	Parâmetros	Cápsula de dados de saída
Cadeia de caracteres	Start Index - Índice do primeiro caractere a ser incluído na subcadeia de caracteres retornada End Index - Índice do último caractere a ser incluído na subcadeia de caracteres retornada	Cadeia de caracteres: cadeia de caracteres transformada como uma subcadeia de caracteres da cadeia de caracteres de entrada.

Figura 11. Exemplo

• Entrada: exemplo de cadeia de caracteres de entrada
• Índice de início: 3
• Índice de término: 6
• Saída: mple

Para minúsculas

Converte os caracteres da cadeia de caracteres de entrada em minúsculas.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	cadeia de caracteres em minúsculas.

Figura 12. Exemplo

• Entrada: ExamPle inpuT stRing
• Saída: exemplo de cadeia de caracteres de entrada

Para maiúsculas/minúsculas

Altera o caso das palavras na cadeia de caracteres de entrada. Coloca em maiúscula a primeira letra de cada palavra e torna as letras restantes na palavra minúsculas. Uma palavra é considerada qualquer cadeia de caracteres separada por um espaço, hífen, barra invertida ou caractere de barra normal. A função de transformação sempre avalia as palavras da esquerda para a direita para determinar a primeira letra.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	cadeia de caracteres em letras maiúsculas

Figura 13. Exemplo

• Entrada: exAMPle-input string/TEXT
• Saída: exemplo - cadeia de caracteres/texto de entrada

Para maiúsculas

Converte os caracteres da cadeia de caracteres de entrada em maiúsculas.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	cadeia de caracteres em maiúsculas.

Figura 14. Exemplo

• Entrada: ExamPle inpuT stRing
• Saída: EXAMPLE INPUT STRING

Corte

Remove espaços em branco do início e do final da cadeia de caracteres de entrada. Não remove espaços em branco na cadeia de caracteres de entrada.

Cápsula de dados de entrada	Cápsula de dados de saída
Cadeia de caracteres	Cadeia de caracteres - cadeia de caracteres transformada com espaço em branco cortado

Figura 15. Exemplo

• Entrada: SQL Server APAC 1
• Saída: SQL Server APAC 1

Neste exemplo, a ação faz uma chamada REST para um sistema de terceiros e obtém um corpo de resposta que contém dados sobre um servidor. Em seguida, a função de transformação Trim remove qualquer espaço em branco indesejado antes de adicionar o nome do servidor a um novo registro na tabela Servidor [cmdb_ci_server].