Saltar para o conteúdo principal
Versão: Próximo

DISTINCT ATTRIBUTE PATHS

DISTINCT ATTRIBUTE PATHS ( campoObjeto ; rotaArray )

ParâmetroTipoDescrição
campoObjetoCampo🡒campo objeto indexado
rotaArrayArray texto🡘Array que vai receber a lsita de diferentes rotas

Descrição

O comando DISTINCT ATTRIBUTE PATHS [#descv] devolve a lista de rotas diferentes que se encontram no campo objeto indexado passado em campoObjeto para a seleção atual da tabela a qual pertence o campo. [#descv]

Se campoObjeto não for um campo de objeto indexado, um erro é devolvido.

Depois da chamada, o tamanho de arrayRota é igual ao número de rotas distintas que se encontram na seleção. As rotas a atributos de objetos aninhados se devolvem utilizando a notação padrão ponto, por exemplo "empresa.endereço.número". Lembre que os nomes de atributo de objeto são sensíveis às maiúsculas e minúsculas. O comando não muda a seleção atual ou o registro atual.

Em arrayRota, a lista de rotas diferentes é retornada em ordem alfabética (diacrítica).

Notas:

  • Registros com um valor indefinido no campoObj não foram levadas em consideração.
  • Rotas atributos criadas durante uma transação foram levadas em consideração pelo comando. É importante notar que estas rotas são mantidas no índice do campo objeto mesmo se a transação tiver sido cancelada

Exemplo

Se seu banco de dados contiver um campo objeto [Customer]full_Data (indexado) com 15 registros:

Este código será executado:

 ARRAY TEXT(aTPaths;0)
 ALL RECORDS([Customer])
 DISTINCT ATTRIBUTE PATHS([Customer]full_Data;aTPaths)

O array aTPaths obtém os elementos abaixo:

ElementValue
1"age"
2"Children"
3"Children[]"
4"Children[].age"
5"Children[].Name"
6"Children.length"
7"client"
8"FirstName"
9"LastName"
10"Sex"
11"telephone"
12"telephone[]"
13"telephone.length"

Note: "length"/comprimento é uma propriedade virtual que está disponível automaticamente para todos os atributos de tipo array. Oferece o tamanho do array, ou seja, o número de elementos, e pode ser usada em pesquisas. Para saber mais, veja o parágrafo [#cmd id="1397" anchor="2998555"/].

Ver também

DISTINCT ATTRIBUTE VALUES