¿Cómo crear un equipo usando Fracttal Hub?

La integración con Fracttal Hub facilita la incorporación controlada de nuevos equipos a la plataforma, garantizando que los datos sigan una estructura estandarizada. Esta guía explica cómo configurar un flujo seguro para crear equipos en Fracttal One utilizando una hoja de cálculo como origen de datos.

La conexión se establecerá utilizando una Cuenta de Servicio (Service Account) de Google Cloud Platform, que es el método recomendado para integraciones de servidor a servidor, garantizando seguridad y autonomía.

Etapa 1: Configuración en Google Cloud Platform (GCP)

El primer paso es crear las credenciales necesarias en la plataforma de Google para permitir que Fracttal One acceda a su hoja de forma segura.

1.1. Accede a la cuenta de servicio

• Acceda a la Consola de Google Cloud Platform.

• En el menú de navegación, vaya a APIs y servicios > Credenciales.

• Haga clic en + CREAR CREDENCIALES y seleccione la opción Cuenta de servicio.

• Complete los siguientes campos:
  • Nombre de la cuenta de servicio: Asigne un nombre descriptivo.
  • ID de la cuenta de servicio: Generalmente se genera automáticamente a partir del nombre.

• Haz clic en "Listo" para finalizar la creación de la credencial.

1.2. Generar la Clave de Acceso (JSON)

• En la pantalla de Credenciales, ubique la cuenta de servicio recién creada y haga clic en su dirección de correo electrónico.
• Vaya a la pestaña CLAVES.
• Haga clic en AGREGAR CLAVE y seleccione Crear clave nueva.

• Elija el tipo JSON (recomendado) y haga clic en CREAR.

• Se descargará automáticamente un archivo .json en su equipo. Guárdelo en un lugar seguro, ya que contiene las credenciales de acceso y será necesario en la Etapa 3.

Etapa 2: Preparación de la hoja de Google Sheets

Ahora prepararemos la hoja que servirá como fuente de datos.

• Abra su hoja de Google Sheets.

Estructura de los encabezados:
En la primera fila, asegúrese de que los nombres de las columnas coincidan exactamente con los parámetros requeridos por la API de Fracttal para la creación de activos. Los campos obligatorios son:

• code: Código único del activo.
• id_type_item: ID numérico del tipo de activo (por ejemplo: 2 para Equipos, según la documentación de la API).
• field_1: Corresponde al Nombre del activo.

Compartir la hoja:
Es crucial otorgar permiso de acceso a la Cuenta de Servicio que creamos.

• En GCP, copie el correo electrónico de su cuenta de servicio.

• Vuelva a la hoja de cálculo, haga clic en Compartir.
• Pegue el correo en el campo de compartir.
• Asigne el permiso de Editor.

• Haga clic en Enviar/Compartir.

  

Etapa 3: Configuración de la conexión en Fracttal One

Con las credenciales y la hoja listas, configuraremos el puente de comunicación dentro de Fracttal One.

• En Fracttal One, navegue a Configuración > Catálogos Auxiliares.

• En el selector de catálogos, elija Conexiones.
• Haga clic en el ícono + para agregar una nueva conexión.

Configure los siguientes campos:

• Tipo: Seleccione Google Sheet (Service Account).
• Descripción: Ingrese un nombre claro para esta conexión, por ejemplo, CREAR EQUIPOS.

Completa las credenciales:

Abra el archivo .json descargado en la Etapa 1.2 y copie y pegue el contenido de cada campo en el formulario de Fracttal One:

• private_key
• client_email
• client_id
• client_x509_cert_url
• ...y los demás campos requeridos.

Haga clic en Guardar.

Etapa 4: Crear el flujo en el Automatizador (Fracttal Hub)

Finalmente, crearemos el flujo de automatización que leerá los datos y creará los activos.

• Vaya al menú principal y seleccione Automatizador > Fracttal Hub.

• Haga clic en el ícono + para crear un nuevo flujo.

• Asigne un nombre al flujo.

4.1. Configurar la Fuente (Source)

• Activador

 Para este ejemplo, seleccione Manual. Esto le permite ejecutar el flujo cuando lo desee.

• Fuente:

• Módulo: Seleccione GoogleSheet.
• Conexión: Seleccione la conexión creada en la Etapa 3 (CREAR EQUIPOS).
• Acción: Seleccione Leer.
• spreadsheet_id: Pegue el ID de su hoja. Lo puede encontrar en la URL (el código largo entre /d/ y /edit).
• sheet: Ingrese 0 para leer la primera pestaña (la numeración comienza en 0).
• Campos: Agregue los nombres de los encabezados de su hoja (code, id_type_item, field_1).

4.2. Configurar el Destino (Destination)

• Conexión:

• Módulo: Seleccione Fracttal.
• Conexión: Seleccione FRACTTAL HUB.
• Acción: Seleccione Actualizar o crear un activo.

• Configuración

• Haga clic en el ícono de engranaje (Configuración).
• Mapee los campos de origen (Google Sheet) con los de destino (API de Fracttal), asegurándose de que coincidan:

• Haga clic para guardar el mapeo y luego en Guardar en la esquina superior derecha para guardar todo el flujo.