ResultatRubrique

Evalue NomRubrique et renvoie le contenu de la rubrique définie.

Format 

ResultatRubrique ( Rubrique )

Paramètres 

Rubrique : une expression de type texte ou une rubrique texte se rapportant à un nom de rubrique

Résultat 

Texte, nombre, date, heure, horodatage, conteneur

Provient de la version 

6.0 ou version antérieure

Description 

RésultatRubrique évalue Rubrique, compare le résultat à une rubrique de la table pour laquelle le calcul a été effectué et renvoie le contenu de cette rubrique.

Pour renvoyer les valeurs des rubriques ayant le même nom dans plusieurs tables, placez Rubrique entre guillemets, comme dans RésultatRubrique("Rubrique").

Par exemple, RésultatRubrique("Téléphone") renvoie la valeur Client::Téléphone lorsque RésultatRubrique est calculé pour la table Client et renvoie Société::Téléphone lorsque RésultatRubrique est calculé pour la table Société.

Pour renvoyer les valeurs de plusieurs rubriques, ne placez pas Rubrique entre guillemets, comme dans RésultatRubrique(Rubrique) et indiquez une rubrique contenant une valeur qui correspond au nom d'une autre rubrique de la table. Pour modifier la valeur renvoyée par RésultatRubrique, modifiez la valeur dans la rubrique définie pour qu'elle corresponde au nom d'une autre rubrique de la table.

Par exemple, une table comporte trois rubriques : Client::MéthodeContact, Client::Téléphone et Client::Email. Si Client::MéthodeContact contient "Téléphone", RésultatRubrique(MéthodeContact) renvoie le contenu de Client::Téléphone. En revanche, si Client::MéthodeContact contient "Email", RésultatRubrique(MéthodeContact) renvoie le contenu de Client::Email.

Exemple 1 

Si vous triez les enregistrements d'après une rubrique Calcul définie par la fonction RésultatRubrique, vous pouvez trier les enregistrements de manière dynamique et afficher des données de sous-récapitulatifs en modifiant la valeur de la rubrique définie par RésultatRubrique.

Supposons qu'une base de données comporte quatre rubriques :

  • Nom du client, une rubrique Texte
  • Ville, une rubrique Texte
  • TrierSélection, une rubrique de type Global
  • CritèreTri, une rubrique Calcul définie comme ResultatRubrique( TrierSélection )

Ce script active le modèle Factures et trie les enregistrements d'après la rubrique CritèreTri :

Copier
Activer modèle ["Factures" (Factures)]
Trier enregistrements [Rétablir; Avec boîte de dialogue: Non]
#Trier d'après la rubrique CritèreTri
Afficher enreg/requête/page [Premièr(e)]

Si TrierSélection contient "Nom du client", CritèreTri renvoie les valeurs de la rubrique Nom du client et le jeu d'enregistrements trouvés est trié par Nom du client. Les données de sous-récapitulatifs définies pour apparaître lorsque des enregistrements sont triés par CritèreTri sont affichées d'après la rubrique Nom du client.

Si le contenu TrierSélection est remplacé par "Ville", CritèreTri renvoie les valeurs de la rubrique Ville, le jeu d'enregistrements trouvés est retrié par Ville et les données de sous-récapitulatifs sont affichées d'après la rubrique Ville.

Le jeu d'enregistrements trouvés étant trié par CritèreTri, les informations de tri sont automatiquement mises à jour lorsque les valeurs renvoyées par CritèreTri sont modifiées, sans que vous ayez besoin d'exécuter une nouvelle opération de tri.