DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Gestion des doublons activée
  • Généralisation du test des doublons
  • Désactiver le test des doublons
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Active ou désactive la gestion des doublons sur une clé unique.
Remarques :
  • Par défaut, le test des doublons est actif.
  • Cette fonction n'est pas disponible sur les bases de données accédées par OLE DB ou par les Connecteurs Natifs (également appelés Accès Natifs).
Exemple
// Désactive la gestion des doublons sur le fichier de données Client pour la clé "Nom"
HGèreDoublon(Client, Nom, Faux)
Syntaxe
<Résultat> = HGèreDoublon([<Fichier de données> [, <Rubrique clé>, ]] <Activation>)
<Résultat> : Booléen
Ancien mode de gestion des doublons (avant utilisation de la fonction HGèreDoublon) :
  • Vrai si la gestion des doublons était active,
  • Faux si la gestion des doublons n'était pas active (ou si la clé spécifiée est une clé avec doublons).
Si <Rubrique clé> = "*", <Résultat> est à Vrai si dans l'ancien mode de gestion des doublons, le test des doublons était actif au moins sur une rubrique.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données manipulé.
Si ce paramètre n'est pas spécifié ou correspond à "*", la gestion des doublons est prise en compte pour tous les fichiers de données de l'analyse.
<Rubrique clé> : Chaîne de caractères optionnelle
Nom de la rubrique clé unique utilisée.
Si ce paramètre n'est pas spécifié ou correspond à "*", la gestion des doublons est prise en compte pour toutes les rubriques clés du fichier de données spécifié.
<Activation> : Booléen
Mode de gestion :
  • Vrai si la gestion des doublons sur la rubrique doit être activée,
  • Faux si cette gestion doit être désactivée.
Si seul ce paramètre est précisé, le mode de gestion spécifié s'applique à toutes les rubriques de tous les fichiers de données.
Remarques

Gestion des doublons activée

Si la gestion du test des doublons est branchée sur une clé définie comme étant unique, le test d'unicité est effectué automatiquement lors de chaque ajout ou modification d'un enregistrement du fichier de données.
Aussi, si l'unicité n'est pas vérifiée lors d'un ajout (fonction HAjoute) ou d'une modification (fonction HModifie), l'enregistrement n'est pas ajouté (respectivement modifié), la fonction d'ajout (ou de modification) renvoie une erreur et la fonction HErreurDoublon renvoie Vrai.
Remarque : Seules les fonctions HAjoute et HModifie peuvent générer une erreur de doublons.

Généralisation du test des doublons

  • Pour généraliser le mode de gestion des doublons à toutes les rubriques d'un fichier de données, utilisez le méta-caractère "*".
    Par exemple :
    HGèreDoublon(<Fichier de données>, "*", <Activation>)
  • Pour généraliser le mode de gestion des doublons à toutes les rubriques de tous les fichiers de données, il faut utiliser le méta-caractère "*".
    Par exemple :
    HGèreDoublon("*", "*", <Activation>)
  • Si seul le paramètre <Activation> est précisé, le mode de gestion spécifié s'applique à tous les fichiers de données et à toutes les rubriques.

Désactiver le test des doublons

Désactiver le test de doublons implique la possibilité de violer les règles d'unicité énoncées lors de la description des fichiers de données dans l'éditeur d'analyses. Désactiver le test de doublons n'est donc pas une opération insignifiante : elle doit être utilisée à bon escient.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale