Introdução ao Apex
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Definir o que é código.
- Descrever onde armazenar e editar código.
- Descrever duas maneiras de criar comentários de código.
- Explicar por que o comentário de código é importante.
Você sabia que pode aprender com um especialista? Assista a este vídeo para saber mais sobre os tópicos deste módulo:
Então, você está interessado em aumentar seu conhecimento do Salesforce para aprender sobre código do Apex? Bem, você está no lugar certo. Prepare-se para uma jornada passo a passo no mundo da leitura e escrita de código. Pode ser um pouco assustador no início, mas não se preocupe. Vamos simplificar até os conceitos mais complexos.
Como administrador, você já entende os prós e contras das funcionalidades do Salesforce e suas limitações atuais. Você tem experiência no uso do Flow Builder para automatizar processos comerciais e está empolgado em fornecer os melhores aplicativos personalizados para seus clientes. Ao passar por este módulo, você será primeiro apresentado aos conceitos de programação, seguido por exemplos que você pode testar por conta própria.
Pronto para começar? Mãos à obra!
O que é código?
Código é a linguagem que os humanos usam para falar com computadores. Usamos código para escrever um conjunto preciso de instruções para realizar uma ação específica. Pense no código como uma receita. Cada ingrediente e instrução precisa ser exato para que o prato fique como você antecipou.
Assim como as pessoas em todo o mundo usam idiomas diferentes, os computadores usam linguagens diferentes, como JavaScript, Java, Ruby, Python e muitos outros. Embora as linguagens de programação difiram de várias maneiras, todas elas se baseiam nas mesmas estruturas fundamentais e podem ser interpretadas por um computador para criar aplicativos. Ao aprender mais sobre a linguagem de programação Apex, você começará a entender as estruturas de programação.
Onde o código do Apex está armazenado?
Você se pergunta: por onde eu começo? Primeiro, precisamos descobrir onde armazenamos nosso código. O código é armazenado em arquivos. Esses arquivos podem estar em locais (em seu PC ou Mac), na nuvem (sua organização do Salesforce), ou podem ser salvos localmente e sincronizados automaticamente com a nuvem. Legal, isso, não!?
O Developer Console
Como administrador, você provavelmente já ouviu falar de algo chamado Developer Console. O Developer Console é uma ferramenta que os desenvolvedores usam para criar e editar arquivos de código. Ao longo deste módulo, usaremos o Developer Console para armazenar e executar código em sua organização do Salesforce. Vamos dar uma olhada.
Como acessar o Developer Console:
- Primeiro, verifique se você está conectado ao Trailhead.
- Em seguida, clique em seu avatar de usuário no canto superior direito desta página e selecione Hands-on Orgs (Organizações práticas) na lista suspensa.
- Clique no nome de usuário para iniciar sua organização. Deseja criar uma nova organização? Consulte o módulo Gerenciamento do Trailhead Playground para saber como.
- Em seu Trailhead Playground, clique em
e selecione Developer Console.
Mantenha o Developer Console aberto. Ao longo deste módulo, vamos usá-lo para testar o código.
Escrever o pseudocódigo
A parte mais importante de qualquer projeto em que você participa como administrador do Salesforce é o planejamento. O planejamento ajuda você a entender as necessidades de seus clientes, a organizar seus próprios pensamentos e a prever problemas que podem ser encontrados durante o desenvolvimento do aplicativo.
Durante o planejamento do projeto, antes de os desenvolvedores começarem a escrever código Apex, eles escrevem o pseudocódigo. O pseudocódigo é uma descrição detalhada, mas legível, do que um programa ou recurso deve fazer. Ele está escrito em linguagem natural em vez de uma linguagem de programação. O pseudocódigo permite que os não programadores analisem as etapas para confirmar se o código proposto satisfaz os requisitos do aplicativo. Os desenvolvedores escrevem pseudocódigo em documentos separados, em quadros ou no Developer Console.
Para ter uma ideia de como escrever um pseudocódigo ajuda os desenvolvedores a documentar seu pensamento sobre como programar um aplicativo, vamos escrever o pseudocódigo para fazer um bule de chá para os amigos.
- No Developer Console, selecione File (Arquivo) | New (Novo) | Apex Class (Classe do Apex).
Nota
Não se preocupe sobre o que é uma classe agora. Você aprenderá sobre as Classes do Apex em um módulo mais avançado. Por enquanto, pense neste arquivo como um arquivo de texto.
- Nomeie a classe como
Teatime. - Clique em OK.
- Depois de nomear a classe, uma janela aparecerá com uma nova classe.
- Copie e cole essas instruções acima da classe existente.
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
Cada instrução do pseudocódigo deve indicar uma ação. Se você desse essas instruções a um robô, acha que o robô poderia realizar cada etapa corretamente?
Provavelmente não. O robô precisaria saber quais utensílios e ingredientes obter, como ferver água e quanto de cada ingrediente adicionar. Esse pseudocódigo precisa de mais detalhes.
- Volte para o Developer Console.
- Substitua o código existente por este:
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 você escrever o pseudocódigo, passe por cada etapa e detalhe cada uma o máximo possível para explicar cada cenário. Por exemplo, este pseudocódigo diz para encher a chaleira com água. E se a chaleira já estiver cheia? O robô deve continuar enchendo a chaleira com água? Deve esvaziar a chaleira? Quando você pensa como um desenvolvedor, deve pensar em diferentes pontos de vista e considerar várias possibilidades.
Comentário de código
Como administrador, você já viu um campo personalizado sem descrição? A menos que esse campo tenha um nome muito claro e descritivo, seu objetivo pode não ser óbvio. No código, os comentários descrevem a finalidade de um bloco de código (uma ou mais linhas de código). Os comentários ajudam os desenvolvedores a entender o código a ser escrito, o que o código existente faz e o que o código que está falhando deve fazer. Os desenvolvedores podem incorporar comentários no código, mas devem colocá-los em caracteres especiais que indiquem ao computador para não ler nem executar os comentários.
Vamos ver duas maneiras de comentar o código: comentários de linha única e comentários de várias linhas.
Comentários de linha única
Os comentários de linha única começam com duas barras ( // ). O programa de computador ignora caracteres na mesma linha à frente do // quando ele é executado. Exemplo:
Integer i = 1; //This comment will be ignored when the code is run.
Comentários de várias linhas
Os comentários de várias linhas começam com barra e asterisco ( /* ) e terminam com asterisco e barra ( */ ). Exemplo:
Integer i = 1; /*This comment is
ignored when the
code runs*/
Nota
No comentário de várias linhas, você notou que, embora o código abranja várias linhas, elas são todas recuadas? O recuo consistente melhora a legibilidade e é uma prática recomendada.
Vamos transformar o pseudocódigo Teatime em um comentário. Para manter o desenvolvimento do código em andamento, é uma boa prática escrever seu pseudocódigo como se fosse um esboço.
- No Developer Console, adicione os comentários de várias linhas ao pseudocódigo. Ele deverá ser parecido com isto.
/*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 { } - Clique em File (Arquivo) | Save (Salvar).
Neste módulo, você aprenderá a seguir as melhores práticas quando escrever código Apex. Isso definirá sua base para se tornar um desenvolvedor extraordinário.
Agora que você já molhou os pés, vamos mergulhar e começar a codificar.