# Python -------------------------------------------------------------------------------- title: "Introducción" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/introduction/" service: "All Services" related: - Project Directory Structure (/es/cli/v1/project-directory-structure/introduction/) - News API (https://newsapi.org/) -------------------------------------------------------------------------------- # NewsApp ### Introducción En este tutorial, crearemos una aplicación de noticias llamada **The Daily Broadcast**, que recupera las últimas noticias de múltiples fuentes confiables, actualiza el contenido en intervalos de tiempo definidos y muestra las noticias actualizadas dentro de la aplicación. Para este propósito, utilizaremos [NewsAPI](https://newsapi.org/), un servicio de terceros que obtiene titulares de diversas categorías como Negocios, Entretenimiento, Salud, Ciencia, Deportes y Tecnología de fuentes en toda la web. Integraremos esta API en nuestra aplicación y mostraremos las noticias junto con enlaces a los artículos originales. La apariencia final de la aplicación client se asemejará a esta pantalla: ![final-look](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/final-look.webp) Puede acceder a la aplicación funcional desde aquí: [¡Pruebe la App!](https://news-fetcher.catalystserverlessapp.com/app/) Construiremos la aplicación de noticias utilizando los siguientes Servicios y Componentes de Catalyst, cada uno desempeñando un papel clave en la arquitectura general: 1. [**Catalyst Serverless**](https://docs.catalyst.zoho.com/es/serverless/getting-started/introduction/): - **[Función Advanced I/O](https://docs.catalyst.zoho.com/es/serverless/help/functions/advanced-io/)**: Esta función está codificada en **Python** y sirve como la capa API de la aplicación. Recupera datos de noticias del Catalyst CloudScale Data Store y los entrega al frontend como una respuesta JSON. - **[Job Function](https://docs.catalyst.zoho.com/es/serverless/help/functions/job-functions/)**: Esta función está codificada en Python y contiene la lógica para llamar a [NewsAPI](https://newsapi.org/), obtener los últimos titulares de diferentes categorías y almacenarlos en el Data Store. 2. [**Catalyst CloudScale**](https://docs.catalyst.zoho.com/es/cloud-scale/getting-started/introduction/): - **[Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/)**: Este componente actúa como el almacenamiento central para todos los datos de noticias obtenidos de [NewsAPI](https://newsapi.org/). Asegura un acceso rápido y escalable al contenido de noticias. - **[ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction/)**: Este componente se utiliza para consultar el Data Store de manera eficiente y recuperar los datos de noticias relevantes. - **[Web Client Hosting](https://docs.catalyst.zoho.com/es/cloud-scale/help/web-client-hosting/introduction/)**: Este componente aloja el frontend de la aplicación, permitiendo a los usuarios ver el contenido de noticias de manera fluida a través de una interfaz web. 3. **[Catalyst Job Scheduling](https://docs.catalyst.zoho.com/es/job-scheduling/getting-started/introduction/)**: Este componente permite la ejecución periódica de la Job Function, asegurando que la aplicación se actualice con noticias frescas en intervalos definidos. Juntos, estos componentes permiten una aplicación de noticias completamente funcional y automatizada que se mantiene actualizada con la información más reciente de fuentes confiables. Utilizaremos la consola web de Catalyst y la Interfaz de Línea de Comandos (CLI) de Catalyst para construir esta aplicación. Se le proporcionará el código para los archivos que se incluirán en los componentes de función y client en este tutorial. Solo tendrá que copiar el código proporcionado en esta guía y pegarlo en los archivos apropiados según se indique. ### Arquitectura de la aplicación -------------------------------------------------------------------------------- title: "Requisitos previos" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/prerequisites/" service: "All Services" related: - CLI Command Reference (/es/cli/v1/cli-command-reference/) -------------------------------------------------------------------------------- # Requisitos previos Antes de comenzar a construir la aplicación, debe tener los siguientes requisitos previos instalados en su sistema: 1. **Catalyst CLI** \ \ Catalyst CLI contiene un conjunto de herramientas que le permiten inicializar, desarrollar, probar y desplegar los componentes de su aplicación desde su máquina local. Trabajaremos con Catalyst CLI en este tutorial. \ \ Debe realizar las siguientes acciones: 1. **Instalar Catalyst CLI:** Catalyst CLI se instala a través de NPM. Por lo tanto, debe tener NPM y Node.js instalados en su sistema antes de instalar el CLI. Consulte la [**página de ayuda de Instalación de Catalyst CLI**](https://docs.catalyst.zoho.com/es/getting-started/installing-catalyst-cli/) para obtener detalles sobre los requisitos previos y los pasos para instalarlo. 2. **Iniciar sesión en Catalyst CLI:** Después de instalar Catalyst CLI, debe autenticar el CLI con su cuenta de Catalyst antes de usarlo. Consulte la [**página de ayuda de Inicio de sesión en CLI**](https://docs.catalyst.zoho.com/es/cli/v1/login/login-from-cli/) para conocer los pasos para iniciar sesión desde Catalyst CLI y las diversas opciones disponibles. 2. **Cualquier herramienta IDE para desarrollo de código Python y client** \ \ Puede usar cualquier IDE para trabajar con la función Advanced I/O y el código del client. Algunas opciones populares incluyen Visual Studio Code, IntelliJ IDEA, Eclipse y Sublime Text. Descargue e instale un IDE de su elección en su sistema. > Si es usuario del IDE Visual Studio Code, puede instalar la extensión **Catalyst Tools**, y usar su IDE en lugar del CLI. Puede encontrar más detalles sobre la extensión de Catalyst para VS Code en esta [sección de ayuda](https://docs.catalyst.zoho.com/es/catalyst-extensions/vs-code-extension/introduction/). -------------------------------------------------------------------------------- title: "Crear un proyecto" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/create-project/" service: "All Services" related: - Project Directory (/es/cli/v1/project-directory-structure/introduction) - Setup Catalyst Projects (/es/getting-started/catalyst-projects) -------------------------------------------------------------------------------- # Crear un proyecto Vamos a [crear un proyecto Catalyst](https://docs.catalyst.zoho.com/es/getting-started/catalyst-projects) desde la consola de Catalyst. 1. Inicie sesión en la [Consola de Catalyst](https://console.catalyst.zoho.com/baas/index) y haga clic en **Create New Project**. ![cron_create_project](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/cron_create_project.webp) 2. Ingrese el nombre del proyecto como "**NewsApp**" en la ventana emergente. ![cron_project_name](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/cron_project_name.webp) 3. Haga clic en **Create**. Su proyecto será creado. Puede abrir el proyecto haciendo clic en **Access Project**. ![cron_access_project](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/cron_access_project.webp) -------------------------------------------------------------------------------- title: "Crear tablas" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/create-tables/" service: "All Services" related: - Data Store (/es/cloud-scale/help/data-store/introduction) -------------------------------------------------------------------------------- # Crear tablas en el Data Store A continuación, vamos a crear tablas en el [Catalyst CloudScale Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction/) del proyecto NewsApp. Crearemos siete tablas para almacenar noticias de diversas categorías. Comencemos creando la primera tabla. Para crear una tabla, siga los pasos listados a continuación: 1. Navegue al servicio [CloudScale](https://docs.catalyst.zoho.com/es/cloud-scale/getting-started/introduction/) desde la consola de Catalyst, y haga clic en **Start Exploring**. ![cloudscale](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/cloudscale.webp) 2. Navegue a **Data Store** bajo la sección **Storage** y haga clic en **Create a new Table**. ![create-new-table](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/create-new-table.webp) 3. Ingrese el nombre de la tabla como '**HEADLINES**' y haga clic en **Create**. ![headlines](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/headlines.webp) Esta tabla almacenará los titulares generales de los elementos de noticias obtenidos a través de [NewsAPI](https://newsapi.org/). > **Nota**: Asegúrese de ingresar el nombre exactamente como se indica, porque el código de la aplicación contiene el mismo nombre. La tabla ahora está creada y se muestra en la página de *Data Store*. ![created-table](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/created-table.webp) Haga clic en **New Table** para crear las otras tablas de la misma manera. ![click-new-table](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/click-new-table.webp) Necesitaremos crear otras seis tablas para almacenar datos de noticias de diversas categorías y nombrarlas de la siguiente manera: 'BUSINESS', 'ENTERTAINMENT', 'HEALTH', 'SCIENCE', 'SPORTS', 'TECHNOLOGY'. > **Nota**: Asegúrese de ingresar todos los nombres de tablas exactamente como se indica, porque el código de la aplicación contiene los mismos nombres. Las tablas se mostrarán a la izquierda en la página de **Data Store**. ![all-tables](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/all-tables.webp) ### Crear columnas Ahora, vamos a crear columnas en todas las tablas. Crearemos dos columnas en cada tabla: * **title**: Para almacenar el título del artículo de noticias * **url**: Para almacenar la URL original de la fuente del artículo de noticias Para crear una columna en una tabla, asegúrese de seguir los pasos a continuación: 1. Haga clic en **New Column** en la sección *Schema View* de la tabla. ![new-column](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/new-column.webp) 2. Ingrese el nombre de la columna como '**title**'. Seleccione el tipo de dato como **Var Char**, ingrese la longitud máxima como '**255**' y haga clic en **Create**. ![title](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/title.webp) Puede conocer los diversos tipos de datos soportados por Catalyst y las otras propiedades de una columna en la [página de ayuda de Data Store](https://docs.catalyst.zoho.com/es/cloud-scale/help/data-store/introduction). > **Nota**: Asegúrese de ingresar el nombre exactamente como se indica, porque el código de la aplicación contiene el mismo nombre. Ahora cree la columna **'url'** de la misma manera. Proporcione los mismos valores y haga clic en **Create**. ![url](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/url.webp) Las columnas ahora están creadas para la tabla y se listarán en la sección *Schema View*. ![columns-added](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/columns-added.webp) Ahora cree las mismas columnas con los mismos valores en cada una de las otras seis tablas. Ahora hemos configurado el Data Store. Trabajaremos en la codificación de la aplicación desde nuestro sistema local. Configuraremos el servicio Job Scheduling más adelante. -------------------------------------------------------------------------------- title: "Crear un Job Pool" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/create-job-pool/" service: "All Services" related: - Job Scheduling (/es/cloud-scale/help/data-store/introduction) -------------------------------------------------------------------------------- # Crear un Job Pool Ahora vamos a [crear un job pool](https://docs.catalyst.zoho.com/es/job-scheduling/help/implementation/create-jobpool/) usando el [servicio Catalyst Job Scheduling](https://docs.catalyst.zoho.com/es/job-scheduling/getting-started/introduction/). Este componente es responsable de ejecutar jobs y activar la [job function](https://docs.catalyst.zoho.com/es/serverless/help/functions/job-functions/) que configuraremos en el [Paso 5](https://docs.catalyst.zoho.com/es/tutorials/newsapp/nodejs/configure-job-function). Configuraremos un programa [cron predefinido](https://docs.catalyst.zoho.com/es/job-scheduling/help/implementation/submit-job-predefined-cron/) para enviar automáticamente jobs al job pool en intervalos regulares (digamos una vez cada hora). Puede obtener más información sobre la ejecución de jobs en un job pool en [esta página de ayuda](https://docs.catalyst.zoho.com/es/job-scheduling/help/jobpool/introduction/#architecture-of-job-execution-in-a-job-pool). Para crear un job pool, asegúrese de seguir los pasos listados a continuación: 1. Navegue al servicio **Job Scheduling** en la consola de Catalyst. ![job-scheduling](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-scheduling.webp) 2. Navegue a **Job Pool** bajo la sección **Job Source** y haga clic en **Create Job Pool**. ![job-pool](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-pool.webp) En la ventana emergente, proporcione el nombre del Job Pool como **"News"** y seleccione el tipo de Job Pool como **Function** (esta es típicamente la job function que configuraremos en el [Paso 5](https://docs.catalyst.zoho.com/es/tutorials/newsapp/nodejs/configure-job-function)). Puede seleccionar la memoria de cómputo requerida para la función. En nuestro caso, como límite superior puede seleccionar hasta 2GB y hacer clic en **Create**. ![create-job-pool](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/news-app-job-pool-creation-pop-up.webp) El job pool ahora está creado. ![job-pool-id](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-pool-creation-success.webp) -------------------------------------------------------------------------------- title: "Inicializar el proyecto" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/initialize-project/" service: "All Services" related: - Project Directory Structure (/es/cli/v1/project-directory-structure/introduction/) - Initialize Resources (/es/cli/v1/initialize-resources/introduction/) - Advanced I/O Functions (/es/serverless/help/functions/advanced-io/) -------------------------------------------------------------------------------- # Inicializar el proyecto desde el CLI Ahora puede comenzar a trabajar en su proyecto Catalyst desde el CLI. El primer paso es inicializar el proyecto en un directorio vacío. Este será el directorio principal de su proyecto y todos los archivos del proyecto se guardarán en él. Puede obtener más información sobre esto en la [página de ayuda de Estructura de Directorio del Proyecto](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction/). Puede aprender sobre la inicialización de un proyecto en detalle en la [documentación de ayuda del CLI](https://docs.catalyst.zoho.com/es/cli/v1/initialize-resources/introduction/). Para la aplicación de noticias, inicializaremos una [job function](https://docs.catalyst.zoho.com/es/serverless/help/functions/job-functions/) y el [client](https://docs.catalyst.zoho.com/es/cli/v1/working-with-the-client/introduction/), y luego [agregaremos una función Advanced I/O](https://docs.catalyst.zoho.com/es/serverless/help/functions/advanced-io) al directorio del proyecto. 1. Cree una carpeta para el proyecto en su máquina local y navegue hasta ella desde la terminal. Inicialice un proyecto ejecutando el siguiente comando desde ese directorio: ```sh catalyst init ``` 2. El CLI ahora le pedirá que seleccione la organización en la que reside su proyecto Catalyst que creamos anteriormente en la consola. Seleccione la organización y presione **Enter**. ![catalyst-portal](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/catalyst-portal.webp) 3. Seleccione el proyecto en la organización de la lista y presione **Enter**. ![select-project](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/select-project.webp) 4. Seleccione **Functions** y **Client** usando la barra espaciadora. Presione **Enter** para inicializar los componentes. ![select-components](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/select-components.webp) 5. El CLI primero iniciará la configuración de la función. Seleccione **Job** como el tipo de función. ![job-function](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-function.webp) 6. Seleccione el runtime más reciente de **Python** como el stack de la función. ![select-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/select-python.webp) 7. Ingrese **"NewsApp"** como el nombre del paquete, **"main.py"** como el punto de entrada y presione **Enter**. Puede presionar **Enter** para completar los valores predeterminados. ![setup-function-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/setup-function-python.webp) 8. El CLI ahora inicializará la configuración del client. Elija **"Basic web app"** como el tipo de client. ![basic-web-app](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/basic-web-app.webp) 9. Ingrese **'NewsAppClient'** como el nombre del paquete del client y presione **Enter**. Puede ingresar cualquier nombre que desee. ![client-setup](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/client-setup.webp) El directorio del client se creará en la estructura estándar. La inicialización de Catalyst está ahora completa. Ahora agreguemos una función Advanced I/O adicional al directorio del proyecto. Como se mencionó anteriormente, la codificaremos en el stack de **Node.js**. 1. Para agregar una función adicional, ejecute el siguiente comando desde el directorio del proyecto: ```sh catalyst functions:add ``` 2. Seleccione **AdvancedIO** como el tipo de función y presione **Enter**. ![advancedio](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/advancedio.webp) 3. Seleccione el runtime más reciente de **Python** como el stack de la función, y presione **Enter**. ![advancedio-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/advancedio-python.webp) 4. Ingrese **'news_app_function'** como el nombre del paquete, **'main.py'** como el punto de entrada y presione **Enter**. Puede presionar **Enter** para completar los valores predeterminados. ![advancedio-setup-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/advancedio-setup-python.webp) > **Nota**: Asegúrese de ingresar el nombre del paquete exactamente como se indica, porque el código de la aplicación contiene los mismos nombres. El directorio de su proyecto ahora está configurado con el [directorio del client](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/client-directory) y el [directorio de functions](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory) junto con archivos de configuración y dependencias. El directorio de functions contiene tanto la función Job como la función Advanced I/O en carpetas individuales. El directorio del proyecto también contiene el archivo de configuración [`catalyst.json`](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/catalyst-json) y un archivo oculto `.catalystrc`. La estructura del directorio del proyecto NewsApp se verá así: ![project-dir-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/project-dir-python.webp) -------------------------------------------------------------------------------- title: "Configurar la Job Function" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/configure-job-function/" service: "All Services" related: - Job Scheduling (/es/job-scheduling/getting-started/introduction/) - Job Functions (/es/serverless/help/functions/job-functions/) -------------------------------------------------------------------------------- # Configurar la Job Function A continuación, comenzaremos a codificar la aplicación de noticias configurando el componente de la job function. El directorio de la función, en este caso `functions/NewsApp`, contiene: * El archivo principal de la función `main.py` * El archivo de configuración `catalyst-config.json` * El archivo [requirements.txt](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/#python-modules-and-function-dependencies) Agregaremos código en el archivo `main.py`. No modificará el código de los archivos de configuración y dependencias. Como se mencionó en la [introducción](https://docs.catalyst.zoho.com/es/tutorials/newsapp/java/introduction/), la job function realiza dos tareas: hacer las llamadas API a [NewsAPI](https://newsapi.org/) para obtener noticias, y poblar las noticias en Catalyst Data Store. Las llamadas API se realizan utilizando una clave API proporcionada por NewsAPI. ### Registrarse en NewsAPI Antes de codificar la job function, debe registrarse para una suscripción gratuita de desarrollador con NewsAPI y obtener la clave API de la siguiente manera: 1. Visite [https://newsapi.org/register](https://newsapi.org/register). 2. Proporcione los detalles requeridos y haga clic en **Submit**. ![register-api-key](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/register-api-key.webp) Después de completar su registro, NewsAPI le proporcionará una clave API. Debe usarla en su función cron, como se indica después de la sección de código. ![api-key](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/api-key.webp) ### Agregar código de la función Puede copiar el código a continuación y pegarlo en `main.py` ubicado en el directorio `functions/NewsApp` de su proyecto y guardar el archivo. Puede usar cualquier IDE para trabajar con los archivos de la aplicación. > **Nota**: Por favor, revise el código proporcionado en esta sección para asegurarse de que lo comprende completamente. **main.py** ```python import logging import zcatalyst_sdk import requests logger = logging.getLogger() def handler(job_request, context): logger.info("Fetching news!") # Los nombres de las tablas en el Data Store donde se almacenarán los elementos de noticias table_name = ["HEADLINES", "BUSINESS", "ENTERTAINMENT", "HEALTH", "SCIENCE", "SPORTS", "TECHNOLOGY"] country = "US" #Obtiene los elementos de noticias de los Estados Unidos de América api_key = "cc30ddcaxxxxxxxxxx" # Proporcione la clave API que obtuvo de NewsAPI dentro de las comillas fetch_url = "https://newsapi.org/v2/top-headlines" #Obtiene las noticias de última hora de diferentes categorías con sus titulares for category in table_name: # Construyendo lo requerido para obtener noticias params = { 'country':country, 'apiKey':api_key, } if category != "HEADLINES": params['category'] = category # Realiza una llamada API a News API para obtener los datos response = requests.get(fetch_url, params=params) # Si la respuesta es 200, los datos se mueven al Data Store. Si no, el error se registra. if response.status_code == 200: data = response.json() try: if 'articles' in data: array_data = data['articles'][:15] logger.info("15 days "+str(array_data)) # Este método inserta/actualiza las noticias en el Data Store push_to_datastore(array_data,category) except requests.RequestException as e: logger.error("Request failed: "+ str(e)) context.close_with_failure() # fin de la aplicación con error # Las acciones se registran. Puede verificar los logs desde Catalyst Logs. logger.info("New updated") else: logger.error("Request failed with status :: ",response.status_code) context.close_with_failure() # fin de la aplicación con error context.close_with_success() # fin de la aplicación con éxito def push_to_datastore(sliced_data,tableName): app = zcatalyst_sdk.initialize() zcql_service = app.zcql() datastore_service = app.datastore() #Define la consulta ZCQL que se usará para encontrar el número de filas en una tabla query = "select ROWID from "+tableName zcql_result = zcql_service.execute_query(query) table_instance = datastore_service.table(tableName) #Inserta / Actualiza los datos obtenidos de la API en el datastore for i in range(0,14): title = sliced_data[i]['title'] url = sliced_data[i]['url'] if len(zcql_result) == 0: # insertando nueva fila row_data= {'title':title,'url':url} table_instance.insert_row(row_data) logger.info("Row inserted "+ str(row_data)) else: # actualizando fila row_data= {'title':title,'url':url,'ROWID':zcql_result[i][tableName]['ROWID']} table_instance.update_row(row_data) logger.info("Row inserted "+ str(row_data)) ``` > **Nota**: Después de copiar y pegar este código en su archivo de función, asegúrese de reemplazar el valor de `APIKEY` en la línea **12** con la clave API que obtuvo de NewsAPI. La job function está ahora configurada. Discutiremos la arquitectura de la aplicación después de configurar el client. -------------------------------------------------------------------------------- title: "Configurar la función Advanced I/O" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/configure-advancedio/" service: "All Services" related: - Advanced I/O Function (/es/serverless/help/functions/advanced-io) - Data Store (/es/cloud-scale/help/data-store/introduction) - ZCQL (/es/cloud-scale/help/zcql/introduction) -------------------------------------------------------------------------------- # Configurar la función Advanced I/O El directorio de la función Advanced I/O (`functions/news_app_function`) contiene los siguientes archivos: * El archivo principal de la función `main.py` * El archivo de configuración `catalyst-config.json` * El archivo [requirements.txt](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/functions-directory/#python-modules-and-function-dependencies) #### Agregar código Agregará código en el archivo `main.py`. La función Advanced I/O obtiene el elemento de noticias de su tabla de origen en el Data Store y lo envía al componente client como una respuesta JSON. Copie el código y péguelo en `main.py` en el directorio `functions/news_app_function `. **main.py** ```python import logging from flask import Request, make_response, jsonify import zcatalyst_sdk def handler(request: Request): #Inicializando el SDK de Catalyst app = zcatalyst_sdk.initialize() logger = logging.getLogger() # API GET que obtiene las noticias de la tabla requerida if request.path == "/fetchData": table_name = request.args.get("tablename") logger.info("Fetching news from datastore table - "+table_name) zcql_instance = app.zcql() # Consulta para obtener noticias de la tabla query = "Select title,url from "+table_name #Consulta la tabla del Catalyst Data Store y obtiene las noticias requeridas zcql_result = zcql_instance.execute_query(query) return jsonify({"content": zcql_result}), 200 else: # Para ruta no definida se lanzará un error response = make_response('Unknown path') response.status_code = 400 return response ``` La función Advanced I/O está ahora configurada. Discutiremos la arquitectura de la aplicación después de configurar el client. -------------------------------------------------------------------------------- title: "Configurar el client" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/configure-client/" service: "All Services" related: - Client (/es/cli/v1/project-directory-structure/introduction) - Advanced I/O Function (/es/serverless/help/functions/advanced-io) -------------------------------------------------------------------------------- # Configurar el Client Ahora configuremos el componente client. El [directorio](https://docs.catalyst.zoho.com/es/cli/v1/project-directory-structure/introduction) contiene: * El archivo `index.html` que contiene el código HTML para la aplicación frontend * El archivo `main.css` que contiene el código CSS * El archivo `main.js` que contiene el código JavaScript * El archivo de configuración `client-package.json` Codificaremos `index.html`, `main.js` y `main.css`. > **Nota**: Por favor, revise el código en esta sección para asegurarse de que lo comprende completamente. Copie el código a continuación y péguelo en los archivos respectivos ubicados en el directorio `client/` de su proyecto usando un IDE y guarde los archivos. **index.html** ```xml <!DOCTYPE html> <html> <title>NewsApp</title> <script src="main.js"></script> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <link rel="stylesheet" type="text/css" media="screen" href="main.css" /> <head> <meta name="viewport" content="width=device-width, initial-scale=1"> </head> <body onload="fetchNews('HEADLINES')"> <center> <h1>Welcome to The Daily Broadcast</h1> <h3>Today's News</h3> <h2>HEADLINES</h2><br> </center> <div class="sidenav"> <img src="https://i.pinimg.com/236x/e6/71/5f/e6715f8bd963c783f75f11fdc37fa4aa.webp" width="220" height="200" onclick="fetchNews('HEADLINES')"><br> <a onclick="return fetchNews('BUSINESS');">Business</a><br> <a onclick="return fetchNews('ENTERTAINMENT');">Entertainment</a><br> <a onclick="return fetchNews('HEALTH');">Health</a><br> <a onclick="return fetchNews('SCIENCE');">Science</a><br> <a onclick="return fetchNews('SPORTS');">Sports</a><br> <a onclick="return fetchNews('TECHNOLOGY');">Technology</a><br> </div> <div class="loading" id="loader" style="display: none;"></div> <div class="main"> <ul id="newsList"></ul> </div> </body> </html> ``` **main.css** ```css .sidenav { height: 100%; width: 220px; position: fixed; z-index: 1; top: 0; left: 0; background-color: #111; overflow-x: hidden; } a{ cursor: pointer; } .sidenav a { padding: 6px 8px 6px 16px; text-decoration: none; font-size: 25px; font-family: "Helvetica", sans-serif; color: #818181; display: block; } .sidenav a:hover { color: #f1f1f1; } .main { margin-left: 200px; font-size: 20px; padding: 0px 10px; font-family: "Poynter", sans-serif; } @media screen and (max-height: 450px) { .sidenav { padding-top: 15px; } .sidenav a { font-size: 18px; } } .loading { height: 0; width: 0; padding: 15px; border: 6px solid rgb(155, 155, 155); border-right-color: rgb(88, 88, 88); border-radius: 22px; -webkit-animation: rotate 1s infinite linear; /* left, top and position just for the demo! */ position: absolute; left: 50%; top: 50%; } @-webkit-keyframes rotate { /* 100% keyframe for clockwise. use 0% instead for anticlockwise */ 100% { -webkit-transform: rotate(360deg); } } ``` **main.js** ```javascript function fetchNews(name) { //Como mostramos los elementos de noticias como nodos, elimina los nodos existentes para cada cambio de categoría const nodes = document.getElementById("newsList"); nodes.innerHTML = ''; document.getElementById("loader").style.display = "block"; var tablename = name; console.log(tablename); //Realiza una llamada API a la función Advanced I/O para obtener el elemento de noticias de una tabla particular $.ajax({ url: "/server/news_app_function/fetchData?tablename=" + tablename, //Si inicializó la función Advanced I/O con un nombre diferente, asegúrese de reemplazar news_app_function con ese nombre. type: "get", success: function (response) { var data = response; var i; document.getElementById("loader").style.display = "none"; //Analiza la respuesta de la función Advanced I/O y la renderiza en la página HTML creando una lista de nodos for (i = 0; i < data.content.length; i++) { var list = document.getElementById('newsList'); var anchor = document.createElement('a'); var li = document.createElement('li'); var linebreak = document.createElement("br"); anchor.href = data.content[i][tablename].url; anchor.innerText = data.content[i][tablename].title; anchor.setAttribute('target', '_blank'); li.appendChild(anchor); list.appendChild(li); list.appendChild(linebreak); } }, error: function (error) { alert(error.data); } }); } ``` > **Nota**: Si ha elegido un nombre diferente para su función Advanced I/O, entonces reemplace **news_app_function** con ese nombre en la línea **10**. El directorio del client está ahora configurado. ### Funcionamiento de las Functions y el Client Repasemos rápidamente el funcionamiento de los componentes de función y client de la aplicación: * Cuando un cron recursivo se configura para ejecutarse en un intervalo de tiempo especificado, digamos una vez cada hora, y se asocia con la job function `NewsApp`, automáticamente inicia la ejecución de la función una vez cada hora. * Se realiza una llamada API a http://newsapi.org/v2/top-headlines para obtener los titulares de noticias. Esta solicitud se autentica usando la clave API obtenida de NewsAPI. La elección del país, la clave API y la categoría de noticias asociada con la tabla respectiva en el Data Store se pasan como parámetros de consulta. * El método `push_to_datastore` inserta los datos obtenidos de la llamada API para los parámetros `title` y `url` en una lista. Una consulta [ ZCQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/zcql/introduction) luego obtiene el conteo de filas de cada tabla. Si los datos ya están poblados en una tabla de una llamada API anterior realizada a NewsAPI, los datos se reemplazan con los elementos de noticias actualizados. Si no existen filas, se insertan nuevos datos en la tabla. * El script definido en el componente client `main.js` realiza una llamada API a la función Advanced I/O ejecutando una solicitud `GET` a la ruta `/fetchData` definida en la función. Los nombres de las tablas se pasan en la URL de la solicitud. * La función Advanced I/O consulta las tablas relevantes en el Data Store y obtiene el `title` y la `url` de los elementos de noticias. Esto se construye como una respuesta JSON y se devuelve a `main.js`. * `main.js` analiza la respuesta JSON obtenida de la función y la renderiza en la página HTML creando una lista de nodos. -------------------------------------------------------------------------------- title: "Probar la aplicación" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/test-application/" service: "All Services" related: - Serve Resources (/es/cli/v1/serve-resources/introduction/) -------------------------------------------------------------------------------- # Probar la aplicación Antes de desplegar la aplicación en la consola remota, puede probar la aplicación en un servidor local y verificar si todo funciona correctamente usando el CLI de Catalyst. Probaremos la función cron usando el [functions shell](https://docs.catalyst.zoho.com/es/cli/v1/working-with-functions/functions-shell/) en el CLI, y luego [serviremos la función Advanced I/O y el client localmente](https://docs.catalyst.zoho.com/es/cli/v1/serve-resources/introduction/) para probar el frontend de la aplicación. Primero ejecutemos el siguiente comando para generar un payload de ejemplo para pasar en el functions shell al que accederemos más adelante: ```sh catalyst event:generate:job 10108000007982015 // Reemplaza con el Job Pool ID requerido ``` El payload generado se verá así: ![payload](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/payload.webp) Ahora abra el functions shell en su CLI ejecutando el siguiente comando desde el directorio de su proyecto (CATALYST_PROJECT_HOME): ```sh catalyst functions:shell ``` Esto abrirá el functions shell para la función cron en el CLI donde puede probar su ejecución. Para invocar la función, ingrese `NewsApp()` en el shell, pase el payload generado dentro de los paréntesis y presione **Enter**. ![function-invoke-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/function-invoke-python.webp) Al probar la Job Function usando el comando shell, la respuesta indica el estado de ejecución de la función, ya sea `success` o `failure`. ![invoke-success-java](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/invoke-success-java.webp) El estado de ejecución de la función se devuelve como exitoso. Esto realizará la llamada API a NewsAPI y obtendrá los elementos de noticias de cada categoría, y los poblará en el Data Store. Puede verificar el componente Data Store para confirmar si los datos se han poblado como se esperaba. ![test-datastore-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/test-datastore-python.webp) Ahora, alojemos el componente client localmente y verifiquemos el frontend de la aplicación. Para servir el proyecto Catalyst localmente, ejecute el siguiente comando desde el directorio de su proyecto (CATALYST_PROJECT_HOME): ```sh catalyst serve ``` La aplicación de noticias ahora se servirá en el puerto predeterminado 3000. Se mostrarán las URLs de los endpoints locales de los componentes (el client y la función Advanced I/O). > **Nota**: Cada vez que acceda a la página principal o a cualquiera de las subpáginas de su client o la función, el CLI mostrará un registro en vivo de la URL accedida, junto con el método de solicitud HTTP. ![catalyst-serve-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/catalyst-serve-python.webp) Ahora puede abrir la aplicación en un navegador usando la URL local del client mostrada en el CLI. ![serve-output](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/serve-output.webp) La aplicación de noticias muestra los titulares generales de noticias en la página principal. Puede hacer clic en un tema a la izquierda para consultar los últimos titulares en esa categoría. Puede abrir el artículo de noticias original haciendo clic en un titular. Si esta configuración funciona correctamente, podemos desplegar la aplicación en la consola. -------------------------------------------------------------------------------- title: "Desplegar el proyecto" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/deploy-application/" service: "All Services" related: - Deploy Resources (/es/cli/v1/deploy-resources/introduction/) -------------------------------------------------------------------------------- # Desplegar el proyecto Para [desplegar su proyecto Catalyst desde el CLI](https://docs.catalyst.zoho.com/es/cli/v1/deploy-resources/introduction/), ejecute el siguiente comando en su terminal desde el directorio de su proyecto (CATALYST_PROJECT_HOME): ```sh catalyst deploy ``` Las funciones se despliegan primero, seguidas del componente client. Se muestran las URLs de producción de los componentes. ![catalyst-deploy-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/catalyst-deploy-python.webp) Ahora puede abrir la URL del componente client en un navegador para acceder a la aplicación desplegada. La aplicación de noticias ahora puede ser accedida desde su [URL de la aplicación web](https://docs.catalyst.zoho.com/es/cloud-scale/help/web-client-hosting/introduction). ![deploy-output](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/deploy-output.webp) -------------------------------------------------------------------------------- title: "Programar un Cron" description: "Construya una aplicación web de noticias que obtiene noticias de un servicio de terceros con Catalyst Cron, y una Job Function y función Advanced I/O en Python." last_updated: "2026-11-04T10:10:44.000Z" source: "https://docs.catalyst.zoho.com/es/tutorials/newsapp/python/schedule-cron/" service: "All Services" related: - Job Scheduling Cron (/es/job-scheduling/help/cron/introduction/) - Job Functions (/es/serverless/help/functions/job-functions/) -------------------------------------------------------------------------------- # Programar un Cron A continuación, vamos a [crear un cron](https://docs.catalyst.zoho.com/es/job-scheduling/help/cron/introduction/), asociarlo con el Job Pool creado en el [Paso 3](https://docs.catalyst.zoho.com/es/tutorials/newsapp/java/create-job-pool/), y programarlo para que se ejecute cada hora. Este cron activará la [Job Function](https://docs.catalyst.zoho.com/es/tutorials/newsapp/nodejs/configure-job-function/) periódicamente para obtener las últimas noticias de [NewsAPI](https://newsapi.org/) y actualizar la aplicación. Al ejecutarse una vez cada hora, el cron asegura que la aplicación se mantenga actualizada con contenido de noticias fresco. Cada vez que se ejecuta, invoca automáticamente la Job Function, que realiza una llamada API a NewsAPI para recuperar los últimos titulares. Para crear un cron desde la consola de Catalyst, asegúrese de seguir los pasos listados a continuación: 1. Navegue a **Cron** bajo la sección **Job Executor** y haga clic en **Create Cron**. ![create-cron](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/create-cron.webp) 2. Ingrese un nombre y una descripción para el cron. Puede ingresar cualquier nombre. Seleccione el **Format Type** como **Standard Input**. Seleccione el **Schedule Type** como **Recursive**. Seleccione el **Repeat Type** como **Every**. Puede configurar el **Schedule Time** según sea necesario y también elegir habilitar los **Cron termination details**. Después de ingresar todos los detalles, haga clic en **Next**. ![cron-details-java](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/cron-details-java.webp) 3. Proporcione un nombre para el Job, seleccione el Job Pool como News y la función objetivo como **NewsApp**. Haga clic en **Create**. ![job-create-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-create-python.webp) El cron se ha creado exitosamente. Ahora puede enviar el job para iniciar su ejecución haciendo clic en el botón **Submit Job**. ![job-submit-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-submit-python.webp) Puede hacer clic en el botón **Execution History** para ver los detalles de ejecución del cron. ![exec-history-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/exec-history-python.webp) Puede navegar a la sección **Jobs** y ver el estado de ejecución de los jobs programados en el cron para cada hora. ![job-history-python](https://catalyst-docs-development.zohostratus.in/images/tutorials/cron/job-history-python.webp) La aplicación de noticias ahora es funcional y las noticias se obtendrán de NewsAPI y se actualizarán en la aplicación cada hora.