|
|
|
|
|
|
|
|
|
|
- Gestion de l'intégrité activée
- Désactiver les règles d'intégrité
- En mode HFSQL Client/Serveur
HGèreIntégrité (Fonction) En anglais : HSetIntegrity
  Disponible uniquement avec ces types de connexion
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.
HGèreIntégrité(ClientCommande, hCardinalité, Faux)
HGèreIntégrité("*", "*", hCardinalité + hEnModification + hEnSuppression, Faux)
CxFichierSource est une Connexion
CxFichierRelié est une Connexion
HGèreIntégrité(CxFichierSource, CxFichierRelié, ClientCommande, ...
hCardinalité + hEnModification + hEnSuppression, Faux)
Syntaxe
Activer ou désactiver la gestion d'une contrainte d'intégrité en spécifiant le nom du fichier de données Masquer les détails
<Résultat> = HGèreIntégrité([<Liaison à  manipuler>] [, <Fichier de données>] [, <Contrainte d'intégrité>] , <Mode de gestion>)
<Résultat> : Booléen Ancienne gestion de l'intégrité (avant utilisation de la fonction HGèreIntégrité) : - Vrai si la gestion de l'intégrité était active,
- Faux si la gestion de l'intégrité était inactive.
Si <Liaison à manipuler> = "*" ou si <Fichier de données> = "*" , <Résultat> est à Vrai si dans l'ancien mode de gestion de l'intégrité, l'intégrité était activée sur au moins une liaison ou au moins un fichier de données. <Liaison à manipuler> : Chaîne de caractères optionnelle Nom de la liaison concernée (nom composé des différents fichiers de données participant à la liaison).
Si ce nom n'est pas spécifié ou est égal à "*", la nouvelle gestion de l'intégrité s'applique à toutes les liaisons définies dans l'analyse. <Fichier de données> : Chaîne de caractères optionnelle Nom du fichier de données manipulé.
Si ce nom n'est pas spécifié ou est égal à "*", la nouvelle gestion spécifiée s'applique à tous les fichiers de données intervenant dans la liaison (y compris les alias).
Si le paramètre <Liaison à manipuler> correspond à "*", ce paramètre doit également correspondre à "*". En effet, il n'est pas possible d'activer ou de désactiver l'ensemble des contraintes d'intégrité de toutes les liaisons d'un fichier de données spécifique. <Contrainte d'intégrité> : Constante ou combinaison de constantes optionnelle de type Entier Permet de déterminer les 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. | | hEnModification | Règle d'intégrité appliquée pendant une modification. | | hEnSuppression | Rè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.
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> = HGèreIntégrité(<Connexion fichier de données source> [, <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 HGè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> : Chaîne de caractères ou variable de type Connexion Connexion à laquelle appartient le fichier de données source de la liaison. Cette connexion correspond : <Connexion fichier de données relié> : Chaîne de caractères optionnelle ou variable de type Connexion Connexion à laquelle appartient le fichier de données relié de la liaison. Cette connexion correspond : Si ce paramètre n'est pas précisé, les deux fichiers de données appartiennent alors à la même connexion (paramètre <Connexion fichier de données source>). <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. | | hEnModification | Règle d'intégrité appliquée pendant une modification. | | hEnSuppression | Rè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. 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|