Gegevens en opnieuw laden
Laatst bijgewerkt: 14-10-2026QV2QS converteert de QlikView-UI en kan automatisch gegevens laden in de geconverteerde app met behulp van de optie Auto-binary. Schakel Reload en Auto-binary in de wizard of op de opdrachtregel in, en QV2QS handelt de gegevensoverdracht automatisch af. Als Auto-binary niet wordt gebruikt, moet de geconverteerde app afzonderlijk worden herladen om gegevens te vullen.
QV2QS converteert de QlikView UI-metadata (PRJ XML) naar Qlik Sense JSON en bouwt de app rechtstreeks op de Qlik Cloud tenant. Het conversieproces verwerkt werkbladindelingen, visualisatieobjecten, expressies en opmaak. Zonder herladen bevat de resulterende Qlik Sense app geen gegevens nadat de buildstap is voltooid.
Om gegevens in de geconverteerde app te laden, moet de app opnieuw worden geladen. Er zijn drie benaderingen:
- Automatisch binair laden — QV2QS uploadt het oorspronkelijke QVW-bestand naar Qlik Cloud en gebruikt een
Binary-instructie om de gegevens tijdens het bouwen te laden. Deze aanpak is de snelste manier om direct na de conversie een werkende app met data te zien. Zie voor meer informatie Automatisch binair laden hieronder. - Handmatig herladen — Als er al gegevensverbindingen zijn gemaakt in Qlik Cloud en de QVD-bestanden of gegevensbronnen toegankelijk zijn, kan de app worden herladen na het aanpassen van het load-script. QV2QS past basisnormalisatie van load-scriptpaden toe, maar verbindingsnamen en gegevensbronpaden vereisen mogelijk handmatige updates.
- Geactiveerd opnieuw laden — Gebruik de vlag
--reloadom het opnieuw laden te activeren als onderdeel van de implementatie. De reload voert het load-script ongewijzigd uit. Het herladen slaagt alleen als de gegevensverbindingen en gegevensbronnen waarnaar in het load-script wordt verwezen al beschikbaar zijn in de Qlik Cloud-omgeving.
Twee flags beheren gegevens in verschillende fasen. De --noData-flag slaat gegevens over tijdens de buildstap, zodat de app-structuur kan worden getest zonder te wachten op een reload. De flag --exportQvfNoData exporteert de QVF zonder gegevens nadat de build is voltooid, wat een kleiner bestand oplevert om te delen. De vlaggen kunnen onafhankelijk of samen worden gebruikt.
Automatisch binair laden
Automatisch binair laden uploadt het oorspronkelijke QVW-bestand naar Qlik Cloud, gebruikt een Binary-opdracht om de gegevens in de geconverteerde app te laden en verwijdert vervolgens het geüploade bestand. De geconverteerde app ontvangt dezelfde gegevens als het QlikView-origineel zonder dat handmatige configuratie van de gegevensverbinding vereist is.
Om automatisch binair laden in te schakelen, gebruikt u --autoBinary op de opdrachtregel of schakelt u Auto-binary in de gebruikersinterface in.
QV2QS voert de volgende stappen uit wanneer automatisch binair laden is ingeschakeld:
- Upload het QVW-bestand naar Qlik Cloud als tijdelijke app.
- Voeg een
Binary [<appId>];-instructie en eenExit Script;-instructie toe aan het begin van het geconverteerde app-load-script. - Bouw de app (en herlaad als
--reloadis opgegeven), die gegevens laadt uit de geüploade QVW. - De tijdelijk geüploade app verwijderen uit Qlik Cloud.
- Herstel het oorspronkelijke load-script in de Qlik Cloud-app en verwijder de Binary- en Exit Script-instructies.
Na het opschonen bevat de Qlik Cloud-app de geladen gegevens, maar verwijst het load-script niet langer naar de tijdelijke app.
De uploadstap is onderhevig aan de limieten voor bestandsgrootte van Qlik Cloud. Grote QVW-bestanden overschrijden mogelijk de uploadlimiet voor het abonnementsniveau van de tenant. Als de upload mislukt, implementeer de app dan in een ruimte waarin ondersteuning voor grote apps is ingeschakeld, of gebruik het argument --binaryAppId om te verwijzen naar een bestaande app die zich al in Qlik Cloud bevindt. Voor meer informatie over tenant-resourcelimieten, zie Qlik Cloud-resourcelimieten.
Opschonen bij mislukking
Als de build- of herlaadstap mislukt nadat het QVW-bestand is geüpload, probeert QV2QS automatisch op te schonen alvorens af te sluiten. Het opschonen omvat het verwijderen van de tijdelijk geüploade app uit Qlik Cloud en het herstellen van het oorspronkelijke load-script, zowel lokaal als in de Cloud-app.
Als het opschonen zelf mislukt (bijvoorbeeld door een netwerkonderbreking), kan de tijdelijke app in de Qlik Cloud-tenant achterblijven. Verweesde tijdelijke apps worden QV2QS_Binary_YYYYMMDD_HHMMSS genoemd (bijvoorbeeld QV2QS_Binary_20260219_143025). Controleer de doelruimte op apps die overeenkomen met dit patroon en verwijder deze handmatig. Het lokale script.qvs-bestand in de buildmap kan ook de tijdelijke Binary-instructie bevatten. Voer de conversie opnieuw uit om het opnieuw te genereren.
Automatisch binair laden vereist de --reload-vlag en een --qvw pad. QV2QS wijst de opdracht af en wordt beëindigd met code 1 als een van beide vereisten ontbreekt.
Het originele QVW-bestand op de lokale computer wordt nooit gewijzigd of verwijderd. Alleen de tijdelijke kopie in Qlik Cloud wordt verwijderd nadat het laden van gegevens is voltooid.
Automatisch binair laden wordt niet ondersteund voor apps die Sectietoegang gebruiken. De herlaadengine van Qlik Cloud kan zich niet authenticeren bij de Sectietoegang-tabel in het bron-QVW-bestand. Wanneer QV2QS Sectietoegang detecteert in de bron-app, worden de binaire upload- en herlaadstappen overgeslagen en wordt er een waarschuwing geregistreerd. De app is geïmplementeerd zonder gegevens. Om gegevens te laden, maakt u Qlik Cloud-gegevensverbindingen en werkt u het load-script handmatig bij, of verwijdert u Sectietoegang uit een kopie van de bron-QVW en voert u deze opnieuw uit met --autoBinary.
Wanneer --preserveTargetAppScript wordt gecombineerd met --reload, voert het opnieuw laden het bestaande load-script in de doel-app uit, niet het geconverteerde script. Dit is handig wanneer de doel-app al werkende Qlik Cloud-gegevensverbindingen heeft en alleen de UI-laag hoeft te worden bijgewerkt. Zie voor meer informatie Een bestaande app hergebruiken.