PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Fichier de données physique associé à un alias
  • Annuler des alias d'un ou de plusieurs fichiers de données
  • Alias et requêtes
  • Manipuler le fichier alias et ses rubriques
  • Changement de répertoire ou modification de la connexion
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HAlias (Fonction)
En anglais : HAlias
ODBCNon disponible avec ce type de connexion
Crée un alias logique d'un fichier de données (ou d'une requête) ou annule tous les alias existants. L'annulation de l'alias peut aussi être réalisée grâce à la fonction HAnnuleAlias.
Rappel : Un alias permet de travailler sur différents fichiers de données physiques ayant une même description logique. Par exemple, pour un fichier de données, la description du fichier est effectuée dans l'analyse et la fonction HAlias permet de créer l'alias du fichier.
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
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
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
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.
// Variable source de données pour manipuler l'alias après sa création
CommandeVerification est une Source de Données <description=Commande>
// Nouveauté de la version 19 :
// <description=Commande> permet d'obtenir la complétion de code
// pour les rubriques du fichier Commande

// Création d'un alias du fichier "Commande"
SI HAlias(Commande, CommandeVerification) = Vrai ALORS
// "CommandeVerification" peut maintenant être utilisé dans les traitements.
// Il se comporte comme le fichier "Commande" décrit dans l'analyse.
// Par défaut, le nom du fichier physique associé correspond
// au nom de la source de données donc ici "CommandeVerification"
// Pour manipuler le même fichier physique que celui d'origine, il faut modifier le nom :
   HChangeNom(CommandeVerification, Commande..NomPhysique)
    // Pour utiliser un fichier sur une autre base de données ou dans un autre répertoire,
// il faut ensuite utiliser la fonction HChangeConnexion ou la fonction HChangeRep
SINON
   Erreur("Echec de la création de l'alias", HErreurInfo())
   RETOUR
FIN
Commande2013 est une Source de Données
// Création d'un alias du fichier "Commande"
SI HAlias(Commande, Commande2013) = Vrai ALORS
// "Commande2013" peut maintenant être utilisé dans les traitements.
// Il se comporte comme le fichier "Commande" décrit dans l'analyse.
// Nom du fichier physique associé : nom par défaut Commande2013.
HCréationSiInexistant(Commande2013)
FIN
Syntaxe
<Résultat> = HAlias(<Nom Logique> [, <Nom de l'alias>])
<Résultat> : Booléen
  • Vrai si l'alias a été créé,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Nom Logique> : Chaîne de caractères (avec ou sans guillemets)
Nom logique du fichier de données (défini dans l'analyse) ou nom de la requête (créée avec l'éditeur de requêtes).
Si ce paramètre correspond à "*", tous les alias définis dans l'application en cours sont annulés. Les fichiers de données correspondants sont automatiquement fermés.
<Nom de l'alias> : Chaîne de caractères optionnelle (avec guillemets) ou source de données
Nom de l'alias, utilisé pour désigner la structure de l'alias. Si ce paramètre n'est pas précisé, tous les alias créés pour le fichier <Nom Logique> sont annulés. Les fichiers de données correspondants sont fermés.
Pour optimiser les performances de vos applications, il est conseillé d'utiliser une variable de type source de données (voir exemple).
OLE DBAccès Natifs Le fichier <Nom de l'alias> utilise les paramètres de connexion du fichier <Nom Logique> (paramètres définis dans l'analyse).
Remarques

Fichier de données physique associé à un alias

Par défaut, le nom spécifié pour l'alias est attribué au fichier de données physique correspondant à l'alias.
Pour associer l'alias à un fichier de données physique de nom différent, il suffit d'utiliser les fonctions HChangeConnexion, HChangeNom et HChangeRep.

Annuler des alias d'un ou de plusieurs fichiers de données

L'annulation d'un alias (fonction HAnnuleAlias) entraîne la fermeture du fichier de données associé.
Pour annuler les alias d'un fichier de données, il suffit d'utiliser la fonction HAlias sans préciser le nom de l'alias.
Pour annuler tous les alias définis sur tous les fichiers de données du projet en cours, il suffit d'utiliser la syntaxe suivante :
HAlias("*")

Alias et requêtes

  • Si la requête a été créée par programmation (fonction HExécuteRequêteSQL), il suffit de créer la requête alias avec cette même fonction mais en spécifiant le nom de l'alias.
  • Si la requête a été créée avec l'éditeur de requêtes, pour créer un alias, il suffit de :
    • exécuter la requête initiale.
    • utiliser la fonction HAlias en spécifiant le nom de la requête et le nom de l'alias.
    • utiliser la fonction HExécuteRequête avec la requête alias. L'alias est initialisé.
    Par exemple :
    AliasRequête est une Source de Données
    HAlias(REQ_Requête1, AliasRequête)
    HExécuteRequête(AliasRequête)

    Remarque : Lors de la création de l'alias, la requête initiale doit avoir été exécutée.
    Exemple :
    AliasRequête est une Source de Données
    SI HExécuteRequête(REQ_Requête1) = Faux ALORS
    Erreur(HErreur(hErrEnCours))
    SINON
    HLitPremier(REQ_Requête1)
    Trace(REQ_Requête1.Ville)
    HAlias(REQ_Requête1, AliasRequête)
    SI HExécuteRequête(AliasRequête) = Faux ALORS
    Erreur(HErreur(hErrEnCours))
    SINON
    POUR TOUT AliasRequête
    Trace(AliasRequête.Ville)
    FIN
    FIN
    FIN

Manipuler le fichier alias et ses rubriques

  • Pour éviter l'erreur "Identificateur inconnu" lors de l'utilisation d'un fichier alias et de ses rubriques, il est recommandé d'utiliser une variable de type source de données pour déclarer le nom de l'alias avant l'utilisation de la fonction HAlias.
    Par exemple :
    Commande2000 est une Source de Données
    HAlias(Commande, Commande2000)

    Attention : l'utilisation du mot-clé Externe est possible mais entraîne un ralentissement non négligeable à l'exécution.
  • Dans les fonctions HLitRecherche, HLitPremier, HLitSuivant, ... le nom de la rubrique de l'alias ne peut pas être utilisé directement : il faut utiliser le nom de la rubrique entre guillemets.
    Par exemple :
    HLitRecherchePremier(srcAlias, "RubriqueClé", "Valeur Recherchée")
  • Sous l'éditeur de fenêtres ou de pages, les champs ne peuvent pas être directement associés à des rubriques des fichiers alias. Il est nécessaire : Exemple :
    ChampAlias(Champ, srcAlias)
    OU
    ChampAlias(GR_GroupeDeChamp, srcAlias)
    OU
    ChampAlias(FEN_Fenêtre, srcAlias)
    OU
    SAI_NomClient..LiaisonFichier = "SrcAlias.NomClient"
  • Les fichiers alias peuvent être manipulés par les fonctions HListeRubrique et HListeClé. Les fichiers alias peuvent être ré-indexés.
  • Par défaut, le mot de passe d'un fichier alias est identique au mot de passe du fichier de données d'origine. Il est possible de modifier ce mot de passe grâce à la fonction HPasse. Le nom du fichier de données utilisé dans cette fonction correspond alors au nom de l'alias.
  • La modification automatique des fichiers de données peut être appliquée aux fichiers alias.
  • Les blocages des fichiers de données ou des enregistrements sont effectifs entre les alias d'une même instance d'une application.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesOLE DBAccès Natifs

Changement de répertoire ou modification de la connexion

Si les fonctions HChangeRep ou HConnecte ont été utilisées avec le fichier d'origine, ces changements ne sont pas pris en compte pour le fichier <Nom de l'Alias>.
Après avoir créé un alias, il est conseillé d'utiliser la fonction HConnecte pour définir les paramètres de connexion sur le fichier alias.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire