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 usando o Process 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:

  1. Primeiro, verifique se você está conectado ao Trailhead.
  2. 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.
  3. 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.
  4. Em seu Trailhead Playground, clique em Configuração 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. 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.

  1. No Developer Console, selecione File (Arquivo) | New (Novo) | Apex Class (Classe do Apex).
  2. 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. 

  3. Nomeie a classe como Teatime.
  4. Clique em OK.
  5. Depois de nomear a classe, uma janela aparecerá com uma nova classe.
  6. 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
public class Teatime {
}

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. 

  1. Volte para o Developer Console.
  2. 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

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.

  1. No Developer Console, adicione os comentários de várias linhas ao pseudocódigo. Ele deverá ser parecido com isto.
  2. /*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 {
    }
  3. 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. 

Recursos