# Catalyst Extensions ## Extensión de VS Code -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión te permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.862Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/introduction/" service: "All Services" -------------------------------------------------------------------------------- # Extensión de Catalyst para el IDE Visual Studio Code ### Introducción Catalyst es una potente plataforma de desarrollo, la más sencilla de utilizar para diseñar y desplegar soluciones serverless de cualquier escala y verticalidad. Con una amplia variedad de servicios como Cloud Scale, Serverless, DevOps, SmartBrowz, QuickML, entre otros, Catalyst te permite crear y alojar desde un microservicio sencillo hasta una aplicación empresarial robusta de la manera más rápida y simple. Como plataforma orientada al código, Catalyst ofrece una extensión en el IDE Visual Studio Code para garantizar que, como desarrollador, tengas una experiencia mejorada en la ingeniería de lógica de negocio con Catalyst. La extensión **Catalyst Tools** para Visual Studio Code te permite ejecutar ciertos comandos del CLI directamente en el entorno de desarrollo, en lugar de usar la terminal del CLI. Esta funcionalidad asegura que no tengas que abandonar tu entorno de desarrollo preferido para ejecutar operaciones de Catalyst en tu entorno local a través del CLI, que normalmente usarías para este propósito. Nota: No todas las operaciones que puedes ejecutar dentro de Catalyst CLI se pueden ejecutar con esta extensión. La lista de operaciones disponibles con esta extensión se encuentra en esta sección. La extensión tiene como objetivo mejorar aún más tu experiencia de desarrollo, mientras te beneficias de una plataforma unificada y potente para crear, diseñar, programar, probar, alojar, desplegar y gestionar aplicaciones dentro del entorno de VS Code en tu sistema local. Puedes utilizar tu IDE de VS Code en conjunto con el Catalyst CLI y la consola de Catalyst para gestionar tu proceso de desarrollo de software. <br /> ### Resumen de las operaciones que puedes realizar con Catalyst Tools Puedes realizar las siguientes operaciones directamente en el IDE de VS Code después de instalar la extensión Catalyst Tools: * Generar, revocar y eliminar tokens de autenticación que te permiten acceder a los recursos de Catalyst de forma local. * Ejecutar comandos básicos del CLI como whoami y login, así como opciones del CLI como verbose. * Inicializar y desplegar proyectos. * Inicializar de forma independiente, servir localmente y desplegar funciones HTTP y no HTTP, así como componentes Client. * Seleccionar e inicializar tu proyecto predeterminado, alternar entre proyectos activos y acceder a todos los proyectos disponibles desde tu consola de Catalyst. * Hacer pull de archivos de funciones, modificarlos y desplegarlos. * Descargar, modificar y desplegar reglas de API Gateway. * Proporcionar entradas de casos de prueba mediante la creación de un archivo JSON llamado catalyst-inputs.json, y probar funciones no HTTP. Nota: Puedes obtener información más detallada sobre todos los comandos del CLI y las operaciones posibles con la extensión Catalyst Tools en esta sección de ayuda. <br /> -------------------------------------------------------------------------------- title: "Beneficios" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión te permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.862Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/benefits/" service: "All Services" -------------------------------------------------------------------------------- # Beneficios * Esta extensión te permite usar tu IDE de VS Code como un único entorno de desarrollo. No es necesario alternar constantemente entre tu IDE y el Catalyst CLI. * Proporciona una interfaz gráfica intuitiva con la que puedes realizar operaciones en tu entorno local con solo unos clics. No necesitas escribir y ejecutar comandos como lo harías con el CLI. * Puedes iniciar sesión o cerrar sesión fácilmente, así como generar, revocar y eliminar tokens de autenticación, todo desde el IDE. De esta manera, puedes mantener sesiones de inicio de sesión en tu IDE de forma independiente al CLI. * Puedes programar componentes de Client y Functions dentro de VS Code, y también desplegarlos de forma segura en la consola desde el mismo espacio. * También puedes usar la terminal integrada en tu IDE de VS Code y ejecutar Catalyst CLI desde allí, si lo necesitas. * Puedes probar fácilmente funciones no HTTP en el IDE proporcionando entradas de prueba como archivos .JSON mediante el archivo catalyst-inputs.json. <br /> -------------------------------------------------------------------------------- title: "Comandos y operaciones de Catalyst Tools" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión te permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.862Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/catalyst-tools-operations/" service: "All Services" -------------------------------------------------------------------------------- # Comandos y operaciones de Catalyst Tools A continuación se muestra una lista de los comandos accesibles desde la paleta de comandos del IDE VS Code y las operaciones que se pueden realizar con la extensión Catalyst Tools: ### Comandos Puedes ejecutar estos comandos seleccionándolos en el menú desplegable de la paleta de comandos mientras usas la extensión. Para acceder a la lista desplegable, busca "**>Catalyst:**" en la paleta de comandos. <br /> <table class="content-table"> <thead> <tr> <th>Comandos del CLI</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>Catalyst: Whoami</td> <td>Muestra el nombre de usuario y la dirección de correo electrónico de la cuenta con la que iniciaste sesión en Catalyst.</td> </tr> <tr> <td>Catalyst: Login to Catalyst</td> <td>Inicia sesión en tu cuenta de Catalyst directamente desde el IDE. Debes iniciar sesión antes de poder realizar cualquier otra operación.</td> </tr> <tr> <td>Catalyst: Logout from Catalyst</td> <td>Cierra sesión en tu cuenta de Catalyst.</td> </tr> <tr> <td>Catalyst: Enable verbose</td> <td>Habilita el modo verbose en los logs. Puedes ver los logs directamente en tu IDE accediendo a Help>toggle developer tools.</td> </tr> <tr> <td>Catalyst: Disable verbose</td> <td>Deshabilita el modo verbose en los logs.</td> </tr> <tr> <td>Catalyst: Focus on Catalyst Configs View</td> <td>Te dirige a la sección CATALYST CONFIGS de la extensión.</td> </tr> <tr> <td>Catalyst: Focus on Client View</td> <td>Te dirige a la sección CLIENT de la extensión.</td> </tr> <tr> <td>Catalyst: Focus on HTTP Functions View</td> <td>Te dirige a la sección HTTP FUNCTIONS de la extensión.</td> </tr> <tr> <td>Catalyst: Focus on HTTP Functions View</td> <td>Te dirige a la sección NON HTTP FUNCTIONS de la extensión.</td> </tr> </tbody> </table> ### Operaciones A continuación se muestra la lista de todas las operaciones del CLI que se pueden realizar en el IDE Visual Studio Code mediante la extensión Catalyst Tools: <table class="content-table"> <thead> <tr> <th>Operaciones del CLI</th> <th>Descripción</th> </tr> </thead> <tbody> <tr> <td>login</td> <td>Inicia sesión en tu cuenta de Catalyst.</td> </tr> <tr> <td>whoami</td> <td>Muestra el nombre de usuario y la dirección de correo electrónico de la cuenta con la que iniciaste sesión en Catalyst.</td> </tr> <tr> <td>token:generate</td> <td>Genera tokens para autenticar el acceso a tu cuenta de Catalyst sin necesidad de iniciar sesión.</td> </tr> <tr> <td>token:revoke</td> <td>Deshabilita un token de autenticación que hayas generado previamente.</td> </tr> <tr> <td>token:list</td> <td>Muestra una lista de todos los tokens asociados a tu cuenta.</td> </tr> <tr> <td>project:list</td> <td>Lista todos los proyectos creados en tu cuenta.</td> </tr> <tr> <td>project:use</td> <td>Selecciona un proyecto específico asociado a tu cuenta de Catalyst.</td> </tr> <tr> <td>project:reset</td> <td>Deshace la operación project:use.</td> </tr> <tr> <td>init</td> <td>Inicializa el proyecto de Catalyst, las funciones HTTP y no HTTP, y los componentes de Client.</td> </tr> <tr> <td>apig:status</td> <td>Verifica si API Gateway (un componente de Security & Identity de Catalyst Cloud Scale) está habilitado o deshabilitado.</td> </tr> <tr> <td>apig:enable</td> <td>Habilita API Gateway para tu proyecto.</td> </tr> <tr> <td>apig:disable</td> <td>Deshabilita API Gateway para tu proyecto.</td> </tr> <tr> <td>pull</td> <td>Descarga una función, un Client o un archivo de API Gateway.</td> </tr> <tr> <td>client:setup</td> <td>Configura el componente Client en un proyecto existente.</td> </tr> <tr> <td>client:delete</td> <td>Elimina una versión anterior del componente Client.</td> </tr> <tr> <td>functions:setup</td> <td>Configura una función en un proyecto existente.</td> </tr> <tr> <td>functions:add</td> <td>Agrega una nueva función en tu directorio de funciones.</td> </tr> <tr> <td>functions:delete</td> <td>Elimina una función de tu proyecto.</td> </tr> <tr> <td>serve</td> <td>Sirve los recursos del proyecto en tu entorno local.</td> </tr> <tr> <td>deploy</td> <td>Despliega los recursos del proyecto en la consola remota.</td> </tr> <tr> <td>logout</td> <td>Cierra sesión en Catalyst.</td> </tr> </tbody> </table> -------------------------------------------------------------------------------- title: "Uso de Catalyst Tools" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión te permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.862Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/implementation/" service: "All Services" -------------------------------------------------------------------------------- # Uso de Catalyst Tools En esta sección de ayuda se explica cómo aprovechar al máximo la extensión **Catalyst Tools** y realizar diversas operaciones en tu proyecto dentro del entorno de VS Code. ### Instalar Catalyst Tools Para instalar la extensión: 1. Haz clic en el icono de extensiones de VS Code y busca "**Catalyst Tools**". <br /> 2. Haz clic en **Install**. <br /> Nota: * Asegúrate de estar usando VS Code en la versión **v 1.74.0** o superior. * Revisa la descripción y las funcionalidades listadas para comprender mejor la extensión. Ahora puedes acceder a la extensión Catalyst Tools haciendo clic en el icono de Catalyst en la barra lateral o en la parte inferior del IDE. <br /> ### Iniciar sesión en Catalyst Para comenzar a usar la extensión **Catalyst Tools**, primero debes iniciar sesión en tu cuenta de Catalyst. Puedes consultar la página de ayuda de inicio de sesión desde el CLI para obtener detalles sobre los distintos pasos. Inicia sesión en tu cuenta de Catalyst desde el IDE de VS Code de la siguiente manera: 1. Haz clic en el botón **Login** que se muestra en la sección *CATALYST CONFIGS* del panel izquierdo. <br /> 2. Elige el DC en el que deseas iniciar sesión. <br /> 3. Se te redirigirá a una página de permisos en tu navegador predeterminado. <br /> 4. Haz clic en **Accept** para completar el inicio de sesión en tu cuenta de Catalyst y conectar el IDE con la consola de Catalyst. <br /> 5. La sesión se habrá iniciado correctamente. <br /> Cierra la ventana y continúa usando la extensión **Catalyst Tools** en VS Code. ### Inicializar tu proyecto de Catalyst Antes de inicializar un proyecto en esta extensión: * Asegúrate de haber creado un proyecto en la consola de Catalyst. Puedes consultar cómo hacerlo en esta sección de ayuda. * Crea un directorio local donde inicializar tu proyecto de Catalyst usando **Catalyst Tools** desde VS Code. Puedes consultar el documento de ayuda Inicializar recursos desde el CLI para obtener una explicación más detallada sobre la inicialización de recursos de un proyecto de Catalyst, incluyendo funciones de diferentes stacks y tipos, en tu entorno local. Para inicializar un proyecto en la extensión **Catalyst Tools**: 1. Haz clic en **Initialize**. <br /> 2. Se listarán todos los proyectos de Catalyst de tu cuenta remota. Elige el proyecto que deseas inicializar dentro de VS Code. <br /> 3. Selecciona los componentes que deseas inicializar y luego haz clic en el **icono de confirmación**. Puedes inicializar *Functions* y *Client*. <br /> 4. **Configuración de Function** - Selecciona el tipo de función requerido. Puedes consultar la página de ayuda de Functions para obtener detalles sobre cada tipo. <br /> - Selecciona tu lenguaje de programación preferido: Java o Node.js. <br /> - Ingresa los datos requeridos y confírmalos haciendo clic en **Enter**. <br /> - Ingresa una dirección de correo electrónico para el autor o haz clic en **Enter** para usar la misma dirección de correo electrónico con la que creaste tu cuenta de Catalyst. <br /> - Haz clic en **Yes** si deseas instalar las dependencias necesarias. <br /> La configuración de la función se ha completado. Nota: También puedes simplemente presionar Enter y se proporcionarán los valores predeterminados. La función Advanced I/O inicializada estará ahora disponible en la sección *HTTP FUNCTIONS*. <br /> Puedes encontrar más información sobre los pasos de inicialización de cada stack de funciones en esta página de ayuda. 5. **Configuración de Client** - Selecciona el tipo de client a inicializar: Basic, Angular o React. <br /> - Ingresa el nombre del client y luego haz clic en el **icono de envío**. <br /> El directorio del proyecto contendrá el directorio de client y el de function con la estructura estándar. Puedes consultar la página de ayuda sobre la estructura de directorios del proyecto para obtener detalles sobre los archivos de configuración y las dependencias que se instalan. El proyecto y sus recursos se han inicializado correctamente en el IDE de VS Code mediante la extensión **Catalyst Tools**. <br /> ### Gestionar tu proyecto La sección *CATALYST CONFIGS* se puede usar para realizar diversas operaciones en tu proyecto y gestionarlo. Puedes realizar las siguientes operaciones: * **Add Functions**: Agrega una nueva función HTTP o no HTTP al directorio de tu proyecto. * **Client Setup**: Configura el componente Client en el directorio de tu proyecto. * **Serve**: Sirve tanto los recursos de función como de client del proyecto a través de un localhost usando el puerto predeterminado 3000. * **Deploy**: Despliega todo el proyecto local en la consola. * **Project**: Consulta la información del proyecto y modifica las configuraciones usando la consola de gestión integrada de la extensión. Nota: Puedes obtener más información sobre la consola de gestión de la extensión en esta sección de ayuda. #### Add Functions Puedes agregar funciones adicionales de cualquier tipo o stack al directorio de tu proyecto mediante esta opción, o agregar tu primera función al proyecto si no inicializaste funciones durante la inicialización del proyecto. Consulta la página de ayuda Trabajar con Functions para obtener más detalles. Para agregar una función HTTP o no HTTP a tu proyecto, haz clic en la opción **Add Functions** para iniciar la configuración de la función. <br /> Sigue los mismos pasos mencionados en la sección *Configuración de Function* de esta página de ayuda. <br /> Para los fines de este documento de ayuda, hemos creado una función Event, que se listará en la sección *NON HTTP Functions* del IDE. La función se creará con la estructura estándar de directorio de funciones. #### Client Setup Puedes configurar el componente Client en el directorio de tu proyecto mediante esta opción si no inicializaste el client durante la inicialización del proyecto. Consulta la página de ayuda Trabajar con Client para obtener más detalles. Para inicializar un componente Client, haz clic en la opción **Client Setup** para comenzar la configuración del client. <br /> Nota: Si ya tienes un componente Client, se te pedirá que confirmes si deseas crear un nuevo componente Client sobrescribiendo el existente. Sigue los pasos indicados en la sección *Configuración de Client* de esta página de ayuda. <br /> Para este documento de ayuda, hemos creado un nuevo componente Client como una **aplicación web React**, que se creará con su estructura estándar. #### Serve Puedes servir funciones Basic I/O y Advanced I/O, así como el componente Client de todos los tipos, a través de un localhost usando el puerto predeterminado: 3000, para probarlos antes de desplegarlos en el proyecto remoto. Consulta la página de ayuda Servir recursos para obtener más detalles. Para servir todos los recursos del proyecto localmente: 1. Haz clic en el botón **Serve**. <br /> 2. Elige la opción que prefieras: <br /> - Haz clic en **Yes** para servir todos los componentes de función y client. <br /> - Haz clic en **No** para elegir los componentes específicos que deseas servir localmente. <br /> Los componentes seleccionados se servirán localmente. Puedes usar la URL generada en tu navegador preferido para probar la funcionalidad de los componentes. <br /> - Puedes detener el proceso de serve haciendo clic en el **icono de detener**. <br /> #### Deploy Puedes desplegar todas las funciones y el client que inicializaste en la extensión a la consola remota. Esto hará que estén disponibles en el entorno de desarrollo de tu proyecto. Consulta la página de ayuda Desplegar recursos para obtener detalles sobre el proceso de despliegue de cada recurso del proyecto. Para desplegar el proyecto en la consola de Catalyst: 1. Haz clic en el botón **Deploy**. <br /> 2. Elige la opción que prefieras: <br /> - Haz clic en **Yes** para desplegar todos los componentes. <br /> - Haz clic en **No** para elegir los componentes específicos que deseas desplegar. Selecciona los componentes que deseas desplegar y luego haz clic en el **icono de envío**. <br /> Los recursos seleccionados se desplegarán y la extensión mostrará las URL de endpoint de las funciones y del client a las que puedes acceder. <br /> ### Servir y desplegar desde catalyst.json El archivo catalyst.json contiene la lista de componentes y la configuración de todo el proyecto. Con **Catalyst Tools** tienes la opción de servir y desplegar todo tu proyecto o recursos específicos directamente desde el archivo catalyst.json. Para servir o desplegar los recursos de tu proyecto, puedes hacer clic en los botones **Serve** y **Deploy** que aparecen junto a cada recurso del proyecto, y luego seguir los mismos pasos de serve y deploy indicados anteriormente. ### Functions En esta sección se describen todas las operaciones que se pueden realizar en las secciones *HTTP FUNCTIONS* y *NON HTTP FUNCTIONS* de la extensión **Catalyst Tools**. * **Run/Debug**: Sirve la función localmente y prueba su funcionalidad. También se sincroniza con el depurador del IDE, lo que te permite depurar tu código de forma sencilla. * **Deploy**: Despliega únicamente los componentes de función en la consola de Catalyst. * **Delete**: Elimina una función de tu proyecto local de forma permanente. #### Ejecutar o depurar una función En esta sección se explican los pasos para utilizar de forma efectiva la funcionalidad de run/debug de la extensión. **HTTP FUNCTIONS** Las funciones HTTP incluyen funciones Basic I/O y Advanced I/O, ya que pueden contener funcionalidades de solicitud y respuesta HTTP. Aquí puedes acceder a todas las funciones Basic I/O y Advanced I/O presentes en tu proyecto. Sigue los pasos a continuación para probar funciones HTTP localmente y depurarlas: 1. Haz clic en la función con la que deseas trabajar de la lista de funciones en la sección *HTTP FUNCTIONS*. <br /> 2. Haz clic en la opción **Run/Debug** para servir la función localmente. <br /> La URL de la función a través de un localhost se generará en el *Catalyst Serve Terminal* de VS Code. Puedes hacer clic en ella para comenzar a probar su funcionalidad. 3. Puedes hacer clic en la URL local de la función y se abrirá en tu navegador predeterminado. El IDE también te redirigirá a la sección de depuración. Nota: Consulta la sección de ayuda Configuración de la extensión para saber cómo ejecutar la función sin abrir la sección de depuración del IDE. 4. Si es necesario, puedes modificar o editar el código simultáneamente y ver los cambios en tiempo real. <br /> **NON HTTP FUNCTIONS** Aquí puedes acceder a las funciones Cron, Event e Integration presentes en tu proyecto. Para ejecutar o depurar estos tipos de función, necesitarás crear un archivo JSON llamado catalyst-inputs.json. Este archivo contendrá tus datos de prueba como valor JSON, y deberás almacenarlo en el directorio de la función correspondiente. Nota: * El archivo catalyst-inputs.json es exclusivo de la extensión Catalyst Tools de VS Code y se utiliza para probar funciones no HTTP. * Las funciones Cliq Integration no están disponibles actualmente para los usuarios de Catalyst que acceden desde los centros de datos de la EU, AU, IN o CA. Las funciones ConvoKraft Integration están disponibles para usuarios que acceden desde todos los DC. Para este documento de ayuda, vamos a ejecutar o depurar una función Event llamada shipment-submit. Para ejecutar o depurar (**Run/Debug**) esta función no HTTP, primero crearemos un archivo catalyst-inputs.json en el directorio de la función shipment-submit. Nota: Las funciones no HTTP no se pueden servir a través de esta extensión si no existe un archivo catalyst-inputs.json en su directorio. A continuación se muestra un ejemplo de código JSON para agregar en el archivo catalyst-inputs.json de la función Event shipment-submit: { "cache_put": { "project_details": { "id": "1434000000473001", "project_name": "ShipmentTracking" }, "event_bus_details": { "name": "Default", "id": "1434000000473009" }, "data": { "cache_name": "3b793", "cache_value": "0b3c97a93a", "project_details": { "id": "1434000000473001", "project_name": "Tunneling" }, "segment_details": { "segment_name": "Default", "project_details": { "project_name": "Tunneling", "id": "1434000000473001", "project_type": "Live" }, "id": "1434000000473037" }, "expiry_in_hours": 48, "expires_in": "Apr 28, 2023 03:13 PM" }, "current_project": { "id": "1434000000473001", "project_name": "Tunneling" }, "action": "Put", "source_entity_id": "1434000000473037", "source": "Cache", "event_time": 1682502183500 }, "datastore_insert": { "project_details": { "id": "1434000000473001", "project_name": "Tunneling" }, "event_bus_details": { "name": "Default", "id": "1434000000473009" }, "data": [ { "ROWID": "345460658792283", "CREATORID": "979726486268217", "CREATEDTIME": "2023-04-26 15:14:06", "MODIFIEDTIME": "2023-04-26 15:14:06" } ], "current_project": { "id": "1434000000473001", "project_name": "Tunneling" }, "action": "Insert", "source_entity_id": "817140351651431", "source": "Datastore", "event_time": 1682502245961 } } Este archivo de entrada pasa datos de evento de ejemplo provenientes de una operación Cache PUT y una operación Data Store INSERT que ocurren en el listener de eventos Default. Los datos del evento se pasan a la función shipment-submit. Nota: * Este archivo JSON de ejemplo contiene dos claves: cache_put y datastore_insert. Puedes personalizar el origen del evento y modificar el nombre de estas claves según corresponda. Sin embargo, Catalyst sigue un formato específico para los datos de evento que se pasan para cada entidad u operación. Las claves y valores deben respetar el formato estándar de datos de evento correspondiente a la operación que proporciones. * Puedes acceder a datos de evento de ejemplo para incluir en el archivo catalyst-inputs.json de cualquier operación compatible generando un payload de evento de ejemplo desde Catalyst CLI. El directorio de la función shipment-submit incluirá los siguientes archivos: <br /> Ahora, sigue los pasos a continuación para probar tu función localmente y depurarla si es necesario: 1. Haz clic en la función con la que deseas trabajar de la lista de funciones en la sección *NON HTTP FUNCTIONS*. <br /> 2. Haz clic en la opción **Run/Debug** para servir la función localmente. <br /> 3. Haz clic en la clave de entrada con la que deseas servir tu función. <br /> 4. Se abrirá un Catalyst Serve Terminal en VS Code. Podrás ver que la función se sirve a través de un web socket. Puedes probar la función. También podrás acceder al depurador del IDE. <br /> 5. Puedes realizar cambios en el código de tu función si es necesario, y estos se reflejarán durante el proceso de serve. <br /> También puedes cerrar el Catalyst Serve Terminal haciendo clic en el **icono de eliminar** en la consola inferior del IDE. <br /> Nota: El Catalyst Serve Terminal seguirá disponible y presente en segundo plano hasta que lo cierres. Para el ejemplo anterior, utilizamos una función Event como ejemplo. A continuación se muestra el archivo catalyst-inputs.json con un payload de ejemplo para probar funciones Cron e Integration: **Archivo de ejemplo catalyst-inputs.json para una función Cron**: { "cron_input": { "param": "value" } } **Archivo de ejemplo catalyst-inputs.json para una función Integration**: { "bot_welcome": { "name": "Sample", "unique_name": "sample_uniq", "handler": { "type": "welcome_handler" }, "response_url": "https://cliq.zoho.com/v2/extensions/2980/responses/17202823900615741410013820", "type": "bot", "timestamp": 1569520690703, "params": { "environment": { "data_center": "us" }, "access": { "user_id": "651652091", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:69.0) Gecko/20100101 Firefox/69.0", "chat_id": "CT_2243226337559778047_661211447-B2" }, "user": { "country": "us", "timezone": "Asia/calcutta", "last_name": "Fisher", "first_name": "Scott", "language": "en", "id": "123456", "email": "scott.fisher@zylcal.com", "admin": true, "organization_id": "123456456" }, "newuser": true, "mentions": [], "options": {}, "selections": [], "arguments": "" } } } #### Desplegar una función Para desplegar una función en la consola de Catalyst, sigue los pasos a continuación: 1. Haz clic en la función que deseas desplegar de la lista de funciones en la sección *HTTP FUNCTIONS* o *NON HTTP FUNCTIONS*, y luego haz clic en **Deploy**. <br /> 2. Haz clic en **Yes** para confirmar. <br /> La función se desplegará en la consola y se generará una URL de despliegue en el Catalyst Deploy Terminal de VS Code para la función. <br /> Ahora se puede acceder a la función desde la consola, en el componente Functions que se encuentra en Catalyst Serverless. <br /> #### Eliminar una función Para eliminar una función de tu proyecto local usando **Catalyst Tools**, sigue los pasos a continuación: 1. Haz clic en la función que deseas eliminar de la lista de funciones en la sección *HTTP FUNCTIONS* o *NON HTTP FUNCTIONS*, y luego haz clic en **Delete**. <br /> 2. Haz clic en **Yes** para continuar. <br /> La función y todos los archivos presentes en el directorio de la función se eliminarán de tu proyecto local. <br /> Nota: Para las funciones no HTTP, el archivo catalyst-inputs.json también se eliminará, ya que se encuentra en el directorio de la función. ### Client En la sección *Client* de la extensión **Catalyst Tools**, puedes realizar las siguientes operaciones sobre los componentes Client: * **Serve**: Sirve únicamente tus recursos de client y prueba su funcionalidad. * **Deploy**: Despliega únicamente tus recursos de client en la consola de Catalyst. * **Delete**: Elimina el componente Client de tu proyecto local. #### Operación Serve Para servir el client de forma independiente usando la extensión **Catalyst Tools** a través de un localhost:3000, sigue los siguientes pasos: 1. Ve a la sección *CLIENT* de la extensión y luego haz clic en **Serve**. <br /> El componente Client se servirá localmente y se generará una URL de endpoint local para tu componente Client en el Catalyst Serve Terminal. Al hacer clic en la URL podrás acceder al web client en tu navegador predeterminado. <br /> 2. Puedes detener el proceso de serve haciendo clic en el botón del icono de detener. <br /> También puedes cerrar el Catalyst Serve Terminal haciendo clic en el icono de eliminar en la consola inferior del IDE. Nota: El Catalyst Serve Terminal seguirá disponible y presente en segundo plano hasta que lo elimines. #### Operación Deploy Para desplegar el client de forma independiente en la consola de Catalyst usando la extensión **Catalyst Tools**, sigue los siguientes pasos: 1. Ve a la sección *CLIENT* de la extensión y luego haz clic en **Deploy**. <br /> 2. Haz clic en **Yes** para continuar con la operación de despliegue. <br /> El componente Client se desplegará y se generará una URL de despliegue para tu componente Client en el Catalyst Deploy Terminal de VS Code. Al hacer clic en la URL podrás acceder al client en tu navegador predeterminado. <br /> También puedes cerrar el Catalyst Deploy Terminal haciendo clic en el **icono de eliminar** en la consola inferior del IDE. Nota: El Catalyst Deploy Terminal seguirá disponible y presente en segundo plano hasta que lo elimines. #### Operación Delete Para eliminar el client de tu proyecto local usando **Catalyst Tools**, sigue los pasos a continuación: 1. Ve a la sección *CLIENT* y luego haz clic en **Delete**. <br /> 2. Haz clic en **Yes** para continuar. <br /> El componente Client se eliminará de tu proyecto local. <br /> <br /> -------------------------------------------------------------------------------- title: "Explorador de proyectos de Catalyst Tools" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.864Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/catalyst-tools-explorer/" service: "All Services" -------------------------------------------------------------------------------- # Catalyst Tools Project Explorer La funcionalidad *Project Explorer* de la extensión **Catalyst Tools** te permite realizar las siguientes operaciones: * Cambiar entre tus proyectos activos y reinicializar tu proyecto predeterminado. * Generar tokens de autenticación. * Buscar los recursos de Client, Functions y las reglas de API Gateway disponibles en el proyecto. * Obtener y sobrescribir componentes de Functions, Client y API Gateway desde el proyecto remoto. * Cerrar sesión en tu cuenta de Catalyst dentro de la extensión. Nota: Para acceder a Catalyst Tools Project Explorer en la extensión, es necesario que el proyecto haya sido desplegado en la consola de Catalyst. Existen dos formas de acceder al Project Explorer: 1. Haz clic en la opción **Project** en la sección *CATALYST CONFIGS*. <br /> 2. Haz clic en el botón **Catalyst** en la barra de estado del IDE. <br /> En el *Project Explorer* podrás ver lo siguiente: <br /> * Los detalles de la cuenta con la que iniciaste sesión en Catalyst * Una lista de todos los proyectos en tu cuenta * La URL de la aplicación web del proyecto * El nombre y el Project ID del proyecto * Información detallada sobre los componentes Client, Function y API Gateway ### Cambiar entre proyectos En el Project Explorer puedes obtener cualquiera de tus proyectos activos presentes en la consola de Catalyst y reinicializar tu proyecto predeterminado. **Para cambiar entre los proyectos activos**: 1. Haz clic en el **ícono de flecha** en la sección *Active* del Project Explorer. <br /> 2. Elige el proyecto al que deseas cambiar en el menú desplegable. <br /> También puedes hacer clic en el **ícono de restablecimiento** para asegurarte de que todas las actualizaciones realizadas en la consola de Catalyst se reflejen en el entorno local del Project Explorer. <br /> **Para reinicializar el proyecto predeterminado**: 1. Haz clic en el botón **re-init** en la sección *Default* del Project Explorer. <br /> 2. Elige el proyecto que deseas reinicializar y haz clic en el botón **Re-init** que aparece junto a él. <br /> El proyecto en tu directorio se reinicializará. ### Obtener recursos del proyecto La funcionalidad Project Explorer de **Catalyst Tools** te permite a ti y a tus colaboradores obtener fácilmente recursos del proyecto como Client, Function y API Gateway desde el proyecto remoto. Si un recurso específico no existe en el directorio local de tu proyecto, se creará automáticamente durante el pull. Sin embargo, si el recurso ya existe en la carpeta de tu proyecto, la extensión te pedirá confirmación para sobrescribir el archivo existente. Puedes trabajar en los recursos y enviar los cambios realizados desplegando el proyecto completo nuevamente, o solo los componentes que hayas modificado. Para obtener más información sobre cómo obtener recursos en tu entorno local, consulta la página de ayuda Pull Resources. **Obtener un recurso de Client**: 1. Navega a la sección *Client* en el Project Explorer. <br /> 2. Haz clic en el botón del **ícono de pull** que aparece junto a los detalles del Client. <br /> El componente Client se obtendrá. Si ya existe un componente Client en tu proyecto local, se sobrescribirá. <br /> **Obtener una Function**: 1. Navega a la sección *Function* en el Project Explorer. <br /> 2. Selecciona la Function deseada y haz clic en el **ícono de pull** que aparece junto a ella. <br /> 3. Selecciona la Function requerida en el cuadro de diálogo para confirmar la sobrescritura y confirma tu elección haciendo clic en el **ícono de envío**. <br /> Nota: Si decides no sobrescribir una Function, esta no se obtendrá. La Function seleccionada se obtendrá y estará disponible en el directorio de tu proyecto. <br /> **Realizar un pull masivo**: También puedes realizar una operación de pull masivo de Functions de la siguiente manera: 1. Selecciona la casilla de verificación en el encabezado de la tabla y luego haz clic en el botón **Pull Selected**. <br /> 2. Confirma las Functions que deseas obtener y haz clic en el **ícono de envío**. <br /> Las Functions seleccionadas se obtendrán y estarán disponibles en tu directorio. <br /> **Obtener una regla de API Gateway**: El archivo de reglas de API Gateway es un archivo JSON que contiene las definiciones de cada API creada en el componente API Gateway de tu aplicación. Si no has creado ninguna API en tu proyecto, puedes obtener igualmente el archivo con definiciones de API de ejemplo mediante el pull. Puedes consultar la página de ayuda Working with API Gateway para obtener detalles sobre el uso de esta funcionalidad en un entorno local. En la sección de API Gateway de la consola podrás ver si el componente ha sido habilitado en la consola de Catalyst o no. <br /> Si el componente API Gateway no ha sido habilitado, no podrás obtener el archivo de reglas localmente a través de la extensión. Si el componente ha sido habilitado en la consola de Catalyst, puedes obtener las reglas de API Gateway de la siguiente manera: 1. Navega a la sección de API Gateway del Project Explorer. <br /> 2. Haz clic en el botón **Pull All Rules**. <br /> Se obtendrán todas las reglas asociadas con API Gateway. <br /> Las reglas asociadas con API Gateway estarán disponibles en el directorio de tu proyecto como un archivo JSON llamado catalyst-user-rules. A continuación se muestra un ejemplo del archivo catalyst-user-rules.json: [ { "name": "shipment-tracker - Web Client Hosting", "source_endpoint": "/app/{path1:(.*)}", "target_endpoint": "/app/{path1}", "target": "client", "method": "GET", "throttling": { "overall": {}, "ip": {} } }, { "name": "shipment-info", "source_endpoint": "/server/shipment-info/execute", "target_endpoint": "/server/shipment-info/execute", "target": "basicio", "method": "ANY", "throttling": { "overall": {}, "ip": {} }, "target_id": "12096000000568097" }, { "name": "logistic_struct", "source_endpoint": "/server/logistic_struct/execute", "target_endpoint": "/server/logistic_struct/execute", "target": "basicio", "method": "ANY", "throttling": { "overall": {}, "ip": {} }, "target_id": "12096000000573043" }, { "name": "Login Redirect", "source_endpoint": "/app/index.html", "target_endpoint": "/app/index.html", "target": "client", "method": "GET", "throttling": { "overall": {}, "ip": {} }, "system": true } ] ### Gestionar tokens de autenticación Catalyst te permite generar tokens de autenticación para acceder de forma directa y segura a tu cuenta de Catalyst sin necesidad de iniciar sesión. Estos tokens validan tus operaciones con tu cuenta de Catalyst y sus proyectos. Puedes obtener más información en la página de ayuda Working with Tokens. Puedes generar tokens de autenticación fácilmente desde tu IDE VS Code utilizando la funcionalidad Project Explorer de la extensión **Catalyst Tools**. Para generar tokens, sigue estos pasos: 1. Haz clic en el botón **Manage Token**. <br /> Si existen tokens creados previamente, se mostrarán aquí. 2. Para generar un nuevo token, haz clic en el botón **Create Token**. <br /> 3. Se abrirá la terminal de tokens en VS Code y se generará una URL de verificación junto con un código de verificación. <br /> 4. Haz clic en la URL, pega el código de verificación en el espacio proporcionado y haz clic en **Verify**. <br /> 5. Haz clic en **Accept** después de revisar la lista de alcances y permisos. <br /> Tu acceso ha sido autenticado. <br /> Cuando regreses al IDE VS Code, tu token estará generado y disponible en la ventana *Manage Token* y en la terminal de tokens. <br /> Haz clic en el **ícono de copiar** para copiar el token y haz clic en el botón **Revoke** para revocar tokens. <br /> Puedes usar este token para autenticar el acceso a tu cuenta de Catalyst. Nota: Los tokens de acceso solo se pueden generar una vez cada sesenta minutos. ### Cerrar sesión en tu cuenta de Catalyst Puedes cerrar sesión en tu cuenta de Catalyst dentro del entorno de la extensión de VS Code a través de la funcionalidad Project Explorer. Para cerrar sesión en tu cuenta de Catalyst, sigue estos pasos: 1. Haz clic en el **ícono de puntos suspensivos** en el Project Explorer. <br /> 2. Haz clic en **Log Out**. <br /> Se cerrará tu sesión correctamente. Puedes volver a iniciar sesión en tu cuenta de Catalyst desde el IDE siguiendo los pasos indicados en esta página de ayuda. <br /> -------------------------------------------------------------------------------- title: "Configuración de la extensión" description: "Catalyst Tools es una extensión de Catalyst que se puede instalar en el IDE Visual Studio Code. La extensión te permite ejecutar comandos y operaciones del CLI sin necesidad de usar la terminal de Catalyst CLI." last_updated: "2026-07-02T09:34:15.865Z" source: "https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/extension-settings/" service: "All Services" -------------------------------------------------------------------------------- # Configuración de la extensión Tienes la opción de modificar las siguientes configuraciones de la extensión **Catalyst Tools** en el IDE según tus preferencias: * Proporcionar una ruta de credenciales personalizada. Una ruta de credenciales personalizada es la ubicación que defines en tu sistema local donde se almacenarán las credenciales de tu cuenta en un archivo JSON. * Seleccionar si deseas que el depurador del IDE esté activo al realizar la operación *Run/Debug*. Puedes acceder a la sección *Settings* siguiendo los pasos que se indican a continuación: 1. Haz clic en el **ícono de configuración** ubicado en la barra lateral del IDE. <br /> 2. Haz clic en **Settings**. <br /> 3. Busca *Catalyst* en la barra de búsqueda. <br /> Se mostrará tu ruta de credenciales predeterminada, y la configuración de depuración del IDE también estará habilitada por defecto. ### Cambiar la ruta de credenciales predeterminada En la sección *Users* de la configuración de la extensión, puedes cambiar la ruta de credenciales. Para cambiar la ruta de credenciales, sigue los pasos que se indican a continuación: 1. Haz clic en **Add Item**. <br /> 2. Ingresa la ruta que prefieras y haz clic en **OK**. <br /> La ruta predeterminada se cambiará a la ruta que hayas elegido. 3. En la ruta seleccionada se creará un directorio llamado **zcatalyst-vscode**. Cuando inicies sesión desde la extensión, tus credenciales se almacenarán en este directorio en un archivo JSON. Al cambiar la ruta de credenciales, se producen los siguientes cambios: * Los códigos de autenticación que habías generado previamente dejarán de ser accesibles. Tendrás que generar nuevos códigos nuevamente. * Tendrás que iniciar sesión en tu cuenta de Catalyst otra vez. Nota: Los códigos antiguos que generaste seguirán presentes de forma encriptada en la ruta predeterminada original. Para verlos de nuevo, solo necesitas revertir a la ruta predeterminada; no es necesario regenerar los códigos. ### Editar o revertir la ruta de credenciales a la predeterminada Para editar la ruta de credenciales: 1. Haz clic en el **ícono de edición**. <br /> 2. Proporciona una ruta actualizada y haz clic en **OK**. <br /> Para revertir a la ruta de credenciales predeterminada: 1. Haz clic en el **ícono de eliminar**. <br /> 2. La ruta de credenciales se revertirá a la predeterminada. <br /> ### Habilitar o deshabilitar la sección de depuración del IDE De forma predeterminada, cuando utilizas la funcionalidad **Run/Debug** en la sección *HTTP FUNCTIONS* o *NON HTTP FUNCTIONS*, el depurador del IDE se activa automáticamente. Si deshabilitas la opción de depuración en el IDE, al hacer clic en **Run/Debug** simplemente se servirá la función sin un depurador adjunto. Si ya no deseas que se abra el depurador y prefieres solo servir la función, sigue los pasos que se indican a continuación: 1. Ve a la sección de configuración y selecciona la opción **Zcatalyst: Debug**. <br /> 2. Desmarca la opción para asegurarte de que el depurador del IDE no se adjunte a tu función cuando ejecutes el comando catalyst serve. <br /> Puedes volver a habilitar el depurador del IDE en cualquier momento siguiendo los mismos pasos. Nota: Puedes ir a la sección User o a la sección Workspace para modificar esta configuración. Sin embargo, si la modificas en la sección Workspace, el cambio solo se aplicará al proyecto actual. Si la cambias en la sección User, los cambios se aplicarán de forma global.