Dataproducten consumeren in applicaties

Analytics-ontwikkelaars kunnen dataproducten, inclusief hun semantische modellen, laden in analyticstoepassingen met behulp van de datacatalogus. De datacatalogus genereert het benodigde script en maakt master-items aan voor metingen en dimensies.

Wanneer u een dataproduct gebruikt, genereert de datacatalogus een IncludeModel-scriptinstructie die de geselecteerde tabellen, relaties, meetwaarden en dimensies in uw toepassing laadt. Metingen en dimensies uit het semantisch model verschijnen automatisch als masteritems, klaar voor gebruik in visualisaties.

Vereisten

Om een dataproduct en het bijbehorende semantisch model te consumeren, hebt u het volgende nodig:

Machtigingen

Om het semantisch model van dataproducten in gedeelde, beheerde en dataruimten te consumeren, hebt u de machtiging Mag gegevens consumeren of Mag weergeven nodig in de ruimte die het dataproduct bevat.

Zie voor volledige details Rollen en machtigingen voor gegevensproducten.

Toegankelijke datasets

U moet toegang hebben tot de gegevenssets, evenals tot de verbindingen met de onderliggende gegevens, die zijn opgenomen in het semantisch model.

Unieke dataproductnaam

Het dataproduct moet een unieke naam hebben binnen de ruimte. Als een applicatie al een dataproduct met dezelfde naam bevat, mislukt het laden van het semantisch model.

Een dataproduct en semantisch model consumeren via het dataproduct

U kunt rechtstreeks een analyse-app maken op basis van een gegevensproduct. U kunt verfijnen wat u gebruikt uit het dataproduct en het bijbehorende semantisch model: datasets, velden en masteritems.

1. Open het dataproduct door er een te selecteren op de datamarktplaats of door in de catalogus te bladeren.

2. Klik in de header van de dataproductnaam op Gebruiken in > Applicatie.

   

3. Controleer in het venster Een nieuwe toepassing maken het semantisch model en de gegevens die worden geladen.
4. Klik op Doorgaan.

   De Editor voor laden van gegevens van de zojuist gemaakte applicatie wordt geopend en u wordt doorgestuurd naar de gegevenscatalogus. Het dataproduct is standaard geselecteerd, maar u kunt bladeren, uw selectie verfijnen en de gegevens controleren voordat u deze in de toepassing laadt. Voor meer informatie, zie Een dataproduct en semantisch model consumeren via de Editor voor laden van gegevens.

5. Wanneer u klaar bent, klikt u op Gegevens laden.

Nadat de gegevens zijn geladen, kunt u beginnen met het toevoegen van werkbladen en aan de toepassing werken, of naar de Editor voor laden van gegevens navigeren om indien nodig het script te inspecteren en te wijzigen. De tabellen, relaties, metingen en dimensies van het semantisch model zijn nu beschikbaar voor gebruik.

Voor meer informatie over het visualiseren van gegevens in werkbladen, zie Analyses maken en gegevens visualiseren.

Een dataproduct en semantisch model consumeren via de Editor voor laden van gegevens

De datacatalogus biedt een interface voor het bladeren door en selecteren van data en informatie over het semantisch model uit dataproducten, in plaats van handmatig script in te voeren.

Om een dataproduct en het bijbehorende semantische model te laden:

1. Applicatie openen.
2. Klik op Editor voor laden van gegevens in de bovenste navigatiestaaf.
3. Klik in het rechterpaneel Gegevens toevoegen op Toevoegen vanaf gegevenscatalogus.
4. Het modale venster van de datacatalogus wordt geopend en toont de beschikbare gegevens, waaronder dataproducten met semantische modellen.

   

Bladeren door gegevensproducten

De datacatalogus toont dataproducten die semantische modellen bevatten. U kunt door dataproducten bladeren en ernaar zoeken op naam, beschrijving of tags.

Klik op een dataproduct om een samenvatting te bekijken van wat er in het applicatiescript wordt geladen, inclusief tabellen, metingen en dimensies.

Als een dataset in het semantisch model niet toegankelijk is, wordt deze gemarkeerd met een waarschuwingsindicator. U kunt nog steeds meetwaarden en dimensies gebruiken die hieraan gerelateerd zijn en zich in het semantisch model bevinden, maar de ontoegankelijke datasets en de bijbehorende velden zijn uitgesloten.

Een semantisch model selecteren en verfijnen

Nadat u hebt geselecteerd welk dataproduct u wilt gebruiken, kunt u uw selectie verfijnen en precies kiezen welke componenten van het semantisch model u in uw applicatie wilt opnemen.

1. Beweeg de muisaanwijzer over het geselecteerde dataproduct en klik op Selectie verfijnen.

   

   Er zijn drie nieuwe tabbladen beschikbaar waarin u door elementen van het dataproduct kunt navigeren:

   • Tabellen/velden
   • Dimensies
   • Metingen
2. Gebruik de selectievakjes om uw selectie te verfijnen en te kiezen welke datasets, velden, meetwaarden en dimensies moeten worden opgenomen.
Tip

Geavanceerde gebruikers kunnen Toegevoegde items automatisch opnemen bij opnieuw laden in- of uitschakelen om te bepalen of nieuwe items automatisch worden opgenomen wanneer het semantisch model verandert.

Wanneer ingeschakeld, worden nieuwe velden, metingen en dimensies die zijn toegevoegd aan het semantisch model bij het opnieuw laden automatisch toegevoegd aan het gegevensmodel en de masteritems. Dit is alleen van toepassing wanneer respectievelijk alle velden, meetwaarden en dimensies zijn aangevinkt.

3. Wanneer uw selectie gereed is, klikt u op Script invoegen.

Het gegenereerde IncludeModel-script wordt ingevoegd in het load-script en kan worden bekeken en bewerkt in de Editor voor laden van gegevens. Om de gegevens in de applicatie te laden, klikt u op Gegevens laden.

Nadat de gegevens zijn geladen, kunt u beginnen met het toevoegen van werkbladen en aan de applicatie werken. Zie voor meer informatie Analyses maken en gegevens visualiseren.

Inzicht in auto-include

De functie voor automatisch opnemen bepaalt hoe uw toepassing reageert wanneer het semantisch model verandert.

Wanneer auto-include is ingeschakeld voor een componenttype, gebruikt het gegenereerde script een jokerteken (*)-selector:

• Fields *: Bevat alle velden uit de opgegeven tabel.
• WithMeasures: *: Bevat alle meetwaarden als masteritems.
• WithDimensions: *: Bevat alle dimensies als hoofditems.

Wanneer automatisch opnemen is uitgeschakeld, vermeldt het script expliciet de geselecteerde items. Bijvoorbeeld:

• WithMeasures [Total sales], [Total quantity]: Bevat alleen de opgegeven meetwaarden.
• WithDimensions [Region], [Product]: Bevat alleen de opgegeven dimensies.

Automatisch opnemen wordt aanbevolen voor geavanceerde gebruikers om onderhoud te verminderen en ervoor te zorgen dat uw toepassing profiteert van verbeteringen aan het semantisch model. Schakel automatisch opnemen uit als u strikte controle wilt over welke items worden opgenomen.

Het gegenereerde IncludeModel-script begrijpen

De gegevens genereren een IncludeModel-scriptinstructie die verwijst naar het semantisch model en specificeert welke componenten moeten worden geladen.

Voorbeeldscript

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 *;

Scriptparameters:

• IncludeModel: De naam van het dataproduct dat het semantisch model bevat.
• FromSpace: Specificeert de space die het dataproduct bevat.
• WithTables: Geeft aan welke tabellen moeten worden opgenomen.
• Table: Geeft een op te nemen tabel aan. U kunt Table-instructies opnemen voor elke tabel die u wilt gebruiken, gescheiden door komma's.
• Fields: Geeft aan welke velden moeten worden opgenomen uit de opgegeven tabel. Gebruik * voor alle velden of een door komma's gescheiden lijst met velden.
• Connection: Geeft de locatie van de tabel aan met behulp van de indeling environment:space:connection, space:connection of connection.
• WithMeasures: Geeft aan welke metingen moeten worden opgenomen als hoofdmetingen. Gebruik * voor alle meetwaarden of een lijst met specifieke meetwaardenamen.
• WithDimensions: Geeft aan welke dimensies als masterdimensies moeten worden opgenomen. Gebruik * voor alle dimensies of een lijst met specifieke dimensienamen.

U kunt de IncludeModel-instructie handmatig bewerken om aan te passen welke items worden opgenomen of om te schakelen tussen jokerteken- en expliciete selectiemodi.

Voor alle details over de instructie IncludeModel, zie IncludeModel.

Veld- en tabelnaamgeving

Wanneer een dataproduct in een applicatie wordt geladen, kunnen veld- en tabelnamen automatisch worden aangepast om naamconflicten te voorkomen en om relaties om te zetten in op naam gebaseerde associaties volgens de analysepatronen van Qlik.

• Velden met dezelfde naam zonder relatie: Als twee tabellen een veld met dezelfde naam bevatten, maar de velden geen relatie hebben, worden de veldnamen automatisch gekwalificeerd met hun tabelnaam (bijvoorbeeld TableName.FieldName) om een onbedoelde automatische associatie in de applicatie te voorkomen.
• Velden met een relatie: als de twee velden een relatie hebben maar verschillende namen hebben, worden ze hernoemd naar dezelfde naam, de naam van de relatie, wanneer ze in een toepassing worden geladen om een associatie te vormen.

• Samengestelde sleutels: Voor samengestelde sleutels wordt een nieuw sleutelveld toegevoegd aan de betrokken tabellen.

• Tabellen met dezelfde naam: Als twee tabellen dezelfde naam hebben, worden ze automatisch hernoemd door een numeriek achtervoegsel toe te voegen, bijvoorbeeld TableName_1, TableName_2, enzovoort.

Werken met overgeërfde masteritems

Wanneer u een toepassing opnieuw laadt die een IncludeModel-instructie bevat, verschijnen meetwaarden en dimensies uit het semantisch model automatisch in het deelvenster hoofditems.

Om hoofditems uit een semantisch model te gebruiken:

1. Laad de applicatie opnieuw om gegevens uit het semantisch model te laden.
2. Open een werkblad in de bewerkingsmodus.
3. Klik in het linkerpaneel op Hoofditems.
4. De meetwaarden en dimensies uit het semantische model verschijnen in de lijst met een gegevensproductindicator.

   

5. Sleep een mastermeting of dimensie naar een visualisatie om deze te gebruiken.

Masteritems die zijn overgeërfd van semantische modellen tonen de naam en beschrijving van hun brondataproduct. U kunt de expressie bekijken die door de meting of dimensie wordt gebruikt door de muisaanwijzer erboven te houden.

Eigenschappen van masteritems

De meeste attributen van masteritems die zijn overgenomen van semantische modellen, zijn alleen-lezen in de consumerende applicatie. Sommige andere masteritem-attributen, zoals die met betrekking tot visualisaties, kunnen nog steeds binnen de applicatie worden bewerkt.

Het alleen-lezen-gedrag is alleen van toepassing op de gebruikersinterface—u kunt via de API een aantal masteritem-eigenschappen instellen:

• Eigenschappen die configureerbaar zijn in het semantisch model, maar alleen-lezen zijn in de gebruikersinterface van de consumerende toepassing. Dit omvat de titel, beschrijving en tags.

• Eigenschappen die niet zijn geconfigureerd in het semantisch model en niet worden weergegeven in de gebruikersinterface van de consumerende toepassing.

Wijzigingen in eigenschappen die zijn gedefinieerd door het semantisch model worden overschreven wanneer de applicatie opnieuw wordt geladen.

Masteritem verwijderen

In een niet-gepubliceerde applicatie kunt u een overgeërfd masteritem verwijderen, maar het verschijnt opnieuw bij de volgende herlaadbeurt als er nog steeds naar wordt verwezen in het IncludeModel-script. Om het permanent te verwijderen, verwijdert u het eerst uit het script. U kunt ook een overgeërfd masteritem dupliceren. Het dupliceren is een gewoon applicatiemasteritem en is volledig bewerkbaar.

Masteritems en applicaties publiceren

Wanneer een applicatie wordt gepubliceerd, blijven de overgeërfde hoofditems gekoppeld aan de versie van het dataproduct dat werd gebruikt toen de applicatie werd gepubliceerd. Het opnieuw laden van een gepubliceerde applicatie leidt niet tot het maken, bijwerken of verwijderen van master-items uit het dataproduct. Om nieuwe of gewijzigde meetwaarden en dimensies te gebruiken, werkt u de applicatie bij en publiceert u deze opnieuw.

Omgaan met updates van een semantisch model in een toepassing

Als het semantisch model verandert nadat u het hebt gebruikt, kunt u uw toepassing bijwerken om de wijzigingen weer te geven.

Als u de modus voor automatisch opnemen met jokertekenselectoren hebt gebruikt, worden nieuwe meetwaarden en dimensies automatisch opgenomen. Als u expliciete selectie hebt gebruikt, worden alleen de items geladen die u oorspronkelijk hebt geselecteerd.

Om nieuwe items toe te voegen vanuit het semantisch model:

1. Open de Editor voor laden van gegevens.
2. Zoek het statement IncludeModel in uw script.
3. Bewerk de instructie om nieuwe items toe te voegen of selectoren te wijzigen in * voor automatisch opnemen.
4. De applicatie opnieuw laden.

U kunt ook de bestaande IncludeModel-instructie verwijderen en de gegevenscatalogus gebruiken om een nieuwe te genereren met bijgewerkte selecties.

Dataproducten consumeren in andere tools

In Script is het mogelijk om dataproducten te consumeren, maar de meetwaarden en dimensies worden genegeerd.

Bij het consumeren van dataproducten in andere bedrijfsmiddelen dan applicaties en scripts (zoals dataflows en tabelrecepten), fungeert het dataproduct als een set vertrouwde datasets waaruit kan worden gekozen. Deze tools gebruiken de datasets als bronnen en het dataproduct wordt niet weergegeven als bronknooppunt in de herkomst.