Änderungen aus Schreibtabellen extrahieren

Wenn Benutzer Daten in bearbeitbaren Spalten innerhalb von Schreibtabellen hinzufügen, werden ihre Änderungen nicht auf das Datenmodell der Anwendung angewendet. Sie sind zudem temporär – Änderungen werden maximal 90 Tage in von Qlik verwalteten Änderungsspeichern gespeichert, danach werden sie gelöscht.

Sie können diese Änderungen über die Change-Stores API abrufen. Die Änderungen können auf verschiedene Weise genutzt werden, unter anderem:

• Laden Sie die Änderungen in QVDs oder Anwendungen zur dauerhaften Speicherung und Nutzung in Qlik Cloud.

• Extrahieren Sie die Änderungen und fügen Sie sie externen Systemen hinzu, wie z. B. Excel-Arbeitsblättern oder SQL-Datenbanken.

• Integrieren Sie die Daten dynamisch in automatisierte Prozesse, wie z. B. Senden von E-Mails und Auffüllen von Lagerbeständen.

• Erstellen Sie eigene Apps und integrieren Sie Aufrufe an die Change-Stores API in Ihre betrieblichen Abläufe.

Voraussetzungen

Bevor Sie auf die im Änderungsspeicher gespeicherten Daten zugreifen können, benötigen Sie Zugriff auf die Change-Stores API. Hierzu benötigen Sie Folgendes:

• API-Schlüssel für den Qlik Cloud Mandanten. Siehe Verwalten von API-Schlüsseln.

• Die erforderlichen Berechtigungen zum Arbeiten mit Schreibtabellen, die von Mandantenadministratoren zugewiesen wurden. Siehe:

  • Festlegen von Berechtigungen für Schreibtabellen (kapazitätsbasierte Abonnements)

  • Festlegen von Berechtigungen für Schreibtabellen (benutzerbasierte Abonnements)

• Die ID des Änderungsspeichers. Diese kann nach dem Erstellen der Schreibtabelle in einem Arbeitsblatt abgerufen werden. Siehe Arbeiten mit Änderungsspeichern.

Verfügbare Tools zum Extrahieren von Änderungen

Sie können die folgenden Tools verwenden, um Änderungen aus der Change-Stores API zu extrahieren und zu verwenden:

• Qlik Automate

• Der REST-Konnektor, der mit Qlik Skripterstellung und Datenaufbereitung verfügbar ist.

Beispiele und Anwendungsfälle finden Sie unter:

• Extrahieren von Schreibtabellenänderungen mit Qlik Automate

• Extrahieren von Schreibtabellenänderungen mit dem REST-Konnektor

• Anwendungsfälle für Schreibtabellen

Extrahieren von Schreibtabellenänderungen mit Qlik Automate

Die im Änderungsspeicher gespeicherten Änderungen können mithilfe der Change Store-Blöcke im Qlik Cloud Services Konnektor in Qlik Automate extrahiert werden. Dieser Konnektor verbindet sich automatisch mit dem Qlik Konto des Automatisierungsbesitzers, sodass keine zusätzlichen Schritte zur Authentifizierung erforderlich sind.

Weitere Informationen zu Qlik Automate finden Sie unter Qlik Automate.

Auflisten aktueller Änderungen aus dem Änderungsspeicher

Der List Current Changes From Change Store-Block verwendet den API-Endpunkt /changes/tabular-views und gibt nur den jeweils aktuellen Wert für jede Zelle zurück (anders ausgedrückt gibt er die aktuellen Werte zurück). Diese Werte werden als Liste von Objekten zurückgegeben, wobei jedes Objekt die Primärschlüssel und die Änderungswerte enthält. Jeder Datensatz wird außerdem um einen Zeitstempel vom Typ updatedAt für das Datum und die Uhrzeit der letzten Aktualisierung des Datensatzes sowie um eine Benutzer-ID vom Typ updatedBy für den Benutzer erweitert, der diese Änderung vorgenommen hat.

Auflisten des Änderungsspeicherverlaufs

Der List Change Store History-Block verwendet den API-Endpunkt /changes und gibt den vollständigen Verlauf für jede Zelle zurück. Wenn eine Zelle mehrmals aktualisiert wurde, gibt dieser Block jeden Wert, die userId und den Zeitstempel updatedAt für jede Aktualisierung zurück.

Arbeiten mit Vorlagen

Sie können auch mit einer Automatisierungsvorlage beginnen, wenn Sie die Daten in eine MySQL-Datenbank extrahieren. Die folgenden Vorlagen sind unter Insights to Action verfügbar:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Diese Vorlagen ordnen die Change Store-Blöcke (oben beschrieben) mit anderen Blöcken an, damit Sie die Daten schneller extrahieren können. Passen Sie einfach die Blockparameter an, um eine Verbindung zu Ihren Ressourcen herzustellen. Eine detaillierte Anleitung finden Sie in diesem Community-Artikel.

Extrahieren von Schreibtabellenänderungen mit dem REST-Konnektor

Dieses Beispiel zeigt, wie Sie eine REST-Verbindung zur Change-Stores API konfigurieren können. Diese Verbindung kann verwendet werden, um Daten aus der API abzurufen und die Änderungen dann wieder in eine Anwendung zu laden oder in QVDs innerhalb von Qlik Cloud zu speichern.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie in Qlik Cloud Analytics eine neue Verbindung zum REST-Konnektor. Siehe Hinzufügen von Datenverbindungen.

2. Legen Sie die folgenden Parameter für die Verbindung fest:

   • 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