Funções de coleção CreateUiDefinition

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 especificada, uma matriz contém o valor especificado ou um objeto contém a chave especificada.

Exemplo: string contém

O exemplo a seguir retorna true:

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

Exemplo: matriz contém

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

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

Exemplo: objeto contém

Suponha element1 retornos:

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

O exemplo a seguir retorna true:

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

empty

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

Exemplo: string vazia

O exemplo a seguir retorna true:

"[empty('')]"

Exemplo: matriz vazia

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

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

Exemplo: objeto vazio

Suponha element1 retornos:

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

O exemplo a seguir retorna false:

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

Exemplo: nulo e indefinido

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

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

filtrar

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.

O exemplo a seguir retorna a matriz [ { "name": "abc" } ].

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

Primeiro

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

Exemplo: string first

O exemplo a seguir retorna "c":

"[first('contoso')]"

Exemplo: array first

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

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

Exemplo: objeto primeiro

Suponha element1 retornos:

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

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

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

Último

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: string last

O exemplo a seguir retorna "o":

"[last('contoso')]"

Exemplo: array last

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

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

Exemplo: objeto último

Suponha element1 retornos:

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

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

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

length

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 element1 retornos [1, 2, 3]. O exemplo a seguir retorna 3:

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

Exemplo: comprimento do objeto

Suponha element1 retornos:

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

O exemplo a seguir retorna 2:

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

map

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))]"

O exemplo 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: string skip

O exemplo a seguir retorna "app":

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

Exemplo: array skip

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

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

Exemplo: pulo de objeto

Suponha element1 retornos:

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

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

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

split

Retorna uma matriz de cadeias de caracteres contendo as subcadeias da entrada delimitadas pelo separador.

O exemplo 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: string take

O exemplo a seguir retorna "web":

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

Exemplo: array take

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

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

Exemplo: tomada de objeto

Suponha element1 retornos:

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

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

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

Próximos passos

• Para obter uma introdução ao Azure Resource Manager, consulte Visão geral do Azure Resource Manager.