Remarques
Conditions d'utilisation
La fonction
TableSupprime peut être utilisée sur :
- un champ Table ou Table hiérarchique fichier.
- un champ Table ou Table hiérarchique par programmation.
- un champ monosélection ou multisélection.
Rappel : La multisélection n'est pas disponible sur les champs Table en mode "Serveur".
Suppression dans un champ Table ou Table hiérarchique fichier
La fonction
TableSupprime supprime l'enregistrement correspondant dans le fichier de données associé au champ. Si des rubriques sont reliées à d'autres fichiers de données, aucune modification n'est effectuée automatiquement sur ces fichiers de données liés.
Intégrité référentielle et champ Table ou Table hiérarchique fichier
Si la gestion de l'intégrité référentielle est active (fonction
HGèreIntégrité), testez la fonction
HErreurIntégrité après l'appel de la fonction
TableSupprime pour vérifier l'intégrité.
Si une erreur d'intégrité est détectée, la ligne n'est pas supprimée et reste visible dans le champ.
Suppression dans un champ Table fichier et Trigger
Il est possible de déclencher un trigger lors de la suppression d'un enregistrement dans un champ Table fichier. Pour plus de détails, consultez la documentation de la fonction
HDécritTrigger.
Gestion des erreurs
En cas d'échec de la suppression, la variable
ErreurDétectée est à
Vrai. Pour plus de détails sur l'erreur, il est possible d'utiliser la fonction
ErreurInfo.
Exemple de cas d'erreur : Suppression d'une ligne dont l'indice correspond à une ligne non sélectionnée dans la partie visible du champ Table.
Blocage du fichier de données lié
Si le fichier de données est bloqué dans le traitement en cours, la fonction
TableSupprime supprime la ligne spécifiée et débloque le fichier de données.
Suppression dans un champ Table par programmation avec un filtre de type "Contient"
La fonction
TableSupprime utilisée sur un champ Table par programmation utilisant un filtre de type "Contient" fait apparaître des enregistrements qui ne correspondent pas au filtre. Les filtres définis par les FAA (Fonctionnalités Automatiques de vos Applications) sont annulés.