¿Cómo crear medidores en Fracttal HUB?

Con la opción de automatización en Fracttal Hub, es posible gestionar la creación de medidores de forma eficiente y sin intervención manual, especialmente en contextos de alto volumen de datos. Esta funcionalidad permite a los usuarios agilizar procesos operativos y minimizar errores humanos en el manejo de lecturas de medidores.

A continuación, encontrarás una guía paso a paso sobre cómo configurar esta funcionalidad dentro de la plataforma Fracttal Hub.

Paso 1: Accede a la Consola de Google Cloud

Ingresa a Google Cloud Console.

• Dirígete a la sección de API y servicios > Credenciales.

• Haz clic en Crear credenciales > Cuenta de servicio.

  

• Nombra la cuenta de servicio como "crear_medidores" y sigue el proceso hasta finalizar.

Paso 2: Genera la clave JSON

1. Una vez creada la cuenta de servicio, selecciónala desde el listado.

   

2. Ingresa en la sección Claves. Haz clic en Agregar clave > Crear clave nueva.

   

3. Selecciona el formato JSON.

   

4. Guarda el archivo generado en una ubicación segura; este archivo será necesario para configurar la integración en Fracttal Hub.

Paso 3: Preparar la hoja de cálculo (Google Sheets)

Ahora, prepararemos la hoja de cálculo que servirá como fuente de datos para la creación de los medidores.

1. Cree una nueva hoja de cálculo en Google Sheets.

2. Asígnele un nombre descriptivo, como CREAR MEDIDOR.

3. En la primera fila, defina las cabeceras de las columnas. Estas deben coincidir con los parámetros que requiere la API de Fractal. Para este ejemplo, utilizaremos los siguientes campos obligatorios y uno opcional:

   • Columna A: description (Descripción del medidor, ej: "Medidor de KM").

   • Columna B: item_code (Código del activo al cual se asociará el medidor, ej: "HUB-004").

   • Columna C: unit_code (Código de la unidad del medidor, ej: "KM". Este código debe existir previamente en Configuración > Catálogos Auxiliares > Unidad).

   • Columna D: is_counter (Opcional, pero recomendado. Indica si el medidor es un acumulador. Escriba TRUE si lo es, o FALSE si no).

4. Llene las filas con la información de los medidores que desea crear.

5. Compartir la hoja de cálculo: Este es un paso crucial.

   • Copie el correo electrónico de la cuenta de servicio que creó en el Paso 1 (lo encontrará dentro del archivo .json en el campo client_email).

   • Haga clic en el botón Compartir en su hoja de cálculo.

   • Pegue el correo de la cuenta de servicio y asígnele permisos de Editor.

• Haga clic en Enviar.

Paso 4: Crear la conexión en Fracttal One

Ahora vamos a configurar la conexión dentro de Fracttal para que pueda usar las credenciales de la cuenta de servicio.

1. En Fracttal, navega hasta Configuración > Catálogos Auxiliares > Conexiones.
2. Haz clic en el ícono + para agregar una nueva conexión.
3. Rellena los siguientes campos:

• Tipo: Selecciona Google Sheet (Service Account).

• Descripción: Asigna un nombre a la conexión:

4. Abre el archivo .json descargado y copia/pega el contenido de los siguientes campos en sus respectivos lugares del formulario de Fracttal:

• private_key

• client_email

• client_id

• client_x509_cert_url

5. Haz clic en el ícono ✓ para guardar y luego en Guardar.

Paso 5: Configurar el flujo en Fracttal Hub

Con la conexión lista, el último paso es crear el flujo de automatización.

1. Navega hasta el módulo Fracttal Hub.
2. Haz clic en el ícono + para crear un nuevo flujo.
3. Añade una Descripción para el flujo:

Configuración del activador:

• Haz clic en Activador y selecciona el tipo Manual. Esto permite ejecutar el flujo cuando se desee.

Configuración de la Fuente:

• Haz clic en Fuente.

• Módulo: Selecciona GoogleSheet.

• Conexión: Selecciona la conexión creada en el paso anterior.

• Acción: Selecciona Leer.

• spreadsheet_id: Copia el ID de tu hoja de cálculo (lo encuentras en la URL, entre /d/ y /edit/).

• sheet: Escribe 0 para leer la primera pestaña.

• Campos: Agrega los nombres de las columnas: 

Configuración del Destino:

• Haz clic en Conexión en la sección de destino.

• Módulo: Selecciona Fracttal.

• Conexión: Elige FRACTTAL HUB.

• Acción: Selecciona Crear Medidores.

Configuración de campos (mapeo):

• Haz clic en Configuración en la sección de destino.

• Mapea los campos de la hoja (Origen) con los del sistema (Destino), asegurándote de que coincidan:

description ⟵ description

item_code ⟵ item_code

unit code ⟵ unit_code

is_counter ⟵ is_counter
 

Haz clic en Guardar para guardar la configuración del flujo.

Paso 7: Ejecutar y verificar el flujo

1. Activa el interruptor Habilitado.

2. Haz clic nuevamente en Guardar.

3. Haz clic en el botón Ejecutar para iniciar el proceso.

Puedes monitorear el progreso en las pestañas Cola de eventos e Historial de Ejecución. Un proceso exitoso mostrará "Proceso Realizado" y marcará como completas las etapas de Extracción, Transformación y Carga.