Konsumera dataprodukter i applikationer

Analysutvecklare kan läsa in dataprodukter, med sina semantiska modeller, i analysapplikationer med hjälp av datakatalogen. Datakatalogen genererar det nödvändiga skriptet och skapar huvudobjekt för mått och dimensioner.

När du konsumerar en dataprodukt genererar datakatalogen en IncludeModel-skriptsats som läser in de valda tabellerna, relationerna, måtten och dimensionerna i din applikation. Mått och dimensioner från den semantiska modellen visas automatiskt som huvudobjekt, redo att användas i visualiseringar.

Förutsättningar

För att konsumera en dataprodukt och dess semantiska modell behöver du:

Behörigheter

För att konsumera den semantiska modellen för dataprodukter i delade, hanterade och datautrymmen behöver du behörigheten Kan konsumera data eller Kan visa i utrymmet som innehåller dataprodukten.

För fullständig information, se Roller och behörigheter för dataprodukter.

Tillgängliga datamängder

Du måste ha åtkomst till datauppsättningarna, samt anslutningarna till underliggande data, som ingår i den semantiska modellen.

Unikt dataproduktnamn

Dataprodukten måste ha ett unikt namn inom utrymmet. Om en applikation redan innehåller en dataprodukt med samma namn misslyckas inläsningen av den semantiska modellen.

Konsumera en dataprodukt och semantisk modell via dataprodukten

Du kan skapa en analysapp direkt från en dataprodukt. Du kan förfina vad som ska användas från dataprodukten och dess semantiska modell: datauppsättningar, fält och originalobjekt.

1. Öppna dataprodukten, antingen genom att välja en från datamarknadsplatsen eller genom att bläddra i katalogen.

2. I rubriken för dataproduktens namn klickar du på Använd i > Applikation.

   

3. I fönstret Skapa en ny applikation granskar du den semantiska modellen och de data som kommer att läsas in.
4. Klicka på Fortsätt.

   Skriptredigeraren för den nyligen skapade applikationen öppnas, och du dirigeras till datakatalogen. Dataprodukten är vald som standard, men du kan bläddra, förfina ditt urval och granska datan innan du läser in den i applikationen. För mer information, se Konsumera en dataprodukt och semantisk modell via Skriptredigeraren.

5. När du är redo klickar du på Läs in data.

Efter att data har lästs in kan du börja lägga till ark och arbeta med applikationen, eller navigera till Skriptredigeraren för att granska och ändra skriptet vid behov. Den semantiska modellens tabeller, relationer, mått och dimensioner är nu tillgängliga för användning.

För mer information om att visualisera data i kalkylblad, se Skapa analyser och visualisera data.

Konsumera en dataprodukt och semantisk modell via Skriptredigeraren

Datakatalogen tillhandahåller ett gränssnitt för att bläddra bland och välja data och information om semantisk modell från dataprodukter, i stället för att manuellt ange skript.

För att läsa in en dataprodukt och dess semantiska modell:

1. Öppna en applikation.
2. Klicka på Dataladdningsredigeraren i den övre navigeringsstapeln.
3. I den högra panelen Lägg till data klickar du på Lägg till från datakatalog.
4. Modalfönstret för datakatalogen öppnas och visar tillgängliga data, inklusive dataprodukter med semantiska modeller.

   

Bläddra bland dataprodukter

Datakatalogen visar dataprodukter som innehåller semantiska modeller. Du kan bläddra och söka efter dataprodukter baserat på namn, beskrivning eller taggar.

Klicka på en dataprodukt för att visa en sammanfattning av vad som kommer att läsas in i applikationsskriptet, inklusive tabeller, mått och dimensioner.

Om en datauppsättning i den semantiska modellen är otillgänglig markeras den med en varningsindikator. Du kan fortfarande använda mått och dimensioner relaterade till det som finns i den semantiska modellen, men de otillgängliga datauppsättningarna och deras fält är uteslutna.

Välja och förfina en semantisk modell

När du har valt vilken dataprodukt du ska använda kan du förfina ditt val och välja exakt vilka komponenter i den semantiska modellen som ska inkluderas i din applikation.

1. För muspekaren över den valda dataprodukten och klicka på Förfina markering.

   

   Tre nya flikar är tillgängliga där du kan navigera bland dataproduktens element:

   • Tabeller/fält
   • Dimensioner
   • Mått
2. Använd kryssrutorna för att förfina ditt urval och välja vilka datauppsättningar, fält, mått och dimensioner som ska inkluderas.
Anteckning om tips

Avancerade användare kan växla Inkludera tillagda objekt automatiskt vid omladdning för att styra om nya objekt inkluderas automatiskt när den semantiska modellen ändras.

När det är aktiverat läggs nya fält, mått och dimensioner som har lagts till i den semantiska modellen automatiskt till i datamodellen och originaldelarna vid omladdning. Detta gäller endast där samtliga fält, mått respektive dimensioner är markerade.

3. När ditt val är klart klickar du på Infoga skript.

Det genererade IncludeModel-skriptet infogas i laddningsskriptet och kan visas och redigeras i Skriptredigeraren. För att läsa in data i applikationen klickar du på Läs in data.

Efter att data har lästs in kan du börja lägga till ark och arbeta med applikationen. För mer information, se Skapa analyser och visualisera data.

Förstå auto-include

Funktionen för automatisk inkludering styr hur din applikation reagerar när den semantiska modellen ändras.

När automatisk inkludering är aktiverad för en komponenttyp använder det genererade skriptet en jokerteckenselektor (*):

• Fields *: Inkluderar alla fält från den angivna tabellen.
• WithMeasures: *: Inkluderar alla mått som huvudobjekt.
• WithDimensions: *: Inkluderar alla dimensioner som originaldelar.

När automatisk inkludering är inaktiverad listar skriptet uttryckligen de valda objekten. Exempel:

• WithMeasures [Total sales], [Total quantity]: Inkluderar endast de angivna måtten.
• WithDimensions [Region], [Product]: Inkluderar endast de angivna dimensionerna.

Automatisk inkludering rekommenderas för avancerade användare för att minska underhållet och säkerställa att din applikation drar nytta av förbättringar av den semantiska modellen. Inaktivera automatisk inkludering om du behöver strikt kontroll över vilka objekt som inkluderas.

Förstå det genererade IncludeModel-skriptet

Data genererar en IncludeModel-skriptsats som refererar till den semantiska modellen och anger vilka komponenter som ska läsas in.

Exempelskript

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

Skriptparametrar:

• IncludeModel: Namnet på dataprodukten som innehåller den semantiska modellen.
• FromSpace: Anger utrymmet som innehåller dataprodukten.
• WithTables: Anger vilka tabeller som ska inkluderas.
• Table: Anger en tabell som ska inkluderas. Du kan inkludera Table-satser för varje tabell du vill använda, separerade med kommatecken.
• Fields: Anger vilka fält som ska inkluderas från den angivna tabellen. Använd * för alla fält eller en kommaseparerad lista med fält.
• Connection: Anger tabellens plats med formatet environment:space:connection, space:connection eller connection.
• WithMeasures: Anger vilka mått som ska inkluderas som originalmått. Använd * för alla mått eller en lista över specifika måttnamn.
• WithDimensions: Anger vilka dimensioner som ska inkluderas som masterdimensioner. Använd * för alla dimensioner eller en lista över specifika dimensionsnamn.

Du kan manuellt redigera IncludeModel-satsen för att justera vilka objekt som inkluderas eller för att växla mellan lägena för jokertecken och explicit urval.

För fullständig information om satsen IncludeModel, se IncludeModel.

Namngivning av fält och tabeller

När en dataprodukt läses in i en applikation kan fält- och tabellnamn justeras automatiskt för att förhindra namnkonflikter och för att omvandla relationer till namnbaserade associationer enligt analysmönster för Qlik.

• Fält med samma namn utan relation: Om två tabeller innehåller ett fält med samma namn men fälten inte har någon relation, kvalificeras fältnamnen automatiskt med sitt tabellnamn (till exempel TableName.FieldName) för att förhindra en oavsiktlig automatisk association i applikationen.
• Fält som har en relation: Om de två fälten har en relation men olika namn döps de om till samma namn, relationens namn, när de läses in i en applikation för att bilda en association.

• Sammansatta nycklar: För sammansatta nycklar läggs ett nytt nyckelfält till i berörda tabeller.

• Tabeller med samma namn: Om två tabeller har samma namn döps de automatiskt om genom att ett numeriskt suffix läggs till, till exempel TableName_1, TableName_2 och så vidare.

Arbeta med ärvda original

När du laddar om en applikation som innehåller en IncludeModel-sats visas mått och dimensioner från den semantiska modellen automatiskt i panelen för huvudobjekt.

För att använda originalobjekt från en semantisk modell:

1. Ladda om applikationen för att läsa in data från den semantiska modellen.
2. Öppna ett ark i redigeringsläge.
3. Klicka på Huvudobjekt i den vänstra panelen.
4. Måtten och dimensionerna från den semantiska modellen visas i listan med en dataproduktindikator.

   

5. Dra ett originalmått eller en dimension till en visualisering för att använda det.

Samlingsobjekt som har ärvts från semantiska modeller visar källdataproduktens namn och beskrivning. Du kan se uttrycket som används av måttet eller dimensionen genom att hålla muspekaren över det.

Egenskaper för originalobjekt

De flesta attribut för huvudobjekt som ärvs från semantiska modeller är skrivskyddade i den konsumerande applikationen. Vissa andra attribut för originalobjekt, såsom de som är relaterade till visualiseringar, kan fortfarande redigeras i applikationen.

Skrivskyddet gäller endast användargränssnittet—du kan ange ett antal egenskaper för originalobjekt via API:

• Egenskaper som är konfigurerbara i den semantiska modellen men skrivskyddade i den konsumerande applikationens användargränssnitt. Detta inkluderar titel, beskrivning och taggar.

• Egenskaper som inte är konfigurerade i den semantiska modellen och inte exponeras i den konsumerande applikationens användargränssnitt.

Ändringar av egenskaper som definieras av den semantiska modellen kommer att skrivas över när applikationen laddas om.

Borttagning av huvudartikel

I en opublicerad applikation kan du ta bort ett ärvt originalobjekt, men det återkommer vid nästa omladdning om det fortfarande refereras i IncludeModel-skriptet. För att ta bort det permanent tar du först bort det från skriptet. Du kan också kopiera ett ärvt originalobjekt. Objektet som skapas genom att kopiera är ett vanligt originalobjekt i programmet och är fullt redigerbart.

Samlingsobjekt och publicering av appar

När en applikation publiceras förblir dess ärvda masterobjekt låsta till den version av dataprodukten som användes när applikationen publicerades. Att ladda om en publicerad applikation skapar, uppdaterar eller tar inte bort masterobjekt från dataprodukten. För att använda nya eller ändrade mått och dimensioner uppdaterar du applikationen och publicerar den igen.

Hantera uppdateringar av en semantisk modell i en applikation

Om den semantiska modellen ändras efter att du har konsumerat den kan du uppdatera din applikation för att återspegla ändringarna.

Om du använde läget för automatisk inkludering med jokerteckenselektorer inkluderas nya mått och dimensioner automatiskt. Om du använde explicit markering läses endast de objekt in som du ursprungligen markerade.

För att lägga till nya objekt från den semantiska modellen:

1. Öppna Skriptredigeraren.
2. Hitta IncludeModel-satsen i ditt skript.
3. Redigera satsen för att lägga till nya objekt eller ändra väljare till * för automatisk inkludering.
4. Ladda om applikationen.

Alternativt kan du ta bort den befintliga IncludeModel-satsen och använda datakatalogen för att generera en ny med uppdaterade urval.

Konsumera dataprodukter i andra verktyg

I Skript är det möjligt att konsumera dataprodukter, men mått och dimensioner ignoreras.

När dataprodukter konsumeras i andra tillgångar än applikationer och skript (såsom dataflöden och tabellrecept) fungerar dataprodukten som en uppsättning betrodda datamängder att välja bland. Dessa verktyg använder datamängderna som källor och dataprodukten visas inte som en källnod i ursprung.