|
|
|
|
|
- Table physique associée à un alias
- Annuler des alias d'une ou de plusieurs tables
- Alias et requêtes
- Manipuler le fichier alias et ses rubriques
- Changement de répertoire ou modification de la connexion
HAlias (Fonction) En anglais : HAlias
Non disponible avec ce type de connexion
Crée un alias logique d'une table (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érentes tables physiques ayant une même description logique. Par exemple, pour une table, la description de la table est effectuée dans le schéma des données et la fonction HAlias permet de créer l'alias de la table. Remarque: Cette page d'aide décrit la création d'un alias avec la fonction HAlias. A partir de la version 27, il est possible d'utiliser une variable de type Alias. Ce type de variable simplifie la création et la manipulation des alias.
CommandeVerification est une Source de Données <description=Commande>
SI HAlias(Commande, CommandeVerification) = Vrai ALORS
HChangeNom(CommandeVerification, Commande.NomPhysique)
SINON
Erreur("Echec de la création de l'alias", HErreurInfo())
RETOUR
FIN
Syntaxe
<Résultat> = HAlias(<Table> [, <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.
<Table> : Chaîne de caractères Nom logique de la table (défini dans le schéma des données) 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 tables correspondantes sont automatiquement fermées. <Alias> : Chaîne de caractères optionnelle 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 <Table> sont annulés. Les tables correspondantes sont fermées. Pour optimiser les performances de vos applications, il est conseillé d'utiliser une variable de type Source de données (voir exemple). Remarques Table physique associée à un alias Par défaut, le nom spécifié pour l'alias est attribué à la table physique correspondant à l'alias. Annuler des alias d'une ou de plusieurs tables L'annulation d'un alias (fonction HAnnuleAlias) entraîne la fermeture de la table associée. Pour annuler les alias d'une table, il suffit d'utiliser la fonction HAlias sans préciser le nom de l'alias. Pour annuler tous les alias définis sur toutes les tables du projet en cours, il suffit d'utiliser la syntaxe suivante: 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:
Commande2018 est une Source de Données
HAlias(Commande, Commande2018)
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")
- Le nom de la source de données ne doit pas être utilisé entre guillemets, si l'option Nommage automatique des sources de données est activée dans la fenêtre de description du projet.
- 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:
- soit d'affecter les champs un par un par programmation.
- soit d'utiliser la fonction ChampAlias ou la propriété LiaisonDonnées avant d'utiliser:
Exemple:
ChampAlias(Champ, srcAlias)
OU
ChampAlias(GR_GroupeDeChamp, srcAlias)
OU
ChampAlias(FEN_Fenêtre, srcAlias)
OU
SAI_NomClient.LiaisonDonnées = "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'une table alias est identique au mot de passe de la table d'origine. Il est possible de modifier ce mot de passe grâce à la fonction HPasse. Le nom de la table utilisé dans cette fonction correspond alors au nom de l'alias.
- La modification automatique des tables peut être appliquée aux tables alias.
- Les blocages des tables ou des enregistrements sont effectifs entre les alias d'une même instance d'une application.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|