Programmation d’objets avancés OLAP AMO
S’applique à :
SQL Server Analysis Services Azure Analysis Services 
Fabric/Power BI Premium
Cette rubrique explique en détails la programation d'objets OLAP AMO (Analysis Management Objects) avancés.
Objets d’action
Les classes Action sont utilisées pour créer une réponse active lors de l'exploration de certaines zones du cube. Les objets Action peuvent être définis à l'aide d'objets AMO, mais ils sont utilisés à partir de l'application cliente qui explore les données. Les actions peuvent être de différents types et doivent être créées en fonction de leur type. Les actions peuvent être :
Des actions d'extraction, qui retournent l'ensemble de lignes qui représente les données sous-jacentes des cellules sélectionnées du cube où l'action se produit.
Actions de création de rapports, qui retournent un rapport à partir de qui est associé à la section sélectionnée du cube où l’action se produit.
Des actions standard, qui retournent l'élément d'action (URL, HTML, DataSet, ensemble de lignes et autres éléments) associé à la section sélectionnée du cube où l'action se produit.
La création d'un objet Action passe par les étapes suivantes :
Créez l'objet action dérivé et remplissez les attributs de base.
Les attributs de base sont constitués du type d'action, du type ou de la section cible du cube, de la zone cible ou spécifique du cube où l'action est disponible, de la légende et de l'emplacement où celle-ci est une expression MDX.
Remplissez les attributs spécifiques du type d'action.
Les attributs sont différents pour les trois types d'actions ; consultez l'exemple de code qui suit pour examiner les paramètres.
Ajoutez l'action à la collection du cube et mettez ce dernier à jour. L'action est un objet qui ne peut pas être mis à jour.
Pour tester l'action, vous avez besoin d'une application différente. Vous pouvez tester votre action dans Visual Studio.
L'exemple de code suivant réplique trois actions différentes de l'exemple de projet Analysis Services Adventure Works. Vous pouvez distinguer les actions les unes des autres, car celles que vous introduisez au moyen du code suivant commencent par « My ».
static public void CreateActions(Cube cube)
{
#region Adding a drillthrough action
// Verify That action exists and drop it
if (cube.Actions.ContainsName("My Reseller Details"))
cube.Actions.Remove("My Drillthrough Action",true);
//Create a Drillthrough action
DrillThroughAction dtaction = new DrillThroughAction("My Reseller Details", "My Drillthrough Action");
//Define the Action
dtaction.Type = ActionType.DrillThrough;
dtaction.TargetType = ActionTargetType.Cells;
dtaction.Target = "MeasureGroupMeasures(\"Reseller Sales\")";
dtaction.Caption = "My Drillthrough...";
dtaction.CaptionIsMdx = false;
#region create drillthrough action specifics
//Adding Drillthrough columns
//Adding Measure columns to the drillthrough
MeasureGroup mg = cube.MeasureGroups.FindByName("Reseller Sales");
MeasureBinding mb1 = new MeasureBinding();
mb1.MeasureID = mg.Measures.FindByName( "Reseller Sales Amount").ID;
dtaction.Columns.Add(mb1);
MeasureBinding mb2 = new MeasureBinding();
mb2.MeasureID = mg.Measures.FindByName("Reseller Order Quantity").ID;
dtaction.Columns.Add(mb2);
MeasureBinding mb3 = new MeasureBinding();
mb3.MeasureID = mg.Measures.FindByName("Reseller Unit Price").ID;
dtaction.Columns.Add(mb3);
//Adding Dimension Columns to the drillthrough
CubeAttributeBinding cb1 = new CubeAttributeBinding();
cb1.CubeID = cube.ID;
cb1.CubeDimensionID = cube.Dimensions.FindByName("Reseller").ID;
cb1.AttributeID = "Reseller Name";
cb1.Type = AttributeBindingType.All;
dtaction.Columns.Add(cb1);
CubeAttributeBinding cb2 = new CubeAttributeBinding();
cb2.CubeID = cube.ID;
cb2.CubeDimensionID = cube.Dimensions.FindByName("Product").ID;
cb2.AttributeID = "Product Name";
cb2.Type = AttributeBindingType.All;
dtaction.Columns.Add(cb2);
#endregion
//Add the defined action to the cube
cube.Actions.Add(dtaction);
#endregion
#region Adding a Standard action
// Verify That action exists and drop it
if (cube.Actions.ContainsName("My City Map"))
cube.Actions.Remove("My Action", true);
//Create a Drillthrough action
StandardAction stdaction = new StandardAction("My City Map", "My Action");
//Define the Action
stdaction.Type = ActionType.Url;
stdaction.TargetType = ActionTargetType.AttributeMembers;
stdaction.Target = "[Geography].[City]";
stdaction.Caption = "\"My View Map for \" + [Geography].[City].CurrentMember.Member_Caption + \"...\"";
stdaction.CaptionIsMdx = true;
#region create standard action specifics
stdaction.Expression = "\"http://maps.msn.com/home.aspx?plce1=\" + " +
"[Geography].[City].CurrentMember.Name + \",\" + " +
"[Geography].[State-Province].CurrentMember.Name + \",\" + " +
"[Geography].[Country].CurrentMember.Name + " +
"\"®n1=\" + " +
"Case " +
"When [Geography].[Country].CurrentMember Is " +
"[Geography].[Country].&[Australia] " +
"Then \"3\" " +
"When [Geography].[Country].CurrentMember Is " +
"[Geography].[Country].&[Canada] " +
"Or [Geography].[Country].CurrentMember Is " +
"[Geography].[Country].&[United States] " +
"Then \"0\" " +
"Else \"1\" " +
"End ";
#endregion
//Add the defined action to the cube
cube.Actions.Add(stdaction);
#endregion
#region Adding a Reporting action
// Verify That action exists and drop it
if (cube.Actions.ContainsName("My Sales Reason Comparisons"))
cube.Actions.Remove("My Report Action", true);
//Create a Report action
ReportAction rsaction = new ReportAction("My Sales Reason Comparisonsp", "My Report Action");
//Define the Action
rsaction.Type = ActionType.Report;
rsaction.TargetType = ActionTargetType.AttributeMembers;
rsaction.Target = "[Product].[Category]";
rsaction.Caption = "\"My Sales Reason Comparisons for \" + [Product].[Category].CurrentMember.Member_Caption + \"...\"";
rsaction.CaptionIsMdx = true;
#region create Report action specifics
rsaction.ReportServer = "MyRSSamplesServer";
rsaction.Path = "ReportServer?/AdventureWorks Sample Reports/Sales Reason Comparisons";
rsaction.ReportParameters.Add("ProductCategory", "UrlEscapeFragment( [Product].[Category].CurrentMember.UniqueName )");
rsaction.ReportFormatParameters.Add("rs:Command", "Render");
rsaction.ReportFormatParameters.Add("rs:Renderer", "HTML5");
#endregion
//Add the defined action to the cube
cube.Actions.Add(rsaction);
#endregion
}
Objets KPI
Un indicateur de performance clé (KPI) est un ensemble de calculs associés à un groupe de mesures dans un cube qui servent à évaluer les performances de l'entreprise. KpiLes objets peuvent être définis par AMO, mais ils sont utilisés à partir de l'application cliente qui explore les données.
La création d’un Kpi objet nécessite les étapes suivantes :
Créez l’objet Kpi et renseignez les attributs de base.
Voici une liste d'attributs de base : Description, Afficher le dossier, Groupe de mesures associé et Valeur. Afficher le dossier indique à l'application cliente là où l'indicateur de performance clé doit se situer pour que l'utilisateur final puisse le trouver. L'attribut Groupe de mesures associé indique le groupe de mesures dans lequel tous les calculs MDX doivent être mentionnés. L'attribut Valeur présente la valeur réelle de l'indicateur de performance sous forme d'expression MDX.
Définissez les indicateurs de performance clé : Objectif (Goal), État (Status) et Tendance (Trend).
Les indicateurs sont des expressions MDX dont les valeurs sont normalement comprises entre -1 et 1, mais c'est l'application d'exploration qui définit la plage de valeurs des indicateurs.
Lorsque vous parcourez des indicateurs de performance clés, les valeurs inférieures à -1 sont traitées comme -1 et les valeurs supérieures à 1 sont traitées comme 1.
Définissez des images graphiques.
Les images graphiques sont des valeurs de chaîne utilisées comme référence dans l'application cliente pour identifier l'ensemble d'images qu'il convient d'afficher. Une chaîne d'image graphique définit également le comportement de la fonction d'affichage. En général, la plage est scindée en un nombre impair d'états, de mauvais à bon, et une image du jeu est assignée à chaque état.
Si vous utilisez Visual Studio pour parcourir vos indicateurs de performance clés, en fonction des noms, la plage d’indicateurs est divisée en trois états ou cinq états. De plus, pour certains noms, la plage est inversée. Autrement dit, -1 correspond à « Bon » et 1 à « Mauvais ». Dans Visual Studio, les trois états de la plage sont les suivants :
Mauvais = -1 à -0,5
OK = -0,4999 à 0,4999
Bon = 0,50 à 1
Dans Visual Studio, cinq états dans la plage sont les suivants :
Mauvais = -1 à -0,75
Risque = -0,7499 à -0,25
OK = -0,2499 à 0,2499
En hausse = 0,25 à 0,7499
Bon = 0,75 à 1
Le tableau suivant présente l'utilisation, le nom et le nombre d'états associés à l'image.
| Utilisation de l'image | Nom de l'image | Nombre d'états |
|---|---|---|
| Statut | Formes | 3 |
| Statut | Feu de circulation | 3 |
| Statut | Panneaux de signalisation | 3 |
| Statut | Jauge | 3 |
| Statut | Jauge inversée | 5 |
| Statut | Thermomètre | 3 |
| Statut | Cylindre | 3 |
| Statut | Visages | 3 |
| Statut | Flèche de variance | 3 |
| Tendance | Flèche standard | 3 |
| Tendance | Flèche d'état | 3 |
| Tendance | Flèche d'état inversée | 5 |
| Tendance | Visages | 3 |
- Ajoutez l'indicateur de performance clé à la collection du cube et mettez ce dernier à jour, car l'indicateur de performance clé est un objet qui ne peut pas être mis à jour.
Pour tester l'indicateur de performance clé, vous avez besoin d'une application différente. Vous pouvez tester votre KPI dans Visual Studio.
L'exemple de code suivant crée un indicateur de performance clé dans le dossier « Financial Perpective/Grow Revenue » du cube Adventure Works inclus dans l'exemple de projet Analysis Services Adventure Works.
static public void CreateKPIs(Cube cube)
{
Kpi kpi = cube.Kpis.Add("My Internet Revenue", "My Internet Revenue");
kpi.Description = "(My) Revenue achieved through direct sales via Interner";
kpi.DisplayFolder = "\\Financial Perspective\\Grow Revenue";
kpi.AssociatedMeasureGroupID = "Internet Sales";
kpi.Value = "[Measures].[Internet Sales Amount]";
#region Goal
kpi.Goal = "Case" +
" When IsEmpty" +
" (" +
" ParallelPeriod" +
" (" +
" [Date].[Fiscal Time].[Fiscal Year]," +
" 1," +
" [Date].[Fiscal Time].CurrentMember" +
" )" +
" )" +
" Then [Measures].[Internet Sales Amount]" +
" Else 1.10 *" +
" (" +
" [Measures].[Internet Sales Amount]," +
" ParallelPeriod" +
" (" +
" [Date].[Fiscal Time].[Fiscal Year]," +
" 1," +
" [Date].[Fiscal Time].CurrentMember" +
" )" +
" ) " +
" End";
#endregion
#region Status
kpi.Status = "Case" +
" When KpiValue( \"Internet Revenue\" ) / KpiGoal ( \"Internet Revenue\" ) >= .95 " +
" Then 1 " +
" When KpiValue( \"Internet Revenue\" ) / KpiGoal ( \"Internet Revenue\" ) < .95 " +
" And " +
" KpiValue( \"Internet Revenue\" ) / KpiGoal ( \"Internet Revenue\" ) >= .85 " +
" Then 0 " +
" Else -1 " +
"End";
#endregion
#region Trend
kpi.Trend = "Case " +
" When VBA!Abs " +
" ( " +
" KpiValue( \"Internet Revenue\" ) - " +
" ( " +
" KpiValue ( \"Internet Revenue\" ), " +
" ParallelPeriod " +
" ( " +
" [Date].[Fiscal Time].[Fiscal Year], " +
" 1, " +
" [Date].[Fiscal Time].CurrentMember " +
" ) " +
" ) / " +
" ( " +
" KpiValue ( \"Internet Revenue\" ), " +
" ParallelPeriod " +
" ( " +
" [Date].[Fiscal Time].[Fiscal Year], " +
" 1, " +
" [Date].[Fiscal Time].CurrentMember " +
" ) " +
" ) " +
" ) <=.02 " +
" Then 0 " +
" When KpiValue( \"Internet Revenue\" ) - " +
" ( " +
" KpiValue ( \"Internet Revenue\" ), " +
" ParallelPeriod " +
" ( " +
" [Date].[Fiscal Time].[Fiscal Year], " +
" 1, " +
" [Date].[Fiscal Time].CurrentMember " +
" ) " +
" ) / " +
" ( " +
" KpiValue ( \"Internet Revenue\" ), " +
" ParallelPeriod " +
" ( " +
" [Date].[Fiscal Time].[Fiscal Year], " +
" 1, " +
" [Date].[Fiscal Time].CurrentMember " +
" ) " +
" ) >.02 " +
" Then 1 " +
" Else -1 " +
"End";
#endregion
kpi.TrendGraphic = "Standard Arrow";
kpi.StatusGraphic = "Cylinder";
}.
Objets perspective
PerspectiveLes objets peuvent être définis par AMO, mais ils sont utilisés à partir de l'application cliente qui explore les données.
La création d’un Perspective objet nécessite les étapes suivantes :
Créez l’objet Perspective et remplissez les attributs de base.
Voici une liste d'attributs de base : Nom, Mesure par défaut, Description et Annotations.
Ajoutez tous les objets du cube parent à révéler à l'utilisateur final.
Ajoutez les dimensions du cube (attributs et hiérarchies), les groupes de mesure (mesure et groupe de mesures), les actions, les indicateurs de performance clés et les calculs.
Ajoutez la perspective à la collection du cube et mettez ce dernier à jour, car la perspective est un objet qui ne peut pas être mis à jour.
Pour tester la perspective, vous avez besoin d'une application différente.
L'exemple de code suivant crée une perspective nommée « Direct Sales » pour le cube fourni.
static public void CreatePerspectives(Cube cube)
{
Perspective perspective = cube.Perspectives.Add("Direct Sales", "Direct Sales");
CubeDimension dim1 = cube.Dimensions.GetByName("Date");
PerspectiveDimension pdim1 = perspective.Dimensions.Add(dim1.DimensionID);
pdim1.Attributes.Add("Date");
pdim1.Attributes.Add("Calendar Year");
pdim1.Attributes.Add("Fiscal Year");
pdim1.Attributes.Add("Calendar Quarter");
pdim1.Attributes.Add("Fiscal Quarter");
pdim1.Attributes.Add("Calendar Month Number");
pdim1.Attributes.Add("Fiscal Month Number");
pdim1.Hierarchies.Add("Calendar Time");
pdim1.Hierarchies.Add("Fiscal Time");
CubeDimension dim2 = cube.Dimensions.GetByName("Product");
PerspectiveDimension pdim2 = perspective.Dimensions.Add(dim2.DimensionID);
pdim2.Attributes.Add("Product Name");
pdim2.Attributes.Add("Product Line");
pdim2.Attributes.Add("Model Name");
pdim2.Attributes.Add("List Price");
pdim2.Attributes.Add("Size");
pdim2.Attributes.Add("Weight");
pdim2.Hierarchies.Add("Product Model Categories");
pdim2.Hierarchies.Add("Product Categories");
PerspectiveMeasureGroup pmg = perspective.MeasureGroups.Add("Internet Sales");
pmg.Measures.Add("Internet Sales Amount");
pmg.Measures.Add("Internet Order Quantity");
pmg.Measures.Add("Internet Unit Price");
pmg = perspective.MeasureGroups.Add("Reseller Sales");
pmg.Measures.Add("Reseler Sales Amount");
pmg.Measures.Add("Reseller Order Quantity");
pmg.Measures.Add("Reseller Unit Price");
PerspectiveAction pact = perspective.Actions.Add("Drillthrough Action");
PerspectiveKpi pkpi = perspective.Kpis.Add("Internet Revenue");
Cube.Update();
}
Objets ProactiveCaching
ProactiveCachingLes objets peuvent être définis par AMO.
La création d’un ProactiveCaching objet nécessite les étapes suivantes :
Créer l’objet ProactiveCaching.
Il n'y a aucun attribut de base à définir.
Ajoutez des spécifications de cache.
| Caractéristique | Description |
|---|---|
| AggregationStorage | Type de stockage pour les agrégations. S'applique uniquement aux partitions. Sur la dimension, doit être Regular. |
| SilenceInterval | Durée d'existence minimale du cache avant que ne démarre le processus de création d'images MOLAP. |
| Latence | Laps de temps qui s'écoule entre la première notification et le moment où les images MOLAP sont détruites. |
| SilenceOverrideInterval | Laps de temps après une notification initiale à l'issue duquel le processus de création d'images MOLAP entre en action sans condition. |
| ForceRebuildInterval | Laps de temps (débutant à la suite de la suppression d'une image MOLAP nouvelle) à l'issue duquel le processus de création d'images démarre sans condition (aucune notification). |
| OnlineMode | Période de disponibilité de l'image MOLAP. Peut être Immediate ou OnCacheComplete. |
- Ajoutez l’objet ProactiveCaching à la collection parente. Vous devez mettre à jour le parent, car ProactiveCaching n’est pas un objet pouvant être mis à jour.
L’exemple de code suivant crée un ProactiveCaching objet dans toutes les partitions à partir du groupe de mesures Internet Sales dans le cube Adventure Works dans une base de données spécifiée.
static public void SetProactiveCachingSettings(Database db)
{
ProactiveCaching pc;
if (db.Cubes.ContainsName("Adventure Works") && db.Cubes.FindByName("Adventure Works").MeasureGroups.ContainsName("Internet Sales"))
{
ProactiveCachingTablesBinding pctb;
TableNotification tn;
MeasureGroup mg = db.Cubes.FindByName("Adventure Works").MeasureGroups.FindByName("Internet Sales");
foreach(Partition part in mg.Partitions)
{
pc = new ProactiveCaching();
pc.AggregationStorage = ProactiveCachingAggregationStorage.MolapOnly;
pc.SilenceInterval = TimeSpan.FromSeconds(10);
pc.Latency = TimeSpan.FromSeconds(-1);
pc.SilenceOverrideInterval = TimeSpan.FromMinutes(10);
pc.ForceRebuildInterval = TimeSpan.FromSeconds(-1);
pc.Enabled = true;
pc.OnlineMode = ProactiveCachingOnlineMode.OnCacheComplete;
pctb = new ProactiveCachingTablesBinding();
pctb.NotificationTechnique = NotificationTechnique.Server;
tn = new TableNotification("[FactInternetSales]", "dbo");
pctb.TableNotifications.Add( tn);
pc.Source = pctb;
part.ProactiveCaching = pc;
part.Update();
}
}
}
Objets de traduction
Les objets Translation peuvent être définis par AMO, mais ils sont utilisés à partir de l'application cliente qui explore les données. Les objets Translation sont des objets simples à coder. Les traductions de légendes d'objets sont fournies par les paires Identificateur de paramètres régionaux et Légende traduite. Plusieurs traductions peuvent être activées pour une même légende. Des traductions peuvent être fournies pour la plupart des objets, tels que les dimensions, les attributs, les hiérarchies, les cubes, les groupes de mesures, les mesures, etc.
L'exemple de code suivant fournit une traduction espagnole pour le nom de l'attribut Product Name.
static public void CreateTranslations(Database db)
{
//Spanish Tranlations for Product Category in Product Dimension
Dimension dim = db.Dimensions["Product"];
DimensionAttribute atr = dim.Attributes["Product Name"];
Translation tran = atr.Translations.Add(3082);
tran.Caption = "Nombre Producto";
dim.Update(UpdateOptions.ExpandFull);
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour