Creazione di un'applicazione modello on-demand
Un'applicazione modello on-demand è una normale applicazione Qlik Sense con un'importante differenza: il suo script di caricamento contiene espressioni di associazione dati utilizzate per formulare le query sulle sorgenti dati. Queste espressioni di associazione dati vengono utilizzate al momento della generazione dell'applicazione on-demand per leggere i valori dallo stato di selezione dell'applicazione di selezione e associarli allo script dell'applicazione modello in modo che l'applicazione generata venga caricata con un sottogruppo di dati controllato dall'utente.
L'applicazione modello solitamente si connette alla stessa sorgente dati dell'applicazione di selezione. Lo script di caricamento di un'applicazione di selezione carica generalmente dati aggregati per ridurre i volumi di dati offrendo allo stesso tempo visualizzazioni interattive di importanti dimensioni e misure. Lo script di caricamento di un'applicazione modello utilizza query che caricano un sottogruppo controllato di dati più granulari.
Le applicazioni modello devono avere i loro fogli resi pubblici affinché altri utenti possano generare applicazioni su richiesta. Per ulteriori informazioni, vedere Concessione dell'accesso a fogli, gruppi di fogli, segnalibri e racconti.
Struttura di un'app modello
Un'app modello è collegata a un'app di selezione utilizzando un collegamento di navigazione all'app on-demand. Il collegamento di navigazione all'app include proprietà che controllano il numero di record sottoposti a query quando l'app on-demand viene caricata con dati. Lo script di caricamento dell'app modello contiene espressioni di associazione dati che specificano quali dati del campo dall'app di selezione vengono utilizzati per formulare le query generate durante il caricamento dei dati nell'app on-demand.
In June 2020 è stata introdotta una nuova sintassi per l'espressione di associazione dati. La sintassi e i prefissi precedenti od_, ods_, odo_, odso_ e odb_ si comportano come prima includendo vincoli di quantità, suffisso _n e specifiche di formato. Se la propria applicazione deve funzionare su Qlik Sense versioni precedenti a giugno 2020, utilizzare la vecchia sintassi. Per la vecchia sintassi, vedere Creazione di un'app modello on-demand (versione precedente).
Il suffisso _n non è supportato al momento di utilizzare i nuovi prefissi.
Le espressioni di associazione dati base hanno la forma:
$(odag_FIELDNAME)
Il prefisso odag_ viene utilizzato per associare lo stato di selezione dell'app di selezione allo script di caricamento dell'app On-demand, che viene creata mediante la copia dell'app modello. La parte dell'espressione di associazione dati che segue il prefisso odag deve essere un nome corrispondente a un campo nell'app di selezione. Quando l'app On-demand viene generata, viene utilizzato lo stato di selezione corrente dell'app di selezione per ottenere i valori desiderati da associare per ciascun campo. Ogni occorrenza di un'espressione $(odag_FIELDNAME) nello script di caricamento dell'app on-demand appena creata viene sostituita con l'elenco dei valori selezionati per il campo corrispondente nello stato di selezione dell'app di selezione.
Sono disponibili altri prefissi per un'associazione dati più specializzata. Per saperne di più sulla personalizzazione in presenza di casi speciali e l'ottimizzazione delle istruzioni di caricamento, vedere Espressioni di associazione in applicazioni modello on-demand.
Le associazioni on-demand possono essere inserite direttamente nelle istruzioni SELECT e WHERE nel proprio script di caricamento. Quando si aggiungono associazioni direttamente alle proprie istruzioni WHERE , è facile combinarle con altre condizioni nell'istruzione.
È possibile aggiungere una variabile segnaposto $(odagActive) al momento di realizzare il proprio script di caricamento. Ciò consente di caricare dati campione nell'app modello in modo che i grafici principali per le visualizzazioni dinamiche possano essere creati senza caricare tutti i dati.
Se si modifica lo script dell'app modello e si inserisce una nuova variabile di associazione, è necessario creare nuovi collegamenti di navigazione all'app on-demand per sostituire quelli esistenti. Se non lo si fa, la selezione del campo corrispondente non verrà inviata per le app on-demand esistenti che utilizzano quell'app modello.
Gli esempi seguenti illustrano uno script di caricamento dei modelli on-demand.
Esempio: Aggiunta di alcuni dati campione
Questo esempio aggiunge valori campione in modo che l'app possa essere caricata anche se le associazioni non sono complete.
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;
Esempio: Caricamento dati nell'app modello
Quello riportato di seguito è uno script di caricamento campione per il caricamento dei dati campione e il filtro con le associazioni odag_FIELDNAME generate. Le associazioni odagn_<Field Name> scelgono i numeri nei valori duali e li utilizzano per impostazione predefinita senza delimitazione tra virgolette.
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));
Single Sign-On (SSO)
Le applicazioni on-demand possono utilizzare Single Sign-On (SSO) con sorgenti dati che supportano SSO. L'engine e la sorgente dati devono essere configurati per consentire il SSO.
Una volta configurati l'engine e la sorgente dati per SSO, l'applicazione modello deve abilitare SSO aggiungendo la sintassi seguente allo script dell'applicazione modello:
///!ODAG_SSO
Servizio app On-Demand analizza lo script quando viene generata un'applicazione on-demand e ogni volta che viene ricaricata.
Quando un'applicazione on-demand viene caricata con SSO, l'identità dell'utente finale viene inviata alla sorgente dati. L'utente finale deve disporre dell'accesso alle sorgenti utilizzate nelle connessioni dati dell'applicazione modello. Vengono caricati solo i dati a cui l'utente può accedere in queste sorgenti, anche nel caso in cui venga selezionata una serie di dati più grande.