Información general sobre Apex
Objetivos de aprendizaje
Después de completar esta unidad, podrá:
- Definir lo que es el código.
- Describir dónde almacenar y modificar el código.
- Describir dos maneras de crear comentarios de código.
- Explicar por qué comentar el código es importante.
¿Le interesa ampliar sus conocimientos sobre Salesforce para aprender sobre el código Apex? Bien, está en el lugar correcto. Prepárese para ser guiado paso a paso en el mundo de la lectura y redacción de código. Puede dar un poco de miedo al principio, pero no se preocupe: simplificaremos incluso los conceptos más complejos.
Como administrador, ya comprende los entresijos de las funciones de Salesforce y sus limitaciones actuales. Tiene experiencia en el uso de Flow Builder para automatizar los procesos de negocio y está entusiasmado con proporcionar las aplicaciones mejor personalizadas para sus clientes. Durante este módulo, primero le presentaremos los conceptos de programación, y luego ejemplos que podrá probar por su cuenta.
¿Listo para empezar? ¡Hagámoslo!
¿Qué es el código?
Código es el lenguaje que los humanos utilizan para hablar con las computadoras. Utilizamos el código para escribir un conjunto preciso de instrucciones para realizar una acción específica. Piense en el código como en una receta. Cada ingrediente e instrucción tiene que ser exacta de modo que el plato salga como se espera.
Del mismo modo que las personas del mundo utilizan diferentes idiomas, las computadoras utilizan diferentes lenguajes, como JavaScript, Java, Ruby, Python y muchos otros. Aunque los lenguajes de programación difieren en muchos aspectos, todos se basan en las mismas estructuras fundacionales y los puede interpretar una computadora para crear aplicaciones. A medida que aprenda más sobre el lenguaje de programación Apex, empezará a comprender las estructuras de la programación.
¿Dónde se almacena el código de Apex?
¿Dónde empiezo? Lo primero es lo primero: tenemos que disponer dónde almacenar nuestro código. El código se almacena en archivos. Estos archivos pueden ser locales (en su PC o Mac), en la nube (su organización de Salesforce) o pueden guardarse de forma local y sincronizarse automáticamente en la nube. ¿No es genial?
Developer Console
Como administrador, es posible que haya escuchado sobre algo denominado Developer Console. Developer Console es una herramienta que los desarrolladores utilizan para crear y modificar archivos de código. A lo largo de este módulo utilizamos Developer Console para almacenar y ejecutar el código en su organización de Salesforce. Echemos un vistazo.
Para acceder a Developer Console:
- En primer lugar, asegúrese de que inició sesión en Trailhead.
- A continuación, haga clic en su avatar de usuario de la esquina superior derecha de esta página y seleccione Organizaciones de prácticas desde el menú desplegable.
- Haga clic en el nombre de usuario para iniciar su organización. ¿Desea crear una nueva organización? Consulte el módulo Gestión de Trailhead Playground para aprender cómo hacerlo.
- En su Trailhead Playground, haga clic en
y seleccione Developer Console.
Mantenga Developer Console abierta. A lo largo de este módulo la utilizaremos para probar código.
Redactar pseudocódigo
La parte más importante de cualquier proyecto en que participe como administrador de Salesforce es la planificación. La planificación le ayuda a comprender las necesidades de sus clientes, organizar sus propios pensamientos y predecir problemas que podría encontrarse mientras desarrolla la aplicación.
Durante la planificación del proyecto, antes de que los desarrolladores comiencen a redactar código de Apex, escriben pseudocódigo. El pseudocódigo es una descripción detallada pero legible de lo que debe hacer un programa o función. Está escrito en lenguaje natural en lugar de un lenguaje de programación. El pseudocódigo permite a los no programadores revisar los pasos para confirmar que el código propuesto satisface los requisitos para la aplicación. Los desarrolladores redactan pseudocódigo en documentos separados, en pizarras o en Developer Console.
Para conocer cómo el pseudocódigo ayuda a los desarrolladores a documentar sus pensamientos sobre cómo programar una aplicación, escribamos el pseudocódigo para hacer una tetera para los amigos.
- En Developer Console, seleccione File | New | Apex Class (Archivo | Nuevo | Clase de Apex).
Nota
Ahora no debe preocuparse de lo que es una clase. Aprenderá sobre las clases de Apex en un módulo más avanzado. Por ahora, piense en este archivo como uno de texto.
- Asigne el nombre a la clase
Hora del té. - Haga clic en Aceptar.
- Después de asignar el nombre a la clase, aparece una ventana con una nueva clase.
- Copie y pegue estas instrucciones por encima de la clase 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 instrucción de pseudocódigo debería indicar una acción. Si diera estas instrucciones a un robot, ¿cree que el robot podría realizar cada paso correctamente?
Probablemente no. El robot tendría que saber qué utensilios e ingredientes obtener, cómo hervir el agua y qué cantidad de cada ingrediente agregar. Este pseudocódigo necesita más detalle.
- Vuelva a Developer Console.
- Sustituya el código existente por este código:
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 { }
Cuando escriba pseudocódigo, vaya por cada paso y desglóselo lo más posible para tener en cuenta cada escenario posible. Por ejemplo, este pseudocódigo indica llenar la tetera con agua. ¿Y si la tetera ya está llena? ¿Debería el robot seguir llenando la tetera con agua? ¿Debería vaciar la tetera? Cuando piensa como un desarrollador, debe pensar desde diferentes puntos de vista y considerar múltiples posibilidades.
Comentar el código
Como administrador ¿vio alguna vez un código personalizado que no tenía descripción? A no ser que ese campo tuviera un nombre muy claro y descriptivo, su propósito podría no ser obvio. En el código, los comentarios describen el propósito de un bloque de código (una o más líneas de código). Los comentarios ayudan a los desarrolladores a comprender qué código escribir, qué hace el código existente y qué se supone que debe hacer el código que falla. Los desarrolladores incrustan comentarios dentro del código, pero los encierran entre caracteres especiales que indican a la computadora no leer o ejecutar los comentarios.
Veamos dos maneras de comentar el código: comentarios de una sola línea y comentarios de varias líneas.
Comentarios de una sola línea
Los comentarios de una sola línea comienzan con dos barras ( // ). El programa de computadora ignora los caracteres en la misma línea a la derecha de // cuando se ejecuta. Ejemplo:
Integer i = 1; //This comment will be ignored when the code is run.
Comentarios de varias líneas
Los comentarios de varias líneas comienzan con una barra y un asterisco ( /* ) y terminan con un asterisco y una barra ( */ ). Ejemplo:
Integer i = 1; /*This comment is
ignored when the
code runs*/
Nota
En el comentario de varias líneas, ¿se dio cuenta que aunque el código abarca varias líneas, todas tienen sangría? La sangría coherente mejora la legibilidad y es una mejor práctica importante.
Convirtamos el pseudocódigo Hora del té en un comentario. Para mantener el desarrollo de código controlado, es una buena práctica redactar su pseudocódigo como en un esquema.
- En Developer Console, agregue los comentarios de varias líneas al pseudocódigo. Debería tener un aspecto similar a 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 { } - Haga clic en File Save (Archivo | Guardar).
En este módulo aprenderá a seguir las mejores prácticas cuando redacte código de Apex. Esto podrá los cimientos para que se convierta en un desarrollador extraordinario.
Ahora que sabemos lo básico, profundicemos y empecemos a programar.
