Accéder au contenu principal Passer au contenu complémentaire

Création d'une application modèle On-demand

Une application modèle On-demand est une application Qlik Sense standard à une grande différence près : son script de chargement comprend des expressions de liaison de données utilisées pour formuler les requêtes portant sur les sources de données. Ces expressions de liaison de données sont utilisées au moment de la génération de l'application On-demand. Elles permettent de lire les valeurs à partir de l'état de sélection de l'application et de lier celles-ci au script de l'application modèle afin que l'application générée soit chargée avec un sous-ensemble des données contrôlé par l'utilisateur.

En général, l'application modèle se connecte à la même source de données que l'application de sélection. Le script de chargement d'une application de sélection charge habituellement des données agrégées afin de réduire les volumes de données tout en offrant cependant des visualisations interactives de dimensions et de mesures importantes. Le script de chargement d'une application modèle utilise des requêtes qui chargent un sous-ensemble contrôlé de données plus granulaires.

Les feuilles des applications modèles doivent être rendues publiques pour que d'autres utilisateurs puissent générer des applications On-demand. Pour plus d'informations, voir Affectation d'un accès aux feuilles, favoris et récits.

Note InformationsUne application modèle On-demand ne charge pas directement les données. La connexion de l'application modèle doit être valide, mais il est nécessaire de générer une application On-demand pour tester son bon fonctionnement. Lorsqu'une application On-demand est générée, le script de chargement est modifié par le On-demand app service de façon à charger l'état de sélection de l'application de sélection On-demand. Si la génération de l'application On-demand se déroule sans erreur, cela signifie que la connexion de l'application modèle fonctionne correctement.
Note InformationsTenez compte de la taille de vos applications lorsque vous développez des applications modèles On-demand. Selon votre type de déploiement, il se peut que des limites de stockage aient été définies ou que l'utilisation d'un grand volume de stockage entraîne le dimensionnement de votre déploiement de cloud. Pour plus d'informations, contactez votre administrateur système.

Structure d'une application modèle

Une application modèle est associée à une application de sélection par un lien de navigation d'application On-demand. Ce lien de navigation inclut des propriétés permettant de contrôler le nombre d'enregistrements interrogés lorsque l'application On-demand est chargée avec des données. Le script de chargement de l'application modèle comprend des expressions de liaison de données qui indiquent quelles données de champ de l'application de sélection sont utilisées pour formuler les requêtes émises au moment du chargement des données dans l'application On-demand.

Note Informations

Une nouvelle syntaxe a été lancée en juin 2020 pour les expressions de liaison de données. La précédente syntaxe et les précédents préfixes od_, ods_, odo_, odso_ et odb_ se comportent comme avant, y compris les contraintes de quantité, le suffixe _n et les spécifications de format. Si votre application doit fonctionner sur les versions Qlik Sense antérieures à juin 2020, utilisez l'ancienne syntaxe. Pour connaître l'ancienne syntaxe, voir Création d'une application modèle On-demand (ancienne version).

Lors de l'utilisation des nouveaux préfixes, le suffixe _n n'est plus pris en charge.

Les expressions de liaison de données de base suivent la forme ci-dessous :

$(odag_FIELDNAME)

Le préfixe odag_ est utilisé pour lier l'état de sélection de l'application de sélection au script de chargement de l'application On-demand, qui est créé via la copie de l'application modèle. Dans l'expression de liaison de données, le préfixe odag_ doit être suivi par un nom correspondant à un champ figurant dans l'application de sélection. Lorsque l'application On-demand est générée, l'état de sélection actif de l'application de sélection est utilisé pour définir les valeurs souhaitées à lier pour chaque champ. Chaque occurrence d'une expression $(odag_FIELDNAME) figurant dans le script de chargement de l'application On-demand qui vient d'être créée est remplacée par la liste des valeurs choisies pour le champ correspondant dans l'état de sélection de l'application de sélection.

D'autres préfixes, pour des liaisons de données plus spécialisées, sont disponibles. Pour en savoir plus sur la personnalisation des cas spéciaux et l'optimisation des instructions LOAD, voir Expressions de liaison dans les applications modèles On-demand.

Les liaisons On-demand peuvent être directement insérées dans les instructions SELECT et WHERE de votre script de chargement. Lorsque vous ajoutez des liaisons directement dans les instructions WHERE, il est facile de les combiner avec d'autres conditions de l'instruction.

Lorsque vous générez votre script de chargement, vous pouvez ajouter une variable d'espace réservé $(odagActive). Cela vous permet de charger les échantillons de données dans l'application modèle afin de pouvoir créer les graphiques principaux des vues dynamiques sans charger la totalité des données.

Les exemples suivants montre un script de chargement modèle On-demand.

Ajout de certains échantillons de données

Cet exemple ajoute des échantillons de valeurs afin de pouvoir charger l'application, même si les liaisons ne sont pas complètes.


IF '$(odagActive)'='' THEN
trace ODAG variables not inserted! Loading sample data.;
SET 'odag_Origin Code' = '''LAX''';
SET 'odag_Destination Code' = '''JFK''';
SET odagn_Year = 2015;
SET odag_Quarter = '''1''';
SET 'odag_Ticket Carrier Code' = '''CA''';
SET 'odag_Fare Class' = '''X''';
END IF;

Chargement de données dans l'application modèle

L'exemple suivant montre un script de chargement modèle pour le chargement des échantillons de données et leur filtrage avec les liaisons odag_FIELDNAME générées. Les liaisons odagn_<Field Name> sélectionnent les nombres dans les valeurs doubles et, par défaut, n'utilisent pas de guillemets.


SQL SELECT *
FROM FlightDB.Flights
WHERE "Origin Code" IN ($(odag_Origin Code))
AND "Destination Code" IN ($(odag_Destination Code))
AND "Year" IN ($(odagn_Year))
AND "Quarter" IN ($(odag_Quarter))
AND "Ticket Carrier Code" IN ($(odag_Ticket Carrier Code))
AND "Fare Class" IN ($(odag_Fare Class));

Authentification unique (SSO)

Les applications On-demand peuvent utiliser authentification unique (SSO) avec des sources de données qui prennent en charge SSO. Il convient de configurer le moteur et la source de données de façon à autoriser SSO.

Une fois le moteur et la source de données configurés pour SSO, activez la fonction SSO dans l'application modèle en ajoutant la syntaxe suivante dans le script de l'application modèle :

///!ODAG_SSO

Le service Service d'applications On-demand analyse le script lorsqu'une application On-demand est générée et chaque fois qu'elle est chargée.

Lorsqu'une application On-demand est chargée avec SSO, l'identité de l'utilisateur final est envoyée à la source de données. L'utilisateur final doit avoir accès aux sources utilisées dans les connexions de données de l'application modèle. Seules les données auxquelles l'utilisateur a accès sont chargées dans ces sources, même si un ensemble de données plus vaste est sélectionné.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !