Ausgabestruktur und App-Benennung

Letzte Aktualisierung: 14.10.2026

QV2QS organisiert die Batch-Ausgabe in einer Verzeichnishierarchie und bietet eine flexible App-Benennung für die Bereitstellung in Qlik Cloud. Dieses Thema behandelt Optionen für das Verzeichnis-Layout, Einstellungsempfehlungen und Benennungsvorlagen.

Ausgabestruktur

Standardmäßig spiegelt QV2QS die Quellverzeichnishierarchie unter dem Ausgabestammverzeichnis wider. Jedes Projekt erzeugt einen Unterordner, der die Build-Ausgabe, Berichte und Protokolle enthält.

Hierarchie beibehalten (Standard)

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

Hierarchie abflachen (--batchFlatOutput)

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

Die Beibehaltung der Hierarchie ist sinnvoll, wenn die Quellordnerstruktur organisatorische Gruppierungen (nach Abteilung, Region oder Geschäftsbereich) widerspiegelt und die Ausgabe diese Struktur widerspiegeln soll. Das Verflachen der Hierarchie ist sinnvoll, wenn die Ordnerstruktur nicht aussagekräftig ist oder wenn sich mit einer flachen Liste in nachgelagerten Prozessen einfacher arbeiten lässt.

Wenn zwei Projekte denselben Ausgabeordnernamen erzeugen (beispielsweise zwei Projekte namens Sales in verschiedenen Unterverzeichnissen), hängt QV2QS _2, _3 und nachfolgende Nummern an, um Kollisionen zu vermeiden.

Einstellungen im Batch-Modus

Alle Konvertierungseinstellungen gelten einheitlich für jedes Projekt im Batch. Es gibt keinen Mechanismus für projektspezifische Überschreibungen. Die feste Canvas-Skalierung, Objektskalierung, Größenbeschränkungen, Zuschnittabmessungen, Layout-Verkleinerung, Hintergrundbehandlung und jede andere Einstellung werden identisch auf jede App im Durchlauf angewendet.

Diese einheitliche Anwendung hat eine wichtige praktische Auswirkung: Gruppieren Sie ähnliche Anwendungen, wenn Sie Batch-Konvertierungen ausführen. Anwendungen, die ähnliche Bildschirmauflösungen, Hintergrundbild-Layouts und Objektgrößen aufweisen, funktionieren gut in einem einzigen Batch. Anwendungen mit deutlich unterschiedlichen Layouts oder Designmustern profitieren von separaten Batch-Läufen mit unterschiedlichen Einstellungen.

Empfohlener Workflow für die Stapelkonvertierung:

1. Kopieren Sie alle QVW- und QVF-Quelldateien in einen lokalen Arbeitsordner. Führen Sie keine Batch-Konvertierungen für Produktionsverzeichnisse oder Netzwerkfreigaben aus.
2. Identifizieren Sie Gruppen von QlikView-Anwendungen, die ähnliche Layout-Merkmale aufweisen (Auflösung, Hintergrundbilder, Objektdichte).
3. Laden Sie eine repräsentative Anwendung aus jeder Gruppe im Einzelprojektmodus.
4. Öffnen Sie Mockup Studio und experimentieren Sie mit den Einstellungen für feste Zeichenfläche, Skalierung, Zuschnitt und Größenbeschränkungen, bis das Layout zufriedenstellend ist.
5. Notieren Sie sich die Einstellungen, die für diese Gruppe das beste Ergebnis liefern.
6. Wechseln Sie in den Batch-Modus, verweisen Sie auf den Ordner, der diese Gruppe enthält, und wenden Sie dieselben Einstellungen an.
7. Wiederholen Sie dies für jede Gruppe von Anwendungen.

Dieser Ansatz vermeidet den häufigen Fehler, einen großen Batch mit generischen Einstellungen auszuführen und anschließend Zeit damit zu verbringen, einzelne Apps manuell anzupassen. Einige Minuten Testen in Mockup Studio mit einer repräsentativen Stichprobe können bei einem großen Batch erheblichen Aufwand ersparen.

App-Benennung im Batch-Modus

Beim Bereitstellen von Batch-Konvertierungen in Qlik Cloud steuert --qsAppName, wie jede App benannt wird:

• Nicht angegeben — Jede App wird nach dem Projekt benannt (<Name>).
• Klartext — Der Wert wird als Präfix verwendet: <prefix> - <Name>.
• Vorlage mit Platzhaltern — Der Wert wird als Formatzeichenfolge behandelt.

Die folgenden Platzhalter stehen in Template-Strings zur Verfügung.

Zum Beispiel erzeugt --qsAppName "Migrated {name} ({rel})" App-Namen wie Migrated Sales (region1/finance).

Mehr erfahren

• Parallele Ausführung
• Stapelberichterstellung
• Argumentreferenz