Iniciar Code Builder

Objetivos de aprendizaje

Después de completar esta unidad, podrá:

• Acceder a la aplicación Code Builder en su organización.
  
• Conectarse a su organización con Code Builder.
  
• Ejecutar una consulta SOQL.
  

Abrir la aplicación Code Builder

Code Builder está instalada y se ha concedido el permiso CodeBuilderGroup. Acceda al panel de Code Builder e inicie la aplicación.

1. Desde App Launcher (Iniciador de aplicación) (), busque y seleccione Code Builder.
   
   
2. Haga clic en Launch (Abrir).
   La primera vez que abre Code Builder, se inicia un proceso de configuración que lleva unos minutos. Verá el siguiente mensaje: "Code Builder is loading..." (Code Builder se está cargando). Puede que salgan un par de avisos que puede descartar.
   

Se abre Code Builder con un nuevo proyecto de Salesforce DX ya iniciado. Se muestra la estructura de archivos en el explorador junto a la barra de actividad. Ahora mismo, no tiene cargados metadatos ni archivos de su organización en el proyecto. Hablaremos de eso en breve.

Introducción a la barra de actividad

El menú se compone de ocho opciones principales.

Authorize Your Org (Autorizar su organización)

Para ver los metadatos o archivos de su organización, debe autorizar a Code Builder para acceder a la organización con sus credenciales. Puede autorizar la organización que quiera (producción, sandbox o borrador) con su nombre de usuario y contraseña.

1. Si aparece la página de inicio, haga clic en Connect an Org (Conectar una organización).
   De lo contrario, pulse Ctrl+Mayús+P (Windows) o Cmd+Mayús+P (macOS) para abrir la paleta de comandos. Escriba SFDX y seleccione SFDX: Authorize an Org (SDFX: Autorizar una organización).
   
2. Para el tipo de organización, seleccione Production (Producción) para poder conectarse a un Trailhead Playground.
   
   
3. En el alias, introduzca CBTrailhead y pulse la tecla de retorno (macOS) o Intro (Windows).
   Puede tener distintas autorizaciones, así que le recomendamos crear alias que se diferencien bien.
   Se abre una pantalla de conexión especial para Code Builder con un código precargado.
   
   
4. Haga clic en Connect (Conectar).
   
5. Inicie sesión con su nombre de usuario y contraseña para la organización que quiere autorizar.
   
6. Haga clic en Allow (Permitir).
   
7. Haga clic en Continue (Continuar).
   Ya se ha conectado a una organización, y su nombre aparece en la barra de estado de la parte inferior de la ventana de Code Builder.
   
   

Ver los metadatos de la organización

¡Perfecto! Ya se ha conectado a su organización. Ahora vamos a obtener algunos archivos y metadatos de la organización en el proyecto de DX de Code Builder para trabajar con ellos.

1. En Activity Bar (Barra de actividad), seleccione Org Browser (Navegador de la organización, ).
   
2. En la parte superior del panel, haga clic en SFDX Refresh Types (Tipos de actualización de SFDX, ).
   
3. Desplácese hacia abajo y seleccione Custom Objects (Objetos personalizados).
   
4. Seleccione Retrieve Source from Org (Recuperar código fuente de la organización, ) para el objeto Account (Cuenta).
   

Ahora, los archivos de metadatos están en su proyecto de Code Builder. Vamos a echar un vistazo.

1. Seleccione Explorer (Explorador, ).
   
2. Seleccione force-app.
   
   
3. Seleccione objects (objetos).
    Estos son los archivos que ha recuperado. Un momento, hay muchos archivos para Account (Cuenta). Así es, cada objeto contiene archivos de metadatos para todos sus atributos. Puede ver un archivo para comprobar cada uno de los campos, vistas de lista e incluso el archivo principal Account.object.meta.xml.
   

Ahora ya sabe cómo ver y recuperar metadatos y archivos de una organización autorizada. Pero, ¿qué ocurre con los datos? SOQL Builder es una herramienta maravillosa para consultar los registros de la organización.

Ver registros con SOQL Builder

SOQL es el lenguaje de consulta de objetos de Salesforce. Es un lenguaje de comandos sencillo que facilita la recuperación de registros de una organización de Salesforce. Puede hacer muchas cosas con él. Consulte la insignia de Trailhead SOQL para administradores para obtener más información sobre el uso de SOQL. Por ahora, vamos a explorar algunos registros de su organización.

1. Pulse Control + Mayús + P (en Windows) o Comando + Mayús + P (en macOS) para abrir Command Palette (Paleta de comandos).
   
2. Escriba SOQL y seleccione SFDX: Create Query in SOQL Builder (SFDX: Crear una consulta en SOQL Builder).
   
3. En el campo From (Origen), introduzca cont y seleccione Contact (Contacto).
   
   
4. En Fields (Campos), escriba id y seleccione Id (Id.).
   
5. Introduzca otro campo: Name (Nombre).
   Observe cómo aparece la consulta de SOQL en función de los valores que seleccione en los campos.
   
6. Haga clic en Run Query (Ejecutar consulta) para ver los resultados.
   
   
7. Cierre SOQL Builder y haga clic en Save (Guardar) para guardar la consulta o en Don't Save (No guardar) para descartarla.
   

Puede hacer muchas cosas con SOQL Builder. No olvide consultar la página de SOQL Builder para desarrolladores para obtener más información sobre la herramienta y sus registros.

Ahora que ya conoce una forma sencilla de configurar y usar Code Builder, anime a sus usuarios a enfrentarse a un poco de programación o siga aprendiendo para descubrir todas las increíbles maneras de consultar registros y registros conectados sin limitaciones. Tiene más información en la sección Recursos.

Recursos

• Trailhead: SOQL para administradores
  
• Desarrolladores: SOQL Builder