Estrazione delle modifiche dalle tabelle di scrittura

Quando gli utenti aggiungono dati nelle colonne modificabili all'interno delle tabelle di scrittura, le loro modifiche non vengono applicate al modello dati dell'applicazione. Sono anche temporanee—le modifiche vengono archiviate in archivi delle modifiche gestiti 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 QVD o applicazioni 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:

  • 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 Lavorare con i change store.

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:

• Estrazione delle modifiche dal grafico di scrittura tabelle con Qlik Automate

• Estrazione delle modifiche dal grafico di scrittura tabelle con il connettore REST

• Casi d'uso per le tabelle di scrittura

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 all'indirizzo Qlik Automate.

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.

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.

Utilizzo dei modelli

È inoltre possibile iniziare con un modello di automazione se si stanno estraendo i dati in un database MySQL. I seguenti modelli sono disponibili in Insights to Action:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Questi modelli organizzano i blocchi Change Store (descritti sopra) con altri blocchi per aiutare a estrarre i dati più velocemente. È sufficiente regolare i parametri del blocco per connettersi alle risorse. Per una procedura dettagliata, vedere questo articolo della Community.

Estrazione delle modifiche dal grafico di scrittura tabelle con il connettore REST

Questo esempio mostra come configurare una connessione REST a change-stores API. Questa connessione può essere utilizzata per estrarre dati dall'API e quindi caricare le modifiche in un'applicazione o archiviarle in QVD in Qlik Cloud.

Procedere come indicato di seguito:

1. In Qlik Cloud Analytics, creare una nuova connessione al connettore REST. Vedere Aggiunta di connessioni dati.

2. Impostare i seguenti parametri per la connessione:

   • URL: your_tenant_base_URL/api/analytics/change-stores/your change store id/changes/tabular-views

   • Additional request parameters

     • Query parameters

       • Limit (Key): 100 (Value)

     • Query headers

       • Authorization (Key): Bearer your_API_token (Value)

   • Pagination type: Next URL

     • 'Next url' path: links/next/href