Compartilhar via

Funções de coleção CreateUiDefinition

  • Artigo

Essas funções podem ser usadas com coleções, como cadeias de caracteres JSON, matrizes e objetos.

contém

Retorna true se uma cadeia de caracteres contém a subcadeia de caracteres especificada, uma matriz contém o valor especificado ou um objeto contém a chave especificada.

Exemplo: a cadeia de caracteres contém

O exemplo a seguir retorna true:

"[contains('webapp', 'web')]"

Exemplo: a matriz contém

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna false:

"[contains(steps('demoStep').element1, 4)]"

Exemplo: o objeto contém

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna true:

"[contains(steps('demoStep').element1, 'key1')]"

vazio

Retorna true se a cadeia de caracteres, matriz ou objeto é nulo ou vazio.

Exemplo: cadeia de caracteres vazia

O exemplo a seguir retorna true:

"[empty('')]"

Exemplo: matriz vazia

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna false:

"[empty(steps('demoStep').element1)]"

Exemplo: objeto vazio

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna false:

"[empty(steps('demoStep').element1)]"

Exemplo: nulo e indefinido

Suponha que element1 é null ou indefinido. O exemplo a seguir retorna true:

"[empty(steps('demoStep').element1)]"

filter

Retorna uma nova matriz depois de aplicar a lógica de filtragem fornecida como uma função lambda. O primeiro parâmetro é a matriz a ser usada para filtragem. O segundo parâmetro é a função lambda que especifica a lógica de filtragem.

A amostra a seguir retorna a matriz [ { "name": "abc" } ].

"[filter(parse('[{\"name\":\"abc\"},{\"name\":\"xyz\"}]'), (item) => contains(item.name, 'abc'))]"

first

Retorna o primeiro caractere da cadeia de caracteres especificada, o primeiro valor da matriz especificada ou a primeira chave e valor do objeto especificado.

Exemplo: cadeia de caracteres primeiro

O exemplo a seguir retorna "c":

"[first('contoso')]"

Exemplo: matriz primeiro

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna 1:

"[first(steps('demoStep').element1)]"

Exemplo: objeto primeiro

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna {"key1": "Linux"}:

"[first(steps('demoStep').element1)]"

last

Retorna o último caractere da cadeia de caracteres especificada, o último valor da matriz especificada ou a última chave e valor do objeto especificado.

Exemplo: cadeia de caracteres por último

O exemplo a seguir retorna "o":

"[last('contoso')]"

Exemplo: matriz por último

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna 3:

"[last(steps('demoStep').element1)]"

Exemplo: objeto por último

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna {"key2": "Windows"}:

"[last(steps('demoStep').element1)]"

comprimento

Retorna o número de caracteres em uma cadeia de caracteres, o número de valores em uma matriz ou o número de chaves em um objeto.

Exemplo: comprimento da cadeia de caracteres

O exemplo a seguir retorna 7:

"[length('Contoso')]"

Exemplo: comprimento da matriz

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna 3:

"[length(steps('demoStep').element1)]"

Exemplo: comprimento do objeto

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna 2:

"[length(steps('demoStep').element1)]"

mapa

Retorna uma nova matriz depois de chamar uma função lambda em uma matriz fornecida. O primeiro parâmetro é a matriz a ser usada para a função lambda. O segundo parâmetro é a função lambda.

O exemplo a seguir retorna uma nova matriz com cada valor dobrado. O resultado é [2, 4, 6].

"[map(parse('[1, 2, 3]'), (item) => mul(2, item))]"

A amostra a seguir retorna uma nova matriz ["abc", "xyz"].

"[map(parse('[{\"name\":\"abc\"},{\"name\":\"xyz\"}]'), (item) => item.name)]"

skip

Ignora um número especificado de elementos em uma coleção e, em seguida, retorna os elementos restantes.

Exemplo: ignorar cadeia de caracteres

O exemplo a seguir retorna "app":

"[skip('webapp', 3)]"

Exemplo: ignorar matriz

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna [3]:

"[skip(steps('demoStep').element1, 2)]"

Exemplo: ignorar objeto

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna {"key2": "Windows"}:

"[skip(steps('demoStep').element1, 1)]"

divisão

Retorna uma matriz de cadeia de caracteres contendo as subcadeias da entrada delimitada pelo separador.

A amostra a seguir retorna a matriz [ "555", "867", "5309" ].

"[split('555-867-5309', '-')]"

take

Retorna um número especificado de caracteres contíguos do início da cadeia de caracteres, um número especificado de valores contíguos do início da matriz ou um número especificado de chaves e valores contíguos do início do objeto.

Exemplo: take da cadeia de caracteres

O exemplo a seguir retorna "web":

"[take('webapp', 3)]"

Exemplo: take da matriz

Suponha que element1 retorne [1, 2, 3]. O exemplo a seguir retorna [1, 2]:

"[take(steps('demoStep').element1, 2)]"

Exemplo: take do objeto

Suponha que element1 retorne:

{
  "key1": "Linux",
  "key2": "Windows"
}

O exemplo a seguir retorna {"key1": "Linux"}:

"[take(steps('demoStep').element1, 1)]"

Próximas etapas