Expressions de liaison dans les applications modèles On-demand

Les liaisons de données figurant dans une application modèle indiquent quelles données d'une application de sélection correspondante sont utilisées pour formuler les requêtes émises au moment du chargement des données dans l'application On-demand.

Le format de base des expressions de liaison--$(odag_FIELDNAME)--n'est pas la seule méthode disponible pour lier des expressions. Il est possible d'utiliser d'autres préfixes pour affiner les sélections et s'assurer que l'application modèle charge correctement les données.

Préfixes de liaison disponibles

Le format de préfixe général est odag[s|o][n][cnt], où :

• s - inclut uniquement les valeurs sélectionnées
• o - inclut uniquement les valeurs facultatives
• n - sélectionne la version numérique, par défaut non encadrée de guillemets
• cnt - insère le nombre de valeurs au lieu des valeurs réelles

Le tableau suivant fournit une liste de toutes les versions de préfixes de liaison disponibles. Les exemples supposent un champ nommé MyField avec 1,2,3 comme valeurs sélectionnées (valeurs vertes) et 4 comme valeur sélectionnée facultative (valeur blanche).

Optimisation d'une base de données volumineuse

Les préfixes odags_ et odagsn_ sont prévus à des fins d'optimisation des requêtes. Quand les champs de liaison ne contiennent aucune sélection, odag_ inclut toutes les valeurs, tandis que odags_ n'inclut aucune valeur. Dans certains cas, il est plus efficace d'utiliser les préfixes odags_ et odagscnt_. Cela vous permet de tester si le jeu de valeurs est vide. Par exemple, l'exemple suivant est plus efficace en l'absence de sélections dans MyField que de tester toutes les valeurs dans odag_MyField :

odags_ ne peut pas être utilisé quand il existe un champ alternatif, qui n'est pas un champ On-demand, à partir duquel effectuer une sélection dans l'application de sélection. Par exemple, si l'utilisateur effectue des sélections dans CountryName, mais que l'expression de liaison se trouve dans le champ associé CountryCode, odags_ ne peut pas être utilisé. Dans ces cas, odago_ peut être utilisé à sa place. En l'absence de valeurs dans une liaison odago_, cela peut signifier soit que toutes les valeurs doivent être incluses, soit qu'aucune valeur ne doit être incluse.

Liaison de valeurs numériques

Lorsque les données à lier à l'application On-demand se composent de nombres plutôt que de chaînes, il est préconisé de désactiver le comportement de mise entre guillemets pour les champs numériques. Par exemple, si les enregistrements de ventes incluent une colonne DAY_OF_WEEK numérique et que vous souhaitez que l'utilisateur de l'application de sélection puisse choisir des combinaisons arbitraires de DAY_OF_WEEK, vous devez préciser dans la requête d'agrégation utilisée pour le chargement de l'application de sélection qu'elle doit inclure DAY_OF_WEEK à la fois dans la liste SELECT et la liste GROUP BY. Si des guillemets entourent les valeurs DAY_OF_WEEK lorsqu'elles sont sélectionnées, cela pourrait entraîner une erreur de requête d'exécution si la base de données ne prend pas en charge la conversion automatique du type chaîne en type numérique.

Pour gérer cette situation, vous pouvez utiliser une version numérique du suffixe de l'expression de liaison. Cela oblige la liaison de champ à utiliser les valeurs numériques de l'application de sélection plutôt que les valeurs de chaîne. Les versions numériques suivantes sont disponibles :

• odagn_
• odagon_
• odagsn_

Si des versions numériques sont utilisées, les valeurs sont sélectionnées à partir de la partie numérique des valeurs doubles qui stockent les valeurs sélectionnées et les valeurs sont par défaut non encadrées de guillemets.

Obligation d'utiliser un certain nombre de sélections

Dans certains cas, il peut s'avérer nécessaire d'exiger que la requête d'application On-demand comprenne un nombre ou une plage de valeurs spécifique pour un champ donné. Par exemple, supposons que la requête de l'application On-demand contienne une clause BETWEEN afin d'obtenir toutes les ventes comprises entre une date de début et une date de fin. L'expression de liaison du champ YEARQUARTER peut comporter le suffixe syntaxique [2] qui exigera la sélection exacte de deux valeurs pour YEARQUARTER, comme dans l'exemple ci-dessous :

Le point de navigation d'application On-demand défini sur l'application de sélection restera désactivé tant qu'il n'y aura pas exactement deux valeurs de YEARQUARTER sélectionnées. Un message s'affiche pour indiquer qu'exactement deux valeurs de YEARQUARTER doivent être sélectionnées.

Les contraintes de quantité de sélections établissent une liaison préalable entre l'application de sélection et l'application On-demand. Ce cas diffère des expressions de liaison, qui n'utilisent pas de contraintes de quantité. Par exemple, lorsque le script de l'application modèle inclut une expression de liaison sans contrainte de quantité, comme dans :

il n'est nullement obligatoire pour l'application de sélection de contenir un champ intitulé MYFIELD ni que des valeurs soient sélectionnées si ce champ existe. Si l'application de sélection ne comporte pas de champ intitulé MYFIELD ou si l'utilisateur oublie simplement d'y effectuer des sélections, il est tout de même possible d'activer le point de navigation d'application On-demand lorsque d'autres sélections sont effectuées pour remplir la condition de valeur de limite d'enregistrements.

D'un autre côté, si l'expression de liaison est définie comme suit :

l'application de sélection est alors soumise à deux obligations :

• L'application de sélection doit contenir un champ intitulé MYFIELD.
• L'utilisateur doit sélectionner une ou plusieurs valeurs pour MYFIELD.

Il convient d'employer ce type d'expression de liaison avec prudence, car il limite les applications de sélection qu'il est possible d'utiliser avec l'application modèle. Il est déconseillé d'appliquer cette contrainte de quantité aux liaisons d'une application modèle, à moins d'être certain de vouloir imposer cette restriction à toutes les applications de sélection liées à cette application modèle.

Pour exécuter le processus de liaison de données, le service On-demand app utilise une approche de substitution de chaîne qui ne tient pas compte des commentaires figurant dans le script. Autrement dit, il convient de ne pas utiliser d'expressions de liaison dans les commentaires, à moins de souhaiter inclure dans ces derniers la liste des valeurs liées faisant suite à la génération de l'application. Toutes les liaisons dans les commentaires apparaîtront également dans la liste de champs du lien de génération de l'application On-demand, alors que ce n'est peut-être pas souhaitable.

Il est possible de définir d'autres contraintes de quantité. Le tableau suivant résume les différentes combinaisons de contraintes de quantité de sélections possibles.

Modification des guillemets et délimiteurs de valeurs

Lorsqu'une liste de valeurs d'un champ sélectionné dans une application de sélection est insérée dans le script d'une application modèle, les valeurs sont encadrées de guillemets simples et séparées par des virgules. Ce sont les caractères par défaut utilisés comme guillemets et délimiteurs. Il est possible de modifier ces valeurs dans la syntaxe ajoutée à l'instruction de liaison relative à chaque champ. Par exemple :

Ces nouvelles valeurs sont ensuite appliquées lors de la formulation de la liste des valeurs de liaison récupérée à partir de l'application de sélection. Par exemple, si les valeurs sélectionnées correspondent aux trois premiers mois de l'année, la liste serait élaborée de la façon suivante :

Les valeurs par défaut des guillemets et délimiteurs sont prises en charge par la plupart des bases de données SQL standard. Toutefois, elles peuvent être incompatibles avec certaines bases de données SQL et ne fonctionnent pas avec de nombreuses sources de données dynamiques telles que NoSQL et REST. Avec ces sources, vous devez ajouter cette expression de liaison afin de modifier les caractères utilisés comme guillemets et délimiteurs.

Le tableau suivant indique les paramètres de format pour modifier les caractères de guillemet et de délimiteur.

Les tableaux suivants indiquent la spécification de format et les valeurs générées pour odag_ et odagn_. Les valeurs insérées générées sont basées sur les valeurs des données par défaut de VAL1, VAL2.

Traitement des valeurs individuelles

Quand le traitement individuel des valeurs de champ est requis, vous pouvez utiliser une méthode intégrée pour générer des valeurs dans la variable Values et effectuer un traitement arbitraire avec Replace ou une autre fonction. Dans l'exemple ci-dessous, Replace est utilisé avec les valeurs d'espace réservé.