Struttura dell'output e denominazione dell'app

Ultimo aggiornamento: 14/10/2026

QV2QS organizza l'output batch in una gerarchia di directory e offre una denominazione flessibile delle app per la distribuzione in Qlik Cloud. Questo argomento illustra le opzioni di layout della directory, le impostazioni consigliate e i modelli di denominazione.

Struttura dell'output

Per impostazione predefinita, QV2QS replica la gerarchia delle directory di origine nella radice di output. Ogni progetto produce una sottocartella contenente l'output della build, i report e i log.

Mantieni gerarchia (predefinito)

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

Appiattisci gerarchia (--batchFlatOutput)

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

Mantenere la gerarchia è utile quando la struttura delle cartelle di origine riflette raggruppamenti organizzativi (per reparto, regione o business unit) e l'output deve rispecchiare tale struttura. Appiattire la gerarchia è utile quando la struttura delle cartelle non è significativa o quando un elenco piatto risulta più facile da gestire a valle.

Se due progetti producono lo stesso nome per la cartella di output (ad esempio, due progetti denominati Sales in sottodirectory diverse), QV2QS aggiunge _2, _3 e i numeri successivi per evitare collisioni.

Impostazioni in modalità batch

Tutte le impostazioni di conversione si applicano in modo uniforme a ogni progetto del batch. Non esiste alcun meccanismo per gli override per singolo progetto. La scala fissa del canvas, la scala degli oggetti, i vincoli di dimensione, le dimensioni di ritaglio, la riduzione del layout, la gestione dello sfondo e ogni altra impostazione vengono applicati in modo identico a ogni app nell'esecuzione.

Questa applicazione uniforme ha un'importante implicazione pratica: raggruppare insieme le applicazioni simili durante l'esecuzione di conversioni batch. Le applicazioni che condividono risoluzioni dello schermo, layout delle immagini di sfondo e dimensioni degli oggetti simili funzionano bene in un unico batch. Le applicazioni con layout o design pattern significativamente diversi traggono vantaggio da esecuzioni batch separate con impostazioni differenti.

Flusso di lavoro consigliato per la conversione in batch:

1. Copiare tutti i file QVW e QVF di origine in una cartella di lavoro locale. Non eseguire conversioni batch su directory di produzione o condivisioni di rete.
2. Identificare i gruppi di applicazioni QlikView che condividono caratteristiche di layout simili (risoluzione, immagini di sfondo, densità degli oggetti).
3. Carica un'applicazione rappresentativa di ciascun gruppo in modalità a progetto singolo.
4. Apri Mockup Studio e sperimenta con le impostazioni di canvas fisso, ridimensionamento, ritaglio e vincoli di dimensione fino a ottenere un layout soddisfacente.
5. Prendi nota delle impostazioni che producono il miglior risultato per quel gruppo.
6. Passa alla modalità batch, punta alla cartella contenente quel gruppo e applica le stesse impostazioni.
7. Ripetere per ciascun gruppo di applicazioni.

Questo approccio evita l'errore comune di eseguire un batch di grandi dimensioni con impostazioni generiche per poi dover dedicare tempo a regolare manualmente le singole app in un secondo momento. Pochi minuti di test in Mockup Studio con un campione rappresentativo possono far risparmiare un notevole sforzo su un batch di grandi dimensioni.

Denominazione delle app in modalità batch

Quando si distribuiscono conversioni batch in Qlik Cloud, --qsAppName controlla come viene denominata ciascuna app:

• Non specificato — Ogni app prende il nome dal progetto (<Name>).
• Testo non formattato — Il valore viene utilizzato come prefisso: <prefix> - <Name>.
• Modello con segnaposto — Il valore viene trattato come una stringa di formato.

I seguenti segnaposto sono disponibili nelle stringhe di template.

Ad esempio, --qsAppName "Migrated {name} ({rel})" produce nomi di app come Migrated Sales (region1/finance).

Ulteriori informazioni

• Esecuzione parallela
• Reportistica batch
• Riferimento degli argomenti