Criação de Funções no Construtor de Funções

No Construtor de Funções, selecione uma função e especifique a conexão e os membros que você deseja que a função use.

O Construtor de Funções, então, cria a função usando a sintaxe adequada e a insere na célula selecionada. Você pode editar funções.

As seleções disponíveis em um determinado campo do Construtor de Funções são limitadas às seleções em outros campos do Construtor de Funções. Por exemplo, apenas as conexões suportadas pela função selecionada são exibidas e apenas as dimensões suportadas pela função selecionada são exibidas.

Uma referência de célula pode ser selecionada para cada argumento de função. A função de digitação está disponível para cada argumento.

Para criar funções utilizando o Construtor de Funções:

  1. Conecte-se a uma origem de dados.
  2. Selecione um cubo e, na caixa de diálogo exibida, selecione Definir como Conexão para Funções, e então digite um nome para a conexão.

    No exemplo abaixo, o nome da conexão é MyVision.

    Nota:

    É necessário criar um nome de conexão para cada pasta de trabalho nova.

    O nome da conexão é salvo com a pasta de trabalho. Na próxima vez que reabrir a pasta de trabalho, você será solicitado a inserir o nome de uma conexão.

    Figura 17-1 Nome e Opção da Conexão


    Caixa de diálogo Conexão mostrando três opções: Análise Ad Hoc, Definir Conexão Ativa para esta Planilha e Definir como Conexão para Funções. Além disso, um campo Nome em que você insere o nome da conexão a ser usada para funções
  3. Na planilha, selecione a célula em que você deseja inserir a função.
  4. Na faixa de opções do Smart View, clique em Funções e, em seguida, em Criar Função, Botão Criar Função, para iniciar o painel Construtor de Funções.
  5. No painel Construtor de Funções escolha uma função na lista e depois clique em Selecionar.

    Nota:

    Atualmente, o Smart View suporta estas funções:

    • HsGetValue
    • HsSetValue
    • HsAlias
    • HsGetSheetInfo

    Para obter uma explicação detalhada dessas funções, consulte Descrições de Função.

    No exemplo abaixo, a função HsGetValue está selecionada.

    Figura 17-2 Painel Construtor de Funções, Lista de Funções Suportadas


    O Construtor de Funções mostrando a lista de funções suportadas, em que você pode selecionar uma função para trabalhar com ela. HsGetValue está selecionada

    Após clicar em Selecionar, o painel da função selecionada será exibido no Construtor de Funções. O exemplo a seguir exibe os campos para HsGetValue no Construtor de Funções. Esses campos variam de acordo com a função selecionada.

    Figura 17-3 Painel do Construtor de Funções, Lista de Membros


    Painel padrão do Construtor de Funções: todos os campos de argumentos de membro e dimensão estão vazios
  6. Para HsGetValue:
    1. Em Conexão, insira o nome da conexão especificado em etapa 2.
    2. Em Lista de Membros, adicione um argumento para cada dimensão no cubo usando qualquer um dos seguintes métodos
      • Clique no botão Selecionar Membro, O botão Seleção de Membros abre a caixa de diálogo Seleção de Membros, ao lado da caixa de texto do argumento. No Seletor de Membros, selecione uma dimensão e um membro. Repita esse procedimento para cada dimensão no cubo.
      • Digite o par dimensão e membro nas caixas de texto no formato dimensão#membro para informar o argumento manualmente. Por exemplo, Year#Qtr1 ou Year#Jan. Repita esse procedimento para cada dimensão no cubo.
      • Para usar referências de célula, siga o procedimento descrito em Usando Referências de Célula.

      O exemplo a seguir mostra uma Lista de Membros completa para a função HsGetValue.

      Figura 17-4 Painel do Construtor de Funções para HsGetValue com base no Banco de Dados de Exemplo da Visão de Planejamento


      O painel do Construtor de Funções preenchido para a função HsGetValue
    3. Opcional: Para adicionar mais linhas à Lista de Membros, clique em Adicionar.
  7. Para HsSetValue:
    1. Em Valor, informe o valor que deseja definir.
    2. Em Conexão, insira o nome da conexão especificado em etapa 2.
    3. Em Lista de Membros, adicione um argumento para cada dimensão no cubo.
    4. Opcional: Para adicionar mais linhas à Lista de Membros, clique em Adicionar.
  8. Para HsAlias:
    1. Em Conexão, insira o nome da conexão especificado em etapa 2.
    2. Insira os valores nos campos Nome do Membro, Alias ​​de Destino, Alias ​​de Origem e Nome Distinto.
  9. Para HsGetSheetInfo: Selecione uma propriedade na lista Propriedade da Planilha.
  10. Clique em Validar e corrija os erros.

    Os erros são indicados no painel Construtor de Funções, ao lado das áreas de problemas.

    Estes são alguns dos erros que podem ser exibidos:

    • Conexão off-line ou inválida
    • Seleção inválida
    • O nome de membro é inválido ou não corresponde ao alias selecionado
    • O nome de dimensão é inválido ou não corresponde ao alias selecionado
    • Combinação de Dimensão#Membro Incompleta
    • "Erro" genérico em caso de aspas ausentes ou outros erros de sintaxe secundários

    Por exemplo, Erros de Validação do Construtor de Funções mostra erros simples de ortografia que resultaram em um nome de Conexão inválido, um nome de dimensão inválido em um argumento e um nome de membro inválido em outro argumento.

    Figura 17-5 Erros de Validação do Construtor de Funções


    Os erros de ortografia no nome da Conexão, no nome de uma dimensão e no nome de um membro resultam em uma mensagem em linha ao lado indicando o problema.

    Nota:

    Valida somente trabalhos com as combinações dimensão#membro que são escritas à mão nas caixas de texto e não se aplica às combinações dimensão#membros que são adicionadas usando a caixa de diálogo Seletor de Membros. Se todas as combinações dimensão#membro forem inseridas usando o Seletor de Membros, nenhuma mensagem de validação sobre essas combinações será exibida. Você continuará a ver um erro sobre o nome da conexão caso ele esteja escrito de maneira incorreta.

    • Se o nome da conexão estiver correto e todas as outras combinações dimensão#membro tiverem sido inseridas usando a caixa de diálogo Seletor de Membros, uma mensagem "Validação bem-sucedida" não será exibida.
    • Se o nome da conexão estiver correto e uma ou mais combinações dimensão#membro tiverem sido digitadas corretamente, uma mensagem "Validação bem-sucedida" será exibida.
  11. Resolva os erros e clique em Validar novamente.

    Quando uma função for validada corretamente, uma mensagem ratificando que a validação foi bem-sucedida será exibida.

    Mensagem de validação bem-sucedida
  12. Clique em Aplicar.
  13. Para executar a função, siga o procedimento descrito em Executando Funções.