Rappresentazione della gerarchia (tabulare)
Le gerarchie sono un meccanismo che consente all'utente finale un'esecuzione più efficace di analisi drill-up e drill-down.
Rappresentazione della gerarchia
Nei modelli a oggetti tabulari una gerarchia è il percorso di navigazione da un attributo a un altro, in base a valori selezionati dall'utente.
Gerarchia in AMO
Quando si utilizza AMO per gestire una tabella di modelli tabulari, vi è una corrispondenza di oggetto uno-a-uno per una gerarchia in AMO; in AMO, una gerarchia è rappresentata dall'oggetto Hierarchy.
Nel frammento di codice seguente viene illustrato come aggiungere una gerarchia a un modello tabulare esistente. Nel codice si presuppone che si disponga di un oggetto di database AMO, newDatabase, e di un oggetto cubo AMO, modelCube.
private void addHierarchy(
AMO.Database newDatabase
, AMO.Cube modelCube
, string tableName
, string hierarchyName
, string levelsText
)
{
//Validate input
if (string.IsNullOrEmpty(hierarchyName) || string.IsNullOrEmpty(levelsText))
{
MessageBox.Show(String.Format("Hierarchy Name or Layout must be provided."), "AMO to Tabular message", MessageBoxButtons.OK, MessageBoxIcon.Warning);
return;
}
if (!overwriteHierarchy.Checked && newDatabase.Dimensions[tableName].Hierarchies.Contains(hierarchyName))
{
MessageBox.Show(String.Format("Hierarchy already exists.\nGive a new name or enable overwriting"), "AMO to Tabular message", MessageBoxButtons.OK, MessageBoxIcon.Warning);
return;
}
try
{
if (newDatabase.Dimensions[tableName].Hierarchies.Contains(hierarchyName))
{
//Hierarchy exists... deleting it to write it later
newDatabase.Dimensions[tableName].Hierarchies.Remove(hierarchyName, true);
newDatabase.Dimensions[tableName].Update(AMO.UpdateOptions.AlterDependents);
}
AMO.Hierarchy currentHierarchy = newDatabase.Dimensions[tableName].Hierarchies.Add(hierarchyName, hierarchyName);
currentHierarchy.AllMemberName = string.Format("(All of {0})", hierarchyName);
//Parse hierarchyLayout
using (StringReader levels = new StringReader(levelsText))
{
//Each line:
// must come with: The columnId of the attribute in the dimension --> this represents the SourceAttributeID
// optional: A display name for the Level (if this argument doesn't come the default is the SourceAttributeID)
string line;
while ((line = levels.ReadLine()) != null)
{
if (string.IsNullOrEmpty(line) || string.IsNullOrWhiteSpace(line)) continue;
line = line.Trim();
string[] hierarchyData = line.Split(',');
if (string.IsNullOrEmpty(hierarchyData[0])) continue; //first argument cannot be empty or blank,
//assume is a blank line and ignore it
string levelSourceAttributeID = hierarchyData[0].Trim();
string levelID = (hierarchyData.Length > 1 && !string.IsNullOrEmpty(hierarchyData[1])) ? hierarchyData[1].Trim() : levelSourceAttributeID;
currentHierarchy.Levels.Add(levelID).SourceAttributeID = levelSourceAttributeID;
}
}
newDatabase.Dimensions[tableName].Update(AMO.UpdateOptions.AlterDependents);
}
catch (Exception ex)
{
MessageBox.Show(String.Format("Error creating hierarchy [{0}].\nError message: {1}", newHierarchyName.Text, ex.Message), "AMO to Tabular message", MessageBoxButtons.OK, MessageBoxIcon.Warning);
if (newDatabase.Dimensions[tableName].Hierarchies.Contains(hierarchyName))
{
//Hierarchy was created but exception prevented complete hierarchy to be written... deleting incomplete hierarchy
newDatabase.Dimensions[tableName].Hierarchies.Remove(hierarchyName, true);
newDatabase.Dimensions[tableName].Update(AMO.UpdateOptions.AlterDependents);
}
}
newDatabase.Dimensions[tableName].Process(AMO.ProcessType.ProcessFull);
modelCube.MeasureGroups[tableName].Process(AMO.ProcessType.ProcessFull);
}
Esempio AMO2Tabular
Per comprendere le modalità di utilizzo di AMO (Analysis Management Objects) per creare e modificare le rappresentazioni di gerarchie, vedere il codice sorgente dell'esempio Da AMO a tabulare; in particolare controllare nel seguente file di origine: AddHierarchies.cs. L'esempio è disponibile all'indirizzo Codeplex. Nota importante sul codice: il codice viene fornito solo come supporto ai concetti logici illustrati in questo argomento e non deve essere utilizzato in un ambiente di produzione né deve essere utilizzato per altro scopo se non quello formativo.