Utilizzare Visual Studio Code per lo sviluppo in Salesforce

Seguire 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 della fase.)

Terminale o riquadro comandi?

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, premi 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à riquadro comandi, che ci permette di visualizzare 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 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'organizzazione).
   
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.
   Quando la transazione è completata, la finestra del terminale della riga di comando restituisce un messaggio di 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 delle 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 te lo chiede, 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 organizzazione. Utilizziamo il riquadro comandi per eseguire la query sulla nostra organizzazione.

1. Nella riga 3 del codice, evidenzia la query SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes' (non evidenziare 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 il messaggio seguente: SFDX: Execute SOQL Query ... displaying the records it found. (SFDX: esegui query SOQL ... visualizzazione dei record trovati.) 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 This Source to Org (SFDX: Distribuisci sorgente a organizzazione).
   
3. Nella scheda Output del terminale integrato, visualizza i risultati della distribuzione. Dovresti aver ricevuto anche un avviso con la seguente dicitura: SFDX: Deploy this Source to Org (SFDX: Distribuisci sorgente a organizzazione). 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.