DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Types de variables HFSQL
  • Propriétés spécifiques à la description de liaisons
  • Comment décrire des fichiers de données par programmation ?
  • Manipulation des liaisons d'un fichier de données décrit par programmation
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
Une variable de type Description de Liaison permet de décrire par programmation une liaison entre deux fichiers de données. La description de chaque liaison est validée par la fonction HDécritLiaison.
Après cette validation :
  • Cette liaison pourra être manipulée comme n'importe quelle liaison décrite dans l'analyse.
  • La variable de type "Description de Liaison" est réinitialisée et pourra être utilisée pour décrire par programmation une autre liaison.
Remarque : Pour ajouter une liaison dans une base de données HFSQL Client/Serveur, utilisez la fonction HAjouteLiaison.
Exemple
MaLiaison est une Description de Liaison
MaLiaison1, MaLiaison2 sont des Descriptions de Liaison
// Description et validation des fichiers de données Ville et Client
...

// Description de la liaison "HABITE"
MaLiaison est une Description de Liaison
MaLiaison.Nom = "HABITE"
MaLiaison.FichierSource = "VILLE"
MaLiaison.FichierRelié = "CLIENT"
MaLiaison.CléSource = "NOMVILLE"
MaLiaison.CléReliée = "VILLECLI"
// Liaison par défaut (0-1, 0-1)

// Validation de la description de la liaison "HABITE"
HDécritLiaison(MaLiaison)
Syntaxe

Déclarer une ou plusieurs descriptions de liaison Masquer les détails

<Nom de la variable> est une Description de Liaison
<Nom de la variable 1>, <Nom de la variable 2> sont des Descriptions de Liaison
<Nom de la variable> :
Nom de la variable de type "Description de Liaison" à déclarer.
Remarque : Les mots-clés une et des ne sont pas obligatoires : ce sont des mots d'agrément.

Décrire une variable de type "Description de Liaison" Masquer les détails

Pour décrire une variable de type "Description de Liaison" :
Utilisez les propriétés du WLangage spécifiques aux descriptions de liaisons. Pour plus de détails, consultez les remarques.

Pour valider une description d'une variable de type "Description de Liaison" :
Utilisez la fonction HDécritLiaison.
Remarques

Propriétés spécifiques à la description de liaisons

Les propriétés spécifiques à la description de liaisons sont les suivantes :
Remarque : Les propriétés en gras suivies d'un astérisque doivent obligatoirement être initialisées lors de la description d'une liaison par programmation.
Nom de la propriétéEffet
CardinalitéReliéeMaxCardinalité maximale de la rubrique reliée dans une liaison
CardinalitéReliéeMinCardinalité minimale de la rubrique reliée dans une liaison
CardinalitéSourceMaxCardinalité maximale de la rubrique source dans une liaison
CardinalitéSourceMinCardinalité minimale de la rubrique source dans une liaison
CléReliée ( * )Rubrique du fichier relié utilisée dans la liaison
CléSource ( * )Rubrique du fichier source utilisée dans la liaison
FichierRelié ( * )Nom du fichier relié utilisé dans la liaison
FichierSource ( * )Nom du fichier source utilisé dans la liaison
Nom ( * )Nom de la liaison
RègleModificationRègle de modification (gestion de l'intégrité) utilisée dans une liaison
RègleSuppressionRègle de suppression (gestion de l'intégrité) utilisée dans une liaison

Par défaut, les cardinalités de la liaison sont (0-1) / (0-1).

Comment décrire des fichiers de données par programmation ?

Pour décrire des fichiers de données par programmation, il faut :
  1. Déclarer des variables de type "Description de fichier", "Description de Rubrique", "Description d'IndexFullText" et "Description de Liaison" (si nécessaire).
  2. Pour chaque fichier de données :
  3. Décrire si nécessaire les caractéristiques des liaisons grâce aux propriétés HFSQL.
  4. Valider si nécessaire la description de chaque liaison (fonction HDécritLiaison).

Manipulation des liaisons d'un fichier de données décrit par programmation

Lors de la création d'une liaison sous l'éditeur d'analyses, le nom de cette liaison est automatiquement reconnu par le compilateur.
Lors de la création d'une liaison à l'aide d'une variable de type "Description de Liaison", le nom de cette liaison est défini grâce à la propriété Nom. Ce nom n'est pas automatiquement reconnu par le compilateur. L'utilisation de ce nom pour désigner la liaison provoque une erreur de compilation.
Pour que le nom de la liaison créé par programmation soit reconnu par le compilateur, il est nécessaire de déclarer ce nom grâce au mot-clé Externe. Cette liaison pourra alors être manipulée par son nom sous l'éditeur de code.
Par exemple :
MaLiaison est une Description de Liaison
...
MaLiaison.Nom = "HABITE"
...
HDécritLiaison("HABITE")
...
EXTERNE HABITE
...
Cardinalité = HABITE.CardinalitéReliéeMax
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/07/2023

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