VALEURS DISTINCTES CHEMINS

4D v16.3


VALEURS DISTINCTES CHEMINS ( 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 VALEURS DISTINCTES CHEMINS 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 :

 TABLEAU TEXTE(aTPaths;0)

 TOUT SELECTIONNER([Customer])

 VALEURS DISTINCTES CHEMINS([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 Utilisation de la propriété virtuelle length.

Voir aussi

VALEURS DISTINCTES ATTRIBUT