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
Tipos de parâmetro de entrada
Os seguintes tipos de parâmetros de entrada são suportados:
| Tipo | Casos de uso |
|---|---|
| Direto: moeda | Para a conversão de moeda, quando você deseja que o usuário final especifique uma moeda de origem ou de destino. |
| Direto: data | Para 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 medida | Para recuperar dados com base em uma unidade de medida selecionada pelo usuário final |
| Lista estática | Para fornecer ao usuário final uma lista predefinida de valores na qual ele seleciona um ou vários itens. |
| Coluna | Para fornecer ao usuário final uma lista de valores de uma coluna da visão de cálculo |
| Derivado da tabela | Quando 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 procedimento | Quando 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

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

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

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

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