DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Règle de suppression et de modification
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Renvoie la liste des liaisons d'une table (de type Merise) présentes:
  • dans le schéma des données en cours,
  • dans les schémas des données en cours (cas des projets multi-schémas des données).
  • dans un schéma des données spécifique.
Exemple
// Récupérer les liaisons de la table Client du schéma des données en cours
ListeLiaison est une chaîne
ListeLiaison = Client.ListeLiaison(hLstDétail)
// Ajoute la liste des liaisons dans le champ COMBO_MaCombo
COMBO_MaCombo.Ajoute(ListeLiaison)
Syntaxe

Lister les liaisons d'une table présente dans un schéma des données Masquer les détails

<Résultat> = <Source>.ListeLiaison([<Chemin du WDD> [, <Mot de passe du WDD>]] [, <Options>])
<Résultat> : Chaîne de caractères
Liste des liaisons.
Cas des projets multi-schémas des données: Si plusieurs schémas des données sont en cours, toutes les liaisons de tous les schémas des données en cours sont listées (sans doublons).
Les différentes descriptions de chaque liaison sont séparées par RC (Retour chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé:
hLstDétail non précisé<Nom Liaison 1> + TAB + <Nom Fichier de données 1.1> + TAB + <Nom Rubrique 1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier de données 1.2> + TAB + <Nom Rubrique 1.2> + TAB + <Cardinalité 1.2> + RC + ...
hLstDétail précisé<Nom Liaison 1> + TAB + <Nom Fichier de données 1.1> + TAB + <Nom Rubrique 1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier de données 1.2> + TAB + <Nom Rubrique 1.2> + TAB + <Cardinalité 1.2> + TAB + <Règle de modification> + TAB + <Règle de suppression> + RC + ...

Où:
  • <Nom Liaison X>: Nom de la liaison.
  • <Nom Table x.1>: Nom de la table côté clé primaire.
  • <Nom Rubrique x.1>: Nom de la rubrique côté clé primaire.
  • <Cardinalité x.1>: Cardinalité de la liaison côté clé primaire, de la forme "<Cardinalité min>,<Cardinalité max>" (par exemple "0,N" ou "1,N").
  • <Nom Table x.2>: Nom de la table côté clé étrangère.
  • <Nom Rubrique x.2>: Nom de la rubrique côté clé étrangère.
  • <Cardinalité x.2>: Cardinalité de la liaison côté clé étrangère, de la forme "<Cardinalité min>,<Cardinalité max>" (par exemple "0,N" ou "1,N").
  • <Règle de modification>: Règle à appliquer en cas de modification de la clé primaire.
  • <Règle de suppression>: Règle à appliquer en cas de suppression de la clé primaire.
HFSQL Client/Serveur Le nom des tables correspond au nom de la base + '\' + le nom physique relatif de ces tables.
OLE DBConnecteurs Natifs (Accès Natifs) Si une des liaisons listées est réalisée sur une clé composée, le paramètre <Nom Rubrique 1.2> renvoyé correspondra aux noms des différentes composantes de la clé. Les noms seront séparés par une virgule.
<Source> : Type correspondant à la source spécifiée
Nom de la table dont les liaisons doivent être listées. Les liaisons partant ou arrivant à cette table sont indiquées.
<Chemin du WDD> : Chaîne de caractères optionnelle
Chemin complet du schéma des données (c'est-à-dire du fichier .WDD).
Si ce paramètre n'est pas précisé ou est égal à une chaîne vide (""), les liaisons sont recherchées:
  • dans le schéma des données en cours.
  • dans l'ensemble des schémas des données en cours (cas des projets multi-schémas des données).
<Mot de passe du WDD> : Chaîne de caractères optionnelle ou Chaîne secrète
Mot de passe défini pour le schéma des données. Si aucun mot de passe n'est défini, ce paramètre doit être égal à une chaîne vide ("").
Nouveauté 2025
Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
<Options> : Constante optionnelle de type entier
Type de liste à effectuer:
hLstDétailListe les informations détaillées sur les liaisons.
hLstNormal
(valeur par défaut)
Liste les liaisons.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.

Lister les liaisons d'une table accessible via une connexion par Connecteur natif ou par OLE DB ou via une connexion HFSQL Client/Serveur Masquer les détails

<Résultat> = <Source>.ListeLiaison([<Connexion>] [, <Options>])
<Résultat> : Chaîne de caractères
Liste des liaisons. Les différentes descriptions de chaque liaison sont séparées par RC (Retour chariot). En fonction de la constante utilisée, le résultat est plus ou moins détaillé:
hLstDétail non précisé<Nom Liaison 1> + TAB + <Nom Fichier de données 1.1> + TAB + <Nom Rubrique 1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier de données 1.2> + TAB + <Nom Rubrique 1.2> + TAB + <Cardinalité 1.2> + RC + ...
hLstDétail précisé<Nom Liaison 1> + TAB + <Nom Fichier de données 1.1> + TAB + <Nom Rubrique 1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier données 1.2> + TAB + <Nom Rubrique 1.2> + TAB + <Cardinalité 1.2> + TAB + <Règle de modification> + TAB + <Règle de suppression> + RC + ...

Où:
  • <Nom Liaison X>: nom de la liaison.
  • <Nom Table x.1>: Nom de la table côté clé primaire.
  • <Nom Rubrique x.1>: Nom de la rubrique côté clé primaire ou nom de la table spécifiée.
  • <Cardinalité x.1>: Cardinalité de la liaison côté clé primaire, de la forme "<Cardinalité min>,<Cardinalité max>" (par exemple "0,N" ou "1,N").
  • <Nom Table x.2>: Nom de la table côté clé étrangère.
  • <Nom Rubrique x.2>: Nom de la rubrique côté clé étrangère.
  • <Cardinalité x.2>: Cardinalité de la liaison côté clé étrangère, de la forme "<Cardinalité min>,<Cardinalité max>" (par exemple "0,N" ou "1,N").
  • <Règle de modification>: Règle à appliquer en cas de modification de la clé primaire (voir Remarques).
  • <Règle de suppression>: Règle à appliquer en cas de suppression de la clé primaire (voir Remarques).
HFSQL Client/Serveur Le nom des tables correspond au nom de la base + '\' + le nom physique relatif de ces tables.
OLE DBConnecteurs Natifs (Accès Natifs) Si une des liaisons listées est réalisée sur une clé composée, le paramètre <Nom Rubrique 1.2> renvoyé correspondra au nom des différentes composantes de la clé. Les noms seront séparés par une virgule.
<Source> : Type correspondant à la source spécifiée
Nom de la table dont les liaisons doivent être listées. Les liaisons partant ou arrivant à cette table sont indiquées.
<Connexion> : Chaîne de caractères ou variable de type Connexion
Connexion à manipuler. Cette connexion correspond:
<Options> : Constante optionnelle de type entier
Type de liste à effectuer:
hLstDétailListe les informations détaillées sur les liaisons.
hLstNormal
(valeur par défaut)
Liste les liaisons.
Hyper File 5.5 Ce paramètre n'est pas pris en compte.
Remarques

Règle de suppression et de modification

Les règles de modification et de suppression renvoyées par la fonction <Source>.ListeLiaison peuvent correspondre aux constantes suivantes:
hIntégritéAucuneAucune contrainte d'intégrité.
hIntégritéCascadeGestion de la modification et de la suppression en cascade.
hIntégritéInterditeRespect strict de l'intégrité.
hIntégritéValeurDéfautLors de la suppression, rattachement des enregistrements liés à une valeur par défaut.
Composante: wd300hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/05/2025

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