Lançar o Code Builder

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Acessar o aplicativo Code Builder na organização.
  
• Conectar-se à organização com o Code Builder.
  
• Executar uma consulta SOQL.
  

Abrir o aplicativo Code Builder

O Code Builder está instalado e a permissão CodeBuilderGroup foi concedida. Vamos acessar o Painel de Controle do Code Builder e iniciá-lo.

1. No App Launcher (Iniciador de aplicativos) (), encontre e selecione Code Builder.
   
   
2. Click Launch (Iniciar).
   Quando você iniciar o Code Builder pela primeira vez, ele passará por um processo de configuração que levará algum tempo. Você verá a mensagem: “O Code Builder está carregando…” Alguns alertas podem surgir, mas eles podem ser ignorados.
   

O Code Builder abre com um novo projeto Salesforce DX já iniciado. A estrutura do arquivo é exibida no Explorer ao lado da Barra de atividades. Atualmente, nenhum dos metadados ou arquivos da organização está carregado no projeto. Explicaremos mais sobre isso daqui a pouco.

Introdução à barra de atividades

O menu é composto por oito opções principais.

Autorizar sua organização

Para visualizar metadados ou arquivos da organização, você precisa autorizar o Code Builder a acessar a organização usando suas credenciais. Você pode autorizar qualquer organização (produção, sandbox ou teste) usando seu nome de usuário e senha.

1. Se a página inicial estiver sendo exibida, clique em Connect an Org (Conectar uma organização).
   Se não estiver sendo exibida, basta pressionar Ctrl+Shift+P (Windows) ou Cmd+Shift+P (macOS) para abrir a paleta de comandos. Insira SFDX e selecione SFDX: Authorize an Org (SFDX: autorizar uma organização).
   
2. Em Org Type (Tipo de organização), selecione Production (Produção) para se conectar a um Trailhead Playground.
   
   
3. Em alias, insira CBTrailhead e pressione Return (MacOS) ou Enter (Windows).
   Você pode ter várias autorizações, então crie aliases distintos para diferenciá-las.
   Uma tela de conexão especial é aberta apenas para o Code Builder com um código previamente preenchido para você.
   
   
4. Clique em Connect (Conectar).
   
5. Faça login com seu nome de usuário e senha na organização que está autorizando.
   
6. Clique em Allow (Permitir).
   
7. Clique em Continue (Continuar).
   Agora você está conectado a uma organização e seu nome está visível na barra de status na parte inferior da janela do Code Builder.
   
   

Visualizar metadados da organização

Vamos lá! Você está conectado à sua organização. Agora vamos colocar alguns metadados e arquivos da organização no projeto Salesforce DX do Code Builder DX para trabalhar.

1. Na Barra de atividades, selecione o Navegador da organização ().
   
2. Na parte superior do painel do navegador da organização, clique em SFDX Refresh Types (Tipos de atualização do SFDX) ().
   
3. Role para baixo e selecione Custom Objects (Objetos personalizados).
   
4. Selecione Retrieve Source from Org (Recuperar origem da organização) () para Account (Conta).
   

Os arquivos de metadados já estão em seu projeto do Code Builder. Vamos dar uma olhada neles.

1. Selecione Explorer ().
   
2. Selecione force-app.
   
   
3. Selecione objects.
    Esses são os arquivos que você recuperou! Mas espere, há muitos arquivos apenas para Account (Conta). Sim, cada objeto tem arquivos de metadados para todos os atributos. Você pode exibir um arquivo para ver cada um dos campos, listViews e até o arquivo principal Account.object-meta.xml.
   

Agora você sabe como visualizar e recuperar metadados e arquivos de uma organização autorizada. Mas, e os dados? O SOQL Builder é uma ótima ferramenta para procurar os registros da organização.

Visualizar registros com o SOQL Builder

SOQL significa Salesforce Object Query Language (Linguagem de consulta do Salesforce Object). É uma linguagem de comando simples que facilita a recuperação de registros de uma organização do Salesforce. Você pode fazer muito com ele. Para saber mais detalhes sobre como usar o SOQL, confira o emblema do Trailhead SOQL para administradores. Mas, por enquanto, vamos explorar alguns registros na organização.

1. Pressione Ctrl+Shift+P (Windows) ou Cmd+Shift+P (macOS) para abrir a paleta de comandos.
   
2. Insira SOQL e selecione SFDX: Create Query in SOQL Builder (SFDX: Criar consulta no SOQL Builder).
   
3. No campo From (De), insira cont e selecione Contact (Contato).
   
   
4. Em Fields (Campos), insira id e selecione Id.
   
5. Insira outro campo: Name (Nome).
   Veja a Consulta SOQL ser exibida com base nos valores de campo selecionados.
   
6. Clique em Run Query (Executar consulta) para ver os resultados.
   
   
7. Feche o SOQL Builder e clique em Save (Salvar) para salvar a consulta ou Don’t Save (Não salvar) para descartá-la.
   

Você pode fazer muitas coisas com o SOQL Builder. Não deixe de conferir a página SOQL Builder para desenvolvedores para ver mais informações sobre a ferramenta e seus registros.

Agora que você já tem uma forma fácil de configurar e usar o Code Builder, continue e prepare seus usuários para trabalhar com código ou experimente você mesmo todas as maneiras incríveis de exibir seus registros e registros conectados sem limitações. Saiba mais sobre isso na seção Resources (Recursos).

Recursos

• Trailhead: SOQL para administradores
  
• Desenvolvedores: SOQL Builder