Crear y rellenar tablas HubDB

HubDB es una base de datos relacional que te permite crear tablas con un esquema flexible para almacenar datos que puedes utilizar en las páginas de tu sitio web, o consultar externamente a través de la API de HubDB.

Crear una tabla

• En tu cuenta de HubSpot, dirígete a Contenido > HubDB. 
• En la parte superior derecha, haz clic en Crear tabla.
• En el cuadro de diálogo, introduce una etiqueta de Tabla  y un nombre de Tabla  . No puedes  cambiar el nombre de una tabla después de crearla.
• Haz clic en Crear.

Añadir y editar datos de tablas

Edita una tabla de HubDB directamente en tu cuenta de HubSpot o sube un CSV para combinar automáticamente los datos existentes con las filas de tu tabla.

Añadir una columna de tabla personalizada

• En el panel de control de HubDB, haz clic en la etiqueta de una de tus tablas.
• En la parte superior derecha, haz clic en Acciones, luego selecciona Añadir columna.
• En el cuadro de diálogo, configura tu columna:
  • Introduce una Etiqueta de columna.
  • Introduce un Nombre de la columna. Puedes utilizar este nombre para consultar tus datos con la API de HubDB.
  • Introduce una Descripción de la columna. Esta descripción aparecerá cuando un usuario pase el ratón por encima del icono de información info , situado junto al nombre de la columna. 
  • Introduce un Tipo de columna.
• Haz clic en Añadir columna.
• Para modificar o eliminar una columna, pasa el ratón por encima de ella y haz clic en el icono de flecha  , luego selecciona Editar o Eliminar.

Añadir filas a la tabla

• En el panel de control de HubDB, haz clic en la etiqueta de una tabla existente.
• En la parte superior derecha, haz clic en Acciones, luego selecciona Añadir fila.
• Se creará automáticamente una nueva fila debajo de las filas existentes. Introduce un valor para cada columna que hayas configurado para la tabla.
• Para clonar o eliminar una fila, pasa el ratón por encima del ID de la fila y haz clic en el icono de flecha downCarat , luego selecciona Clonar o Eliminar.

Importar datos de tablas mediante un CSV

Si tienes una hoja de cálculo con datos que coinciden con el esquema de tu tabla HubDB, puedes importarla a HubSpot para fusionar automáticamente sus datos con tu tabla.

• En el panel de control de HubDB, haz clic en la etiqueta de una de tus tablas.
• En la parte superior derecha, haz clic en Acciones, luego selecciona Importar.
• Haz clic en la ficha Añadiro Sustituir:
  • Añadir: las filas de tu hoja de cálculo se añadirán a los datos existentes.
  • Reemplazar: filas de tu hoja de cálculo sobrescribirá y reemplazará cualquier dato existente en tu tabla. Si se incluyen ID de filas en la Hoja de cálculo, las filas se actualizarán en lugar de sustituirse. 
• Haz clic en Siguiente.
• Haz clic en Elegir archivo.
• Busca en el disco duro de tu ordenador el CSV que quieras subir y haz clic en Abrir.
• Por defecto, HubSpot detectará la codificación de los datos de tu CSV. Para especificar manualmente la codificación de los datos:
  • Haz clic en Opciones avanzadas.
  • Haz clic en el menú desplegable Personalizar codificación de datos y, a continuación, selecciona una codificación.
• Haz clic en Siguiente.
• Especifica cómo quieres asignar cada campo de tu CSV a la columna correspondiente de la tabla HubDB:
  • Haz clic en el menú desplegable Columna de tabla HubDB y selecciona una columna .
  • Si no has configurado una columna asociada para el campo CSV, haz clic en Añadir columna. En el cuadro de diálogo, introduce una etiqueta , un nombre  , y selecciona un tipo . Cuando hayas terminado, haz clic en Añadir columna.
• Haz clic en Importar.

• Cuando la importación haya finalizado, haz clic en Hecho.

Gestionar ajustes de la tabla (sólo Content Hub Professional y Enterprise)

Si tienes una cuenta Content Hub Professional o Enterprise, puedes gestionar la configuración de cada tabla de HubDB, como, por ejemplo, si la tabla es de acceso público a través de la API y si los datos pueden utilizarse para crear páginas dinámicas.

• En tu cuenta de HubSpot, dirígete a Contenido > HubDB.
• Haz clic en el nombre  de una tabla.
• En la parte superior derecha, haz clic en Acciones > Gestionar configuración. 
  
  
• En la barra lateral derecha, configura los ajustes de la tabla:
  • Permitir acceso público a la API: por defecto, sólo se puede acceder a los datos de la tabla en HubSpot, a través de HubL, o con llamadas autenticadas a la API . Activa esta opción para habilitar las llamadas a la API no autenticadas de para consultar los datos de la tabla. Para consultar los datos, tendrás que incluir el ID de la cuenta de HubSpot en un parámetro de consulta de portalId .
  • Habilitar la creación de páginas dinámicas utilizando datos de filas: activa esta configuración para habilitar la creación de páginas dinámicas utilizando datos de HubDB. A continuación, puedes configurar las siguientes opciones adicionales:
    • Utiliza los menús desplegables de  para seleccionar qué columnas rellenarán las páginas dinámicas con datos de meta descripción, imagen destacada y URL canónica. En las nuevas tablas, deberás crear nuevas columnas para contener estos datos.
      • Meta descripción: debe ser una columna de tipo texto.
      • Imagen destacada: debe ser una columna de tipo imagen.
      • URL canónica: debe ser una columna de tipo URL.
    • Permitir el uso de tablas hijas: activa esta opción para permitir referencias a otras tablas HubDB en esta tabla. También puedes seleccionar la opción Crear automáticamente páginas de listado para tablas secundarias para que HubSpot cree automáticamente páginas de listado intermedias. Más información sobre la creación de páginas dinámicas multinivel utilizando HubDB.
      
      

      Nota: una tabla padre no puede hacer referencia a una tabla hija que también haga referencia a la tabla padre. Esto creará un bucle que da como resultado un error al intentar seleccionar la tabla secundaria dentro de la tabla principal.

• Haz clic en Guardar.

Publicar tablas

Cuando termines de rellenar tu tabla HubDB con datos, puedes publicarla para utilizarla en las páginas de tu sitio web y hacerla accesible para su consulta a través de la API de HubSpot.

• En la parte superior derecha, haz clic en Publicar.
• En el cuadro de diálogo, confirma que estás preparado para hacer pública tu tabla y, a continuación, haz clic en Publicar.

Exportar datos de la tabla

• En el panel de control de HubDB, haz clic en la etiqueta de una de tus tablas.
• En la parte superior derecha, haz clic en el menú desplegable Acciones y selecciona Exportar, a continuación selecciona un formato de archivo . Los datos de HubDB comenzarán a descargarse inmediatamente.

Nota: Las imágenes de exportadas desde una tabla HubDB se formatearán como URLs de imágenes. Si se han personalizado las dimensiones de la imagen, aparecerán al final de la URL. 

Ver tabla dependientes

Una vez creada una tabla, puedes ver dónde se está utilizando una tabla HubDB en tu contenido desde el panel de control de HubDB. Además, al eliminar una tabla HubDB, HubSpot te advertirá si la tabla está siendo utilizada actualmente por algún activo.

Para ver los activos que utilizan una tabla de HubDB, en el panel de control de HubDB, haz clic en el menú desplegable Acciones situado junto a una tabla y, a continuación, selecciona Mostrar dependientes.

Obtén más información sobre HubDB en Documentación para desarrolladores de HubSpot.