Compilazione e distribuzione
Ultimo aggiornamento: 14/10/2026Dopo aver generato l'output della build locale, QV2QS distribuisce l'app convertita su Qlik Cloud attraverso una serie di passaggi automatizzati.
Quando si esegue una conversione senza --unbuildOnly, QV2QS esegue i seguenti passaggi dopo aver generato l'output della build locale:
- Crea o riutilizza un'app Qlik Sense sul tenant. QV2QS utilizza il marcatore
.qv2qs_sourcenella cartella di output per individuare il progetto corretto per il file QVW di origine. Per informazioni dettagliate, vedere Riutilizzo di un'app esistente. - Esporta un backup QVF senza dati dell'app esistente (quando si riutilizza un'app esistente). Utilizza
--noBackupper saltare. - Caricare gli sfondi del foglio, le immagini di sfondo dell'oggetto e le immagini del pulsante nella libreria multimediale dell'app.
- Preparare i fogli (quando si riutilizza un'app esistente). QV2QS registra lo stato di pubblicazione e il rango di ciascun foglio esistente, rimuove i vecchi fogli dall'app cloud e applica una patch all'output della build locale con gli ID dei fogli cloud originali.
- Compila l'app sul tenant.
- Ripristina i fogli (quando si riutilizza un'app esistente). QV2QS ripubblica i fogli che erano stati precedentemente pubblicati e ne ripristina l'ordine originale.
- Pubblica tutti i fogli convertiti come fogli di base (solo nuove app).
Pubblicazione di un foglio
Dopo aver creato l'app, QV2QS pubblica ogni foglio convertito come foglio di base. I fogli di base sono visibili a tutti gli utenti che hanno accesso all'app. Senza la pubblicazione, i fogli rimangono oggetti personali che solo il proprietario dell'app può visualizzare.
La pubblicazione dei fogli viene eseguita automaticamente in entrambe le modalità Build to Qlik Cloud ed Export QVF. In modalità Esporta QVF, lo stato di pubblicazione viene mantenuto all'interno del file QVF esportato.
Per saltare la pubblicazione dei fogli, passare --noPublishSheets sulla riga di comando oppure disabilitare Pubblica fogli nella procedura guidata. Se disabilitata, i fogli rimangono non pubblicati e il proprietario dell'app deve pubblicarli manualmente in Qlik Cloud.
Quando si riutilizza un'app esistente (--reuseAppId o --appId), il passaggio di pubblicazione standard viene sostituito da un passaggio di ripristino automatico. QV2QS registra lo stato di pubblicazione di ciascun foglio prima della build, quindi ripubblica i fogli precedentemente pubblicati al termine della build. I nuovi fogli aggiunti nella conversione corrente vengono pubblicati come fogli di base quando l'impostazione Pubblica fogli è abilitata. Passare --noPublishSheets per lasciare i nuovi fogli non pubblicati.
Gli argomenti di distribuzione includono --qsAppName, --spaceId, --reload, --noData, --noPublishSheets e --unbuildOnly. Per l'elenco completo, consulta Riferimento agli argomenti.