Wijzigingen extraheren uit schrijftabellen

Wanneer gebruikers gegevens toevoegen in bewerkbare kolommen binnen schrijftabellen, worden hun wijzigingen niet toegepast op het gegevensmodel van de applicatie. Ze zijn ook tijdelijk—wijzigingen worden opgeslagen in door Qlik beheerde wijzigingsopslagen gedurende 90 dagen, waarna ze worden verwijderd.

U kunt deze wijzigingen ophalen via de change-stores API. De wijzigingen kunnen op verschillende manieren worden gebruikt, waaronder:

• Laad de wijzigingen in QVD's of applicaties voor permanente opslag en gebruik binnen Qlik Cloud.

• Extraheer de wijzigingen en voeg ze toe aan externe systemen zoals Excel-spreadsheets of SQL-databases.

• Integreer de gegevens dynamisch in geautomatiseerde processen, zoals het verzenden van e-mails en het inkopen van voorraad.

• Bouw uw eigen apps en integreer aanroepen naar de change-stores API in uw operationele workflows.

Vereisten

Voordat u toegang krijgt tot de gegevens die zijn opgeslagen in de wijzigingsopslag, moet u toegang kunnen krijgen tot de change-stores API. Hiervoor hebt u het volgende nodig:

• API-sleutel voor de Qlik Cloud-tenant. Zie API-sleutels beheren.

• De vereiste machtigingen voor het werken met aantekeningtabellen, toegewezen door tenantbeheerders. Zie:

  • Machtigingen instellen voor aantekeningtabellen (capaciteitsgebaseerde abonnementen)

  • Machtigingen instellen voor aantekeningtabellen (gebruikersgebaseerde abonnementen)

• De wijzigingsopslag-id: Dit kan worden opgehaald na het maken van de aantekeningtabel op een werkblad. Zie Werken met wijzigingsarchieven.

Beschikbare tools voor het extraheren van wijzigingen

U kunt de volgende tools gebruiken om wijzigingen uit de change-stores API te extraheren en te gebruiken:

• Qlik Automate

• De REST-connector beschikbaar met Qlik-scripts en gegevensvoorbereiding.

Voor voorbeelden en gebruiksscenario's gaat u naar:

• Wijzigingen van aantekeningtabel extraheren met Qlik Automate

• Wijzigingen van aantekeningtabel extraheren met de REST‑connector

• Gebruiksscenario's voor schrijftabellen

Wijzigingen van aantekeningtabel extraheren met Qlik Automate

De wijzigingen die zijn opgeslagen in de wijzigingsopslag kunnen worden geëxtraheerd met behulp van de Change Store blokken in de Qlik Cloud Services-connector in Qlik Automate. Deze connector maakt automatisch verbinding met het Qlik-account van de eigenaar van de automatisering, zodat er geen extra stappen nodig zijn om te verifiëren.

Meer informatie over Qlik Automate is beschikbaar op Qlik Automate.

Huidige wijzigingen uit wijzigingsopslag weergeven

Het List Current Changes From Change Store blok gebruikt het API-eindpunt /changes/tabular-views en retourneert alleen de meest recente waarde voor elke cel (met andere woorden, het retourneert de huidige waarden). Het retourneert deze waarden als een lijst met objecten, waarbij elk object de primaire sleutels en de wijzigingswaarden bevat. Elke record wordt ook uitgebreid met een updatedAt tijdstempel voor de datum en tijd waarop de laatste update van de record is uitgevoerd en een updatedBy gebruikers-id voor de gebruiker die deze wijziging heeft aangebracht.

Presentatie van wijzigingen in de opslag weergeven

Het blok List Change Store History gebruikt het API-eindpunt /changes en retourneert de volledige presentatie voor elke cel. Als een cel meerdere keren is bijgewerkt, dan retourneert dit blok elke waarde, userId en updatedAt tijdstempel voor elke update.

Werken met sjablonen

U kunt ook beginnen met een automatiseringssjabloon als u de gegevens naar een MySQL-database extraheert. De volgende sjablonen zijn beschikbaar onder Insights to Action:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Deze sjablonen rangschikken de Change Store blokken (hierboven beschreven) met andere blokken om u te helpen de gegevens sneller te extraheren. Pas eenvoudig de blokparameters aan om verbinding te maken met uw bronnen. Voor een gedetailleerde uitleg, zie dit Community-artikel.

Wijzigingen van aantekeningtabel extraheren met de REST‑connector

Dit voorbeeld laat zien hoe u een REST‑verbinding kunt configureren met de change-stores API. Deze verbinding kan worden gebruikt om gegevens uit de API te halen en vervolgens wijzigingen terug te laden in een applicatie of op te slaan in QVD's binnen Qlik Cloud.

Doe het volgende:

1. Maak in Qlik Cloud Analyse een nieuwe verbinding met de REST-connector. Zie Gegevensverbindingen toevoegen.

2. Stel de volgende parameters in voor de verbinding:

   • 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