

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risoluzione dei problemi con le trasformazioni Java
<a name="troubleshooting-code-transformation"></a>

Le seguenti informazioni possono aiutare a risolvere i problemi più comuni durante la trasformazione delle applicazioni Java con Amazon Q Developer.

**Topics**
+ [Perché Amazon Q non riesce a caricare il mio progetto?](#project-upload-fail)
+ [Perché i miei comandi Maven non riescono?](#maven-commands-failing)
+ [Come faccio ad aggiungere Maven al mio `PATH`?](#add-maven-to-path)
+ [Perché Amazon Q non riesce a creare il mio codice?](#build-fail)
+ [Perché la mia trasformazione non è riuscita dopo 55 minuti?](#build-time-limit)
+ [Perché non riesco a scaricare il mio codice trasformato?](#download-code-fail)
+ [Come si accede ai log di trasformazione del codice?](#logs)
+ [Come trovo l’ID del processo di trasformazione?](#job-id)

## Perché Amazon Q non riesce a caricare il mio progetto?
<a name="project-upload-fail"></a>

Se il progetto non viene caricato, è probabile che sia dovuto a uno dei seguenti problemi. Consulta l’argomento che corrisponde all’errore visualizzato in Amazon Q. 

**Topics**
+ [Riduci le dimensioni del progetto](#reduce-project-size)
+ [Configura le impostazioni del proxy nell’IDE](#configure-proxy)
+ [Consenti l’accesso ad Amazon S3](#allowlist-s3-bucket)

### Riduci le dimensioni del progetto
<a name="reduce-project-size"></a>

Per trasformare il codice, Amazon Q genera un artefatto del progetto, che include il codice sorgente, le dipendenze del progetto e i log delle build. La dimensione massima degli artefatti del progetto per un processo di trasformazione è di 2 GB. Se viene visualizzato un errore relativo alla dimensione dell’artefatto del progetto, è necessario ridurre le dimensioni del progetto o provare a trasformare un progetto più piccolo. È possibile visualizzare la dimensione del file dell’artefatto del progetto nei log di trasformazione del codice. Per ulteriori informazioni, consulta [Come si accede ai log di trasformazione del codice?](#logs)

### Configura le impostazioni del proxy nell’IDE
<a name="configure-proxy"></a>

Per trasformare il codice, Amazon Q carica l’artefatto del progetto in un bucket Amazon S3 di proprietà del servizio. Parte del processo di caricamento prevede l’utilizzo di certificati SSL o TLS per stabilire la comunicazione tra Amazon S3 e il tuo IDE. Se utilizzi un server proxy, i certificati SSL o TLS utilizzati dal tuo server proxy devono essere attendibili, altrimenti Amazon Q non sarà in grado di caricare il tuo progetto. 

Se ricevi un errore relativo al proxy o ai certificati, probabilmente dovrai configurare l’IDE o il sistema operativo in modo che i certificati siano attendibili o che aggiorni altre impostazioni del proxy.

**Nota**  
Potresti inoltre riscontrare problemi non correlati ai certificati se utilizzi il server proxy o il firewall della tua organizzazione. Se completi le seguenti procedure per configurare i certificati e hai ancora problemi, contatta l’amministratore di rete per assicurarti di poter comunicare con Amazon S3 dal tuo IDE. Per ulteriori informazioni, consulta [Consenti l’accesso ad Amazon S3](#allowlist-s3-bucket). 

#### Configura i certificati in JetBrains
<a name="configure-proxy-JB"></a>

Per configurare l’ambiente di runtime Java (JRE) dell’IDE di JetBrains in modo che consideri attendibili i certificati SSL o TLS utilizzati dal server proxy, è necessario importare i certificati SSL o TLS nel file `cacerts` in JRE. Il file `cacerts` che contiene certificati root attendibili per connessioni sicure come HTTPS e SSL e fa parte delle impostazioni di sicurezza di JRE. Per importare un certificato, completa la procedura seguente. 

**Nota**  
Si raccomanda di eseguire un backup del file `cacerts` prima di modificarlo, poiché eventuali errori possono causare problemi con le connessioni sicure.

1. Determina il percorso del file `cacerts` in JRE. Il percorso del file `cacerts` nel JRE interno fornito con l’IDE di JetBrains dipende dal sistema operativo e dalla versione dell’IDE di JetBrains in uso. 

   Di seguito sono riportati alcuni esempi di percorsi del file `cacerts` nei sistemi operativi più comuni. Scegli il sistema operativo per vedere degli esempi.
**Nota**  
 `<JetBrains Installation Folder>` si riferisce alla directory in cui sono installati i prodotti JetBrains. In genere, questa directory viene scelta durante il processo di installazione.  
La `jbr` cartella rappresenta il pacchetto JRE fornito con JetBrains IDEs, che è una versione specifica di JRE personalizzata per l'uso con. JetBrains IDEs

------
#### [ Windows ]

   Il percorso del file `cacerts` per un IDE JetBrains installato su Windows è:

   ```
   <JetBrains Installation Folder>\jbr\bin\cacerts
   ```

   Ad esempio, se hai installato un IDE JetBrains su Windows nella posizione predefinita, il percorso potrebbe essere:

   ```
   C:\Program Files\JetBrains\jbr\bin\cacerts
   ```

------
#### [ macOS ]

   Il percorso del file `cacerts` per un IDE JetBrains installato su macOS è:

   ```
   /Applications/JetBrains Toolbox/<version>/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
   ```

   Ad esempio, se hai installato un IDE JetBrains su macOS nella posizione predefinita, il percorso potrebbe essere:

   ```
   /Applications/JetBrains Toolbox/2022.3.4/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
   ```

------
#### [ Linux ]

   Il percorso del file `cacerts` per un IDE JetBrains installato su Linux è:

   ```
   /opt/jetbrains/jbr/lib/security/cacerts
   ```

------

1. Determina il certificato da importare nel file `cacerts`. Il file del certificato ha in genere un’estensione di file `.cer`, `.crt` o `.der`. Se non sei sicuro dei certificati da aggiungere, contatta l’amministratore di rete.

1. Importa il certificato firmato nel keystore `cacerts`. È possibile farlo tramite il comando `keytool` di Java. 

   1. Apri un prompt dei comandi e inserisci il comando seguente:

      ```
      keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>
      ```

   1. Per `<alias>`, puoi infatti aggiungere un nome per il certificato che stai importando per utilizzarlo in un secondo momento. Questa opzione è facoltativa.

   1. Per `<certificate_file>`, specifica il percorso del certificato che stai importando. Dovrebbe essere il percorso del file `.cer`, `.crt` o `.der` contenente il certificato.

   1. Per `<path_to_cacerts>`, specificare il percorso del file keystore `cacerts` salvato nella fase 1. Questo è il file in cui stai importando il certificato. 

   Ad esempio, se desideri importare un certificato denominato `my_certificate.cer` nel keystore `cacerts` del pacchetto JRE incluso in IntelliJ IDEA su Windows e desideri assegnare l’alias `myalias` al certificato, il comando potrebbe essere:

   ```
   keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"
   ```

1. Durante il processo di importazione, ti verrà richiesto di inserire la password del keystore. La password predefinita per il keystore `cacerts` è `changeit`. 

1. Dopo aver eseguito il comando, ti verrà chiesto di considerare attendibile il certificato. Per confermare che il certificato è attendibile e completare l’importazione, inserisci `yes`.

1. Potrebbe inoltre essere necessario aggiungere i certificati all’IDE stesso, oltre al JRE. Per ulteriori informazioni, consulta [Certificati server](https://www.jetbrains.com/help/idea/settings-tools-server-certificates.html) nella documentazione di JetBrains.

#### Configura i certificati in Visual Studio Code
<a name="configure-proxy-VSC"></a>

Per configurare Visual Studio Code in funzione dell’attendibilità dei certificati SSL o TLS utilizzati dal server proxy, assicurati di aver configurato le seguenti impostazioni proxy per il sistema operativo.

##### Configura i certificati in Visual Studio Code in macOS
<a name="certs-mac"></a>

Configura le seguenti impostazioni proxy per Visual Studio Code in macOS.

##### Aggiungi certificati al tuo portachiavi macOS
<a name="w2aac11c16c17c13c23b7b9c11b5b1b5"></a>

Se non l’hai già fatto, devi aggiungere i certificati utilizzati dal server proxy al tuo portachiavi macOS. Per informazioni sull’aggiunta di certificati al portachiavi, consulta [Aggiungere certificati a un portachiavi utilizzando Accesso Portachiavi sul Mac](https://support.apple.com/guide/keychain-access/add-certificates-to-a-keychain-kyca2431/mac) nel Manuale utente di Accesso Portachiavi.

##### Installa l'estensione Mac CA VSCode
<a name="w2aac11c16c17c13c23b7b9c11b5b1b7"></a>

L'[ VSCode estensione Mac CA](https://marketplace.visualstudio.com/items?itemName=linhmtran168.mac-ca-vscode) consente ad Amazon Q di accedere ai certificati che hai aggiunto a Keychain Access sul tuo Mac. 

Per installare l’estensione:

1. Cerca `mac-ca-vscode` nel pannello delle estensioni di VS Code e scegli **Installa**. 

1. Riavviare VS Code.

##### Aggiorna le impostazioni del proxy in VS Code in macOS
<a name="w2aac11c16c17c13c23b7b9c11b5b1b9"></a>

Aggiorna le seguenti impostazioni per assicurarti che VS Code sia configurato correttamente per il proxy. 

1. Apri le impostazioni in VS Code.

1. Inserire `proxy` nella barra di ricerca.

1. Nel campo **Http: Proxy**, aggiungi l’URL del proxy.

1. Deseleziona **Http: Proxy Strict SSL**.

1. Nell’elenco a discesa **Http: Proxy Support**, scegli **attivo**.

1. Nella barra di ricerca delle impostazioni, inserisci `http.experimental.systemCertificatesV2`. Seleziona **Http › Experimental: System Certificates V2**. 

##### Configura i certificati in Visual Studio Code su Windows
<a name="certs-windows"></a>

Configura le seguenti impostazioni proxy per Visual Studio Code su Windows.

##### Aggiungi il certificato come certificato root attendibile su Windows
<a name="w2aac11c16c17c13c23b7b9c11b5b3b5"></a>

Se non l’hai già fatto, devi aggiungere i certificati utilizzati dal server proxy all’archivio Certificati delle autorità di certificazione radice attendibili in Windows. Per creare un certificato, completa la procedura seguente: 

1. Apri lo strumento di ricerca o la finestra di comando Esegui. 

1. Inserisci il comando seguente per aprire lo strumento Gestione certificati:

   ```
   certmgr.msc
   ```

1. Scegli l’archivio **Certificati delle autorità di certificazione radice attendibili**.

1. Fai clic con il pulsante destro del mouse su **Certificati** scegli **Tutte le attività** e quindi **Importa**.

1. Segui le istruzioni fornite per importare il certificato proxy.

1. Dopo aver importato il certificato, conferma che è stato aggiunto. 

   Nell’archivio **Certificati delle autorità di certificazione radice attendibili** fai doppio clic su **Certificati**. Fai clic con il pulsante destro del mouse sul certificato aggiunto e scegli **Proprietà**. In **Scopi del certificato**, deve essere selezionata l’opzione **Abilita tutti gli scopi per questo certificato**.

##### Installa l'estensione Win-CA VSCode
<a name="w2aac11c16c17c13c23b7b9c11b5b3b7"></a>

L'[ VSCode estensione Win-CA](https://marketplace.visualstudio.com/items?itemName=ukoloff.win-ca) consente ad Amazon Q di accedere ai certificati che hai aggiunto ai Trusted Root Certificates in Windows. 

Per installare l’estensione:

1. Cerca `win-ca ` nel pannello delle impostazioni di VS Code.

1. Nell’elenco a discesa **Inserisci**, scegli **aggiungi**.

##### Aggiorna le impostazioni del proxy in Windows VS Code
<a name="w2aac11c16c17c13c23b7b9c11b5b3b9"></a>

Aggiorna le seguenti impostazioni per assicurarti che VS Code sia configurato correttamente per il proxy. 

1. Apri le impostazioni in VS Code.

1. Inserire `proxy` nella barra di ricerca.

1. Nel campo **Http: Proxy**, aggiungi l’URL del proxy.

1. Deseleziona **Http: Proxy Strict SSL**.

1. Nell’elenco a discesa **Http: Proxy Support**, scegli **attivo**.

1. Nella barra di ricerca delle impostazioni, inserisci `http.experimental.systemCertificatesV2`. Seleziona **Http › Experimental: System Certificates V2**. 

1. Riavviare VS Code.

### Consenti l’accesso ad Amazon S3
<a name="allowlist-s3-bucket"></a>

Durante una trasformazione, Amazon Q carica il codice in un bucket Amazon S3 di proprietà del servizio. Se la tua rete o organizzazione non ha configurato l’accesso ad Amazon S3, Amazon Q non è in grado di caricare il progetto. 

Per garantire che Amazon Q possa caricare il progetto, assicurati che la configurazione del proxy e gli altri componenti di rete, come le policy di prevenzione della perdita dei dati (DLP), siano configurati per consentire l’accesso ad Amazon S3. Potrebbe anche essere necessario creare un elenco dei bucket Amazon S3 consentiti in cui Amazon Q carica il progetto. Per ulteriori informazioni, consulta [Bucket URLs Amazon S3 e elenco dei dati consentiti ARNs](firewall.md#data-perimeters). 

Se trasformi un progetto di grandi dimensioni, le policy DLP o altri componenti di rete potrebbero causare ritardi e impedire il corretto caricamento se non sono configurati per inserire nell’elenco degli elementi consentiti il bucket Amazon S3. Se scegli di non inserire il bucket nell’elenco degli elementi consentiti, potresti dover trasformare un progetto più piccolo in modo che Amazon Q possa caricarlo.

## Perché i miei comandi Maven non riescono?
<a name="maven-commands-failing"></a>

Di seguito sono riportati i problemi di Maven configurazione che potresti riscontrare nella JetBrains e. Visual Studio Code IDEs Se risolvi i problemi e riscontri ancora degli errori Maven, il problema potrebbe riguardare il progetto. Utilizza le informazioni contenute nei log degli errori per risolvere eventuali problemi relativi al progetto, quindi prova a trasformarlo nuovamente. 

### Aggiorna la configurazione di Maven in JetBrains
<a name="jetbrains"></a>

Se una trasformazione non riesce in JetBrains a causa di problemi con il comando Maven, i log degli errori vengono visualizzati nella scheda **Esegui**. Utilizza le informazioni nei log per risolvere il problema. Di seguito sono riportati alcuni problemi che potresti dover risolvere: 
+ Assicurati che il percorso Maven principale sia impostato su **In bundle**. Nella finestra di dialogo **Impostazioni**, espandi la sezione **Creazione, esecuzione e implementazione**. Espandi la sezione **Strumenti di creazione**, quindi espandi **Maven**. Nell’elenco a discesa del **percorso principale di Maven**, scegli **In bundle**. 
+ Assicurati che l’ambiente di runtime Java (JRE) utilizzi il tuo progetto JDK. Nella finestra di dialogo **Impostazioni**, espandi la sezione **Creazione, esecuzione e implementazione**. Espandi **Maven** e scegli **Runner**. Nell’elenco a discesa **JRE**, scegli **Usa progetto JDK**. 
+ Assicurati che Maven sia abilitato. Vai su **Impostazioni** e scegli **Plugin**. Cerca Maven e quindi seleziona il plugin Maven. Se vedi un pulsante **Abilita**, sceglilo per abilitare Maven. 

### Aggiorna la configurazione di Maven in Visual Studio Code
<a name="vscode"></a>

Se una trasformazione non riesce in VS Code a causa di problemi con il comando Maven, si apre un file di testo contenente i log degli errori in una nuova scheda. Utilizza le informazioni nei log per risolvere il problema.

Assicurati di configurare una delle seguenti opzioni: 
+ Il progetto contiene un wrapper Maven nella cartella root del progetto
+ Una versione di Maven supportata da Amazon Q è disponibile su `PATH`

Per ulteriori informazioni, consulta [Come faccio ad aggiungere Maven al mio `PATH`?](#add-maven-to-path) 

## Come faccio ad aggiungere Maven al mio `PATH`?
<a name="add-maven-to-path"></a>

Per trasformare il codice in VS Code senza utilizzare un wrapper Maven, è necessario installare Maven e aggiungerlo alla variabile `PATH`. 

Per verificare se l’installazione di Maven è già stata eseguita correttamente, esegui `mvn -v` in un nuovo terminale del sistema operativo esterno a Visual Studio Code. Dovresti vedere un output con la tua versione di Maven.

Se ottieni un output nel terminale di Visual Studio Code ma non nel terminale del sistema operativo, o se il comando non viene trovato, devi aggiungere Maven a `PATH`.

 Per aggiungere Maven a `PATH`, segui le istruzioni del tuo computer.

------
#### [ macOS ]

Per aggiungere Maven al `PATH` di macOS, completa le seguenti fasi.

1. Individua la directory di installazione di Maven o la cartella in cui è stato installato Maven e salva il percorso di tale cartella.

1. Apri il file di configurazione per la tua shell in un editor a scelta. Per le versioni recenti di macOS, la shell predefinita è `zsh` e il file di configurazione predefinito si trova in `~/.zshrc`. 

   Aggiungi le seguenti righe in fondo al file di configurazione. Imposta il valore `M2_HOME` nel percorso salvato nella fase 1:

   ```
   export M2_HOME="your Maven installation directory"
   export PATH="${M2_HOME}/bin:${PATH}"
   ```

   Questi comandi rendono il comando `mvn` disponibile in tutti i terminali.

1. Chiudi tutte le finestre del terminale del sistema operativo e tutte le istanze di Visual Studio Code.

1. Per verificare che Maven sia stato aggiunto al tuo `PATH`, apri un nuovo terminale del sistema operativo ed esegui il seguente comando:

   ```
   mvn -v
   ```

   Dovresti vedere un output con la tua versione di Maven.

1. Dopo aver visto l’output di Maven, riavvia Visual Studio Code. Potrebbe anche essere necessario riavviare il computer. Apri un nuovo terminale in Visual Studio Code ed esegui i comandi seguenti: 

   ```
   mvn -v
   ```

   L’output deve essere identico a quello della fase 4. Se l’output di Visual Studio Code è diverso, prova quanto segue per assicurarti che la configurazione sia corretta:
   + Controlla la variabile `PATH` in Visual Studio Code. Un’estensione IDE potrebbe alterare il `PATH` in modo tale da renderlo diverso dalla variabile del `PATH` locale. Disinstalla l’estensione per rimuoverla dal `PATH`.
   + Controlla la tua shell predefinita in Visual Studio Code. Se è impostata su qualcosa di diverso da `zsh`, ripeti queste fasi per la shell.

------
#### [ Windows ]

Per aggiungere Maven al `PATH` di Windows, completa le seguenti fasi: 

1. Individua la directory di installazione di Maven o la cartella in cui è stato installato Maven e salva il percorso di tale cartella.

1. Apri la finestra Variabili di ambiente:

   1. Scegli il pulsante Windows per aprire la barra di ricerca.

   1. Entra in `Edit environment variables for your account` e sceglilo.

1. Nella finestra **Variabili di ambiente**, cerca la variabile Path. Se hai già una variabile Path, scegli **Modifica...** per aggiornarla. Se non vedi una variabile Path, scegli **Nuovo...** per aggiungerne una. 

1. Nella finestra **Modifica variabile di ambiente** che appare, fai doppio clic sul percorso esistente per modificarlo oppure scegli **Nuovo** per aggiungere una nuova voce di percorso.

   Sostituisci la voce del percorso Maven esistente con il percorso salvato nella fase 1 o aggiungi il percorso come nuova voce. Alla fine del percorso, aggiungi `\bin` come suffisso, come nell’esempio seguente:

   ```
   C:\Users\yourusername\Downloads\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin
   ```

1. Scegli **OK** per salvare l’immissione del percorso, quindi scegli nuovamente **OK** nella finestra **Variabili di ambiente**.

1. Apri un nuovo prompt dei comandi ed eseguire il comando seguente:

   ```
   mvn -v
   ```

   Dovresti vedere un output con la tua versione di Maven.

------

## Perché Amazon Q non riesce a creare il mio codice?
<a name="build-fail"></a>

Se la trasformazione non riesce durante la creazione del codice da parte di Amazon Q, il progetto potrebbe non essere configurato correttamente per l’ambiente in cui Amazon Q crea il codice. Potrebbe essere necessario aggiornare la configurazione della build o l’implementazione del codice.

Esamina l’output del log della build fornita da Amazon Q per determinare se sono presenti delle modifiche che puoi apportare al progetto. Di seguito sono riportati alcuni problemi comuni che potrebbero impedire ad Amazon Q di creare il codice. 

### Rimuovi i percorsi assoluti in pom.xml
<a name="remove-absolute-path"></a>

Se è presente un percorso assoluto nel tuo file pom.xml, Amazon Q non sarà in grado di trovare i file pertinenti e, di conseguenza, potrebbe non essere in grado di creare il codice.

Di seguito è riportato un esempio di percorso assoluto che potresti ritrovare nel tuo file `pom.xml`:

```
<toolspath>
    <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path>
</toolspath>
```

Invece di utilizzare un percorso assoluto, puoi creare un percorso relativo utilizzando un puntatore. Di seguito è riportato un esempio di come è possibile sostituire il percorso assoluto precedente con un percorso relativo:

```
<toolspath>
    <path>${java.home}/../lib/tools.jar</path>
</toolspath>
```

### Rimuovi i database locali o esterni nei test di unità
<a name="remove-external-databases"></a>

Amazon Q esegue tutti i test di unità del tuo progetto quando crea il codice. Se un test di unità richiama un database locale o esterno, Amazon Q non avrà accesso al database, causando un errore di compilazione. Per evitare che la compilazione non riesca, devi rimuovere la chiamata al database dal test di unità o rimuovere il test di unità prima di inviare la trasformazione. 

## Perché la mia trasformazione non è riuscita dopo 55 minuti?
<a name="build-time-limit"></a>

Se il processo di trasformazione del codice non riesce dopo 55 minuti, è probabile che il tempo di compilazione del codice superi il limite di compilazione. Attualmente è previsto un limite di tempo di 55 minuti per la creazione del codice. 

Se il tempo di compilazione locale richiede 55 minuti o più, riduci il tempo di compilazione del progetto per trasformare il codice. Se la compilazione locale è più veloce di quella effettuata con Trasformazione del codice, controlla se nel progetto sono presenti attività che potrebbero non riuscire o richiedere più tempo in un ambiente diverso. Prendi in considerazione la possibilità di disabilitare i casi di test di lunga durata. Valuta anche la possibilità di utilizzare dei timeout per i tentativi di accesso a risorse che potrebbero non essere disponibili nell’ambiente IDE sicuro o su Internet. 

## Perché non riesco a scaricare il mio codice trasformato?
<a name="download-code-fail"></a>

Se non riesci a scaricare il codice dopo il completamento della trasformazione, probabilmente si tratta di uno dei seguenti problemi. Consulta l’argomento che corrisponde all’errore visualizzato in Amazon Q. 

**Topics**
+ [Riduci le dimensioni del progetto](#reduce-project-size-output)
+ [Scarica il codice diff entro 30 giorni](#download-30-hrs)
+ [Configura le impostazioni del proxy nell’IDE](#configure-proxy-download)
+ [Rimuovi i caratteri jolly nelle impostazioni proxy di JetBrains](#remove-wildcard)

### Riduci le dimensioni del progetto
<a name="reduce-project-size-output"></a>

Una volta completata la trasformazione, Amazon Q genera un artefatto di output che contiene un diff con il codice aggiornato e un riepilogo della trasformazione con informazioni sulle modifiche apportate. L’artefatto di output deve essere pari o inferiore a 1 GB per consentire all’IDE di scaricarlo. 

Se l’artefatto di output supera il limite, non sarai in grado di scaricare il codice aggiornato o il riepilogo della trasformazione. Prova a trasformare un progetto più piccolo per evitare un artefatto di output di grandi dimensioni. Se il problema persiste, contatta Supporto. Per informazioni su come contattare Supporto Amazon Q, consulta[Utilizzo di Amazon Q Developer per chattare con Supporto](support-chat.md).

### Scarica il codice diff entro 30 giorni
<a name="download-30-hrs"></a>

Il file code diff con il codice aggiornato è disponibile solo per 30 giorni dopo il completamento della trasformazione. Se sono trascorsi più di 30 giorni dal completamento della trasformazione, riavvia la trasformazione per scaricare il file diff.

### Configura le impostazioni del proxy nell’IDE
<a name="configure-proxy-download"></a>

Amazon Q scarica il codice aggiornato da un bucket Amazon S3 di proprietà del servizio. Parte del processo di download prevede l’utilizzo di certificati SSL o TLS per stabilire la comunicazione tra Amazon S3 e il tuo IDE. Se utilizzi un server proxy, i certificati SSL o TLS utilizzati dal tuo server proxy devono essere attendibili, altrimenti Amazon Q non sarà in grado di caricare il tuo progetto.

Per scaricare il codice, potrebbe essere necessario configurare l’IDE in modo che consideri attendibili i certificati o aggiornare altre impostazioni del proxy. Per ulteriori informazioni o per l’aggiornamento delle impostazioni del proxy, consulta [Configura le impostazioni del proxy nell’IDE](#configure-proxy).

### Rimuovi i caratteri jolly nelle impostazioni proxy di JetBrains
<a name="remove-wildcard"></a>

Se hai configurato le impostazioni proxy nell’IDE di JetBrains, potresti visualizzare il seguente errore durante il download del codice aggiornato: 

```
software.amazon.awssdk.core.exception.SdkClientException: 
Unable to execute HTTP request: Dangling meta character '*' near index 0
```

Ciò è probabilmente causato dalla presenza di un carattere jolly (\$1) nel campo **Nessun proxy per** delle impostazioni proxy dell’IDE. L’SDK Java utilizzato da Amazon Q non supporta le voci con caratteri jolly in questo campo. 

Per scaricare il codice, rimuovi eventuali caratteri jolly dal campo **Nessun proxy per**, quindi riavvia l’IDE. Se devi specificare degli host che devono ignorare il proxy, usa un’espressione regolare anziché un jolly. Per aggiornare le impostazioni del proxy nel tuo JetBrains IDE, consulta [Proxy HTTP](https://www.jetbrains.com/help/idea/settings-http-proxy.html) nella JetBrains documentazione.

## Come si accede ai log di trasformazione del codice?
<a name="logs"></a>

### Log di accesso in JetBrains
<a name="jetbrains-logs"></a>

Per informazioni su come accedere ai file di log di JetBrains, consulta [Locating IDE log files](https://intellij-support.jetbrains.com/hc/en-us/articles/207241085-Locating-IDE-log-files) nella documentazione di JetBrains. 

Per trovare i log emessi da Amazon Q in JetBrains, cerca nei log IDE la seguente stringa:

```
software.aws.toolkits.jetbrains.services.codemodernizer
```

I log di trasformazione del codice iniziano con la stringa precedente. I log generati da Maven vengono visualizzati nella scheda **Esegui** e presentano la stringa precedente prima e dopo la voce di log. 

### Log di accesso in Visual Studio Code
<a name="vsc-logs"></a>

Per trovare i log emessi da Amazon Q in VS Code, completa le fasi seguenti:

1. Scegli **Visualizza** nella barra di navigazione in alto, quindi scegli **Tavolozza dei comandi**.

1. Cerca `Amazon Q: View Logs` nella tavolozza dei comandi che appare.

1. I log si aprono nell’IDE. Per cercare i file di log in `CodeTransformation`, usa `CMD + F` o `Control + F`. 

I log della trasformazione del codice in VS Code hanno il prefisso `CodeTransformation:`. Di seguito è riportato un esempio di log generato in VS Code per un errore relativo alle dipendenze di copia di Maven:

```
2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found
```

## Come trovo l’ID del processo di trasformazione?
<a name="job-id"></a>

### Trova l’ID del processo in JetBrains
<a name="jetbrains"></a>

Per trovare un ID del processo di trasformazione in JetBrains, vai alla scheda **Dettagli trasformazione** nell’**Hub trasformazione** e scegli l’icona **Mostra stato del processo** (clock). 

### Trova l’ID del processo in Visual Studio Code
<a name="vs-code"></a>

Per trovare un ID del processo di trasformazione in VS Code, vai all’**Hub trasformazione** e scegli l’icona **Mostra stato del processo** (clock). 