Creazione di grafici di scrittura tabelle
È possibile creare un grafico di scrittura tabelle su un foglio, aggiungendo dimensioni, misure e colonne modificabili secondo le necessità. Dopo aver creato un grafico di scrittura tabelle in un'app, gli utenti che dispongono di accesso per tale app, nonché delle autorizzazioni per la scrittura delle tabelle, potranno apportare modifiche alle colonne modificabili. Le modifiche possono quindi essere esportate in sistemi esterni.
Creazione di un grafico di scrittura tabelle
È possibile aggiungere un grafico di scrittura tabelle ai fogli in qualsiasi momento.
Procedere come indicato di seguito:
Nel pannello Risorse, in Grafici, trascinare un grafico Scrittura tabelle sul foglio.
Fare clic su Aggiungi dimensione e selezionare una dimensione o un campo.
Aggiungere colonne di dimensione e misura aggiuntive facendo clic su
in Dati nel pannello delle proprietà. Si apre un menu a discesa. Selezionare una delle seguenti opzioni:- Campi e voci principali: apre una casella di dialogo ricercabile, che visualizza ogni campo e voce principale. È possibile scegliere di aggiungere qualsiasi elemento come dimensione o misura.
- Espressione personalizzata: apre una casella di dialogo in cui è possibile digitare un'espressione o aprire l'editor delle espressioni.
Aggiungere colonne modificabili facendo clic su
in Dati nel pannello delle proprietà e selezionando Colonna modificabile.Definire una o più chiavi primarie per la tabella. Nel grafico di scrittura tabelle, nella colonna modificabile, fare clic su Definisci e selezionare una o più colonne dimensione da utilizzare come chiavi primarie.
Per maggiori informazioni sulle chiavi primarie, vedere Chiave primaria.
Fare clic su Salva.
Dopo aver creato il grafico di scrittura tabelle, consentire agli utenti di interagire con esso e aggiungere modifiche alle colonne modificabili. È anche possibile personalizzare l'aspetto del grafico di scrittura tabelle configurandone le proprietà. Vedere Configurazione delle proprietà per la scrittura tabelle.
Estrarre e utilizzare le modifiche
Quando gli utenti aggiungono dati nelle colonne modificabili, le modifiche non vengono applicate al modello dati dell'app. Le modifiche sono anche temporanee: vengono archiviate in un'archiviazione modifiche gestita da Qlik per 90 giorni, dopodiché vengono eliminate.
È possibile recuperare queste modifiche tramite change-stores API. Le modifiche possono essere utilizzate in vari modi, tra cui:
-
Caricare le modifiche in un QVD o nelle app per l'archiviazione permanente e l'utilizzo in Qlik Cloud.
-
Estrarre le modifiche, aggiungendole a sistemi esterni come un foglio di calcolo Excel o un database SQL.
-
Integrare dinamicamente i dati in processi automatizzati, come l'invio di e-mail e gli acquisti di inventario.
-
Creare le applicazioni e integrare le chiamate in change-stores API nei flussi di lavoro operativi.
Prerequisiti
Prima di poter accedere ai dati salvati in archiviazione modifiche, è necessario poter accedere a change-stores API. Per fare ciò, sono necessari i seguenti elementi:
-
Chiave API per il tenant Qlik Cloud. Vedere Gestione delle chiavi API.
-
Le autorizzazioni richieste per utilizzare le funzionalità di scrittura tabelle, assegnate dagli amministratori del tenant. Vedere la sezione:
-
Impostazione delle autorizzazioni per le tabelle di scrittura (sottoscrizioni basate sulla capacità)
-
Impostazione delle autorizzazioni per le tabelle di scrittura (sottoscrizioni basate sugli utenti)
-
-
L'ID dell'archiviazione modifiche. È possibile recuperarlo dopo aver creato il grafico di scrittura tabelle su un foglio. Vedere Archiviazione modifiche.
Strumenti disponibili per l'estrazione delle modifiche
È possibile utilizzare i seguenti strumenti per estrarre e utilizzare le modifiche da change-stores API:
-
Qlik Automate
-
Il connettore REST disponibile con la funzionalità di creazione degli script di Qlik e la preparazione dei dati.
Per gli esempi e i casi d'uso, vedere:
Concetti
Questa sezione fornisce una panoramica dei concetti fondamentali per le funzionalità di scrittura tabelle.
Colonna modificabile
In un grafico di scrittura tabelle, le colonne modificabili consentono agli utenti di inserire i dati al volo durante l'analisi. Salvando le modifiche in una colonna modificabile, un utente scrive le modifiche in un archivio delle modifiche, da cui possono essere recuperate dagli sviluppatori di app e dagli integratori.
Per maggiori informazioni su dove è possibile creare le colonne modificabili, vedere Creazione di un grafico di scrittura tabelle.
Dopo aver aggiunto una colonna modificabile, è possibile personalizzarla ulteriormente per soddisfare le proprie esigenze.
Procedere come indicato di seguito:
-
Nel pannello delle proprietà fare clic sulla scheda Dati.
Vengono visualizzate le proprietà della colonna.
-
È possibile modificare una qualsiasi delle seguenti proprietà:
-
Titolo: modificare il titolo predefinito della colonna.
-
Mostra contenuto: modificare il modo in cui gli utenti possono modificare i dati nella tabella. È possibile scegliere tra:
-
Selezione singola: specificare un set di valori che gli utenti possono selezionare per ogni cella durante la modifica. Ad esempio, è possibile aggiungere due valori per gli stati degli ordini: In corso e In ritardo. Gli utenti possono quindi selezionare uno di questi valori quando commentano i record di dati.
-
Input utente manuale: gli utenti modificano i dati digitando manualmente il testo nelle celle.
-
-
Mostra colonna: attivare/disattivare la visibilità della colonna.
-
Larghezza colonna: imposta la larghezza della colonna.
-
Archiviazione modifiche
L'archiviazione modifiche è una posizione di archiviazione gestita da Qlik che contiene le modifiche aggiunte dall'utente dalle colonne modificabili in un grafico di scrittura tabelle. L'archiviazione modifiche è una posizione di archiviazione temporanea—le modifiche vengono archiviate per un massimo di 90 giorni, dopodiché vengono eliminate.
L'archiviazione modifiche per il grafico di scrittura tabelle è preconfigurata per il tenant ed è accessibile tramite change-stores API. Con l'ID dell'archiviazione modifiche, è possibile formulare richieste API e automazioni che sincronizzano le modifiche dell'utente in una posizione permanente come un foglio di calcolo o un database. Per ulteriori informazioni, vedere Estrarre e utilizzare le modifiche.
È possibile copiare l'ID dell'archiviazione delle modifiche in due modi:
-
In modalità di modifica del foglio dopo aver creato la scrittura delle tabelle. Nel pannello delle proprietà, in Archiviazione modifiche> ID archiviazione modifiche, fare clic su
.Copia dell'ID archiviazione modifiche dal pannello delle proprietà.
-
Nella modalità di analisi quando si visualizzano i grafici di scrittura tabelle. Fare clic sull'icona
nell'angolo in basso a destra. Fare clic su per copiare l'ID archiviazione modificheCopia del l'ID archiviazione modifiche quando si visualizza un grafico di scrittura tabelle.
Chiave primaria
Per aggiungere colonne modificabili a un grafico di scrittura tabelle, è necessario definire almeno una chiave primaria.
Una chiave primaria è un campo utilizzato per collegare le modifiche alle colonne modificabili ai dati originali del modello dati. Le chiavi primarie forniscono la mappatura tra i record nel grafico di scrittura tabelle (che rappresentano i dati del modello dati) e le modifiche che gli utenti introducono all'interno delle colonne modificabili.
La chiave primaria può essere un singolo campo, oppure può essere una chiave composita che si estende su più campi.
Dopo aver definito le chiavi primarie in un grafico di scrittura tabelle, è possibile modificarle in qualsiasi momento. Nel pannello delle proprietà, in Archiviazione modifiche > Chiavi primarie, fare clic su Modifica.
La chiave primaria è importante anche quando si estraggono le modifiche da change-stores API.
Utilizzo degli strumenti di Qlik Cloud per estrarre le modifiche dal grafico di scrittura tabelle
Estrazione delle modifiche dal grafico di scrittura tabelle con Qlik Automate
Le modifiche salvate nell'archiviazione modifiche possono essere estratte utilizzando i blocchi Change Store nel Qlik Cloud Services connettore in Qlik Automate. Questo connettore si connette automaticamente all'account Qlik del proprietario dell'automazione, quindi non sono necessari passaggi aggiuntivi per l'autenticazione.
Maggiori informazioni su Qlik Automate sono disponibili in Qlik Automate.
Accesso ai blocchi Qlik Automate disponibili per l'estrazione delle modifiche dal grafico di scrittura tabelle
Elenco delle modifiche correnti dall'archiviazione modifiche
Il blocco List Current Changes From Change Store utilizza l'endpoint API /changes/tabular-views e restituirà solo il valore più recente per ogni cella (in altre parole, restituisce i valori correnti). Restituisce questi valori come un elenco di oggetti in cui ogni oggetto contiene le chiavi primarie e i valori di modifica. Ogni record è anche esteso con il timestamp updatedAt per la data e l'ora in cui è stato effettuato l'ultimo aggiornamento al record e l'ID utente updatedBy per l'utente che ha apportato tale modifica.
Blocco List Current Changes From Change Store in Qlik Automate
Questo blocco ha anche una variante incrementale List Current Changes From Change Store Incrementally. Questa variante funziona come segue:
-
Alla prima esecuzione, il blocco recupera tutti i record.
- Nelle esecuzioni successive, il blocco recupera solo i valori nuovi e aggiornati nello stesso formato di record.
- Se è stato aggiornato un solo valore in un record, questo blocco restituirà solo quel valore (insieme alle chiavi primarie e ai parametri updatedAt e updatedBy). Se la stessa cella è stata aggiornata più volte tra due esecuzioni di questo blocco, allora solo l'aggiornamento finale (il valore "attuale") verrà restituito da questo blocco.
Elenco del rendiconto delle modifiche dell'archiviazione
Il blocco List Change Store History utilizza l'endpoint /changes dell'API e restituisce il rendiconto completo per ogni cella. Se una cella è stata aggiornata più volte, allora questo blocco restituirà ogni valore, userId e il timestamp updatedAt per ogni aggiornamento.
Blocco List Change Store History in Qlik Automate
Autorizzazioni
Per creare grafici di scrittura tabelle e interagire con change-stores API, sono necessarie autorizzazioni specifiche. Per ulteriori informazioni, vedere Autorizzazioni di scrittura tabelle.