Editer les enregistrements

Cette section présente les principales opérations que vous pouvez effectuer lorsque vous travaillez avec les enregistrements de votre base :

• ajouter des enregistrements,
• modifier des enregistrements,
• supprimer des enregistrements.

Après avoir créé une base de données en mode Développement, vous pouvez commencer à travailler avec vos enregistrements (saisie, modification, suppression...). Ces opérations seront généralement effectuées en mode Application via une interface personnalisée. 

4D vous offre la possibilité de saisir, modifier ou supprimer des enregistrements via le mode Développement. Ce principe vous permet d’effectuer certaines tâches élémentaires et de tester les données de votre application. 

Une fois que vous avez saisi des enregistrements, vous pouvez souhaiter modifier certaines informations. Si vous devez modifier plus d’un enregistrement, vous pouvez utiliser les outils de recherche mis à votre disposition par 4D (cf. chapitre Rechercher des enregistrements). Vous pouvez alors modifier les enregistrements dans vos formulaires entrée ou sortie. 

Vous pourrez parfois avoir besoin d’effectuer exactement la même modification dans un groupe d’enregistrements. Cette opération est appelée une mise à jour globale. Dans 4D, il est possible de mettre à jour automatiquement la totalité du contenu d’une table, sans devoir effectuer un à un les changements dans chaque enregistrement. 

Vous pourrez également devoir supprimer un ou plusieurs enregistrements, si par exemple ils sont devenus obsolètes ou inutiles (si un enregistrement est valide mais que seules certaines de ses données ne le sont plus, il vous suffit de le modifier). Pour supprimer l’enregistrement courant, vous utiliserez un formulaire entrée et pour une sous-sélection d’un ou plusieurs enregistrements, un formulaire sortie.

Vous pouvez ajouter des enregistrements dans un formulaire entrée ou sortie.

En mode Application, l’ajout d’enregistrements pourra être effectué via l’action standard “Ajouter sous-enregistrement” (ajout d’enregistrement en liste) ou les commandes ADD RECORD et CREATE RECORD.

En mode Développement, 4D vous propose par défaut plusieurs possibilités d’ajout, que vous soyez dans un formulaire d'entrée ou de sortie.

• Pour ajouter un nouvel enregistrement dans un formulaire entrée :
  
  1. En mode Développement, choisissez Nouvel enregistrement dans le menu Enregistrements.
     Vous pouvez choisir à tout moment Nouvel enregistrement, que vous soyez dans un formulaire entrée ou sortie.
     4D affiche un formulaire entrée vierge et place le point d’insertion dans la première zone éditable.
  2. Saisissez une valeur dans la première zone éditable puis appuyez sur la touche Tabulation ou Retour chariot pour passer à la zone suivante.
     Répétez ces opérations jusqu’à ce que l’enregistrement soit rempli. Lorsque la saisie est terminée, vous pouvez valider l’enregistrement.
     
  3. Appuyez sur la touche Entrée du pavé numérique ou cliquez sur le bouton de validation du formulaire entrée pour valider l’enregistrement.
     Note : Cet équivalent clavier par défaut peut être modifié dans la Page Interface des Propriétés de la base.
     En validant l’enregistrement, vous demandez à 4D de l’ajouter aux données de la base. Une fois que vous avez validé l’enregistrement, un nouveau formulaire vierge s’affiche.
  4. Si vous souhaitez créer un autre enregistrement, répétez les opérations de saisie et de validation des données.
     OU
     Si vous avez terminé la saisie, cliquez sur le bouton d’annulation ou utilisez la touche Echap dans le formulaire vierge suivant celui que vous avez validé.
     Note : Cet équivalent clavier par défaut peut être modifié dans la Page Interface des Propriétés de la base.
     Le formulaire sortie courant s’affiche

Vous pouvez ajouter des enregistrements directement depuis le formulaire sortie. A noter que dans ce cas, vous ne pouvez pas saisir de données dans des variables, champs d’autres tables ou sous-formulaires.

• Pour créer un enregistrement dans un formulaire sortie :
  
  1. En mode Développement, choisissez Nouvel enregistrement en liste dans le menu Enregistrements.
     Un point d’insertion apparaît dans le premier champ, sous le dernier enregistrement affiché dans le formulaire sortie.
  2. Saisissez une valeur dans le champ et utilisez la touche Tabulation ou Retour chariot pour vous déplacer parmi les champs de cet enregistrement.
     Note : Utilisez la combinaison Maj+Tabulation ou Maj+Retour chariot pour vous déplacer en sens inverse parmi les champs des enregistrements.
     Les éventuels outils de saisie associés aux champs du formulaire seront utilisés lorsque vous sélectionnerez ces champs. Par exemple, si un champ comporte une énumération, elle sera affichée au moment de l’activation du champ.
  3. Appuyez sur la touche Entrée du pavé numérique pour sauvegarder l’enregistrement ou pour créer un nouvel enregistrement vierge.
     OU
     Cliquez sur un champ d’un autre enregistrement.
     4D sauvegarde les valeurs saisies dans l’enregistrement que vous venez de créer.

Vous modifiez des enregistrements lorsque vous souhaitez mettre à jour des informations ou lorsque des erreurs de saisie ont eu lieu. Pour modifier un groupe d’enregistrements, vous devez d’abord les désigner en tant que sélection courante. Vous pouvez effectuer une recherche pour sélectionner les enregistrements ou les sélectionner manuellement dans votre formulaire sortie.

Vous pouvez modifier des enregistrements dans un formulaire entrée ou sortie. Le formulaire sortie est plus pratique pour la modification d’un groupe d’enregistrements car plusieurs d’entre eux peuvent être affichés simultanément.
Si un enregistrement est en train d’être modifié par un autre process ou utilisateur (mode distant), il est verrouillé. Les enregistrements verrouillés peuvent être consultés, mais pas modifiés. Lorsque vous éditez un enregistrement verrouillé, vous pouvez uniquement visualiser les valeurs qu’il contient.

En mode Application, la modification d’enregistrements pourra être effectuée via l’action standard “Modifier sous-enregistrement” (ajout d’enregistrement en liste) ou la commande MODIFY RECORD. 

En mode Développement, 4D vous propose plusieurs fonctions d’ajout. 

• Pour modifier des enregistrements dans un formulaire entrée :
  
  1. Sélectionnez un enregistrement dans le formulaire sortie et choisissez la commande Modifier l’enregistrement dans le menu Enregistrements.
     OU
     Double-cliquez sur l’enregistrement.
     4D affiche l’enregistrement dans le formulaire entrée courant.
  2. Sélectionnez les champs que vous voulez modifier et remplacez ou effacez les valeurs.
  3. Cliquez sur le bouton de validation ou appuyez sur la touche Entrée du pavé numérique pour valider vos modifications et retourner au formulaire sortie.
     OU
     Cliquez sur un bouton de navigation (Enregistrement précédent, Premier enregistrement, Dernier enregistrement, Enregistrement suivant) pour valider les modifications et afficher un autre enregistrement de la sélection courante.
     Les boutons de navigation avec action standard vous permettent de vous déplacer parmi les enregistrements de la sélection courante tout en validant automatiquement l’enregistrement courant.
     Vous pouvez annuler vos modifications et retourner au formulaire sortie à tout moment en cliquant sur le bouton Annuler ou en appuyant sur la touche Echap.

Vous pouvez modifier des enregistrements directement depuis le formulaire sortie. A noter que dans ce cas, vous ne pouvez pas modifier les valeurs des variables, champs d’autres tables ou sous-formulaires.
En mode Application, il est possible de contrôler la possibilité de modifier les enregistrements en liste.

• Pour modifier un enregistrement dans un formulaire sortie :
  
  1. Sélectionnez un enregistrement puis cliquez sur le champ à modifier.
     Le champ passe en mode édition.
     Note : En mode Développement, vous pouvez choisir à tout moment la commande Modifier l’enregistrement dans le menu Enregistrement pour afficher l’enregistrement sélectionné dans le formulaire entrée courant.
  2. Appuyez sur la touche Tabulation ou sur la touche Retour chariot.
     4D sauvegarde immédiatement vos modifications. 
  3. Répétez ces opérations suivant vos besoins.
  4. Cliquez deux fois sur un champ d’un autre enregistrement dans le formulaire sortie pour modifier un autre enregistrement.

Vous effectuez une mise à jour globale pour apporter une modification spécifique à un groupe d’enregistrements. La mise à jour globale vous évite de réaliser manuellement des modifications longues et fastidieuses. Voici par exemple des opérations pouvant typiquement être effectuées par le biais d’une mise à jour globale :

• Changer tous les prix d’une table [Inventaire] en leur appliquant un certain pourcentage.
• Appliquer un format spécifique à un champ numérique ou Alpha.

Une mise à jour globale s’effectue en “appliquant” une formule à la sélection courante d’enregistrements. La modification sera appliquée à chaque enregistrement de la sélection courante. 

Voici quelques exemples de formules et la description des fonctions qu’elles réalisent :

• Cette formule multiplie le champ Salaire par 1,05. Elle peut être utilisée lors d’une augmentation générale des salaires :
  
   [Emp]Salaire :=[Emp]Salaire *1,05

• Cette formule utilise une fonction interne de 4D pour écrire le contenu du champ Pays en majuscules. Cela permet d’assurer une présentation cohérente lorsque les pays apparaissent dans des libellés ou des états :
  
   [Client]Pays:=Uppercase([Client]Pays)

• Cette formule exploite une méthode projet appliquant un format au champ Nom. Cette méthode écrit la première lettre des valeurs du champ Nom en majuscule, les autres lettres restant en minuscules.
  
   [Emp]Nom:=MajusPrem([Emp]Nom)

La possibilité d’insérer des méthodes utilisateur dans les formules est une fonctionnalité très puissante de 4D. Les formules peuvent contenir des fonctions du langage de 4D ainsi que des méthodes projet (déclarées “utilisables” dans les formules par le développeur). Pour des raisons de sécurité, l’accès aux méthodes projet et aux fonctions 4D dans les formules est restreint (cf. section Page Sécurité).

Vous ne pouvez écrire de formules de plus d’une ligne logique, c’est-à-dire que vous ne pouvez pas appuyer sur la touche Retour chariot et taper une deuxième ligne. Toutefois, les méthodes déclarées utilisables dans l’éditeur de formule peuvent, bien entendu, contenir plusieurs lignes.

Pour effectuer une mise à jour globale, vous devez utiliser l’, permettant d’écrire votre formule qui sera ensuite appliquée à chaque enregistrement de la sélection courante. Pour cela, il vous suffit de sélectionner la commande Appliquer une formule dans le menu Enregistrements puis d'écrire votre formule. Vous pouvez également charger une formule auparavant sauvegardée sous forme de fichier sur disque (extension .4fr). Pour plus d'informations, reportez-vous au chapitre .

En mode Application, vous pouvez exécuter directement une formule de mise à jour via la commande EXECUTE FORMULA ou afficher l’éditeur de formules via la commande EDIT FORMULA.

Vous pouvez à tout moment supprimer un enregistrement devenu inutile ou obsolète. Si l’enregistrement reste utile mais que ses données sont incorrectes, il suffit simplement de le modifier. 

Pour supprimer des enregistrements, deux possibilités s’offrent à vous :

• Supprimer un enregistrement individuellement (généralement, depuis un formulaire entrée).
• Supprimer un ensemble d’enregistrements (généralement, depuis un formulaire sortie).

En mode Application, la suppression d’enregistrements est effectuée via les actions standard “Supprimer enregistrement” ou “Supprimer sous-enregistrement” (suppression en liste) ou les commandes DELETE RECORD ou DELETE SELECTION. 

En mode Développement, 4D vous permet également d’utiliser la commande Effacer du menu Edition et les touches d’effacement.

Attention : La suppression d’enregistrements est définitive et ne peut être annulée que via la restitution d’une sauvegarde de la base. Lorsque vous supprimez des enregistrements, 4D affiche une boîte de dialogue d’alerte vous demandant de confirmer l’opération.

La suppression des enregistrements depuis le formulaire entrée vous permet de vérifier le contenu de chaque enregistrement avant de le supprimer.

• Pour supprimer des enregistrements depuis un formulaire entrée :
  
  1. Ouvrez l’enregistrement que vous souhaitez effacer.
  2. Cliquez sur le bouton de suppression pour effacer l’enregistrement.
     Le bouton Supprimer (ou Effacer) peut être représenté de différentes manières, en fonction de l’aspect général du formulaire. Par défaut, il est représenté par une icône symbolisant une corbeille et est associé à l’action standard “Supprimer enregistrement”. Il est également possible qu’un formulaire ne contienne pas de bouton de suppression.
     4D vous demande de confirmer la suppression. Vous ne pourrez pas annuler l’opération par la suite.
  3. Cliquez sur bouton Oui pour valider la suppression.
     4D supprime l’enregistrement courant de la base et affiche le formulaire sortie.

Dans un formulaire sortie, vous pouvez supprimer plusieurs enregistrements en une seule opération, après les avoir sélectionnés au préalable. Les enregistrements à supprimer doivent apparaître surlignés dans le formulaire sortie.

• Pour supprimer des enregistrements depuis le formulaire sortie :
  
  1. Sélectionnez (surlignez) le ou les enregistrement(s) que vous voulez supprimer.
  2. Choisissez Effacer dans le menu Edition ou appuyez sur la touche Suppr. ou Retour Arrière.
     4D affiche une boîte de dialogue vous demandant de confirmer l’opération. Une fois validée, vous ne pourrez pas l’annuler par la suite.
  3. Cliquez sur le bouton OK pour valider la suppression.
     4D supprime de la table le ou les enregistrement(s) sélectionné(s).
     Note : Pour supprimer tous les enregistrements d’une table, choisissez Tout montrer dans le menu Enregistrements puis Tout sélectionner dans le menu Edition avant de choisir la commande Effacer dans le menu Edition (ou une touche d’effacement).

Vous ne pouvez pas supprimer d’enregistrement verrouillé. Les enregistrements sont verrouillés lorsqu’ils sont utilisés par un autre process. Lorsqu’un process ouvre un enregistrement afin de le modifier, 4D le verrouille pour qu’aucun autre process ne puisse y accéder simultanément.

Note 4D Server : Les enregistrements sont aussi verrouillés lorsqu’ils ont été chargés en modification par un autre utilisateur. Cela évite que des utilisateurs ne tentent de modifier le même enregistrement au même moment.

Avant d’effacer des enregistrements, vous devez les sélectionner. Si votre sélection contient des enregistrements verrouillés, l’opération sera effectuée mais les enregistrements verrouillés ne seront pas effacés et resteront dans la sélection courante. Vous devez attendre que ces enregistrements soient déverrouillés (c’est-à-dire que plus aucun utilisateur ou process ne l’utilise) pour pouvoir les supprimer. Les commandes du thème Enregistrements (verrouillage) vous permettent de gérer ce cas de figure. 

La sélection courante peut être modifiée à la suite de la suppression d’enregistrements par un autre process. Par exemple, un process supprimant des enregistrements dans une table peut être exécuté alors que vous travaillez dans votre base. Les enregistrements effacés par ce process sont supprimés définitivement de la table. Cependant, ils ne disparaîtront pas de votre sélection courante tant que vous travaillerez avec la base. 

Pour illustrer ce point, imaginons une table contenant cinquante enregistrements. La sélection courante contient tous les enregistrements. A ce moment, la barre de titre du formulaire sortie indique que “50 parmi 50” enregistrements sont sélectionnés. Si un enregistrement est supprimé dans un autre process, la barre de titre est mise à jour et indique que “50 parmi 49” enregistrements sont sélectionnés. Il y a alors davantage d’enregistrements dans la sélection courante que dans la table réelle !

Si vous tentez de modifier ou de supprimer l’enregistrement effacé, une boîte de dialogue vous informera que l’enregistrement n’existe plus. 

Note 4D Server : Les enregistrements effacés par un autre utilisateur ont le même effet sur la sélection courante. Les enregistrements sont supprimés de la table, mais pas de la sélection courante. En conséquence, il se peut que la sélection courante contienne davantage d’enregistrements qu’il n’en existe réellement dans la table.