4D v14.3Propriétés des champs |
|||||||||
|
4D v14.3
Propriétés des champs
|
id name |
1 dog |
2 cat |
3 penguin |
4 snake |
5 butterfly |
6 ostrich |
Ce menu d'options est disponible pour les champs de type Texte, BLOB et Image uniquement. Il permet de définir le lieu de stockage des données du champ. Les options suivantes sont disponibles :
Comme décrit dans le paragraphe ci-dessus, pour des raisons d’optimisation les données des champs de type BLOB, Image et Texte peuvent être stockées en-dehors des enregistrements ou en-dehors du fichier de données.
Dans cette configuration, il peut être cependant intéressant, pour des raisons de performances, de "forcer" le stockage des données dans les enregistrements lorsque leur taille est réduite. Ce fonctionnement est particulièrement optimisé si votre application traite des données BLOB, image ou texte de tailles non homogènes.
Ce paramétrage est accessible via l’option Taille max stockage interne. La valeur saisie dans cette zone représente la taille en octets au-dessous de laquelle les données du champ seront stockées dans l’enregistrement. Par exemple, si vous saisissez 30 000 pour un champ image, une image de 20 ko sera stockée dans l’enregistrement et une image de 40 ko sera stockée à l’emplacement défini dans les propriétés (dans le fichier de données ou en-dehors du fichier de données). Par défaut, la valeur est 0 : toutes les données du champ sont stockées en-dehors des enregistrements.
Cette propriété est proposée pour les champs de type Alpha. Elle indique que le champ est utilisé pour stocker des identifiants UUID. Les données stockées dans le champ devront respecter le format UUID (combinaison de 32 lettres (A-F, a-f) et chiffres (0-9). Vous pouvez utiliser pour cela la propriété "UUID Auto", la commande Generer UUID ou tout algorithme personnalisé.
Si vous tentez de stocker dans ce champ une chaîne qui n’est pas conforme au format UUID, 4D la convertit automatiquement. La même opération est effectuée avec les valeurs de champs existants non alpha transformés en champs UUID : au chargement des enregistrements, les valeurs sont reformatées puis stockées à nouveau.
Les champs ayant la propriété Format UUID peuvent être affichés dans les formulaires et restent saisissables. Leur contenu est affiché en caractères majuscules. Vous devez passer par une variable si vous souhaitez afficher les minuscules.
Notes :
Cette option n’est active que lorsque la propriété Format UUID est cochée.
La propriété UUID Auto permet de générer automatiquement un numéro UUID dans le champ.
Le calcul automatique du numéro est effectué dans les contextes suivants :
Bien entendu, dans tous les cas, il faut que l'enregistrement soit stocké pour que l'UUID automatique généré soit sauvegardé dans le champ.
Note : Lors de l’importation de données, même si cette propriété est cochée, 4D ne génère pas de nouveau numéro mais utilise les valeurs importées (et les transforme éventuellement si le format n’est pas valide). Toutefois, si la valeur du champ importé est vide, un UUID est automatiquement généré.
Note de compatibilité : Cette option a été conservée pour des raisons de compatibilité uniquement et n'a pas d'effet par défaut. Pour pouvoir l'utiliser, vous devez activer QuickTime dans votre application (cf. section Introduction aux images).
Cette propriété est disponible pour les champs Texte et Alpha. Lorsque cette option est cochée, les recherches et les tris effectués parmi les données stockées dans le champ ne tiendront pas compte des éventuelles balises de style qu’il contient.
Cette option est liée à la possibilité dans 4D d’appliquer des styles différents à l’intérieur d’une même zone de texte (texte riche) dans un formulaire. Pour plus d'informations sur cette fonction, reportez-vous à la section Multistyle (Zone de texte riche).
La définition des styles s’effectue via l’insertion de balises HTML dans le texte. Ces balises sont interprétées au moment de l’affichage de la zone de texte.
Les balises de style sont stockées avec les données. Si, par exemple, vous écrivez "week end" dans un champ texte, 4D stockera "week <SPAN STYLE = "color : #D81E05">end</SPAN>". Ce fonctionnement est transparent pour l’utilisateur au niveau du formulaire. Toutefois, pour les recherches et les tris, un paramétrage spécifique est nécessaire pour que 4D ignore les balises de style. Pour le mot "week end" dans son ensemble, la recherche n’aboutira que si vous avez coché l’option Recherches et tris sur texte sans balise pour le champ.
Note : Avec cette option, une recherche de lavaleur parmi les données de lechamp équivaut en interne à l’exécution de l’instruction suivante :
CHERCHER PAR FORMULE(latable;OBJET Lire texte brut(lechamp)="lavaleur")
La propriété Index est disponible pour les champs de type Alphanumérique, Texte, Date, Heure, Booléen, Entier, Entier long, Entier 64 bits, Réel et Float. La propriété Index de mots-clés est disponible pour les champs de type Alphanumérique, Texte et Image.
L’utilisation d’index permet d’accélérer les traitements et les recherches parmi les données.
La gestion des index est détaillée dans la section Créer et modifier des index.
Les propriétés de contrôle de saisie définissent le fonctionnement du champ durant la saisie dans les formulaires de 4D. Ces propriétés peuvent généralement être également définies au niveau des formulaires.
Lorsque l’attribut Obligatoire est sélectionné pour un champ, l’utilisateur doit obligatoirement saisir une valeur pour ce champ pendant la saisie des données. 4D n’accepte pas de sauvegarder un enregistrement qui contient un champ obligatoire laissé vide. Cette option est habituellement sélectionnée pour un champ qui contient des données essentielles pour votre base. Le champ qui identifie chacun des enregistrements se voit souvent attribuer cette propriété. Les numéros de sécurité sociale, les numéros de facture ainsi que certaines dates peuvent requérir cette option afin de protéger l’intégrité des enregistrements.
Vous pouvez aussi définir cette propriété pour un champ dans un formulaire particulier. Si cette option est sélectionnée dans l’éditeur de structure, vous ne pouvez pas la désélectionner pour un formulaire particulier. Cependant, vous pouvez tout à fait sélectionner cette option pour un champ dans l’éditeur de formulaires alors qu’elle est désélectionnée au niveau de l’éditeur de structure. Pour plus d’informations sur cette possibilité, reportez-vous à la section Propriétés de champs et attributs Saisissable et Obligatoire.
Note : Dans 4D, les champs peuvent également avoir la propriété “Refuser l’écriture de la valeur NULL” (cf. ci-dessus). Les deux notions sont proches mais leur portée est différente : la propriété “Obligatoire” est un contrôle de saisie, tandis que “Refuser l’écriture de la valeur NULL” agit au niveau du moteur de la base de données.
Si cet attribut est sélectionné pour un champ, 4D accepte la première valeur saisie dans ce champ, mais ne permet plus à l’utilisateur de modifier ce champ une fois que l’enregistrement a été sauvegardé. L’utilisateur peut modifier la valeur du champ lors de la création de l’enregistrement, avant qu’il soit validé. Une fois que l’utilisateur a sauvegardé l’enregistrement, la valeur du champ n’est plus modifiable. Le champ ne peut ensuite être modifié que par une méthode ou en mode Développement si vous avez au préalable désélectionné cette option.
Vous pouvez utiliser cet attribut pour les champs qui doivent fournir des éléments fiables, comme des dates de réception, de paiement, etc.
Note : Cet attribut ne fonctionne qu’avec des champs affichés dans un formulaire de saisie en mode Page. Dans les autres cas (saisie en liste, saisie dans un sous-formulaire en mode Liste ou Page), la valeur du champ pourra toujours être modifiée.
L’utilisateur ne peut pas saisir de valeurs à partir du clavier dans un champ pour lequel la propriété Non saisissable est sélectionnée. Vous devez utiliser une valeur par défaut pour un tel champ ou écrire une méthode qui ajoute une valeur dans ce champ. Un champ pour lequel cette propriété est sélectionnée est utile pour l’affichage de valeurs que vous ne souhaitez pas voir modifiées par les utilisateurs, comme des totaux calculés ou des numéros de série affectés par une méthode.
Vous pouvez aussi définir cette propriété pour un champ dans un formulaire particulier. Pour plus d’informations sur cette possibilité, reportez-vous à la section Propriétés de champs et attributs Saisissable et Obligatoire.
Cette option est disponible pour les champs de type Texte uniquement. Lorsqu’elle est cochée, le champ texte est automatiquement configuré, dans les formulaires créés ultérieurement, de manière à contenir plusieurs lignes de texte. Ses caractéristiques par défaut sont les suivantes :
Lorsque cette option n’est pas cochée, l’apparence par défaut du champ texte dans les formulaires est identique à celle des champs de type Alpha : une seule ligne de hauteur et pas de barre de défilement ; le retour chariot provoque le passage au champ suivant dans le formulaire.
Il est possible de modifier l’apparence par défaut du champ à tout moment via l’éditeur de formulaires.
Vous pouvez utiliser cette propriété si vous voulez afficher une énumération lors de la saisie de données dans un champ. Pour utiliser cette propriété, il est nécessaire de créer au préalable une énumération à l’aide de l’éditeur d’Enumérations.
Vous pouvez utiliser cette propriété quand vous souhaitez standardiser les saisies dans les champs et éviter les erreurs de saisie. Cette propriété est utile pour les champs qui ont des valeurs connues et habituelles. L’utilisation d’une énumération n’empêche pas la saisie d’une valeur différente (une valeur qui n’apparaît pas dans la liste).
Vous pouvez aussi utiliser une énumération pour un champ dans un formulaire particulier. Si vous n’affectez une énumération que pour un formulaire, elle n’apparaîtra pas dans les autres éditeurs et boîtes de dialogue, comme l’éditeur de recherches. Pour plus d’informations sur l’utilisation des énumérations dans les formulaires, reportez-vous à la section Contrôles et aides à la saisie.
Note : Il est également possible de définir au niveau des formulaires des énumérations de valeurs obligatoires et de valeurs exclues.
Lorsque vous cochez l’option Autoriser énumération, le menu déroulant associé est activé. Vous pouvez alors sélectionner l’énumération existante que vous souhaitez affecter au champ. Vous pouvez cliquer sur le bouton [...] pour accéder directement à l’éditeur d’Enumérations.
Vous pouvez fournir aux utilisateurs de votre base des informations supplémentaires à l’aide d’infobulles. Si vous écrivez un message dans la zone Infobulles, il s’affichera au-dessus du champ lorsque l’utilisateur placera le pointeur de la souris sur le champ — quel que soit le formulaire dans lequel le champ est placé.
Quand l’utilisateur place le pointeur de la souris au-dessus du champ, le message apparaît dans une infobulle, comme ci-dessous :
Vous pouvez aussi utiliser une infobulle pour un champ dans un formulaire particulier. Si vous n’affectez une infobulle que pour un formulaire, elle n’apparaîtra pas dans les autres formulaires. Pour plus d’informations sur l’utilisation des infobulles dans les formulaires, reportez-vous au paragraphe Message d'aide.
La zone Commentaires de l’Inspecteur vous permet de stocker des informations supplémentaires sur le champ. Ces commentaires seront accessibles à tous les développeurs. A noter que chaque table et chaque lien dispose de sa propre zone de commentaires.
La zone SQL de l’Inspecteur fournit des informations utiles en cas d’exploitation du champ via le moteur SQL.
Elle signale notamment si le nom du champ ne respecte pas les règles de la nomenclature SQL (par exemple, le SQL n’autorise pas qu’un nom de champ contienne des espaces, à la différence de 4D).
Pour chaque champ, la zone d’information SQL indique en outre les attributs SQL correspondants (type et propriétés).
Produit : 4D
Thème : Définir la structure de la base de données
Nom intl. : Field properties
4D - Mode Développement ( 4D v14.3)
Hérité de : Propriétés des champs ( 4D v14 R2)