¿Cómo vincular un activo a un plan de mantenimiento desde Fracttal Hub?

Fracttal Hub permite asociar activos a planes de mantenimiento de forma masiva a partir de Google Sheets. Para que la carga sea válida, el activo no debe estar vinculado a otro plan, debe ser una ubicación, equipo o herramienta, y el plan no puede incluir activadores ni subtareas con lecturas de medidor.

Paso 1: Accede a la consola de Google Cloud

La comunicación entre Fracttal y Google Sheets se realiza de forma segura mediante una cuenta de servicio.

1. Accede a la consola de Google Cloud.

2. En el menú de navegación, ve a IAM y administrador > Cuentas de servicio.
3. Haz clic en + CREAR CUENTA DE SERVICIO.

4. Asigna un nombre a la cuenta de servicio que sea fácil de identificar, por ejemplo: asociar-activo-plan-mantenimiento.

5. Haz clic en FINALIZAR para crear la cuenta sin configurar permisos adicionales.

Paso 2: Generar y descargar la clave de la cuenta de servicio

Para que Fracttal pueda autenticarse, es necesario generar una clave privada para la cuenta de servicio.

1. En la lista de cuentas de servicio, haz clic en el correo electrónico de la cuenta que acabas de crear.

2. Ve a la pestaña CLAVES.

3. Haz clic en AGREGAR CLAVE y selecciona Crear nueva clave.
4. Elige el tipo de clave JSON y haz clic en CREAR.

5. Se descargará automáticamente un archivo .json en tu ordenador. Guarda este archivo en un lugar seguro, ya que contiene las credenciales de acceso.

Paso 3: Compartir la hoja de cálculo de Google con la cuenta de servicio

Ahora necesitas otorgar permisos a la cuenta de servicio para acceder y editar tu hoja de cálculo.

1. Abre el archivo .json que descargaste. Localiza y copia el valor del campo "client_email".

2. Abre tu hoja de cálculo en Google Sheets.

3. Haz clic en el botón Compartir (parte superior derecha).

4. Pega el correo de la cuenta de servicio en el campo de compartir.

5. Asegúrate de otorgar el permiso de Editor.

6. Haz clic en Enviar.

Paso 4: Preparar la hoja de cálculo de Google Sheets

La primera fila de tu hoja debe contener los encabezados (parámetros) exactos que Fracttal espera recibir.

1. Accede a la documentación de la API de Fracttal para consultar los parámetros necesarios.

2. En la primera fila, inserta los siguientes encabezados:

   id_tasks_plan	code_user	item_code	last_date_maintenance
   284558	1928182192	HUB-001	2025-03-12T20:00:00-03

3. Rellena las filas siguientes con los datos correspondientes:

• id_tasks_plan: ID del plan de tareas al que deseas asociar el activo. Puedes encontrarlo en Fracttal.

• code_user: Código del usuario responsable de la transacción. Encuéntralo en Catálogos > Recursos Humanos.

• item_code: Código del activo (equipo, ubicación, etc.) que deseas vincular. Encuéntralo en Catálogos > Activos.

• last_date_maintenance: Fecha del último mantenimiento.

Importante: El formato de la fecha last_date_maintenance debe ser AAAA-MM-DDTHH:MM:SS-UTC.
 Copia el formato desde la documentación de la API para evitar errores.

Paso 5: 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 6: 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:  description, item_code, unit_code, is_counter.

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 Medidor.

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:

Paso 7: Ejecutar y verificar el flujo

1. Haz clic en Guardar para guardar la configuración del flujo.
2. Activa el interruptor Habilitado.
3. Haz clic nuevamente en Guardar.

4. 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.

Para verificar, ve a Tareas > Plan de Tareas, selecciona el plan correspondiente y, en la pestaña Activos Vinculados, verás el activo que fue asociado mediante la hoja de cálculo.

Notas:

• Este método es compatible únicamente con planes de tareas basados en frecuencia (fecha). No es compatible con planes que tengan activadores por lectura de medidor.

• Puedes añadir múltiples filas en tu hoja de Google Sheets para asociar varios activos a uno o más planes de una sola vez.