Rapportering i appen i hanterade utrymmen

Du kan konfigurera rapportering i appen för appar som kräver strikt datastyrning. Du kan använda samma principer som du utgår från när du utvecklar appdatamodeller för användning i hanterade utrymmen när du förbereder din app för rapportfunktioner i appen. Detta gör du genom att använda utrymmesmedveten syntax i laddningsskriptet.

När en app utvecklas som ska publiceras i ett hanterat utrymme behöver du tänka på följande:

• Mallarna kan utvecklas före eller efter publicering av applikationen. Om du skapar mallen före publicering, ändra den anslutna applikationen efter publicering.

• En distributionslista måste läggas till i applikationen innan applikationen publiceras. Under utvecklingen kan detta bestå av testdatakällor, snarare än de verkliga datakällorna. Källorna i distributionslistan refereras i laddningsskriptet; därför måste skriptet skrivas med publicering i åtanke, med utrymmesmedveten syntax. Denna syntax används automatiskt om du laddar upp en distributionslista som källfil.

• Efter publicering kan rapporttillgångarna – mall, filter och rapportuppgifter – återskapas efter önskemål, baserat på rapportanvändningsfallet för den publicerade applikationen. De verkliga datakällorna som används i distributionslistan ska läggas till i det hanterade utrymmet.

Befintliga rapportkonfigurationer.

Om du har skapat en rapportkonfiguration och distributionslista före 26 mars 2024 måste du tänka på ändringar i filuppladdningsprocessen för distributionslistor.

För applikationer som skapades före den 26 mars 2024 fick en källfil med en distributionslista som laddades upp i delavsnittet Rapportering automatiskt ett nytt namn och lades till i utrymmet. Referensen till filen med nytt namn lades sedan automatiskt till i laddningsskriptet. Den uppladdade källfilen byter nu inte längre namn när den läggs till i utrymmet.

För att fortsätta använda befintliga rapportkonfigurationer när du publicerar dessa applikationer, gå till väga enligt motsvarande delavsnitt nedan, beroende på dina distributionslistkällor. Alternativt återskapar du din rapportkonfiguration från början med hjälp av de guider som följer längre ner på den här sidan.

Om du har laddat upp en källfil

Öppna Skriptredigeraren och kontrollera referenserna till filnamnet i skriptavsnittet Distributionslista. Ändra syntaxen så att den använder en utrymmesmedveten referens som pekar på det aktuella utrymmet i stället för valfritt specifikt utrymme. En filreferens kan exempelvis se ut så här:

FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"

Ändra detta till:

FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"

Du kan se att applikations-ID:t för källapplikationen finns i filnamnet. Om du vill att just detta skript ska köras när du publicerar applikationen, lägg till din faktiska distributionslistfil i det hanterade utrymmet, med exakt detta namn.

Alternativt kan du byta namn på källfilen i utvecklingsutrymmet, uppdatera laddningsskriptet och sedan publicera. Lägg slutligen till den aktuella distributionslistfilen med det uppdaterade namnet.

Om du använde fjärrdatakällor manuellt i skriptet

Om du i stället har konfigurerat laddningsskriptet manuellt så att det stöder sig på andra datakällor för distributionslistan behöver du bara ändra laddningsskriptet så att det innehåller relativa, utrymmesmedvetna referenser till datakällorna (om du inte redan har gjort det).

Mer information och specifika exempel finns iDatakällor för applikationer i hanterade utrymmen:

Arbetsflöde

Följ sekvensen nedan för att arbeta med rapportering i applikationen i ett hanterat utrymme.

Applikationsutveckling

Innan applikationen ska publiceras till det hanterade utrymmet utvecklar du applikationen i ditt utvecklingsutrymme (personligt eller delat utrymme) på vanligt sätt.

Utveckla mallarna och filtren

Om så önskas kan du bygga rapportmallarna och filtren innan du publicerar applikationen.Detta kan vara till hjälp som ett steg i applikationsutvecklingen, men mallar och filter som läggs till i källapplikationen behålls inte i den publicerade kopian.

Om du skapar mallarna före publicering och vill använda dem för den publicerade applikationen, ska du ändra den kopplade Qlik Sense-applikationen för mallarna. Du kan utföra denna åtgärd i tillägget för Excel-mallar. Alternativt kan du utföra den här åtgärden i Qlik Sense-applikationen när du laddar upp mallarna till den publicerade applikationen. Se Ändra den anslutna Qlik Sense applikationen.

Förbereda referens till distributionslista

När du lägger till en distributionslista i en applikation ändras applikationens laddningsskript. Laddningsskriptet för en applikation är inte tillgängligt i en publicerad applikation. Därför måste du lägga till en distributionslista i applikationen innan du publicerar den.

I det här steget behöver distributionslistan bara vara en platshållare för den verkliga filen eller andra källor som du kommer att använda till distributionslistan i det hanterade utrymmet.

Proceduren varierar något beroende på om din distributionslista är en källfil eller en fjärrdatakälla som läggs till manuellt i skriptet. Men de underliggande koncepten är desamma. En fullständig guide för att använda utrymmesmedveten syntax i laddningsskriptet finns i Datakällor för applikationer i hanterade utrymmen.

Alternativ 1: direkt uppladdning av källfil

Följ den vanliga proceduren för att ladda upp en källfil som distributionslista: Lägga till distributionslistan genom att ladda upp en källfil.

I stället för att lägga till de slutliga mottagardetaljerna kan du sätta in valfria platshållare. Det viktigaste här är att du laddar upp en fil och att denna fil sedan automatiskt läggs till i utvecklingsutrymmet och refereras i skriptet.

Du kan kontrollera att Distribution List-avsnittet i laddningsskriptet innehåller en utrymmesmedveten referens till filen och inte refererar direkt till ett visst utrymme. Detta görs automatiskt när du laddar upp en källfil som en distributionslista i Rapporter-delavsnittet i applikationen. Det bör se ut ungefär så här:

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

Det här exemplet är en utrymmesmedveten referens som pekar på det aktuella utrymmet där applikationen finns. Det extra kolonet före DataFiles tillhandahåller den nödvändiga relativa referensen.

Senare, när du publicerar applikationen till det hanterade utrymmet, laddar du upp den faktiska distributionslistfilen till det hanterade utrymmet. Den verkliga distributionslistan måste ha samma filnamn som filen som refereras i skriptet.

Alternativ 2: manuell referens till datakällor i skriptet

Följ den vanliga proceduren för att koppla till fjärrdistributionskällor manuellt i ditt skript: Definiera distributionslistan manuellt i laddningsskriptet.

När du skriver skriptet för att koppla till de datakällor som behövs till din distributionslista kan du använda testreferenser till filerna och kopplingarna efter behov. I ditt skript behöver datakällorna bara ha samma namn som de kommer att ha i det hanterade utrymmet och referenserna till de här källorna behöver använda relativ, utrymmesmedveten syntax.

Publicera applikationen

När du har förberett laddningsskriptet och distributionslistan är applikationen redo att publiceras i det hanterade utrymmet. Mer information om att publicera en applikation finns i Publicera applikationer.

Ändra den anslutna Qlik Sense applikationen

Om du har skapat en rapportmall innan du publicerar applikationen måste du uppdatera mallen så att den refererar till rätt applikations-ID. En publicerad kopia av en applikation kommer att ha ett annat applikations-ID än källapplikationen.

Denna process kan slutföras automatiskt i Qlik Sense när du laddar upp mallen. För Microsoft Office-baserade mallformat – Excel, PowerPoint eller Word – kan detta också göras i motsvarande tillägg. Innan du börjar kan du skapa en separat kopia av mallen för att särskilja den från mallen för källapplikationen.

Fullständiga instruktioner finns i:

• från Qlik Sense: Ändra den anslutna Qlik Sense applikationen

• Från Qlik-tillägg för Microsoft Office: Ändra den anslutna Qlik Sense applikationen

Det är alltid möjligt att utveckla och uppdatera dina mallar direkt i det hanterade utrymmet.

Lägga till de verkliga källorna i distributionslistan

I det hanterade utrymmet skapar du de filer och kopplingar som behövs för att ladda din distributionslista enligt referenserna i laddningsskriptet. Det här steget kan utföras när som helst.

De datakällor som tillhandahåller distributionslistan måste innehålla samma parameternamn (namn på kopplingar, filer och fält) som de distributionslistekällor som används i källapplikationens laddningsskript.

När de anslutna källorna läggs till i utrymmet ska du kunna ladda om applikationen.

Skapa de nya rapporttillgångarna

Du kan nu lägga till rapporteringstillgångar i applikationen. Detta kan bestå av mallarna, filter och rapportuppgifter.

Behörigheter

För att arbeta med rapportering i appen för applikationer i hanterade utrymmen behöver du:

• Behörigheter tilldelade dig av en klientorganisationsadministratör. En administratör kan se Ställa in behörigheter för mätbara rapporteringsfunktioner för mer information.

• En av följande utrymmesroller i det hanterade utrymmet:

  • Ägare

  • Kan hantera

  • Kan styra

  Anteckning om informationFör användarbaserade prenumerationer kräver rollen Kan hantera också en Professional användarbehörighet.

Mer information om behörigheter för rapportering i utrymmen finns i Behörigheter för Qlik Reporting Service.

Begränsningar