Verwenden von Datenprodukten in Anwendungen

Analytics-Entwickler können Datenprodukte mitsamt ihren semantischen Modellen mithilfe des Datenkatalogs in Analyseanwendungen laden. Der Datenkatalog generiert das erforderliche Skript und erstellt Master-Elemente für Kennzahlen und Dimensionen.

Wenn Sie ein Datenprodukt nutzen, generiert der Datenkatalog eine IncludeModel-Skriptanweisung, die die ausgewählten Tabellen, Beziehungen, Kennzahlen und Dimensionen in Ihre Anwendung lädt. Kennzahlen und Dimensionen aus dem semantischen Modell erscheinen automatisch als Master-Elemente, bereit zur Verwendung in Visualisierungen.

Voraussetzungen

Um ein Datenprodukt und sein semantisches Modell zu nutzen, benötigen Sie:

Berechtigungen

Um das semantische Modell von Datenprodukten in freigegebenen, verwalteten und Datenbereichen zu nutzen, benötigen Sie die Berechtigung Kann Daten nutzen oder Kann anzeigen in dem Bereich, der das Datenprodukt enthält.

Weitere Einzelheiten finden Sie unter Rollen und Berechtigungen für Datenprodukte.

Zugängliche Datensätze

Sie müssen Zugriff auf die Datasets sowie auf die Verbindungen zu den zugrunde liegenden Daten haben, die im semantischen Modell enthalten sind.

Eindeutiger Datenproduktname

Das Datenprodukt muss innerhalb des Space einen eindeutigen Namen haben. Wenn eine Anwendung bereits ein Datenprodukt mit demselben Namen enthält, schlägt das Laden des semantischen Modells fehl.

Konsumieren eines Datenprodukts und eines semantischen Modells über das Datenprodukt

Sie können eine Analyseanwendung direkt aus einem Datenprodukt erstellen. Sie können verfeinern, was aus dem Datenprodukt und seinem semantischen Modell verwendet werden soll: Datensätze, Felder und Master-Elemente.

1. Öffnen Sie das Datenprodukt, entweder indem Sie eines aus dem Datenmarktplatz auswählen oder den Katalog durchsuchen.

2. Klicken Sie in der Kopfzeile des Datenproduktnamens auf Verwenden in > Anwendung.

   

3. Überprüfen Sie im Fenster Neue Anwendung erstellen das semantische Modell und die Daten, die geladen werden.
4. Klicken Sie auf Weiter.

   Die Dateneditor der neu erstellten Anwendung öffnet sich, und Sie werden zum Datenkatalog weitergeleitet. Das Datenprodukt ist standardmäßig ausgewählt, aber Sie können suchen, Ihre Auswahl verfeinern und die Daten überprüfen, bevor Sie sie in die Anwendung laden. Weitere Informationen finden Sie unter Ein Datenprodukt und semantisches Modell über die Dateneditor nutzen.

5. Wenn Sie bereit sind, klicken Sie auf Daten laden.

Nachdem die Daten geladen wurden, können Sie damit beginnen, Arbeitsblätter hinzuzufügen und an der Anwendung zu arbeiten, oder zum Dateneditor navigieren, um das Skript bei Bedarf zu überprüfen und zu bearbeiten. Die Tabellen, Beziehungen, Measures und Dimensionen des semantischen Modells stehen jetzt zur Verwendung zur Verfügung.

Weitere Informationen zur Visualisierung von Daten in Arbeitsblättern finden Sie unter Erstellen von Analysen und Visualisieren von Daten.

Ein Datenprodukt und semantisches Modell über die Dateneditor nutzen

Der Datenkatalog bietet eine Benutzeroberfläche zum Durchsuchen und Auswählen von Daten und Informationen zum semantischen Modell aus Datenprodukten, anstatt manuell ein Skript einzugeben.

So laden Sie ein Datenprodukt und sein semantisches Modell:

1. Öffnen Sie eine Anwendung.
2. Klicken Sie im oberen Navigationsbalken auf Dateneditor.
3. Klicken Sie im rechten Bereich Daten hinzufügen auf Aus Datenkatalog hinzufügen.
4. Das Datenkatalog-Modal wird geöffnet und zeigt verfügbare Daten an, einschließlich Datenprodukten mit semantischen Modellen.

   

Datenprodukte durchsuchen

Der Datenkatalog zeigt Datenprodukte an, die semantische Modelle enthalten. Sie können Datenprodukte nach Name, Beschreibung oder Tags durchsuchen und nach ihnen suchen.

Klicken Sie auf ein Datenprodukt, um eine Zusammenfassung dessen anzuzeigen, was in das Anwendungsskript geladen wird, einschließlich Tabellen, Kennzahlen und Dimensionen.

Wenn ein Datensatz im semantischen Modell nicht zugänglich ist, wird er mit einem Warnindikator gekennzeichnet. Sie können weiterhin damit verknüpfte Measures und Dimensionen verwenden, die sich im semantischen Modell befinden, aber die nicht zugänglichen Datasets und ihre Felder sind Ausgeschlossen.

Auswählen und Verfeinern eines semantischen Modells

Nachdem Sie ausgewählt haben, welches Datenprodukt verwendet werden soll, können Sie Ihre Auswahl verfeinern und genau auswählen, welche Komponenten des semantischen Modells in Ihre Anwendung einbezogen werden sollen.

1. Bewegen Sie den Mauszeiger über das ausgewählte Datenprodukt und klicken Sie auf Auswahl verfeinern.

   

   Es stehen drei neue Registerkarten zur Verfügung, über die Sie durch Elemente des Datenprodukts navigieren können:

   • Tabellen/Felder
   • Dimensionen
   • Kennzahlen
2. Verwenden Sie die Kontrollkästchen, um Ihre Auswahl zu verfeinern und auszuwählen, welche Datensätze, Felder, Kennzahlen und Dimensionen einbezogen werden sollen.
Tipphinweis

Fortgeschrittene Benutzer können Hinzugefügte Elemente beim Neuladen automatisch einschließen umschalten, um zu steuern, ob neue Elemente automatisch eingeschlossen werden, wenn sich das semantische Modell ändert.

Wenn aktiviert, werden neue Felder, Kennzahlen und Dimensionen, die dem semantischen Modell hinzugefügt wurden, beim Neuladen automatisch dem Datenmodell und den Master-Elementen hinzugefügt. Dies gilt nur, wenn jeweils alle Felder, Kennzahlen und Dimensionen ausgewählt sind.

3. Wenn Ihre Auswahl bereit ist, klicken Sie auf Skript einfügen.

Das generierte IncludeModel-Skript wird in das Ladeskript eingefügt und kann im Dateneditor angezeigt und bearbeitet werden. Um die Daten in die Anwendung zu laden, klicken Sie auf Daten laden.

Nachdem die Daten geladen wurden, können Sie mit dem Hinzufügen von Arbeitsblättern beginnen und an der Anwendung arbeiten. Weitere Informationen finden Sie unter Erstellen von Analysen und Visualisieren von Daten.

Auto-Include verstehen

Die Auto-Include-Funktion steuert, wie Ihre Anwendung reagiert, wenn sich das semantische Modell ändert.

Wenn die automatische Einbindung für einen Komponententyp aktiviert ist, verwendet das generierte Skript einen Wildcard-Selektor (*):

• Fields *: Enthält alle Felder der angegebenen Tabelle.
• WithMeasures: *: Enthält alle Kennzahlen als Master-Elemente.
• WithDimensions: *: Enthält alle Dimensionen als Master-Elemente.

Wenn die automatische Einbindung deaktiviert ist, listet das Skript die ausgewählten Elemente explizit auf. Beispiel:

• WithMeasures [Total sales], [Total quantity]: Schließt nur die angegebenen Kennzahlen ein.
• WithDimensions [Region], [Product]: Enthält nur die angegebenen Dimensionen.

Auto-include wird für fortgeschrittene Benutzer empfohlen, um den Wartungsaufwand zu reduzieren und sicherzustellen, dass Ihre Anwendung von Verbesserungen am semantischen Modell profitiert. Deaktivieren Sie das automatische Einschließen, wenn Sie eine strikte Kontrolle darüber benötigen, welche Elemente eingeschlossen werden.

Das generierte IncludeModel-Skript verstehen

Die Daten generieren eine IncludeModel-Skriptanweisung, die auf das semantische Modell verweist und angibt, welche Komponenten geladen werden sollen.

Beispielskript

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Skriptparameter:

• IncludeModel: Der Name des Datenprodukts, das das semantische Modell enthält.
• FromSpace: Gibt den Bereich an, der das Datenprodukt enthält.
• WithTables: Gibt an, welche Tabellen einbezogen werden sollen.
• Table: Gibt eine Tabelle an, die eingeschlossen werden soll. Sie können für jede Tabelle, die Sie verwenden möchten, durch Kommas getrennte Table-Anweisungen angeben.
• Fields: Gibt an, welche Felder aus der angegebenen Tabelle einbezogen werden sollen. Verwenden Sie * für alle Felder oder eine kommagetrennte Liste von Feldern.
• Connection: Gibt den Standort der Tabelle unter Verwendung des Formats environment:space:connection, space:connection oder connection an.
• WithMeasures: Gibt an, welche Kennzahlen als Master-Kennzahlen einbezogen werden sollen. Verwenden Sie * für alle Kennzahlen oder eine Liste bestimmter Kennzahlennamen.
• WithDimensions: Gibt an, welche Dimensionen als Master-Dimensionen eingeschlossen werden sollen. Verwenden Sie * für alle Dimensionen oder eine Liste bestimmter Dimensionsnamen.

Sie können die IncludeModel-Anweisung manuell bearbeiten, um anzupassen, welche Elemente enthalten sind, oder um zwischen dem Wildcard- und dem expliziten Auswahlmodus zu wechseln.

Ausführliche Informationen zur IncludeModel-Anweisung finden Sie unter IncludeModel.

Feld- und Tabellenbenennung

Wenn ein Datenprodukt in eine Anwendung geladen wird, können Feld- und Tabellennamen automatisch angepasst werden, um Namenskonflikte zu vermeiden und Beziehungen gemäß den Analysemustern von Qlik in namensbasierte Assoziationen umzuwandeln.

• Gleichnamige Felder ohne Beziehung: Wenn zwei Tabellen ein Feld mit demselben Namen enthalten, die Felder jedoch keine Beziehung aufweisen, werden die Feldnamen automatisch mit ihrem Tabellennamen qualifiziert (z. B. TableName.FieldName), um eine unbeabsichtigte automatische Verknüpfung in der Anwendung zu verhindern.
• Felder mit einer Beziehung: Wenn die beiden Felder eine Beziehung, aber unterschiedliche Namen haben, werden sie beim Laden in eine Anwendung in denselben Namen, den Namen der Beziehung, umbenannt, um eine Assoziation zu bilden.

• Zusammengesetzte Schlüssel: Bei zusammengesetzten Schlüsseln wird den beteiligten Tabellen ein neues Schlüsselfeld hinzugefügt.

• Gleichnamige Tabellen: Wenn zwei Tabellen denselben Namen haben, werden sie automatisch durch Anhängen eines numerischen Suffixes umbenannt, zum Beispiel TableName_1, TableName_2 und so weiter.

Arbeiten mit vererbten Master-Elementen

Wenn Sie eine Anwendung neu laden, die eine IncludeModel-Anweisung enthält, erscheinen Kennzahlen und Dimensionen aus dem semantischen Modell automatisch im Bereich „Master-Elemente“.

So verwenden Sie Master-Elemente aus einem semantischen Modell:

1. Laden Sie die Anwendung neu, um Daten aus dem semantischen Modell zu laden.
2. Öffnen Sie ein Arbeitsblatt im Bearbeitungsmodus.
3. Klicken Sie im linken Bereich auf Master-Elemente.
4. Die Kennzahlen und Dimensionen aus dem semantischen Modell erscheinen in der Liste mit einem Datenprodukt-Indikator.

   

5. Ziehen Sie eine Master-Kennzahl oder Dimension auf eine Visualisierung, um sie zu verwenden.

Aus semantischen Modellen geerbte Master-Elemente zeigen den Namen und die Beschreibung ihres Quelldatenprodukts an. Sie können den von der Kennzahl oder Dimension verwendeten Ausdruck anzeigen, indem Sie mit der Maus darauf zeigen.

Master-Element-Eigenschaften

Die meisten Attribute von Master-Elementen, die von semantischen Modellen geerbt wurden, sind in der konsumierenden Anwendung schreibgeschützt. Einige andere Master-Element-Attribute, wie beispielsweise jene, die sich auf Visualisierungen beziehen, können weiterhin innerhalb der Anwendung bearbeitet werden.

Das schreibgeschützte Verhalten gilt nur für die Benutzeroberfläche – Sie können eine Reihe von Master-Element-Eigenschaften über die API festlegen:

• Eigenschaften, die im semantischen Modell konfigurierbar, aber in der Benutzeroberfläche der konsumierenden Anwendung schreibgeschützt sind. Dies umfasst Titel, Beschreibung und Tags.

• Eigenschaften, die nicht im semantischen Modell konfiguriert sind und in der Benutzeroberfläche der nutzenden Anwendung nicht bereitgestellt werden.

Änderungen an Eigenschaften, die durch das semantische Modell definiert sind, werden beim Neuladen der Anwendung überschrieben.

Löschen von Master-Elementen

In einer unveröffentlichten Anwendung können Sie ein vererbtes Master-Element löschen, aber es wird beim nächsten Laden wieder angezeigt, wenn im IncludeModel-Skript weiterhin darauf verwiesen wird. Um es dauerhaft zu entfernen, entfernen Sie es zuerst aus dem Skript. Sie können auch ein vererbtes Master-Element duplizieren. Das durch Duplizieren erstellte Element ist ein gewöhnliches Anwendungs-Master-Element und ist vollständig bearbeitbar.

Master-Elemente und Veröffentlichen von Anwendungen

Wenn eine Anwendung veröffentlicht wird, bleiben ihre geerbten Master-Elemente an die Version des Datenprodukts gebunden, die bei der Veröffentlichung der Anwendung verwendet wurde. Das Neuladen einer veröffentlichten App erstellt, aktualisiert oder löscht keine Master-Elemente aus dem Datenprodukt. Um neue oder geänderte Kennzahlen und Dimensionen zu verwenden, aktualisieren Sie die Anwendung und veröffentlichen Sie sie erneut.

Behandeln von Aktualisierungen des semantischen Modells in einer Anwendung

Wenn sich das semantische Modell ändert, nachdem Sie es verwendet haben, können Sie Ihre Anwendung aktualisieren, um die Änderungen widerzuspiegeln.

Wenn Sie den Auto-Include-Modus mit Wildcard-Selektoren verwendet haben, werden neue Kennzahlen und Dimensionen automatisch einbezogen. Wenn Sie die explizite Auswahl verwendet haben, werden nur die Elemente geladen, die Sie ursprünglich ausgewählt haben.

So fügen Sie neue Elemente aus dem semantischen Modell hinzu:

1. Öffnen Sie Dateneditor.
2. Suchen Sie die Anweisung IncludeModel in Ihrem Skript.
3. Bearbeiten Sie die Anweisung, um neue Elemente hinzuzufügen oder Selektoren für die automatische Einbindung auf * zu ändern.
4. Laden Sie die Anwendung.

Alternativ können Sie die bestehende IncludeModel-Anweisung entfernen und den Datenkatalog verwenden, um eine neue mit aktualisierten Auswahlen zu generieren.

Datenprodukte in anderen Tools nutzen

In Skript ist es möglich, Datenprodukte zu konsumieren, aber die Kennzahlen und Dimensionen werden ignoriert.

Beim Verwenden von Datenprodukten in anderen Extras als Anwendungen und Skripten (wie Datenflüssen und Tabellenrezepten) fungiert das Datenprodukt als eine Reihe vertrauenswürdiger Datasets, aus denen ausgewählt werden kann. Diese Tools verwenden die Datensätze als Quellen und das Datenprodukt wird in der Herkunft nicht als Quellknoten angezeigt.