Strings, Strings Numéricas e Sequências

Em expressões, as strings incluem campos como nomes de propriedades e expressões, além de valores literais. Após você selecionar uma string em uma expressão, há vários métodos e atributos que podem ser selecionados para essa string. Por exemplo, você pode concatenar a descrição e o nome de um nó e usar a string resultante em uma propriedade Alias ou pode retornar apenas uma parte de uma string de origem usando o método de substring.

Strings numéricas e tipos de dados de sequência são strings que oferecem suporte apenas para valores numéricos (0-9). O limite dessas strings é de 40 caracteres.

Você pode adicionar valores literais a tipos de dados String. Consulte Como Trabalhar com Valores Literais.

Muitos dos métodos de string requerem que você insira parâmetros adicionais. O construtor de expressões cria um novo termo de expressão para os parâmetros adicionais quando você seleciona esse método. Por exemplo, quando você seleciona um método concat, um termo de expressão adicional é adicionado para que a string a ser anexada seja especificada. Quando você seleciona um método replace, dois termos de expressão adicionais são acrescentados para permitir a especificação do texto de pesquisa e do texto para substituí-lo.

A tabela a seguir descreve os métodos e atributos que podem ser usados para manipular valores de string no construtor de expressões, além dos parâmetros para esses campos.

Método ou Atributo	Uso	Parâmetros
`Concat`	Concatena (ou anexa) dois ou mais campos de string e retorna a string combinada como resultado. Note: Você pode juntar várias strings em um única instrução `concat`. Quando houver várias strings para concatenar, você poderá clicar em em um termo de expressão e selecionar Inserir Acima ou Remover para inserir esse campo ou removê-lo.	A string a ser anexada
`endsWith`	Retorna `True` se a string original terminar com a string especificada. Note: A string especificada faz distinção entre maiúscula/minúscula.	A string especificada para verificar se está no final da string original.
`equals`	Retorna `True` caso a string seja igual à string especificada.	A string especificada para verificar se é igual à string original.
`greaterThan`	Retorna `True` se o valor da string for maior que o valor especificado (os dois devem ser do mesmo tipo de dados).	A string especificada para verificar se a string original é maior que.
`greaterThanOrEqual`	Retorna `True` se o valor da string for maior que ou igual ao valor especificado (os dois devem ser do mesmo tipo de dados).	A string especificada para verificar se a string original é maior que ou igual a.
`indexOf`	Retorna a posição inicial da string especificada na string original. Note: O método `indexOf` retorna um inteiro, que não pode ser usado diretamente como um valor de retorno. Você pode usar esse inteiro para determinar a posição inicial de uma substring. Consulte Número Inteiro e Flutuante.	A string para a qual você deseja encontrar a posição inicial.
`IsEmpty`	Retornará `True` se a propriedade contiver um valor nulo ou uma string vazia.	Não são necessários parâmetros
`isNull`	Retornará `True` se a propriedade da string tiver um valor nulo.	Não são necessários parâmetros
`length`	Conta o número de caracteres de uma string O atributo `length` é um inteiro. Consulte Número Inteiro e Flutuante.	Não são necessários parâmetros
`lessThan`	Retorna `True` se o valor da string for menor que o valor especificado (os dois devem ser do mesmo tipo de dados).	A string especificada para verificar se a string original é menor que.
`lessThanOrEqual`	Retorna `True` se o valor da string for menor que ou igual ao valor especificado (os dois devem ser do mesmo tipo de dados).	A string especificada para verificar se a string original é menor que ou igual a.
`matches`	Retorna `True` caso a string corresponda à expressão regular Java especificada. Tip: Expressões regulares especificam padrões para pesquisar em dados da string usando convenções de sintaxe padronizadas. Uma expressão regular, ou regex, pode especificar padrões ou sequências de caracteres complexos. Por exemplo, a seguinte expressão regular: `a(b\|c)d` pesquisa o padrão: `a`, seguido de `b` ou `c` e seguido de `d`. Essa expressão regular encontra `abd` e `acd`.	A expressão regular Java especificada para verificar se a string original corresponde. Note: As expressões regulares do Java executam correspondências completas em strings, e não correspondências parciais. Portanto, se você estiver procurando `Corporate` no nome de um aplicativo, um aplicativo cujo nome seja `Corporate Planning` não seria uma correspondência. Use caracteres curinga antes e depois de uma string para procurar correspondências parciais. Por exemplo, `.Corporate.` corresponderá com `Corporate Planning`.
`orElse`	Retorna um valor especificado caso o termo da expressão anterior tenha um valor nulo.	O valor a ser retornado se o termo da expressão anterior for nulo. Por exemplo, `return node.properties.Core.Description.orElse('Default Descr')` retornará "Default Descr" caso a propriedade Core.Description de um nó seja nula.
`replace`	Substitui todas as instâncias de uma string antiga por uma string nova	A string a ser pesquisada Note: Você pode usar uma expressão Java regular para identificar o padrão de string da pesquisa. A string que substituirá a string original
`split`	Divide uma string em uma lista de strings com base no delimitador especificado. Note: Consulte Lista e Lista de Strings dos métodos que você pode adicionar a uma lista de strings.	O delimitador em que a string será dividida Incluir em Branco: Especifique se valores em branco deverão ser incluídos ou não como itens de lista na lista de strings resultante. `True`: Permite que valores em branco sejam incluídos na lista de strings resultante. `False` (padrão): Os valores em branco são excluídos da lista de strings resultante. Por exemplo, para a string `A//C`, se a opção Incluir em Branco estiver ativa, a lista de strings terá três entradas: `A, (valor em branco), C`. Se ela estiver desativada, a lista de strings terá duas entradas: `A` e `C`.
`startsWith`	Retorna `True` se a string original começar com a string especificada. Note: A string especificada faz distinção entre maiúscula/minúscula.	A string especificada para verificar se está no começo da string original.
`substring`	Retorna parte de uma string.	A posição inicial O número de caracteres a serem retornados
`toDate`	Converte o valor de uma string em um valor de data	O formato de data (por exemplo, (MM/dd/aaaa). Consulte Símbolos de Formatação de Data e Hora para ver a formatação de data e hora.
`toFloat`	Converte o valor de uma string em um valor flutuante	Não são necessários parâmetros
`toInteger`	Converte o valor de uma string em um valor de número inteiro	Não são necessários parâmetros
`toLowerCase`	Retorna uma string somente em letra minúscula.	Não são necessários parâmetros
`toUpperCase`	Retorna uma string somente em letra maiúscula.	Não são necessários parâmetros
`trim`	Retorna uma string com espaços em branco removidos à esquerda e à direita. Note: `Trim` também removerá caracteres de espaço em branco, como Tabulações e Retornos de Carro.	Não são necessários parâmetros

Para greaterThan, greaterThanOrEqual, lessThan e lessThanorEqual, a string é classificada pelo primeiro caractere, depois pelo segundo e assim por diante. Em uma comparação, 0-9 é menos que A-Z.

Exemplos:

A < AA
AA > B
11 < 2
A > 1

Você pode combinar atributos e métodos de string na expressão. Por exemplo, a string a seguir procura o caractere @ na descrição de um nó e retorna tudo após esse caractere.

tela contendo uma expressão, conforme descrito no parágrafo a seguir

Neste exemplo, o primeiro termo de expressão é uma expressão de substring, o que requer dois parâmetros: uma posição inicial e o número de caracteres a serem retornados.

Para o termo de expressão de posição inicial, selecionamos um método indexOf com um parâmetro "@". Esse método procurará o caractere @ no campo de descrição e retornará o valor inteiro de onde esse caractere está localizado como posição inicial.
Para o número de caracteres que deverão retornar um termo de expressão, selecionamos um atributo length. Isso garante que, mesmo que a string seja longa, o valor completo após o caractere de @ seja retornado, pois o número de caracteres é igual ao tamanho da string completa.