ROA

Cette fonction renvoie la valeur d'un attribut d'un élément.

Sélectionner Insertion > Fonction > ROA ou utiliser la boîte de dialogue Modifier une formule OLAP, puis sélectionner le type de formule Attributs.

Remarque

RWA est la version accessible en écriture de la fonction ROA. Pour activer l'écriture en différé dans une formule de valeurs de cellules, remplacer ROA par RWA ou sélectionner Autoriser l'écriture en différé d'attributs dans la boîte de dialogue Modifier une formule OLAP.

Syntaxe

=ROA("data_connection","cube","hierarchy_name","attribute_name","element_name")

Exemple

Cette formule renvoie le nom allemand de l'élément spécifié, qui est stocké dans l'attribut Attr2_German :

=ROA("BestPractices OLAP","Sales","[Product]","Att2_German","[Car Tires All Season]")

Affichage dynamique des attributs

La fonction ROA permet d'afficher les attributs de manière dynamique dans un hyperblock.

Exemple

Une liste de produits peut avoir comme attributs les noms des différents responsables produits. Une formule ROA permet alors d'afficher le responsable produit pour chaque produit dans un hyperblock.

Cliquer dans la cellule de valeur de l'hyperblock. Ouvrir la boîte de dialogue Modifier une formule OLAP, puis sélectionner le type de formule Attributs. Sélectionner la connexion de données, le cube, la dimension et la hiérarchie. Sélectionner l'attribut à afficher dans la liste Attribut. Dans la liste Elément, sélectionner la référence de cellule de l'hyperblock.

Renvoi de données à partir de métadonnées OLAP

La fonction ROA peut être utilisée pour obtenir des données à partir de métadonnées OLAP. Les métadonnées OLAP sont des hiérarchies virtuelles qui décrivent les cubes, les dimensions et les hiérarchies des données OLAP. Lorsque la fonction ROA est utilisée avec les métadonnées OLAP, les paramètres d'alias et de cube sont des chaînes vides ("", "") et le nom de la dimension est « Métadonnées OLAP ».

Les attributs suivants sont pris en charge :

  • Actual_Level_Cardinality
  • Children_Cardinality
  • Database_Name
  • Dataconnection_Caption
  • Dataconnection_name
  • Datasource_URL
  • Description
  • Level_Number
  • Level_Unique_Name
  • Measure_Dimension
  • Member_Caption
  • Member_Name
  • Member_Type
  • Member_Unique_Name
  • Member_Weight
  • Name
  • Parent_Level
  • Parent_Unique_Name
  • Project_Name
  • Provider_Type
  • Server_Name
  • Server_URL
  • Session_ID
  • Time_Dimension
  • Value_Type

Exemple

Pour renvoyer le nom unique d'un cube, utiliser cette syntaxe : ROA("","","Olap meta data","Name","[Repository].[alias].[cube_name]").

Exemple

Pour récupérer le nom unique du parent d'un cube spécifique, utiliser cette syntaxe : ROA("","","Olap meta data","Parent_Unique_Name","[Repository].[alias].[cube_name]")

Exemple

Pour récupérer l'URL du serveur d'un alias, utiliser cette syntaxe : ROA("","","Olap meta data","Server_URL","[Repository].[alias]")

Attributs de hiérarchies personnalisées

Les hiérarchies personnalisées sont des hiérarchies créées par l'utilisateur. Comme les métadonnées OLAP, les noms d'alias et de cubes sont des chaînes vides. Pour le paramètre de hiérarchie, utiliser le nom de la hiérarchie personnalisée.

Pour récupérer l'attribut Légende, utiliser : =ROA("","","Hierarchy name","Member_Caption", "element_name")

Pour récupérer l'attribut Numéro du niveau, utiliser :

=ROA("","","Hierarchy name","Level_Number", "celement_name")

Multisélection

La fonction ROA prend en charge la multisélection. Il est donc possible de renvoyer les valeurs d'attribut des éléments stockés dans une définition MLS-XML de multisélection.

Par exemple, la variable de rapport rv_multi contient la définition MLS-XML suivante :

<?xml version="1.0" encoding="utf-16"?>
<MultiSelect xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Hierarchy>[Period]</Hierarchy>
  <AggregationFunction>Sum</AggregationFunction>
  <StructureSelection>
        <Member>
      <MemberUName>[period].[all years].[2017)]</MemberUName>
    </Member>
     <Member>
      <MemberUName>[period].[all years]</MemberUName>
    </Member>
  </StructureSelection>
</MultiSelect>

Cette formule ROA renvoie Jahr 2017 et Alle Jahre. C'est-à-dire qu'elle renvoie l'attribut « ATT2_German » de chaque élément présent dans la définition MLS-XML :

=ROA("BestPracticesOLAP","ANALYSIS","[Period]","ATT2_German",ReportVariables.rv_multi.Text)
Remarque

La fonction d'agrégation spécifiée dans la définition MLS-XML n'est pas pertinente pour les attributs ; elle est donc ignorée.