Representação de perspectiva (de tabela)

Uma perspectiva é um mecanismo para simplificar ou focar o modelo em uma parte menor dele para o aplicativo cliente.

Consulte Representação de perspectiva (de tabela) para obter uma explicação detalhada sobre como criar e manipular a representação de perspectivas.

Cuidado
Perspectivas não são um mecanismo de segurança; objetos fora da perspectiva ainda podem ser acessados pelo usuário através de outras interfaces.

Representação de perspectiva

Em termos de objetos AMO, uma representação de perspectiva tem uma relação de mapeamento de um para um com Perspective e nenhum outro objeto AMO principal é necessário.

Perspectiva no AMO

O trecho de código a seguir mostra como criar uma perspectiva em um modelo de tabela. O elemento chave neste pedaço de código é o perspectiveElements; este objeto é uma representação gráfica de todos os objetos no modelo de tabela que são expostos para o usuário. O elemento perspectiveElements contém 4 colunas e, para este cenário, somente as colunas 1, 2 e 3 são relevantes. A Coluna 1 contém o tipo de elemento exibido - elementTypeValue -; a coluna 2 contém o nome completo do elemento--, que provavelmente precisará ser analisado para inserir o elemento na perspectiva; a coluna 3 contém um item de caixa de seleção - checkedElement - que diz se o elemento faz parte da perspectiva ou não.

        private void updatePerspective_Click(
                             AMO.Cube modelCube
                          ,  DataGridView perspectiveElements
                          ,  string updatedPerspectiveID
                     )
        {
            //Update is done by delete first, create new and insert after
            //if perspective doesn't exist then create first and insert after
            updatedPerspectiveID = updatedPerspectiveID.Trim();
            if (modelCube.Perspectives.Contains(updatedPerspectiveID))
            {
                modelCube.Perspectives.Remove(updatedPerspectiveID, true);
                newDatabase.Update(AMO.UpdateOptions.ExpandFull, AMO.UpdateMode.UpdateOrCreate);
            }
            AMO.Perspective currentPerspective = modelCube.Perspectives.Add(updatedPerspectiveID, updatedPerspectiveID);

            foreach (DataGridViewRow currentDGVRow in perspectiveElements.Rows)
            {
                bool checkedElement = (bool)currentDGVRow.Cells[3].Value;
                if (checkedElement)
                {
                    string elementTypeValue = currentDGVRow.Cells[1].Value.ToString();
                    string elementNameValue = currentDGVRow.Cells[2].Value.ToString();
                    switch (elementTypeValue)
                    {
                        case "Column: Attribute":
                        case "Column: Calculated Column":
                            {
                                string perspectiveDimensionName = Regex.Match(elementNameValue, @"(?<=')(.*?)(?=')").ToString();
                                string perspectiveDimensionAttributeName = Regex.Match(elementNameValue, @"(?<=\[)(.*?)(?=\])").ToString();
                                AMO.PerspectiveDimension currentPerspectiveDimension;
                                if (!currentPerspective.Dimensions.Contains(perspectiveDimensionName))
                                {
                                    currentPerspectiveDimension = currentPerspective.Dimensions.Add(perspectiveDimensionName);
                                }
                                else
                                {
                                    currentPerspectiveDimension = currentPerspective.Dimensions[perspectiveDimensionName];
                                }
                                if (!currentPerspectiveDimension.Attributes.Contains(perspectiveDimensionAttributeName))
                                {
                                    currentPerspectiveDimension.Attributes.Add(perspectiveDimensionAttributeName);
                                }
                            }
                            break;
                        case "Hierarchy":
                            {
                                string perspectiveDimensionName = Regex.Match(elementNameValue, @"(?<=')(.*?)(?=')").ToString();
                                string perspectiveDimensionHierarchyName = Regex.Match(elementNameValue, @"(?<=\[)(.*?)(?=\])").ToString();
                                AMO.PerspectiveDimension currentPerspectiveDimension;
                                if (!currentPerspective.Dimensions.Contains(perspectiveDimensionName))
                                {
                                    currentPerspectiveDimension = currentPerspective.Dimensions.Add(perspectiveDimensionName);
                                }
                                else
                                {
                                    currentPerspectiveDimension = currentPerspective.Dimensions[perspectiveDimensionName];
                                }
                                if (!currentPerspectiveDimension.Hierarchies.Contains(perspectiveDimensionHierarchyName))
                                {
                                    currentPerspectiveDimension.Hierarchies.Add(perspectiveDimensionHierarchyName);
                                }
                            }
                            break;
                        case "Measure":
                            {
                                string perspectiveMeasureGroupName = Regex.Match(elementNameValue, @"(?<=')(.*?)(?=')").ToString();
                                string measureName = Regex.Match(elementNameValue, @"(?<=\[)(.*?)(?=\])").ToString();
                                string perspectiveMeasureName = string.Format("[Measures].[{0}]", measureName);
                                AMO.PerspectiveCalculation currentPerspectiveCalculation = new AMO.PerspectiveCalculation(perspectiveMeasureName, AMO.PerspectiveCalculationType.Member);
                                if (!currentPerspective.Calculations.Contains(perspectiveMeasureName))
                                {
                                    currentPerspective.Calculations.Add(currentPerspectiveCalculation);
                                }
                                if (modelCube.MdxScripts["MdxScript"].CalculationProperties.Contains(string.Format("KPIs.[{0}]", measureName)))
                                {//Current Measure is also a KPI ==> will be added to the KPIs collection of the perspective
                                    AMO.PerspectiveKpi currentPerspectiveKpi = new AMO.PerspectiveKpi(perspectiveMeasureName);
                                    if (!currentPerspective.Kpis.Contains(perspectiveMeasureName))
                                    {
                                        currentPerspective.Kpis.Add(currentPerspectiveKpi);
                                    }
                                }
                            }
                            break;
                        default:
                            break;
                    }
                }
            }

            newDatabase.Update(AMO.UpdateOptions.ExpandFull, AMO.UpdateMode.CreateOrReplace);
            MessageBox.Show(String.Format("Perpective successfully updated."), "AMO to Tabular message", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }

Exemplo de AMO2Tabular

No entanto, para compreender como usar o AMO para criar e manipular representações de perspectiva, consulte o código-fonte do exemplo AMO para Tabela. O exemplo está disponível em Codeplex. Uma nota importante sobre o código: o código é fornecido apenas como um suporte aos conceitos lógicos explicados aqui; ele não deve ser usado em um ambiente de produção, nem para fins que não sejam pedagógicos.