DISTINCT ATTRIBUTE PATHS

4D v16.3


DISTINCT ATTRIBUTE PATHS ( champObjet ; tabChemins )

Paramètre	Type	Description
champObjet	Champ	Champ objet indexé
tabChemins	Tableau texte	Tableau devant recevoir les chemins d'attributs du champ

Description

La commande DISTINCT ATTRIBUTE PATHS retourne la liste des chemins d'attributs différents présents dans le champ objet indexé passé dans champObjet et ce, pour la sélection courante de la table à laquelle le champ appartient.

Vous devez passer dans champObjet un champ de type Objet indexé ; sinon, une erreur est retournée.

Après l'exécution de la commande, la taille du tableau tabChemins est égale au nombre de chemins différents trouvés dans la sélection. Les chemins des attributs imbriqués sont retournés avec la notation à points standard, par exemple "sociétés.adresse.numéro". Attention, gardez à l'esprit que les noms d'attributs d'objets tiennent compte de la casse des caractères.

Dans tabChemins, la liste des chemins d'attributs distincts est retournée dans l'ordre alphabétique (diacritique).

La commande ne modifie pas la sélection courante ni l'enregistrement courant.

Notes :

Les enregistrements pour lesquels la valeur de champObjet est indéfinie ne sont pas pris en compte.
Les chemins d'attributs créés pendant une transaction sont pris en compte par la commande. Attention, ces chemins sont conservés dans l'index du champ objet même si la transaction a été annulée.

Exemple

Votre base de données comporte un champ objet [Customer]full_Data avec 15 enregistrements. Le champ est indexé :

Si vous exécutez ce code :

 ARRAY TEXT(aTPaths;0)

 ALL RECORDS([Customer])

 DISTINCT ATTRIBUTE PATHS([Customer]full_Data;aTPaths)

Le tableau aTPaths reçoit les éléments suivants :

Elément	Valeur
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" est une propriété virtuelle qui est disponible automatiquement pour tous les attributs de type tableau. Elle fournit la taille du tableau, c'est-à-dire le nombre d'éléments, et peut être utilisée dans les requêtes. Pour plus d'informations, reportez-vous au paragraphe Using the .length virtual property.

Voir aussi

DISTINCT ATTRIBUTE VALUES