Fichier de données physique associé à un alias

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

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 :
  

  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é LiaisonFichier avant d'utiliser :
    • la fonction FichierVersEcran.
    • la fonction FichierVersPage.
  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.