Uitvoerstructuur en app-naamgeving

Laatst bijgewerkt: 14-10-2026

QV2QS organiseert batchuitvoer in een directoryhiërarchie en biedt flexibele app-naamgeving voor Qlik Cloud-implementatie. In dit onderwerp worden opties voor de directory-lay-out, aanbevelingen voor instellingen en naamgevingssjablonen behandeld.

Uitvoerstructuur

Standaard spiegelt QV2QS de hiërarchie van de bronmap onder de hoofdmap van de uitvoer. Elk project produceert een submap met daarin de build-uitvoer, rapporten en logbestanden.

Hiërarchie behouden (standaard)

<outputDir>/
  <RelativePath>/
    <ProjectName>/
      build/
      images/
      reports/
      logs/

Hiërarchie afvlakken (--batchFlatOutput)

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/

Het behouden van de hiërarchie is nuttig wanneer de bronmappenstructuur organisatorische groeperingen weerspiegelt (per afdeling, regio of businessunit) en de uitvoer die structuur moet weerspiegelen. Het afvlakken van de hiërarchie is nuttig wanneer de mapstructuur niet betekenisvol is of wanneer een platte lijst verderop in het proces eenvoudiger is om mee te werken.

Als twee projecten dezelfde uitvoermapnaam genereren (bijvoorbeeld twee projecten met de naam Sales in verschillende submappen), voegt QV2QS _2, _3 en daaropvolgende nummers toe om conflicten te voorkomen.

Instellingen in batchmodus

Alle conversie-instellingen zijn uniform van toepassing op elk project in de batch. Er is geen mechanisme voor overschrijvingen per project. De vaste canvasschaal, objectschaal, groottebeperkingen, bijsnijdafmetingen, lay-outsverkleining, achtergrondafhandeling en elke andere instelling worden identiek toegepast op elke app in de run.

Deze uniforme toepassing heeft een belangrijke praktische implicatie: groepeer soortgelijke toepassingen bij elkaar bij het uitvoeren van batchconversies. Applicaties die vergelijkbare schermresoluties, lay-outs van achtergrondafbeeldingen en objectafmetingen delen, werken goed in één batch. Applicaties met aanzienlijk verschillende lay-outs of ontwerppatronen hebben baat bij afzonderlijke batchruns met verschillende instellingen.

Aanbevolen workflow voor batchconversie:

1. Kopieer alle QVW- en QVF-bronbestanden naar een lokale werkmap. Voer geen batchconversies uit op productiemappen of netwerkshares.
2. Identificeer groepen QlikView-applicaties die vergelijkbare lay-outkenmerken delen (resolutie, achtergrondafbeeldingen, objectdichtheid).
3. Laad een representatieve applicatie uit elke groep in single-projectmodus.
4. Open Mockup Studio en experimenteer met de instellingen voor vast canvas, schalen, bijsnijden en groottebeperkingen totdat de lay-out naar wens is.
5. Noteer de instellingen die het beste resultaat opleveren voor die groep.
6. Schakel over naar de batchmodus, wijs naar de map die die groep bevat en pas dezelfde instellingen toe.
7. Herhaal voor elke groep applicaties.

Deze aanpak voorkomt de veelgemaakte fout om een grote batch met algemene instellingen uit te voeren en vervolgens achteraf tijd te besteden aan het handmatig aanpassen van afzonderlijke apps. Enkele minuten testen in Mockup Studio met een representatieve steekproef kan aanzienlijk veel moeite besparen bij een grote batch.

App-naamgeving in batchmodus

Bij het implementeren van batchconversies naar Qlik Cloud bepaalt --qsAppName hoe elke app wordt benoemd:

• Niet opgegeven — Elke app is vernoemd naar het project (<Name>).
• Platte tekst — De waarde wordt gebruikt als prefix: <prefix> - <Name>.
• Sjabloon met tijdelijke aanduidingen — De waarde wordt behandeld als een notatietekenreeks.

De volgende tijdelijke aanduidingen zijn beschikbaar in sjabloontekenreeksen.

Bijvoorbeeld produceert --qsAppName "Migrated {name} ({rel})" appnamen zoals Migrated Sales (region1/finance).

Meer informatie

• Parallelle uitvoering
• Batchrapportage
• Argumentreferentie