Iniziare a utilizzare Apex
Obiettivi di apprendimento
Al completamento di questa unità, sarai in grado di:
- Definire che cosa è il codice.
- Descrivere dove è possibile archiviare e modificare il codice.
- Descrivere due modi di creare commenti all'interno del codice.
- Spiegare perché è importante inserire commenti all'interno del codice.
Ti interessa espandere la tua conoscenza di Salesforce imparando a programmare in Apex? Bene, sei nel posto giusto! Ti guideremo passo dopo passo nel mondo della programmazione, dove imparerai a leggere e a scrivere codice. All'inizio potrebbe farti un po' paura, ma non preoccuparti: faremo in modo che anche i concetti più complessi siano alla tua portata.
In qualità di amministratore, conosci già in dettaglio le funzionalità di Salesforce e i loro limiti attuali. Hai esperienza nell'utilizzo di Flow Builder per automatizzare i processi aziendali e ami mettere a disposizione dei tuoi clienti le migliori applicazioni personalizzate. Nel corso di questo modulo apprenderai prima i concetti della programmazione e, successivamente, potrai metterti alla prova con degli esempi.
Siamo pronti? Cominciamo!
Che cos'è il codice?
Il codice è il linguaggio che gli esseri umani utilizzano per comunicare con i computer. Utilizziamo il codice per scrivere precise serie di istruzioni che servono a eseguire azioni specifiche. Puoi pensare al codice come a una ricetta. Tutti gli ingredienti e le istruzioni devono essere precisi, in modo che il piatto riesca come ti aspettavi.
Proprio come le persone in tutto il mondo utilizzano lingue diverse, i computer utilizzano linguaggi diversi: ad esempio, JavaSrcipt, Java, Ruby, Python e molti altri. Anche se sono diversi sotto molti aspetti, tutti i linguaggi di programmazione si basano sulle stesse strutture fondamentali e possono essere interpretati da un computer per creare applicazioni. Man mano che approfondisci la tua conoscenza del linguaggio di programmazione Apex, comincerai a comprendere le strutture della programmazione.
Dove è archiviato il codice Apex?
Forse ti stai chiedendo: da dove posso cominciare? Per prima cosa, dobbiamo capire dove viene archiviato il codice. Il codice viene archiviato in file. Questi file possono essere archiviati localmente (sul tuo PC o sul tuo Mac) oppure possono essere salvati localmente e sincronizzati automaticamente sul cloud, ossia nella tua organizzazione Salesforce. Fantastico, vero?
La Developer Console
Come amministratore hai probabilmente sentito parlare della Developer Console. La Developer Console è uno strumento che gli sviluppatori utilizzano per creare e modificare file che contengono codice. Nel corso di questo modulo utilizzeremo la Developer Console per archiviare ed eseguire il codice nella tua organizzazione Salesforce. Diamo un'occhiata.
Per accedere alla Developer Console:
- Per prima cosa, assicurati di aver effettuato l'accesso a Trailhead.
- Poi fai clic sul tuo avatar utente nell'angolo in alto a destra di questa pagina e seleziona Organizzazioni pratiche dal menu a discesa.
- Fai clic sul nome utente per avviare la tua organizzazione. Se vuoi creare una nuova organizzazione, leggi il modulo Gestire i Trailhead Playground per scoprire come fare.
- Nel tuo Trailhead Playground, fai clic su
e seleziona Developer Console.
Tieni la Developer Console aperta: nel corso di questo modulo la utilizzeremo per testare il codice.
Scrivere pseudocodice
La parte più importante di qualsiasi progetto a cui partecipi come amministratore Salesforce è la pianificazione. La pianificazione ti consente di comprendere i bisogni dei tuoi clienti, di organizzare i pensieri e prevedere i problemi che potresti riscontrare durante lo sviluppo dell'applicazione.
Durante la fase di pianificazione di un progetto, prima di iniziare a scrivere codice Apex, gli sviluppatori scrivono lo pseudocodice. Lo pseudocodice è una descrizione dettagliata ma leggibile di quello che un programma o una funzionalità deve fare. È scritto nel linguaggio naturale, non in quello di programmazione. Lo pseudocodice consente a chi non è un programmatore di rivedere i passaggi per confermare che il codice proposto soddisfa i requisiti dell'applicazione. Gli sviluppatori possono scrivere lo pseudocodice in documenti separati, su lavagne o nella Developer Console.
Per darti un'idea di come lo pseudocodice aiuta gli sviluppatori a documentare come pensano di programmare un'applicazione, scriviamo lo pseudocodice per descrivere come preparare una tazza di tè per gli amici.
- Nella Developer Console, scegli File | New (Nuovo) | Apex Class (Classe Apex).
Nota
Per il momento non devi preoccuparti se non sai cos'è una classe. Scoprirai cosa sono le classi Apex in un modulo più avanzato. Per ora, considera il file un semplice file di testo.
- Assegna alla classe il nome
Teatime. - Fai clic su OK.
- Dopo aver assegnato il nome alla classe, si apre una finestra con una nuova classe.
- Copia e incolla queste istruzioni al di sopra della classe esistente.
Get Utensils and Ingredients Boil Water in a Tea Kettle Make Tea in Teapot Add Tea and Sugar to a Teacup Serve Tea to Friend
Nello pseudocodice, ciascuna istruzione deve descrivere un'azione. Se queste istruzioni fossero destinate a un robot, il robot sarebbe in grado di eseguire ciascun passaggio correttamente?
Probabilmente no. Il robot avrebbe bisogno di sapere quali utensili e ingredienti procurarsi, come far bollire l'acqua e la quantità di ciascun ingrediente da aggiungere. Bisogna aggiungere più dettagli allo pseudocodice.
- Torna alla Developer Console.
- Sostituisci il codice esistente con quello seguente:
Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend public class Teatime { }
Quando scrivi pseudocodice, esamina ciascun passaggio e suddividilo nel maggior numero di elementi possibile, in modo da contemplare ogni scenario. Ad esempio, questo pseudocodice dice di riempire il bollitore con acqua. E se il bollitore è già pieno? Cosa deve fare il robot: continuare a riempirlo d'acqua? Deve svuotarlo? Pensare come uno sviluppatore significa adottare diversi punti di vista e considerare diverse possibilità.
Aggiungere commenti al codice
Come amministratore, hai mai visto un campo personalizzato senza descrizione? A meno che quel campo non abbia un nome molto chiaro e descrittivo, il suo scopo potrebbe non essere evidente. Nel codice, i commenti descrivono lo scopo di un blocco di istruzioni (una o più righe di codice). I commenti aiutano gli sviluppatori a stabilire cosa deve fare il codice che stanno scrivendo, che cosa fa il codice esistente e cosa dovrebbe fare il codice che non funziona. Gli sviluppatori inseriscono i commenti all'interno del codice, ma utilizzano caratteri speciali per indicare al computer di non leggere o eseguirli.
Vediamo due modi di aggiungere commenti al codice: commenti su una singola riga o commenti su più righe.
Commenti su riga singola
I commenti su singole righe iniziano con due barre ( // ). Quando il programma viene eseguito, i caratteri che si trovano sulla stessa riga a destra della sequenza // vengono ignorati. Esempio:
Integer i = 1; //This comment will be ignored when the code is run.
Commenti su più righe
I commenti su più righe iniziano con una barra e un asterisco ( /* ) e terminano con un asterisco e una barra ( */ ). Esempio:
Integer i = 1; /*This comment is
ignored when the
code runs*/
Nota
Nell'esempio del commento su più righe, hai notato che, anche se il codice si trova su più righe, queste sono tutte rientrate? Utilizzare i rientri in modo sistematico migliora la leggibilità ed è una importante best practice.
Trasformiamo lo pseudocodice della classe Teatime in un commento. Per assicurare uno sviluppo ordinato, è una buona idea scrivere lo pseudocodice in modo strutturato.
- Nella Developer Console, aggiungi allo pseudocodice i caratteri per segnalare i commenti su più righe. Lo pseudocodice dovrebbe avere l'aspetto seguente.
/*Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend*/ public class Teatime { } - Fai clic su File | Save (Salva).
In questo modulo imparerai a seguire le best practice nella scrittura di codice Apex e acquisirai le basi necessarie per poter sviluppare applicazioni eccezionali.
Dopo questo primo assaggio, iniziamo a scrivere codice.
