|
|
|
|
|
|
|
|
|
|
- Champ Etat Interne : état basé sur une requête manipulant une connexion spécifique
- Divers
iInitRequêteEtatConnexion (Fonction) En anglais : iInitReportQueryConnection Initialise la requête liée à l'état. Cette fonction doit être utilisée si la requête utilise des fichiers accédés par une connexion spécifique (connexion à l'aide d'un provider OLE DB par exemple). Si la requête n'utilise pas de connexion spécifique, utilisez la fonction iInitRequêteEtat. Cette fonction peut être appelée : - soit dans l'événement "Initialisation" de l'état. Si la requête attend des paramètres, il est possible de spécifier les paramètres attendus.
- soit avant la fonction iImprimeEtat.
 Si la requête est créée avec l'éditeur d'états utilisateur, il n'est pas nécessaire d'utiliser la fonction iInitRequêteEtatConnexion pour spécifier les paramètres de la requête. En effet, lors de l'exécution d'un état sur une requête paramétrée depuis l'éditeur d'états utilisateur, une fenêtre s'affiche permettant de saisir les paramètres de la requête.
iInitRequêteEtatConnexion(ETAT_BulletinScolaire, hRequêteSansCorrection, ...
"MaConnexion_Oracle", "Dupond", "2020")
iImprimeEtat(ETAT_BulletinScolaire)
Syntaxe
iInitRequêteEtatConnexion(<Etat manipulé> [, <Mode d'initialisation>] , <Nom de la connexion> [, <Paramètre 1 de la requête> [... [, <Paramètre N de la requête>]]])
<Etat manipulé> : Nom d'état Nom logique de l'état à imprimer. <Mode d'initialisation> : Constante optionnelle de type Entier Option pour l'initialisation de la requête : | | hAvecFiltre
(option combinable avec les autres constantes) | Si cette constante est spécifiée :- le résultat de la requête correspond à une sélection d'enregistrements de type filtre si le moteur HFSQL le permet. Sinon, le résultat de la requête est une vue HFSQL.
- les opérations suivantes ne sont pas possibles : recherche sur le résultat de la requête, requête sur requête, vue sur requête, requête sur vue.
- les rubriques de parcours spécifiées lors du parcours du résultat ne sont pas prises en compte.
- la loupe n'est pas disponible sur les tables liées à une requête.
- la fonction hNbEnr ne peut pas être utilisée sur les requêtes.
Attention : si cette option est précisée, la constante hModifieFichier est automatiquement utilisée.
Si cette constante n'est pas spécifiée (par défaut) : - le résultat de la requête correspond à une vue HFSQL
- il est possible de réaliser les opérations suivantes sur les requêtes : recherche sur le résultat de la requête, requête sur requête, vue sur requête, requête sur vue.
- les rubriques de parcours spécifiées lors du parcours du résultat sont prises en compte.
- la loupe est disponible sur les tables liées à une requête.
- la fonction hNbEnr peut être utilisée sur les requêtes.
| hModifieFichier
(option combinable avec les autres constantes) | Sur des fichiers de données HFSQL : Lors de la modification du résultat de la requête (fonctions HAjoute, HEcrit, HModifie, HRaye, HSupprime), ces modifications seront reportées dans les fichiers intervenant dans la requête.
Si cette option n'est pas précisée, seul le résultat de la requête est modifié.
Pour plus de détails sur la modification du résultat d'une requête, consultez Modifier le contenu d'une requête.
Sur des fichiers de données non HFSQL, la constante hModifieFichier est inutile : les fichiers intervenant dans la requête sont automatiquement modifiés lors de la modification du résultat de la requête. | hRequêteDéfaut
(valeur par défaut) | Initialisation de la requête sans interruption. | | hRequêteInterruptible | L'initialisation de la requête peut être interrompue avec la touche ECHAP | | hRequêteSansCorrection | | | hRequêteSansCorrectionHF | HFSQL uniquement : Le moteur HFSQL n'effectue aucune vérification du format de fichier (complété par des espaces ou non). A utiliser si la requête manipule à la fois des fichiers HFSQL au format complété par des espaces et des fichiers HFSQL au format non complété par des espaces. |
<Nom de la connexion> : Chaîne de caractères Nom de la connexion à une base de données. Cette connexion a été définie dans l'éditeur d'analyses ou dynamiquement par la fonction HDécritConnexion. La description de la connexion doit être connue au moment de l'exécution de la fonction. <Paramètre 1 de la requête> : Type du paramètre de la requête (optionnel) Premier paramètre de la requête définie comme source de l'état (si la requête attend un paramètre). <Paramètre N de la requête> : Type du paramètre de la requête (optionnel) Dernier paramètre de la requête définie comme source de l'état (si la requête attend un paramètre). Remarques Champ Etat Interne : état basé sur une requête manipulant une connexion spécifique Si l'état associé à un champ de type "Etat interne" est basé sur une requête manipulant une connexion spécifique, utilisez la fonction iInitRequêteEtatConnexion pour exécuter cette requête (et lui passer si nécessaire des paramètres). Cette fonction doit être utilisée dans l'événement "Avant impression" du bloc contenant le champ "Etat Interne". Divers - Si certains paramètres attendus par la requête ne sont pas précisés (valeur correspondant à une chaîne vide par exemple), les conditions de sélection correspondant à ces paramètres seront ignorées.
- Si le nombre de paramètres précisé dans la fonction iInitRequêteEtatConnexion est supérieur au nombre de paramètres attendu par la requête, les paramètres supplémentaires sont ignorés.
Classification Métier / UI : Code neutre Composante : wd300etat.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|