# Problemi di build e distribuzione

## La build cloud non riesce con errori oggetto

Possibile causa

Uno o più oggetti non sono stati creati in Qlik Sense. La console visualizza `Build failed` seguito da una descrizione dell'errore. L'errore si verifica tipicamente quando una proprietà dell'oggetto non è supportata dal tipo di visualizzazione di destinazione.

Azione proposta

Aprire l'app in Qlik Sense per esaminare gli oggetti interessati. L'app è stata creata e la maggior parte degli oggetti è stata caricata correttamente. Controlla il report di conversione di Excel per gli oggetti con un esito di Errore. Questi oggetti richiedono correzione manuale nell'editor dell'app Qlik Sense. Esaminare il file di log per esecuzione nella `logs/` sottocartella di output per i dettagli completi dell'errore.

## Caricamento media non riuscito

Possibile causa

Non è stato possibile caricare uno o più file immagine nella libreria multimediale di Qlik Sense. La console visualizza `Media upload failed for N/M file(s)` seguito dal primo dettaglio di errore.

Azione proposta

Verificare che i file immagine esistano e non siano danneggiati. Controlla le dimensioni dei file, poiché immagini molto grandi potrebbero superare i limiti di caricamento. Riprova la distribuzione. Se il problema persiste, caricare le immagini manualmente tramite la Qlik Sense libreria multimediale. Esegui con `--logLevel DEBUG` per identificare quali file non sono riusciti nell'output del log.

## App auto-binaria temporanea rimane dopo una distribuzione fallita

Possibile causa

Il passaggio di compilazione o ricaricamento non è riuscito dopo che il file QVW è stato caricato su Qlik Cloud. QV2QS tenta di eliminare automaticamente l'app temporanea, ma la pulizia potrebbe non riuscire se la connessione di rete viene interrotta o la chiave API è scaduta.

Azione proposta

Controlla lo spazio di destinazione per le app denominate `QV2QS_Binary_YYYYMMDD_HHMMSS` (ad esempio, `QV2QS_Binary_20260219_143025`) ed eliminale manualmente. Riesegui la conversione per rigenerare i file di output. Esaminare il file di log per esecuzione nella `logs/` sottocartella di output per i dettagli degli errori di pulizia.

## I fogli scompaiono dopo aver ridistribuito a un'app esistente

Possibile causa

Il passaggio di preparazione del foglio è fallito a metà. QV2QS rimuove i fogli esistenti dalla cloud app prima della creazione in modo che i nuovi fogli possano essere creati con gli stessi ID. Se il passaggio di rimozione o di compilazione fallisce, l'app potrebbe rimanere in uno stato incompleto.

Azione proposta

Ripristina l'app dal backup automatico pre-distribuzione. I backup vengono salvati in `cloud/backups/` nella cartella di output del progetto. Importa il QVF di backup nello spazio di destinazione tramite l'hub di Qlik Cloud. Quindi eseguire nuovamente la distribuzione. Se non è disponibile alcun backup, eseguire nuovamente la conversione come una nuova app omettendo `--reuseAppId` e `--appId`.

## Nuovi fogli non vengono pubblicati dopo aver ridistribuito a un'app esistente

Possibile causa

L'impostazione Pubblicazione fogli è stata disabilitata durante la ridistribuzione. Quando si riutilizza un'app esistente, QV2QS ripristina automaticamente lo stato di pubblicazione dei fogli precedentemente distribuiti, ma i nuovi fogli vengono pubblicati solo quando l'Pubblica fogli impostazione è abilitata.

Azione proposta

Riesegui la distribuzione con Pubblica fogli abilitato (l'impostazione predefinita). In alternativa, pubblica nuovi fogli manualmente in Qlik Cloud. Aprire l'app, fare clic con il pulsante destro del mouse su ogni foglio non pubblicato e selezionare Pubblica.

## Scopri di più

* [Compilazione e distribuzione](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/build-and-deployment.htm)
* [Riutilizzo di un'app esistente](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)
* [Limiti delle risorse di Qlik Cloud](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/known-limitations/qlik-cloud-resource-limits.htm)
* [Rapporto di conversione](https://help.qlik.com/it-IT/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)