DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions d'impression
  • Champ Etat Interne : état basé sur une requête manipulant une connexion spécifique
  • Divers
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
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.
Linux Attention : L'utilisation de cette fonction sous Linux nécessite une configuration spécifique. Pour plus de détails, consultez Imprimer sous Linux.
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.
Exemple
// Initialisation de la requête 
iInitRequêteEtatConnexion(ETAT_BulletinScolaire, hRequêteSansCorrection, ...
"MaConnexion_Oracle", "Dupond", "2020")
// Impression de l'état
iImprimeEtat(ETAT_BulletinScolaire)
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxConnecteurs Natifs (Accès Natifs)
// Initialisation de la requête (connexion Oracle) 
iInitRequêteEtatConnexion(ETAT_BulletinScolaire, "MaConnexion_Oracle", "Dupond", "2020")
// Impression de l'état
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êteInterruptibleL'initialisation de la requête peut être interrompue avec la touche ECHAP
hRequêteSansCorrection
OLE DBConnecteurs Natifs (Accès Natifs) Le moteur HFSQL n'effectue aucune vérification de la requête. Cette option doit être utilisée si la requête comporte des ordres spécifiques à un type de connexion (Oracle, SQL Server, ...).
Attention : si cette constante est utilisée :
hRequêteSansCorrectionHFHFSQL 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".
Pour plus de détails sur les "Etat Interne", consultez Champs de type 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
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 08/12/2023

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