Création de vues de calcul dynamiques

Implémentation des paramètres d'entrée

Objective

After completing this lesson, you will be able to définissez des paramètres d'entrée pour transmettre des valeurs dynamiques à une vue de calcul.

Paramètres d'entrée

Un paramètre d'entrée est similaire à une variable dans la mesure où il prend en charge le transfert de valeurs dynamiques à une vue de calcul au moment de l'exécution. Cependant, alors qu'une variable n'a qu'un seul objectif, à savoir fournir un filtre dynamique basé sur des attributs, un paramètre d'entrée peut répondre à des exigences supplémentaires.

Les paramètres d'entrée peuvent être utilisés à différents endroits pour fournir des valeurs dynamiques, en particulier des colonnes calculées, des colonnes restreintes et des expressions de filtre. Voici quelques exemples :

  • Colonne calculée

    Vous voulez exécuter un calcul ad hoc des ventes prévisionnelles pour l'année suivante, sur la base de l'année en cours et d'une augmentation du volume d'affaires escomptée globale, par exemple 11 %, saisie par l'utilisateur au moment de l'exécution.

  • Colonne restreinte

    Vous voulez qu'une vue de calcul renvoie les ventes pour une année sélectionnée par l'utilisateur au moment de l'exécution, par exemple 2019 et l'année précédente, à l'aide de deux colonnes restreintes.

  • Filtrer

    Vous voulez filtrer l'ensemble de données pour les commandes clients dont le montant total est supérieur à 10 000 $. La valeur seuil est saisie au moment de l'exécution.

    Vous voulez filtrer les données de vente pour les produits dont le nom contient la chaîne "GTR", la chaîne est sélectionnée au moment de l'exécution par l'utilisateur.

    Vous voulez contrôler spécifiquement où une expression de filtre basée sur une entrée utilisateur est appliquée dans le scénario de calcul. Les variables ne vous permettent pas de choisir précisément, dans la vue de calcul, le nœud auquel le filtre est appliqué. Les variables appliquent toujours le filtre en haut.

Les paramètres d'entrée peuvent également être utilisés lorsque vous disposez de fonctions scalaires ou tabulaires dans votre vue de Calcul. Les paramètres de ces fonctions peuvent être fournis avec les valeurs que vous saisissez au moment de l'exécution, lors de l'interrogation de votre vue calculée. Pour ce faire, vous devez mapper les paramètres, qui seront abordés plus loin dans ce sujet.

Remarque

Le filtrage des données par attributs peut être effectué à l'aide de variables ou de paramètres d'entrée. Il est plus simple d'utiliser des variables dans ce cas, car vous n'avez pas besoin d'écrire l'expression de filtre. En outre, certains clients frontend peuvent ne pas prendre en charge les paramètres d'entrée, mais la plupart prennent en charge les variables.

Types de paramètres d'entrée

Les types de paramètres d'entrée suivants sont pris en charge :

TypeCas d'utilisation
Direct : devisePour la conversion de devise, lorsque vous voulez que l'utilisateur final indique une devise source ou cible.
Direct : datePour extraire des données en fonction d'une date saisie par l'utilisateur final (ou sélectionnée dans une zone de saisie de type calendrier).
Direct : unité de quantitéPour récupérer des données en fonction d'une unité de quantité sélectionnée par l'utilisateur final
Liste statiqueFournir à l'utilisateur final une liste prédéfinie de valeurs dans laquelle il sélectionne un ou plusieurs éléments.
ColonnePour fournir à l'utilisateur final une liste de valeurs à partir d'une colonne de la vue calculée
Dérivé de la tableLorsque vous souhaitez que l'utilisateur final dispose d'une liste de valeurs définie à partir d'une table (pas nécessairement incluse dans la vue)
Dérivé de la procédureLorsque vous souhaitez que la valeur du paramètre soit transmise à la vue de calcul en fonction de la sortie scalaire d'une procédure stockée
Direct (sans type sémantique)Lorsqu'aucun des éléments ci-dessus ne s'applique et/ou que vous voulez que l'utilisateur saisisse un paramètre sans le sélectionner dans une liste prédéfinie.

Le type de paramètre Direct peut être combiné à un type sémantique tel que Date, Devise ou Unité de quantité. Cela signifie que l'aide à la saisie sera basée sur ces types de valeurs. Par exemple, si vous spécifiez Date, un calendrier contextuel s'affichera pour l'invite utilisateur. Si vous indiquez Devise, une liste des devises valides sera présentée dans l'aide à la saisie. Cela nous permet de fournir une entrée flexible à l'utilisateur, mais aussi de contrôler le type de valeurs qui sont autorisées.

Types sémantiques Devise et Unité de quantité

Pour les types sémantiques Devise et Unité de mesure, la liste des valeurs proposées est créée en fonction des tables de référence correspondantes dans SAP HANA. Cette configuration nécessite que le schéma par défaut affecté à la vue contienne les tables de référence.

Les paramètres d'entrée prennent en charge plusieurs valeurs. Cela signifie qu'au moment de l'exécution, l'utilisateur final a la possibilité de fournir plusieurs valeurs au paramètre. Voici quelques exemples de cas d'utilisation :

  • Application de filtres des types Liste de valeurs et Pas dans la liste

  • Expression de colonnes calculées et expression de filtres dans des nœuds de projection, à condition que l'expression nécessite une entrée multivaleurs

Lorsque vous définissez un paramètre d'entrée du type Dérivé d'une procédure/fonction scalaire, il est possible de mapper des paramètres à l'entrée de la fonction scalaire ou de la procédure.

Remarque

Les paramètres d'entrée des types Dérivé de la table et Dérivé de la procédure/fonction scalaire ne génèrent pas d'invite pour l'utilisateur final (ils transmettent les valeurs de paramètre directement), sauf si vous sélectionnez l'option Entrée activée. Dans ce cas, les valeurs renvoyées par la table, la procédure ou la fonction scalaire peuvent être modifiées par l'utilisateur final.

Lors de l'exécution de la vue de calcul, les paramètres d'entrée sont transmis dans la requête SQL à l'aide d'une clause PLACEHOLDER, par exemple :

SELECT <colonnes> FROM <nom_vision_calcul> (caractère générique."$$IP_YEAR$$"=>'2019') GROUPE BY <groupe_par colonnes> ;

Toutes les applications ne sont pas en mesure de transmettre des valeurs à PLACEHOLDER. C'est pourquoi vous devez parfois utiliser des variables pour obtenir le même résultat.

Remarque

Lorsque vous avez défini un paramètre d'entrée, vous devez l'utiliser dans une expression. Sinon, elle est ignorée.

Création de paramètres d'entrée

Comme indiqué précédemment, contrairement à une variable, un paramètre d'entrée peut être utilisé dans une expression conditionnelle. Par exemple, nous pouvons utiliser un paramètre d'entrée pour déterminer la mesure à afficher dans une colonne particulière.

Pour illustrer cela, nous créons une colonne calculée appelée AMOUNT, qui peut être renseignée avec le montant brut ou le montant net, en fonction de la valeur que l'utilisateur sélectionne lors de l'interrogation de la vue.

Dans notre exemple, nous avons choisi d'utiliser un paramètre d'entrée de type Liste statique. Cela signifie que nous prédéfinissons la valeur autorisée qui peut être sélectionnée par l'utilisateur dans une liste. C'est très bien pour les listes courtes mais, lorsque la liste devient volumineuse, il devient fastidieux à gérer car vous devez modifier la vue de calcul et la reconstruire à chaque fois. Bien sûr, vous pouvez choisir le type Direct, ce qui signifie que l'utilisateur peut saisir n'importe quoi. Cependant, cela signifierait qu'en dehors de l'absence d'aide de l'utilisateur, il pourrait également mal saisir la valeur, ou saisir la valeur dans le mauvais format (peut-être en ajoutant des zéros non significatifs lorsqu'ils n'étaient pas requis).

Une bonne solution serait de définir le paramètre d'entrée avec le type Colonne, puis, dans l'aide à la saisie de la vue/table, de saisir le nom d'une table ou d'une vue dans laquelle les entrées autorisées sont présentées. Cela signifie également que cette liste peut être utilisée par plusieurs paramètres d'entrée et encourage la gestion centrale de la liste de valeurs autorisées cohérente.

Paramètres d'entrée

Exemple de paramètre d'entrée avec une liste statique.

Si nous voulons que l'utilisateur final décide si le montant brut ou net doit être affiché dans une vue, la première étape consiste à créer un paramètre d'entrée qui sera utilisé dans un calcul.

Le paramètre d'entrée peut être de n'importe quel type approprié, par exemple un type Liste statique.

Dans cet exemple, l'utilisateur pourra choisir « Montant brut » ou « Montant net ».

La valeur par défaut BRUT sera affectée au paramètre d'entrée si l'utilisateur n'indique rien.

Un paramètre d'entrée utilisé dans une formule ne doit pas nécessairement être de type Liste statique. Par exemple, il peut également s'agir d'une valeur numérique directe utilisée dans la multiplication ou tout autre type de calcul.

Appel d'un paramètre d'entrée dans un calcul

Colonne calculée à l'aide d'un paramètre d'entrée dans son expression.

L'étape suivante consiste à utiliser le paramètre d'entrée dans une colonne calculée.

Cela se fait en l'appelant entre guillemets simples et des signes de double dollar.

Dans cet exemple, le paramètre d'entrée est utilisé dans la condition d'une expression IF : if('$$GROSS_OR_NET$$'='Gross',"GROSS_AMOUNT","NET_AMOUNT")

Si l'utilisateur sélectionne BRUT, la colonne calculée (de type Mesure) affiche la mesure GROSS_AMOUNT dans la colonne MONTANT. Toute autre sélection entraîne l'affichage de NET_AMOUNT.

Paramètre d'entrée à l'aide de dates

Capture d'écran d'un paramètre d'entrée avec le type de données défini sur DATE.

Un paramètre d'entrée de type "Direct" avec un type sémantique "Date" peut être utile lorsque vous souhaitez créer des calculs basés sur une date spécifiée par l'utilisateur de reporting.

Vous pouvez créer une plage de dates en créant une paire de paramètres d'entrée (par exemple, "Date de début" et "Date de fin").

Notez que le type de données doit être défini sur "DATE".

Utilisation d'une boîte de dialogue de calendrier pour les paramètres d'entrée de date

Capture d'écran d'ouverture de l'aide à la saisie pour un paramètre d'entrée. S'il est de type Date, l'utilisateur final peut sélectionner la date appropriée dans un calendrier après avoir lancé l'aide à la saisie dans la boîte de dialogue d'aperçu.

Lorsque vous utilisez le type « Date », vous permettez à l'utilisateur final de sélectionner plus facilement une date en utilisant une boîte de dialogue de calendrier pour sélectionner la date appropriée.

Dans la figure, l'utilisateur est invité à saisir une valeur individuelle. Les dates peuvent également être sélectionnées comme plages.

Remarque

SAP recommande d'utiliser des paramètres d'entrée au lieu de variables dans la mesure du possible, car les paramètres d'entrée offrent plus de flexibilité et de fonctionnalités que les variables. Cependant, certains outils frontend ne peuvent pas traiter les paramètres d'entrée et les variables doivent donc être utilisées.

Définir les paramètres d'entrée pour transférer des valeurs dynamiques