Edit

DataClassAttribute

Les attributs Dataclass sont disponibles en tant que propriétés de leurs classes respectives. Par exemple :

 nameAttribute:=ds.Company.name //référence à un attribut de classe
 revenuesAttribute:=ds.Company["revenues"] //méthode alternative

Ce code attribue à nameAttribute et revenuesAttribute des références aux attributs name et revenues de la classe Company. Cette syntaxe ne retourne PAS les valeurs contenues dans l'attribut, mais retourne plutôt des références aux attributs eux-mêmes. Pour gérer les valeurs, vous devez passer par les Entités.

Les objets DataClassAttribut ont des propriétés que vous pouvez lire pour obtenir des informations sur les attributs de votre dataclass.

Les objets de l'attribut Dataclass peuvent être modifiés, mais la structure sous-jacente de la base de données ne sera pas altérée.

Sommaire

.autoFilled : Booléen     contains True if the attribute value is automatically filled by 4D
.fieldNumber : Integer     contains the internal 4D field number of the attribute
.fieldType : Integer     contains the 4D database type of the attribute
.indexed : Booléen     contains True if there is a B-tree or a Cluster B-tree index on the attribute
.inverseName : Text     returns the name of the attribute which is at the other side of the relation
.keywordIndexed : Boolean     contient True s'il existe un index de mot-clé sur l'attribut
.kind : Text     returns the category of the attribute
.mandatory : Boolean     contains True if Null value input is rejected for the attribute
.name : Text     returns the name of the dataClassAttribute object as string
.relatedDataClass : Text     returns the name of the dataclass related to the attribute
.type : Texte     contains the conceptual value type of the attribute
.unique : Booléen     contains True if the attribute value must be unique

.autoFilled

Historique

Version	Modifications
v17 R5	Ajout

.autoFilled : Booléen

Description

The .autoFilled property contains True if the attribute value is automatically filled by 4D. Cette propriété correspond aux propriétés de champ 4D suivantes :

• "Autoincrement", for les champs de type numérique
• "Auto UUID", pour les champs UUID (de type alpha).

Cette propriété n'est pas retournée si .kind = "relatedEntity" ou "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Bool (dataClassAttribute.autoFilled) pour obtenir une valeur valide (false) même si .autoFilled n'est pas retourné.

.fieldNumber

Historique

Version	Modifications
v17 R5	Ajout

.fieldNumber : Integer

Description

The .fieldNumber property contains the internal 4D field number of the attribute.

Cette propriété n'est pas retournée si .kind = "relatedEntity" ou "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Num (dataClassAttribute.fieldNumber) pour obtenir une valeur valide (0) même si .fieldNumber n'est pas retourné.

.fieldType

Historique

Version	Modifications
v17 R5	Ajout

.fieldType : Integer

Description

The .fieldType property contains the 4D database type of the attribute. It depends on the attribute kind (see .kind).

Valeurs possibles :

dataClassAttribute.kind	fieldType	Commentaire
storage	Corresponding 4D field type	Voir la commande Type
relatedEntity	38 (Is object)
relatedEntities	42 (Is collection)

.indexed

Historique

Version	Modifications
v17 R5	Ajout

.indexed : Booléen

Description

The .indexed property contains True if there is a B-tree or a Cluster B-tree index on the attribute.

Cette propriété n'est pas retournée si .kind = "relatedEntity" ou "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Bool (dataClassAttribute.indexed) pour obtenir une valeur valide (false) même si .indexed n'est pas retourné.

.inverseName

Historique

Version	Modifications
v17 R5	Ajout

.inverseName : Text

Description

The .inverseName property returns the name of the attribute which is at the other side of the relation.

This property is not returned if .kind = "storage". It must be of the "relatedEntity" or "relatedEntities" kind.

Pour la programmation générique, vous pouvez utiliser String (dataClassAttribute.inverseName) pour obtenir une valeur valide ("") même si .inverseName n'est pas retourné.

.keywordIndexed

Historique

Version	Modifications
v17 R5	Ajout

.keywordIndexed : Boolean

Description

La propriété .keywordIndexed contient True s'il existe un index de mot-clé sur l'attribut.

This property is not returned if .kind = "relatedEntity" or "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Bool (dataClassAttribute.keywordIndexed) pour obtenir une valeur valide (false) même si .keywordIndexed n'est pas retourné.

.kind

Historique

Version	Modifications
v17 R5	Ajout

.kind : Text

Description

The .kind property returns the category of the attribute. Returned value can be one of the following:

• "storage" : attribut de stockage (ou scalaire), c'est-à-dire un attribut stockant une valeur, et non une référence à un autre attribut
• "relatedEntity": N -> 1 relation attribute (reference to an entity)
• "relatedEntities": 1 -> N relation attribute (reference to an entity selection)

Exemple

Considérons les tables et relations suivantes :

 var $attKind : Text
 $attKind:=ds.Employee.lastname.kind //$attKind="storage"
 $attKind:=ds.Employee.manager.kind //$attKind="relatedEntity"
 $attKind:=ds.Employee.directReports.kind //$attKind="relatedEntities"

.mandatory

Historique

Version	Modifications
v17 R5	Ajout

.mandatory : Boolean

Description

The .mandatory property contains True if Null value input is rejected for the attribute.

This property is not returned if .kind = "relatedEntity" or "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Bool (dataClassAttribute.mandatory) pour obtenir une valeur valide (false) même si .mandatory n'est pas retourné. Attention : Cette propriété correspond à la propriété du champ "Reject NULL value input" au niveau de la base de données 4D. Elle n'est pas liée à la propriété "Mandatory" existante qui est une option de contrôle de la saisie de données pour une table.

.name

Historique

Version	Modifications
v17 R5	Ajout

.name : Text

Description

The .name property returns the name of the dataClassAttribute object as string.

Exemple

 var $attName : Text
 $attName:=ds.Employee.lastname.name //$attName="lastname"

.relatedDataClass

Historique

Version	Modifications
v17 R5	Ajout

.relatedDataClass : Text

Description

Cette propriété n'est disponible qu'avec les attributs de la propriété "relatedEntity" ou "relatedEntities" .kind.

The .relatedDataClass property returns the name of the dataclass related to the attribute.

Exemple

Considérons les tableaux et relations suivants :

 var $relClass1; $relClassN : Text
 $relClass1:=ds.Employee.employer.relatedDataClass //$relClass1="Company"
 $relClassN:=ds.Employee.directReports.relatedDataClass //$relClassN="Employee"

.type

Historique

Version	Modifications
v17 R5	Ajout

.type : Texte

Description

The .type property contains the conceptual value type of the attribute, useful for generic programming.

Le type de valeur conceptuelle dépend de l'attribut .kind.

Valeurs possibles :

dataClassAttribute.kind	type	Commentaire
storage	"number", "date", "object", "bool", "image", ou "string"	"nombre" est rertourné pour tous les types numériques, y compris la durée. "string" est retourné pour les types de champs uuid, alpha et text
relatedEntity	related dataClass name	Ex : "Companies"
relatedEntities	related dataClass name + "Selection" suffix	Ex : "EmployeeSelection"

.unique

Historique

Version	Modifications
v17 R5	Ajout

.unique : Booléen

Description

The .unique property contains True if the attribute value must be unique. Cette propriété correspond à la propriété de champ 4D "Unique".

This property is not returned if .kind = "relatedEntity" or "relatedEntities".

Pour la programmation générique, vous pouvez utiliser Bool (dataClassAttribute.unique) pour obtenir une valeur valide (false) même si .unique n'est pas retourné.