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 a entrada correta tipo de cápsula de dados 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 inadequado, 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 Teste 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: Madrid
• Saída: M

Neste exemplo, o fluxo é acionado quando um registro Usuário [sys_user] é criado. Em seguida, o fluxo atualiza o. Cidade Campo do registro 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: Madrid
• 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 fornecida (regex) e na cadeia de caracteres de substituição. Use o formato de expressão regular 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 parâmetros fornecidos

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

Dividir

Retorna um Array.String com base em um fornecido Separador Que divide a cadeia de caracteres de entrada. . Separador O campo é deixado em branco, a transformação é ignorada e o sistema retorna a cadeia de caracteres de entrada. Se estiver inserindo qualquer tipo de dados diferente de uma cadeia de caracteres como Separador , O sistema converte 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 especifica onde a cadeia de caracteres de entrada deve ser dividida. Se 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 substring da cadeia de caracteres de entrada que é baseada no fornecido Índice de início e. Índice final . O índice de 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 substring retornada End Index - Índice do último caractere a ser incluído na substring retornada	Cadeia de caracteres - Cadeia de caracteres transformada como uma substring da cadeia de caracteres de entrada

Figura 11. Exemplo

• Entrada: Exemplo de cadeia de caracteres de entrada
• Índice inicial: 3
• Índice final: 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: Exemplo de cadeia de caracteres de entrada
• Saída: exemplo de cadeia de caracteres de entrada

Para maiúsculas/minúsculas

Muda a maiúsculas e minúsculas das palavras na cadeia de caracteres de entrada. 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. A função de transformação sempre avalia 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: Cadeia de caracteres/TEXTO de entrada de exemplo
• Saída: Cadeia de caracteres/texto de entrada de exemplo

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: Exemplo de cadeia de caracteres de entrada
• Saída: EXEMPLO DE CADEIA DE CARACTERES DE ENTRADA

Corte

Remove espaços em branco do início e do final da cadeia de caracteres de entrada. Não remove o espaço 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 Transformação de corte remove qualquer espaço em branco indesejado antes de adicionar o nome do servidor a um novo registro na tabela Servidor [cmdb_ci_server].