In-app rapportage in beheerde ruimten

U kunt in-app rapporten configureren voor applicaties waarvoor strikt gegevensbeheer is vereist. Op basis van dezelfde principes die u gebruikt voor het ontwikkelen van applicatiegegevensmodellen voor gebruik in beheerde ruimten, kunt u uw applicatie voorbereiden voor in-app rapportagefuncties. Dit bereikt u door ruimtebewuste syntaxis in het load-script te gebruiken.

Houd rekening met het volgende bij het ontwikkelen van een applicatie als voorbereiding op het publiceren in een beheerde ruimte:

• De sjablonen kunnen vóór of na het publiceren van de applicatie worden ontwikkeld. Als u het sjabloon vóór publicatie maakt, wijzigt u de verbonden applicatie na publicatie.

• Een distributielijst moet aan de applicatie worden toegevoegd voordat de applicatie wordt gepubliceerd. Tijdens de ontwikkeling kan dit bestaan uit dummy-gegevensbronnen, in plaats van de werkelijke gegevensbronnen. Er wordt in het load-script verwezen naar de bronnen in de distributielijst, daarom moet het script worden geschreven op basis van ruimtebewuste syntaxis voorafgaand aan de publicatie. Deze syntaxis wordt automatisch standaard gebruikt als u een distributielijst uploadt als een bronbestand.

• Na de publicatie kunnen de rapportagemiddelen – sjabloon, filters en rapporttaken – indien gewenst opnieuw worden gemaakt op basis van de rapportage-usecase voor de gepubliceerde applicatie. De werkelijke gegevensbronnen die in de distributielijst worden gebruikt, moeten worden toegevoegd aan de beheerde ruimte.

Bestaande rapportconfiguraties

Als u vóór 26 maart 2024 een rapportageconfiguratie en distributielijst hebt gemaakt, moet u rekening houden met wijzigingen van het uploadproces van bestanden voor distributielijsten.

Voor applicaties die zijn gemaakt vóór 26 maart 2024, kreeg een bronbestand van een distributielijst dat is geüpload in de sectie Rapportage automatisch een andere naam en werd toegevoegd aan de ruimte. De verwijzing naar dit hernoemde bestand werd vervolgens automatisch toegevoegd aan het load-script. Het geüploade bestand wordt niet langer hernoemd nadat het aan de ruimte is toegevoegd.

Om bestaande rapportconfiguraties te blijven gebruiken bij het publiceren van deze applicaties, volgt u de betreffende sectie hieronder, afhankelijk van de bronnen van uw distributielijst. U kunt er eventueel ook voor kiezen om uw rapportageconfiguraties compleet opnieuw te maken met behulp van de handleidingen die later op deze pagina staan vermeld.

Als u een bronbestand hebt geüpload

Open Editor voor laden van gegevens en kijk naar de verwijzingen van de bestandsnaam in de scriptsectie Distributielijst. Wijzig de syntaxis zodat er een ruimtebewuste verwijzing naar de huidige ruimte wordt gebruikt, in plaats van naar een specifieke ruimte. Een bestandsverwijzing ziet er bijvoorbeeld als volgt uit:

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

Dit wijzigen in:

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

U ziet dat de applicatie-ID van de bronapplicatie is opgenomen in de bestandsnaam. Als u wilt dat dit exacte script wordt uitgevoerd wanneer u de applicatie publiceert, voegt u uw daadwerkelijke distributielijstbestand toe aan de beheerde ruimte, met deze exacte naam.

U kunt eventueel ook de naam van het bronbestand in de ontwikkelingsruimte wijzigen, het load-script bijwerken en vervolgens publiceren. Voeg tot slot het werkelijke distributiebestand met de bijgewerkte naam toe.

Als u externe gegevensbronnen handmatig in het script hebt gebruikt

Maar als u het load-script handmatig hebt geconfigureerd om te vertrouwen op andere gegevensbronnen voor de distributielijst, moet u het load-script aanpassen zodat het relatieve, ruimtebewuste verwijzingen naar de gegevensbronnen bevat (indien dit nog niet het geval was).

Voor meer informatie en voorbeelden raadpleegt u Gegevensbronnen voor applicaties in beheerde ruimtes.

Workflow

Volg de onderstaande reeks om te werken met in-applicatie rapportage in een beheerde ruimte.

Applicatieontwikkeling

Ontwikkel de applicatie in uw ontwikkelruimte (persoonlijke of gedeelde ruimte), zoals u normaal gesproken zou doen, ter voorbereiding op de publicatie in de beheerde ruimte.

De sjablonen en filters maken

Indien gewenst kunt u de rapportage-sjablonen en filters bouwen voordat u de applicatie publiceert.Dit kan nuttig zijn als een fase in de applicatieontwikkeling, maar sjablonen en filters die aan de bronapplicatie zijn toegevoegd, blijven niet behouden in de gepubliceerde kopie.

Als u de sjablonen maakt voordat u publiceert en deze wilt gebruiken voor de gepubliceerde applicatie, wijzig dan de verbonden Qlik Sense-applicatie voor de sjablonen. Bij Excel-sjablonen kunt u deze actie uitvoeren in de invoegtoepassing. U kunt deze actie ook uitvoeren in de Qlik Sense-applicatie terwijl u de sjablonen uploadt naar de gepubliceerde applicatie. Zie: Wijzig de verbonden Qlik Sense applicatie.

De verwijzing naar de distributielijst voorbereiden

Wanneer u een distributielijst toevoegt aan een applicatie, wordt het load-script van de applicatie gewijzigd. Het load-script van een applicatie is niet toegankelijk in een gepubliceerde applicatie. Daarom moet u een distributielijst toevoegen aan de applicatie voordat u deze publiceert.

In deze stap heeft de distributielijst simpelweg een plaatshouder nodig voor het werkelijke bestand of andere bronnen die u gebruikt voor de distributielijst in de beheerde ruimte.

De procedure verloopt mogelijk net anders, afhankelijk van het feit of uw distributielijst een bronbestand of een externe gegevensbron is die handmatig aan het script is toegevoegd. De onderliggende concepten zijn echter hetzelfde. Voor een volledige handleiding over het gebruik van ruimtebewuste syntaxis in het load-script gaat u naar Gegevensbronnen voor applicaties in beheerde ruimtes.

Optie 1: bronbestand direct uploaden

Volg de algemene procedure voor het uploaden van een bronbestand als de distributielijst: De distributielijst toevoegen door een bronbestand te uploaden.

U kunt elke gewenste plaatshouder invoegen in plaats van de voltooide details van de ontvanger toe te voegen. Het belangrijkste hier is dat u een bestand uploadt en dat dit bestand vervolgens automatisch wordt toegevoegd aan de ontwikkelruimte en dat er in het script naar wordt verwezen.

U kunt controleren of de sectie Distribution List in het load-script een ruimtebewuste verwijzing naar het bestand bevat en niet direct verwijst naar een specifieke ruimte. Dit gebeurt automatisch wanneer u een bronbestand uploadt als een distributielijst in de Rapportage-sectie van de applicatie. Deze moet er als volgt uitzien:

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

Dit voorbeeld is een ruimtebewuste verwijzing die verwijst naar de huidige ruimte waarin de applicatie zich bevindt. De extra puntkomma vóór DataFiles zorgt voor de vereiste relatieve verwijzing.

Later, wanneer u de applicatie publiceert naar de beheerde ruimte, uploadt u het daadwerkelijke distributielijstbestand naar de beheerde ruimte. De werkelijke distributielijst moet dezelfde bestandsnaam hebben als het bestand waarnaar in het script wordt verwezen.

Optie 2: handmatige verwijzing naar gegevensbronnen in het script

Volg de algemene procedure voor het handmatig maken van een verbinding met externe distributielijstbronnen: De distributielijst handmatig definiëren in het load-script.

U kunt dummy-verwijzingen naar de bestanden en verbindingen gebruiken bij het schrijven van een script voor de verbinding met de vereiste gegevensbronnen voor uw distributielijst. In uw script moeten de gegevensbronnen dezelfde namen hebben als in de beheerde ruimte en de verwijzingen naar deze bronnen moeten relatieve, ruimtebewuste syntaxis gebruiken.

De applicatie publiceren

Nadat u het load-script en de distributielijst hebt voorbereid, is de applicatie gereed om te worden gepubliceerd naar de beheerde ruimte. Zie Applicaties publiceren voor meer informatie over het publiceren van een applicatie.

Wijzig de verbonden Qlik Sense applicatie

Als u een rapportsjabloon hebt gemaakt voordat u de applicatie publiceert, moet u het sjabloon bijwerken om te verwijzen naar de juiste applicatie-ID. Een gepubliceerde kopie van een applicatie heeft een andere applicatie-ID dan de bronapplicatie.

Dit proces kan automatisch worden voltooid in Qlik Sense tijdens het uploaden van een sjabloon. Voor op Microsoft Office gebaseerde sjabloonindelingen—Excel, PowerPoint of Word—kan dit ook worden gedaan in de bijbehorende invoegtoepassing. Voordat u begint, kunt u een afzonderlijke kopie van het sjabloon maken om deze te onderscheiden van het sjabloon voor de bronapplicatie.

Voor volledige instructies raadpleegt u:

• Van Qlik Sense: De verbonden Qlik Sense applicatie wijzigen

• Van Qlik add-ins voor Microsoft Office: De verbonden Qlik Sense applicatie wijzigen

Het is altijd mogelijk om uw sjablonen direct in de beheerde ruimte te ontwikkelen en bij te werken.

De werkelijke distributielijstbronnen toevoegen

In de beheerde ruimte maakt u de bestanden en verbindingen die u nodig hebt om uw distributielijst te laden, waarnaar wordt verwezen in het load-script. Deze stap kunt u op elk moment voltooien.

De gegevensbronnen die de distributielijst ter beschikking stellen moeten dezelfde parameternamen (namen van verbindingen, bestanden en velden) bevatten als de distributielijstbronnen die gebruikt worden in het load-script van de bron-applicatie.

Wanneer de verbonden bronnen aan de ruimte zijn toegevoegd, zou u de applicatie opnieuw moeten kunnen laden.

De nieuwe rapportagemiddelen maken

U kunt nu rapportagebedrijfsmiddelen toevoegen aan de applicatie. Dit kan bestaan uit de sjablonen, filters en rapportagetaken.

Machtigingen

Om te werken met in-applicatierapportage voor applicaties in beheerde ruimten, hebt u nodig:

• Machtigingen die u zijn toegewezen door een tenantbeheerder. Voor meer informatie kan een beheerder Machtigingen instellen voor functies voor rapportage op basis van verbruik raadplegen.

• Een van de volgende ruimterollen in de beheerde ruimte:

  • Eigenaar

  • Kan beheren

  • Kan uitvoeren

  InformatieVoor gebruikersgebaseerde abonnementen vereist de rol Kan bedienen ook een Professional gebruikersrecht.

Voor informatie over ruimtemachtigingen voor rapportage, gaat u naar Machtigingen voor Qlik Rapportageservice .

Beperkingen