PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


Nouveauté WINDEV, WEBDEV, WINDEV Mobile 25 !
  • Gestion de l'intégrité activée
  • Désactiver les règles d'intégrité
  • En mode HFSQL Client/Serveur
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Active ou désactive la gestion d'une contrainte d'intégrité sur une liaison d'un fichier de données.
Remarque : Par défaut, toutes les règles d'intégrité définies dans la description de l'analyse sont actives.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 22 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 22
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Android Cette fonction est désormais disponible pour les applications Android.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Java Cette fonction est désormais disponible pour les applications Java.
Android Cette fonction est désormais disponible pour les applications Android.
Exemple
// Désactiver les règles d'intégrité sur la liaison entre une commande et un client
// avec utilisation d'une connexion
CxFichierSource est une Connexion
CxFichierRelié est une Connexion
 
CxFichierSource.GèreIntégrité(CxFichierRelié, ClientCommande, ...
hCardinalité + hEnModification + hEnSuppression, Faux)

Activer ou désactiver la gestion d'une contrainte d'intégrité en spécifiant la connexion du fichier de données Masquer les détails

<Résultat> = <Connexion fichier de données source>.GèreIntégrité([<Connexion fichier de données relié>, ] <Description de la liaison> [, <Contrainte d'intégrité>] , <Mode de gestion>)
<Résultat> : Booléen
Ancienne gestion de l'intégrité (avant utilisation de la fonction <Variable Connexion>.GèreIntégrité) :
  • Vrai si la gestion de l'intégrité était active,
  • Faux si la gestion de l'intégrité était inactive.
<Connexion fichier de données source> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion à laquelle appartient le fichier de données source de la liaison.
<Connexion fichier de données relié> : Variable de type Connexion
Nom de la variable de type Connexion décrivant la connexion à laquelle appartient le fichier de données relié de la liaison.
<Description de la liaison> : Variable de type Description de liaison
Nom de la variable de type Description de liaison contenant les caractéristiques de la liaison.
<Contrainte d'intégrité> : Constante ou combinaison de constantes optionnelle de type Entier
Contraintes d'intégrité à gérer. Si ce paramètre n'est pas spécifié, la nouvelle gestion s'applique à toutes les contraintes de la liaison.
hCardinalitéTest des cardinalités de la liaison.
hEnModificationRègle d'intégrité appliquée pendant une modification.
hEnSuppressionRègle d'intégrité appliquée pendant une suppression.
<Mode de gestion> : Booléen
  • Vrai si la contrainte d'intégrité est 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 à tous les fichiers de données.
Remarques

Gestion de l'intégrité activée

Si une opération sur un fichier de données entraîne la violation d'une contrainte d'intégrité sur une règle active, l'opération n'est pas effectuée et provoque l'erreur de la fonction. La fonction HErreurIntégrité renvoie alors Vrai.
Remarque : Seules les fonctions <Source>.Ajoute, <Source>.Modifie, <Source>.Supprime, <Fichier HFSQL>.Raye et <Source>.Ecrit peuvent générer une erreur d'intégrité.

Désactiver les règles d'intégrité

Désactiver une règle d'intégrité implique la possibilité de violer les contraintes énoncées lors de la description des fichiers de données dans l'éditeur d'analyses. Désactiver une règle d'intégrité n'est donc pas une opération insignifiante : elle doit être utilisée à bon escient.
WINDEVWEBDEV - Code ServeurEtats et RequêtesAndroidWidget AndroidiPhone/iPadUniversal Windows 10 AppWindows MobileJavaHFSQL Client/Serveur

En mode HFSQL Client/Serveur

L'utilisation de la syntaxe <Variable Connexion>.GèreIntégrité(<Gestion>) influe sur le comportement de tous les serveurs HFSQL (que l'ouverture de la connexion soit antérieure ou postérieure à l'appel de la fonction <Variable Connexion>.GèreIntégrité).
L'utilisation de la fonction <Variable Connexion>.GèreIntégrité en précisant le nom de la liaison n'est possible que si :
  • La liaison est décrite dans l'analyse du client (ou par la fonction HDécritLiaison).
  • Les deux fichiers de données reliés par cette liaison sont situés sur le même serveur HFSQL.
Si l'appel à la fonction <Variable Connexion>.GèreIntégrité est effectuée avant que les fichiers de données soient en mode Client/Serveur (par exemple, si la fonction <Source>.ChangeConnexion est utilisée), le serveur active la règle d'intégrité.
Un droit est associé à la gestion de l'intégrité sur la base de données : hDroitGèreIntégrité. Une erreur de droit apparaît lorsque l'utilisateur tente de violer la contrainte d'intégrité (par exemple lors de l'utilisation des fonctions <Source>.Ajoute, <Source>.Modifie, ...).
Composante : wd250hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire