Utilizzare Visual Studio Code per lo sviluppo in Salesforce

Nota

Stai seguendo la formazione in italiano? In questo badge, la convalida delle sfide pratiche di Trailhead funziona in inglese. Le traduzioni sono fornite tra parentesi come riferimento. Nel tuo Trailhead Playground, accertati di (1) selezionare Stati Uniti per le impostazioni internazionali, (2) impostare la lingua su Inglese e (3) copiare e incollare soltanto i valori in lingua inglese. Segui le istruzioni qui.

Visita il badge Trailhead nella tua lingua per informazioni dettagliate su come usufruire dell'esperienza Trailhead in altre lingue.

Segui il processo con Trail Together

Hai bisogno dell'assistenza di un insegnante per completare questo passaggio? Dai un'occhiata a questo video, che fa parte della serie Trail Together su Trailhead Live.

(Questa clip inizia al minuto 19:41, nel caso in cui desideri tornare indietro e riguardare l'inizio del passaggio.)

Terminale o Command Palette?

Come ogni strumento di sviluppo di qualità, anche Visual Studio Code consente di fare le cose in più modi Ci sono due canali principali per interagire con Salesforce CLI: il terminale integrato o la finestra di apertura rapida.

Per visualizzare la finestra di apertura rapida, fai Ctrl+P (Windows) o Cmd+P(macOS). Digitando ? è possibile visualizzare il menu della guida. In questo modulo utilizzeremo la finestra di apertura rapida in modalità Command Palette, che ci permette di mostrare ed eseguire i comandi.

Creare un progetto

1. Premi Ctrl+Shift+P (Windows) o Cmd+Shift+P (macOS) per visualizzare il riquadro comandi.
   
2. Assicurati che il nuovo prompt inizi con >.
   
3. Digita SFDX:Create Project (SFDX: Crea progetto).
   
4. Seleziona SFDX: Create Project (SFDX: Crea progetto).
   
5. Seleziona Standard.
   
6. Digita il nome del progetto VSCodeQuickstart e premi Invio.
   
7. Seleziona il tuo Desktop come posizione in cui creare il progetto, per rendere più facile trovarlo in seguito.
   
8. Attendi che si apra la nuova finestra di Visual Studio Code. Dovresti vedere qualcosa che indica che l'estensione sta preparando il tuo progetto prima di popolare l'explorer.
   
   
   

Ricerca di file

1. Premi Ctrl+Shift+P (Windows) o Cmd+Shift+P (macOS) per visualizzare il riquadro di ricerca. Questo sposta l'attenzione sulla ricerca di file.
   
2. Digita project-scratch-def.json nel campo.
   
3. Fai clic sul risultato per aprire il file.
   
4. Fai clic sul menu Search (Cerca) ().
   
5. Cerca orgName.
   
6. Nel primo risultato trovato in project-scratch-def.json.
   
7. Cambia il valore di orgName (dopo i : e tra le "") in Learning VS Code (Imparare VS Code).
   
8. Salva il file facendo Ctrl+S (Windows) o Cmd+S (macOS).
   
   
   

Autenticare l'accesso al Playground

1. Premi Ctrl+Shift+P (Windows) o Cmd+Shift+P (macOS) per visualizzare il riquadro comandi.
   
2. Digita SFDX:Authorize an Org (SFDX: Autorizza un'organizzazione).
   
3. Seleziona SFDX: Authorize an Org (SFDX: autorizza un'Org).
   
4. Per accettare l'URL di accesso predefinito, premi Invio.
   
5. Inserisci l'alias VSCodePlayground.
   
6. Noterai che il browser predefinito apre una nuova finestra di accesso a Salesforce. Accedi al tuo Playground utilizzando il nome utente e la password recuperati nell'ultima fase
   
7. Quando ti viene chiesto di concedere l'accesso all'app connessa, fai clic su Allow (Consenti).
   
8. Chiudi la finestra del browser.
   Al completamento della transazione, la finestra del terminale della riga di comando restituisce un messaggio che indica che l'operazione è riuscita.
   
   

Creare una classe Apex

1. Fai clic sul menu Explorer (Esplora file) () menu.
   
2. Nella directory VSCODEQUICKSTART, fai clic su Force App per visualizzarne la struttura cartelle. Nella directory force-app/main/default si trovano i metadati inclusi nel progetto, ad esempio applicazioni, aura, classi e altro ancora.
   
3. Fai clic con il tasto destro del mouse sulla cartella classes.
   
4. Seleziona SFDX: Create Apex Class (SFDX: crea classe Apex).
   
5. Inserisci il nome AccountController.
   
6. Se VS Code lo richiede, seleziona force-app/main/default/classes come directory a cui aggiungere AccountController.cls.
   
7. Nel file AccountController.cls appena aperto, sostituisci il codice predefinito con quanto segue:
   

   public with sharing class AccountController {
     public static List<Account> getAllActiveAccounts() {
       return [SELECT Id, Name, Active__c FROM Account WHERE Active__c = 'Yes' WITH SECURITY_ENFORCED];
     }
   }

8. Salva il file.
   

Query

La nostra nuova classe Apex contiene una query SOQL, ma dobbiamo assicurarci che funzioni come previsto prima di distribuirla alla nostra Org. Utilizziamo la Command Palette per eseguire la query sulla nostra Org.

1. Nella riga 3 del codice, seleziona la query SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes' (non selezionare WITH SECURITY_ENFORCED).
   
2. Premi Ctrl+Shift+P (Windows) o Cmd+Shift+P (macOS) per visualizzare il riquadro comandi.
   
3. Digita SOQL.
   
4. Seleziona SFDX:Execute SOQL Query with Currently Selected Text (SFDX:Esegui la query SOQL con il testo attualmente selezionato).
   
5. Seleziona REST API e premi Invio.
   
6. Nella scheda Output della finestra del terminale integrato, esamina i risultati della query. Nella finestra dovrebbe essere visualizzato un riepilogo con scritto SFDX: Execute SOQL Query ... ended with exit code 0 (SFDX: esegui query SOQL ... terminata con codice di uscita 0) Ciò significa che è stata eseguita correttamente.
   
   
   

Distribuire

L'ultima fase consiste nel distribuire il codice al Playground a partire da Visual Studio Code.

1. Fai clic con il tasto destro del mouse sulla cartella classes.
   
   
2. Fai clic su SFDX: Deploy Source to Org (SFDX: distribuisci sorgente a Org).
   
3. Nella scheda Output del terminale integrato, visualizza i risultati della distribuzione. Dovresti aver ricevuto anche un avviso con la seguente dicitura: SFDX: Deploy Source to Org ... ended with exit code 0 (SFDX: distribuisci sorgente a Org ... terminata con codice di uscita 0). Ciò significa che è stata eseguita correttamente.
   

Pensieri di commiato

Hai imparato a usare Visual Studio Code e le estensioni di Salesforce. Hai visto come le funzioni di un IDE possono aiutarti a raggiungere la massima efficienza nello sviluppo. Adesso sei pronto per esplorare alcuni argomenti più complessi, come il debug con Apex Replay Debugger, la personalizzazione dell'editor in base alle tue esigenze e la gestione delle pipeline di sviluppo con Visual Studio Code.