Criação de visões de cálculo dinâmicas

Implementar parâmetros de entrada

Objective

After completing this lesson, you will be able to defina parâmetros de entrada para transferir valores dinâmicos para uma visão de cálculo.

Parâmetros de entrada

Um parâmetro de entrada é semelhante a uma variável na medida em que suporta a transferência de valores dinâmicos para uma visão de cálculo no momento da execução. Mas enquanto uma variável tem apenas um objetivo, ou seja, fornecer um filtro dinâmico baseado em atributos, um parâmetro de entrada pode atender a requisitos adicionais.

Os parâmetros de entrada podem ser usados em diferentes locais para fornecer valores dinâmicos, em particular, colunas calculadas, colunas restritas e expressões de filtro. Aqui estão alguns exemplos:

  • Coluna calculada

    Você pretende executar um cálculo ad hoc das vendas previstas para o próximo ano, com base no ano corrente e um aumento do faturamento previsto global - por exemplo, 11%, inserido pelo usuário no momento da execução.

  • Coluna restrita

    Você quer que uma visão de cálculo retorne as vendas para um ano selecionado pelo usuário no momento da execução - por exemplo, 2019 e o ano anterior, usando duas colunas restritas.

  • Filtro

    Você quer filtrar o conjunto de dados para ordens do cliente que têm um montante total superior a $10.000. O valor limiar é inserido no momento da execução.

    Você quer filtrar dados de vendas para produtos que têm um nome contendo a cadeia 'GTR', a cadeia é selecionada no momento da execução pelo usuário.

    Você deseja controlar especificamente onde uma expressão de filtro baseada em uma entrada do usuário é aplicada dentro do cenário de cálculo. As variáveis não permitem que você selecione com precisão, na visão de cálculo, a qual nó o filtro é aplicado. As variáveis aplicam o filtro sempre na parte superior.

Os Parâmetros de entrada também podem ser usados quando você tem funções escalares ou de tabela em sua Visão de cálculo. Os parâmetros destas funções podem ser alimentados com valores que você insere no momento da execução, ao consultar sua visão de cálculo. Isso requer que você mapeie os parâmetros, que serão discutidos posteriormente nesta lição.

Nota

A filtragem de dados por atributos pode ser alcançada usando variáveis ou parâmetros de entrada. É mais simples usar variáveis neste caso, porque você não precisa escrever a expressão de filtro. Além disso, alguns clientes front-end podem não suportar parâmetros de entrada, mas a maioria suportará variáveis.

Tipos de parâmetro de entrada

Os seguintes tipos de parâmetros de entrada são suportados:

TipoCasos de uso
Direto: moedaPara a conversão de moeda, quando você deseja que o usuário final especifique uma moeda de origem ou de destino.
Direto: dataPara recuperar dados com base em uma data inserida pelo usuário final (ou selecionada em uma caixa de entrada de tipo de calendário).
Direto: unidade de medidaPara recuperar dados com base em uma unidade de medida selecionada pelo usuário final
Lista estáticaPara fornecer ao usuário final uma lista predefinida de valores na qual ele seleciona um ou vários itens.
ColunaPara fornecer ao usuário final uma lista de valores de uma coluna da visão de cálculo
Derivado da tabelaQuando você deseja que o usuário final tenha uma lista definida de valores de uma tabela (não necessariamente incluída na visão)
Derivado do procedimentoQuando você deseja que o valor do parâmetro seja passado para a visão de cálculo com base na saída escalar de um procedimento armazenado
Direto (sem tipo semântico)Quando nenhuma das opções acima se aplica e/ou quando você quer que o usuário insira um parâmetro sem o selecionar a partir de uma lista predefinida.

O tipo de parâmetro Direto pode ser combinado com um tipo semântico, como Data, Moeda ou Unidade de medida. Isso significa que as entradas possíveis serão baseadas nesses tipos de valores. Por exemplo, se você especificar Data, um calendário pop-up será exibido para o prompt do usuário. Se você indicar Moeda, uma lista de moedas válidas será apresentada nas entradas possíveis. Isso nos permite fornecer entrada flexível para o usuário, mas também nos permite controlar o tipo de valores que são permitidos.

Tipos semânticos de moeda e unidade de medida

Para os tipos semânticos Moeda e Unidade de medida, a lista de valores propostos será criada com base nas tabelas de referência correspondentes no SAP HANA. Esta configuração requer que o esquema padrão atribuído à visão contenha as tabelas de referência.

Os parâmetros de entrada suportam vários valores. Isso significa que, no momento da execução, o usuário final tem a possibilidade de fornecer vários valores ao parâmetro. Alguns exemplos de casos de utilização incluem o seguinte:

  • Aplicação de filtros dos tipos Lista de valores e Fora da lista

  • Expressão de colunas calculadas e expressão de filtros em nós de projeção, desde que a expressão exija uma entrada de valor múltiplo

Quando você define um parâmetro de entrada do tipo Derivado de procedimento/função escalar, é possível mapear parâmetros para a entrada da função ou procedimento escalar.

Nota

Parâmetros de entrada dos tipos Derivado da tabela e Derivado do procedimento/função escalar não geram um prompt para o usuário final (eles transferem os valores de parâmetro diretamente), exceto se você selecionar a opção Entrada ativada. Neste caso, os valores retornados pela tabela, procedimento ou função escalar podem ser modificados pelo usuário final.

Após a execução da visão de cálculo, os parâmetros de entrada são transferidos para dentro da consulta SQL usando uma cláusula PLACEHOLDER, por exemplo:

SELECT <colunas> FROM <calculation_view_name> (caractere de preenchimento."$$IP_YEAR$$"=>'2019') GROUP BY <colunas group_by>;

Nem todas as aplicações podem transferir valores para o PLACEHOLDER. É por isso que às vezes você deve usar variáveis para alcançar o mesmo resultado.

Nota

Depois de definir um parâmetro de entrada, você deve utilizá-lo em uma expressão. Caso contrário, ele é ignorado.

Criação de parâmetros de entrada

Como já discutido, ao contrário de uma variável, um parâmetro de entrada pode ser usado em uma expressão condicional. Por exemplo, podemos usar um parâmetro de entrada para determinar qual medida deve ser exibida em uma coluna específica.

Para ilustrar isso, criamos uma coluna calculada chamada AMOUNT, que pode ser preenchida com o montante bruto ou com o montante líquido, dependendo do valor que o usuário seleciona ao consultar a visão.

Em nosso exemplo, optamos por usar um parâmetro de entrada do tipo Lista estática. Isso significa que predefinimos o valor permitido que pode ser escolhido pelo usuário em uma lista. Isso é bom para listas breves, mas quando a lista se torna grande, torna-se complicado administrar porque você teria que editar a visão de cálculo e recriá-la cada vez. Obviamente, você poderia selecionar o tipo Direto, o que significaria que o usuário poderia inserir qualquer coisa. No entanto, isso significaria que, além do usuário não ter nenhuma orientação, ele também poderia digitar o valor incorretamente ou inserir o valor no formato incorreto (talvez adicionando zeros precedentes quando não eram necessários).

Uma boa solução seria definir o parâmetro de entrada com o tipo Coluna e, em seguida, nas Entradas possíveis de visão/tabela, inserir o nome de uma tabela ou visão onde as entradas permitidas são apresentadas. Isso também significa que essa lista pode ser utilizada por vários parâmetros de entrada e incentiva a atualização central da lista de valores consistentes e permitidos.

Parâmetros de entrada

Um exemplo para um parâmetro de entrada com uma lista estática.

Se quisermos que o usuário final decida se o montante bruto ou líquido deve ser exibido em uma visão, a primeira etapa é criar um parâmetro de entrada que será usado em um cálculo.

O parâmetro de entrada pode ser de qualquer tipo adequado, por exemplo, um tipo de lista estática.

Neste exemplo, o usuário poderá selecionar "Montante bruto" ou "Montante líquido".

O valor proposto BRUTO será atribuído ao parâmetro de entrada se o usuário não indicar nada.

Um parâmetro de entrada usado em uma fórmula não precisa necessariamente ser do tipo Lista estática. Por exemplo, também pode ser um valor numérico direto usado na multiplicação ou qualquer outro tipo de cálculo.

Chamada de um parâmetro de entrada em um cálculo

Coluna calculada usando um parâmetro de entrada em sua expressão.

A próxima etapa é usar o Parâmetro de entrada em uma coluna Calculado.

Isso é feito chamando-o entre aspas simples e sinais de dólar duplo.

Neste exemplo, o parâmetro de entrada é usado na condição de uma expressão IF: if('$$GROSS_OR_NET$$'='Gross',"GROSS_AMOUNT","NET_AMOUNT")

Se o usuário selecionar BRUTO, a coluna calculada (do tipo Medida) exibirá a medida GROSS_AMOUNT na coluna AMOUNT. Qualquer outra seleção resultará na exibição de NET_AMOUNT.

Parâmetro de entrada utilizando datas

Captura de tela de um parâmetro de entrada com tipo de dados definido como DATE.

Um tipo de parâmetro de entrada do tipo "Direto" com um tipo semântico "Data" pode ser útil quando você quer criar cálculos com base em uma data indicada pelo usuário de relatório.

Você pode criar um intervalo de datas criando um par de parâmetros de entrada (por exemplo, "Data de" e "Data até").

Observe que o tipo de dados deve ser definido como "DATE".

Utilização de um diálogo de calendário para parâmetros de entrada de data

Captura de tela para abrir as entradas possíveis para um parâmetro de entrada. Se for do tipo Data, o usuário final pode selecionar a data adequada a partir de um calendário depois de iniciar as entradas possíveis no diálogo de visualização.

Ao usar o tipo "Data", você está facilitando para o usuário final selecionar uma data usando uma caixa de diálogo de calendário para selecionar a data apropriada.

Na figura, o usuário é solicitado a fornecer um único valor. As datas também podem ser selecionadas como intervalos.

Nota

A SAP recomenda a utilização de parâmetros de entrada em vez de variáveis sempre que possível, porque os parâmetros de entrada fornecem mais flexibilidade e funcionalidades do que variáveis. No entanto, algumas ferramentas front end não podem processar parâmetros de entrada e, por isso, devem ser usadas variáveis.

Definir parâmetros de entrada para transferir valores dinâmicos