4D v16.3Sequence number |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
Sequence number
Sequence number
Sequence number retourne le prochain numéro automatique de laTable. Ce numéro est unique pour chaque table. C'est une valeur qui ne se répète pas et qui est incrémentée à chaque enregistrement nouvellement créé dans la table(*). (*) Pour des raisons d'optimisation, la numérotation automatique est activée uniquement au premier appel de la commande Sequence number ou d'une des fonctions qui y accèdent (cf. ci-dessous). De plus, le compteur peut être réinitialisé via SET DATABASE PARAMETER. Par conséquent, la valeur retournée ne correspond pas nécessairement au nombre d'enregistrements ayant été créés dans laTable. Par défaut, la numérotation commence à 1 ; vous pouvez toutefois modifier la numérotation automatique des enregistrements de laTable à l'aide de la commande SET DATABASE PARAMETER. Note : S'il n'y a pas d'enregistrement courant et que la numérotation a été modifiée via la commande SET DATABASE PARAMETER, le numéro est bien réservé pour la prochaine création d'enregistrement mais ne sera retourné par la fonction Sequence number que lorsque la commande SAVE RECORD sera effectivement appelée. Le numéro retourné par cette fonction pour laTable est identique à celui généré si vous avez coché l'option Incrémentation auto dans l'Inspecteur de Structure pour un champ de laTable ou si vous fixez #N comme valeur par défaut pour un champ de laTable dans un formulaire (référez-vous au manuel Mode Développement de 4D). Note : L'incrémentation automatique peut également être définie via l'attribut SQL AUTO_INCREMENT. La fonction Sequence number est utile dans les cas suivants :
Pour stocker ce numéro à l'aide d'une méthode, il faut créer un champ de type Entier long dans la table et y affecter la numérotation automatique. [Table1]NumAuto:=Sequence number([Table1])+999 L'exemple suivant fait partie d'une méthode formulaire. Ces lignes de code testent s'il s'agit d'un nouvel enregistrement (si le numéro de facture est égal à une chaîne vide). Si l'enregistrement est nouveau, un numéro est affecté à la facture. Ce numéro de facture est construit avec deux informations : le numéro unique et le numéro de référence de l'utilisateur, qui était saisi à l'ouverture de la base. Le numéro unique est formaté en tant que chaîne avec une longueur de cinq caractères : If([Factures]NumFacture="") ` S'il s'agit d'une nouvelle facture, créer un numéro de facture
Voir aussi
A propos des numéros d'enregistrements
|
PROPRIÉTÉS
Produit : 4D HISTORIQUE
Modifié : 4D 2004.1 UTILISATION DE L'ARTICLE
4D - Langage ( 4D v16) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||