CREATE RECORD
CREATE RECORD {( laTable )}
| Paramètre | Type | Description | |
|---|---|---|---|
| laTable | Table | → | Table dans laquelle créer un enregistrement ou Table par défaut si ce paramètre est omis |
Description
CREATE RECORD crée un nouvel enregistrement vide pour laTable, mais ne l'affiche pas à l'écran. Vous devez utiliser la commande ADD RECORD pour créer un nouvel enregistrement et l'afficher dans un formulaire entrée.
Utilisez CREATE RECORD plutôt que ADD RECORD lorsque les valeurs de l'enregistrement sont entrées par programmation. Le nouvel enregistrement devient l'enregistrement courant mais la sélection courante n'est pas modifiée.
L'enregistrement est créé uniquement en mémoire et doit être sauvegardé à l'aide de SAVE RECORD. Si vous changez d'enregistrement courant (par exemple à la suite d'une recherche) avant la sauvegarde, l'enregistrement créé est perdu.
Note : Cette commande ne nécessite pas que laTable soit en mode lecture/écriture. Elle peut être utilisée même lorsque la table est en mode lecture seulement (cf. section Verrouillage d'enregistrements).
Exemple
L'exemple suivant archive les enregistrements datant de plus de 30 jours. Cette opération est réalisée par la création d'enregistrements dans une table d'archive. Une fois l'opération terminée, les enregistrements archivés sont supprimés de la table [Comptes] :
// Recherche des enregistrements datant de plus de 30 jours
QUERY([Comptes];[Comptes]Saisie <(Date du jour 30))
For($vlRecord;1;Records in selection([Comptes])) // Boucle une fois par enregistrement
CREATE RECORD([Archives]) // Création d'un nouvel enregistrement d'archive
[Archive]Numéro:=[Comptes]Number // Copie des champs dans l'archive
[Archive]Saisie :=[Comptes]Saisie
[Archive]Montant:=[Comptes]Montant
SAVE RECORD([Archive]) // Sauvegarde de l'enregistrement d'archive
NEXT RECORD([Comptes]) // Passage à l'enregistrement de compte suivant
End for
DELETE SELECTION([Comptes]) // Suppression des enregistrements