Hechicería Cotlang: secretos más oscuros para flujos legendarios (parte 4)
Dominaste los conjuros más básicos, sobreviviste a rituales dignos de un verdadero aprendiz de Cotlang, lograste moverte entre las dimensiones de Cotalker, fuiste seducido por el poder ilimitado del Brujo Calvo (logrando sobrevivir) y, en algún momento caíste en la locura enviando un correo de las artes oscuras pidiendo ayuda ([email protected]).
Pero ahora, por fin, ha llegado el momento de descubrir el verdadero poder. Esta será (o eso espero) la última guía de Cotlang. Una guía que de verdad contiene los hechizos secretos que te harán dominar Cotlang, y por supuesto, Cotalker.
Aquí vas a encontrar los conjuros más poderosos, tan poderosos que quizá nunca los logres encontrar en la documentación oficial. Así que toma tu varita, revisa que no estés en productivo (guiño, guiño) y prepárate para invocar la última magia… Una magia tan potente que hará temblar incluso al mismísimo CEO.
Si en algún momento los hechizos te enredan o tu memoria mágica titubea, no te preocupes: todo gran archimago necesita repasar sus hechizos. Recuerda que hasta el mismísimo Brujo Calvo consultaba sus notas antes de lanzar el conjunto devastador Meteo.
Esteban Tejeda
Esteban Tejeda
Esteban Tejeda
Capítulo 1: El gran y todopoderoso Contexto
¿Querías un Contexto? Llegaste tan lejos que el contexto ya no importa. Si antes necesitabas mirar el JSON como quien consulta una bola de cristal, hoy tus hechizos lo moldean todo.
Ya no eres un simple aprendiz que pregunta “¿cuál es el contexto aquí?”. Eres el mago que, con solo agitar la varita ($VALUE, $OUTPUT y compañía), crea y transforma la realidad misma.
A estas alturas, el contexto es solo la materia prima; tú eres el alquimista.
Capítulo 2: Los hechizos prohibidos y el verdadero poder
2.1 El oráculo de las variables: ¿Cansado de copiar y pegar URLs místicas cada vez que cruzas de un entorno a otro? Todo archimago ha sentido el terror de lanzar un hechizo en el universo equivocado y ver cómo sus flujos colapsan por culpa de una simple dirección mal escrita.
$ENV#BASEURL es un comando de Cotlang que retorna la URL base de Cotalker, correspondiente al entorno actual en el que se ejecuta la rutina.Lo que en Javascript sería el clásico process.env.BASE_URL aquí simplemente es $ENV#BASEURL. Muy útil cuando necesitas lanzar hechizos que crucen universos (o sea, entornos) al querer hacer llamadas de red.
Por ejemplo, si necesitas obtener información de un usuario por su ID dentro de una etapa, olvídate de copiar y pegar URLs como https://staging.cotalker.com. Con este hechizo, el entorno se ajusta solo, evitando errores y tragedias mágicas:
$JOIN##($ENV#BASEURL)#(/api/v2/users/)#(userId)Así, nunca más tendrás que buscar y reemplazar URLs a mano. El oráculo siempre sabrá en qué universo estás lanzando tu conjuro.
2.2 El verdadero invocador: ¿Quieres traer a la existencia usuarios, canales o propiedades usando solo un identificador? Esta función es como el Accio de Cotlang, invoca entidades completas con un simple conjuro.
$CODE es un comando avanzado de Cotlang que realiza una solicitud GET automática a Cotalker sin que debas preocuparte por la URL base ni del entorno donde se esté ejecutando.Lo que normalmente requeriría una etapa adicional de Solicitud de Red con un método GET y un endpoint específico, con $CODE puedes hacerlo directamente dentro de tu etapa, simplificando la rutina y evitando pasos innecesarios.
Por ejemplo, si tienes una etapa CCJS donde necesitas la información de un usuario específico pero no quieres crear una etapa extra, basta con invocar:
$CODE#users#_id#(userId)Así, ya no necesitas crear una etapa previa de tipo Solicitud de Red utilizando el cotlang que vimos en 2.1; $CODE lo hace todo por ti, de manera directa y eficiente.
2.3 El Time-Turner: ¿Quieres controlar el flujo del tiempo dentro de tu rutina, programar eventos en el futuro o viajar unos días atrás para ajustar un SLA? Aquí es donde Cotlang saca su Time-Turner del bolsillo.
$$TIME# nos permite generar un timestamp de fechas pasadas y futuras, permitiéndonos definirle la diferencia en días u horas.Por ejemplo, imagina que tienes un startform que crea automáticamente una tarea, pero quieres que el campo endDate se establezca tres días después de la creación de la tarea. En lugar de enredarte creando una etapa extra o manipulando fechas a mano, simplemente en la etapa Crear Tarea usas:
$$TIME#days#3Así, te olvidas de las fórmulas complicadas y de perder la cordura sumando fechas con Javascript. Cotlang lo hace por ti, de manera simple y elegante.
2.4 El Antinull de Cotlang: ¿Te ha pasado que invocas un valor esperando encontrar una respuesta… y el universo te responde con el caos absoluto? Nada más peligroso para una rutina que el temido null o undefined entre las sombras.
$IFNULL es una función de Cotlang que permite evaluar un valor y, en caso de que sea null o undefined, retorne un valor alternativo especificado.Por ejemplo, si intentas acceder a una respuesta que el usuario quizás no entregó, puedes usar $IFNULL para establecer un valor por defecto, como “No encontrado”.
Así, al agregar una etapa condicional, previenes errores antes de que aparezcan:
$IFNULL#($VALUE#answer|data|[find=>identifier=question_inexistente])#(No encontrado)De esta manera, tu flujo sigue funcionando aunque falten respuestas, y los bugs no tienen ni oportunidad de aparecer.
2.5 El traductor de respuestas: ¿Alguna vez tuviste que descifrar jeroglíficos como __ON__ , __OFF__o códigos internos, cuando solo querías saber qué display marcó el usuario en un formulario? Cotlang tiene un hechizo para eso:
cotanswer_list es una función de Cotlang diseñada para transformar las respuestas codificadas de preguntas tipo lista o selección múltiple en sus valores "display" legibles para el usuario. Permite obtener directamente los textos visibles asociados a las opciones seleccionadas, facilitando la interpretación de los resultados del formulario.Por ejemplo, supón que tenemos una lista con dos opciones: Aprobado (code: true) y Rechazado (code: false). Si el usuario selecciona "Rechazado" la respuesta en Cotalker se verá así:
{
"contentType": "application/vnd.cotalker.survey+listquestion",
"identifier": "checklist",
"code": ["true", "false"],
"display": ["Aprobado", "Rechazado"],
"responses": ["__OFF__", "__ON__"],
"process": ["false"],
}
En este caso, solo puedes ver el code de la respuesta seleccionada (en process|0), pero no el display. Aquí es donde la magia de Cotlang viene al rescate:
$VALUE#sentAnswer|data|[find=>identifier=checklist]|[cotanswer_list=>array]|0Con este hechizo, obtendrás directamente el display de la respuesta seleccionada por el usuario: "Rechazado".
2.6 El forjador único: ¿Necesitas un código aleatorio, un identificador único o un string irrepetible? Invoca el conjuro prohibido y tendrás tu propio “hash” sin llamar a ningún mago de backend.
[gencode=>*] es una función de Cotlang que permite generar un identificador único a partir de un valor de entrada, agregando un sufijo aleatorio o hash.Por ejemplo, imagina que estás en un formulario de data maestra y un usuario quiere crear un nuevo registro. Puedes utilizar esta función para generar un identificador único que te servirá como code para ese registro:
(prefijo)|[gencode=>*]Si quisieras usar el valor user como prefijo, tu cotlang quedaría de la siguiente forma: user|[gencode=>*] y ahora cada vez que ejecutes esta función obtendrás un identificador único aleatorio, como user_198500b6e19. Así, te aseguras de que cada registro tenga su propia marca mágica e irrepetible, sin esfuerzo extra.
Capítulo 3: El Archimago del Cotlang y el Último Portal
Así llegaste al final del grimorio prohibido. Has conquistado los secretos más oscuros del Cotlang, dominas conjuros que harían temblar a los magos de otros universos, y tu varita ya no tiembla ni ante los desafíos del CEO.
Desde hoy eres, oficialmente, Archimago del Cotlang. Pero no olvides: Cotlang es solo un capítulo del gran libro de la magia Cotalker.
Allá afuera, más allá de las fórmulas y rutinas, hay flujos, integraciones, bots y automatizaciones esperando a ser domados por manos dignas. El verdadero Gran Archimago de Cotalker aún te espera, y la travesía apenas comienza.
Así que graba bien este conjuro final: el poder de Cotlang está en tus manos, pero la magia real es nunca dejar de aprender (ni de automatizar). Hasta el próximo hechizo, mago supremo. Que la varita nunca te falte, y el bug siempre te respete.
Referencias:
TheLittleSongbird
Member discussion