DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Affichage du résultat dans un champ Liste ou un champ Combo
  • Règle de suppression et de modification
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
Renvoie la liste des liaisons d'un fichier de données (de type Merise) présentes dans l'analyse en cours ou dans une analyse spécifique.
Exemple
// Récupérer les liaisons du fichier de données Client de l'analyse en cours
ListeLiaison est une chaîne
ListeLiaison = HListeLiaison(Client, hLstDétail)
// Ajoute la liste des liaisons dans le champ COMBO_COMBO1
ListeAjoute(COMBO_COMBO1, ListeLiaison)
// Récupérer les liaisons d'une base de données HFSQL Client/Serveur
// indépendamment de l'analyse en cours
CnxHFSQL est une Connexion
CnxHFSQL.Provider = hAccèsHFClientServeur
CnxHFSQL.Utilisateur = "admin"
CnxHFSQL.MotDePasse = ""
CnxHFSQL.Serveur = "HFSQLServeur:4900"
CnxHFSQL.BaseDeDonnées = "CRM"
HOuvreConnexion(CnxHFSQL)
ListeLaison est chaîne = HListeLiaison("*", CnxHFSQL)
// Ajoute la liste des liaisons dans le champ COMBO_COMBO1
ListeAjoute(COMBO_COMBO1, ListeLiaison)
Syntaxe

Lister les liaisons présentes dans une analyse Masquer les détails

<Résultat> = HListeLiaison([<Fichier de données> [, <Chemin du WDD> [, <Mot de passe du WDD>]]] [, <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 Liaison1> + TAB + <Nom Fichier1.1> + TAB + <Nom Rubrique1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier1.2> + TAB + <Nom Rubrique1.2> + TAB + <Cardinalité 1.2> + RC + ...
hLstDétail précisé<Nom Liaison1> + TAB + <Nom Fichier1.1> + TAB + <Nom Rubrique1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier1.2> + TAB + <Nom Rubrique1.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 Fichier x.1> : Nom du fichier de données côté clé primaire.
  • <Nom Rubrique x.1> : Nom de la rubrique côté clé primaire ou nom du fichier de données spécifié.
  • <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 Fichier x.2> : Nom du fichier de données 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 fichiers de données correspond au nom de la base + '\' + le nom physique relatif de ces fichiers de données.
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.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données dont les liaisons doivent être listées. Les liaisons partant ou arrivant à ce fichier de données sont indiquées.
Si ce paramètre correspond à "*", la fonction HListeLiaison liste des liaisons définies pour tous les fichiers de données présents dans l'analyse.
<Chemin du WDD> : Chaîne de caractères optionnelle
Chemin complet de l'analyse (c'est-à-dire du ficher .WDD). Si ce paramètre n'est pas précisé ou est égal à une chaîne vide (""), les liaisons sont recherchées dans l'analyse en cours.
<Mot de passe du WDD> : Chaîne de caractères optionnelle
Mot de passe défini pour l'analyse. Si aucun mot de passe n'est défini, ce paramètre doit être égal à une chaîne vide ("").
<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.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)Ajax

Lister les liaisons d'un fichier de données accessible via une connexion par Connecteur natif ou par OLE DB ou via une connexion HFSQL Client/Serveur Masquer les détails

<Résultat> = HListeLiaison([<Fichier de données> [, <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 Liaison1> + TAB + <Nom Fichier1.1> + TAB + <Nom Rubrique1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier1.2> + TAB + <Nom Rubrique1.2> + TAB + <Cardinalité 1.2> + RC + ...
hLstDétail précisé<Nom Liaison1> + TAB + <Nom Fichier1.1> + TAB + <Nom Rubrique1.1> + TAB + <Cardinalité 1.1> + TAB + <Nom Fichier1.2> + TAB + <Nom Rubrique1.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 fichier x.1> : Nom du fichier de données côté clé primaire.
  • <Nom Rubrique x.1> : Nom de la rubrique côté clé primaire ou nom du fichier de données spécifié.
  • <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 fichier x.2> : Nom du fichier de données 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 fichiers de données correspond au nom de la base + '\' + le nom physique relatif de ces fichiers de données.
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.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données dont les liaisons doivent être listées. Les liaisons partant ou arrivant à ce fichier de données sont indiquées.
Si ce paramètre correspond à "*", la fonction HListeLiaison liste des liaisons définies pour tous les fichiers de données présents dans l'analyse.
Ce paramètre peut correspondre à un nom inconnu du moteur HFSQL, existant uniquement sur le serveur de base de données.
Le nom du fichier de données mis en première position correspond au fichier de données côté clé primaire.
<Connexion> : Chaîne de caractères optionnelle 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

Affichage du résultat dans un champ Liste ou un champ Combo

<Résultat> peut être directement affecté à un champ Liste ou un champ Combo grâce à la fonction ListeAjoute. Chaque ligne contiendra le nom complet d'une des liaisons trouvées.

Règle de suppression et de modification

Les règles de modification et de suppression renvoyées par la fonction HListeLiaison 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 : wd280hf.dll
Voir Aussi
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