HubDB

• almacenar feedback de un mecanismo externo para recuperarla posteriormente.
• almacenar datos estructurados que puedes usar para crear páginas dinámicas del CMS (CMS Hub Pro y Enterprise únicamente).

Se puede acceder a las tablas de HubDB tanto dentro de HubSpot como a través de la API de HubDB, y puedes recuperar los datos de una tabla de varias maneras, dependiendo del uso. Para obtener datos de una tabla de HubDB, puedes:

• Consultar los datos externamente a través de la API de HubDB.
• Utilizar las etiquetas de marcado de HubL de HubSpot para introducir datos en el CMS como contenido estructurado.
• Utilizar la API de HubDB con funciones sin servidor para ofrecer una experiencia de aplicación web interactiva.
  

Además de los límites generales de la API de HubSpot, ten en cuenta las siguientes limitaciones técnicas de HubDB:

• Límites de cuenta
  • 1000 tablas de HubDB por cuenta.
  • 1.000.000 de filas en tablas HubDB por cuenta.

• Límites de tabla:
  • 250 columnas por tabla.
  • 10000 filas por tabla de HubDB.
  • 700 caracteres por nombre de tabla.
  • 700 caracteres por etiqueta de tabla.

• Límites de columna:
  • 65.000 caracteres por columna de texto enriquecido.
  • 10.000 caracteres en cada columna de texto.
  • 700 caracteres por nombre de columna.
  • 700 caracteres por etiqueta.
  • 300 caracteres por descripción de columna.
  • 700 caracteres por opción seleccionable dentro de una columna.
• Límites de página:
  • 10 llamadas a la función hubdb_table_rows de HubL por página CMS.
  • 10 páginas dinámicas usando la misma tabla de HubDB.
  • Los HubDB con páginas dinámicas activadas deben tener rutas en minúsculas para que las URL de estas páginas no distingan mayúsculas de minúsculas.

Puedes crear tablas de HubDB a través de la interfaz de usuario de HubSpot o a través de la API de HubDB.

Todas las nuevas tablas creadas se establecen con un estado de borrador. No se pueden utilizar para dar salida a los datos a través de HubL o la API hasta que se publique la tabla.

Puedes gestionar la configuración de tus tablas de HubDB haciendo clic en Acciones y luego en Administrar configuración. Están disponibles los siguientes ajustes:

• Permitir acceso público a la API: de forma predeterminada, los datos de la tabla solo se pueden ver en la aplicación o dentro de las llamadas autentificadas a la API. Activa este valor de configuración para habilitar las llamadas no autentificadas a la API para consultar los datos de la tabla. 
• Activar la creación de páginas dinámicas utilizando datos de filas: activa este valor de configuración para habilitar la creación de páginas dinámicas usando datos de HubDB. Al activar esta opción, puedes acceder a las siguientes opciones adicionales:
  • Utiliza los menús desplegables para seleccionar qué columnas rellenarán las páginas dinámicas con una metadescripción, una imagen destacada y datos de URL canónica. En las nuevas tablas, deberás crear nuevas columnas para contener estos datos.
    • Metadescripció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.
  • Para hacer referencia a otras tablas de HubDB en esta tabla, selecciona la casilla de verificación Permitir el uso de tablas secundarias. También puedes seleccionar el valor de configuración Crea automáticamente páginas de contenido para tablas secundarias para permitir a HubSpot crear automáticamente páginas de contenido intermedias. Más información sobre cómo crear páginas dinámicas de múltiples niveles con HubDB.

Una tabla es una disposición bidimensional de filas y columnas. Cuando se crea una tabla, se le asigna un ID único global que puede utilizarse para identificarla. 

Las filas son cortes horizontales de una tabla. Todos los valores de una fila están relacionados, normalmente con un único identificador primario. En una aplicación de hoja de cálculo, las filas se representan con números, empezando por el 1. Cada fila de la tabla recibe un ID único global en el momento de su creación. 

Las columnas son cortes verticales de una tabla. Cada columna tiene un tipo. En una aplicación de hoja de cálculo, se representan mediante columnas alfabéticas como A, B, C, etc. Hay dos tipos de columnas de tabla:

Cada fila de una tabla tiene un par de columnas incorporadas:

Las tablas pueden tener tantas columnas personalizadas como desees. Pueden ser texto, texto enriquecido, números, moneda, fechas, horas, imágenes, videos, selecciones o ubicaciones (latitud y longitud). 

Cuando se crea una columna, se le asigna un ID numérico único en la tabla, empezando por el valor 1. Los ID de las columnas son crecientes, pero no necesariamente secuenciales. Los ID de las columnas no se pueden reutilizar, por lo que si una tabla tiene 2 columnas, 1 y 2, y la segunda columna se elimina, la siguiente columna creada tendrá un ID de 3.

Las celdas almacenan los valores donde se cruzan una fila y una columna. Las celdas pueden leerse o actualizarse individualmente o como parte de una fila. Establecer el valor de una celda como nulo equivale a eliminar el valor de la celda.

Con HubL, puedes extraer datos de HubDB para usarlos como contenido estructurado en páginas del sitio web. A continuación, obtén más información sobre cómo recuperar datos de tablas, filas y columnas con HubL.

Para listar las filas de una tabla, utiliza la función de Hubl Hubdb_table_rows(). Puedes acceder a una tabla por su ID o por su nombre. Se recomienda hacer referencia a una tabla de HubDB por su nombre, ya que esto puede ayudar a la portabilidad del código entre las cuentas de HubSpot. El nombre de la tabla inmutable se establece cuando se crea una nueva tabla y se puede encontrar en cualquier momento seleccionando Acciones > Administrar configuración dentro del editor de tablas. El ID de una tabla se puede encontrar en la barra de direcciones del editor de tablas o en el panel de tablas de HubDB bajo la columna ID. 

A continuación se muestra un ejemplo de uso de hubdb_table_rows() para obtener datos.

<filterQuery> utiliza la misma sintaxis que la API HTTP. Por ejemplo hubdb_table_rows(123, "employees__gt=10&orderBy=count") devolvería una lista de filas en las que la columna "employees" es mayor que 10, ordenadas por la columna "count". La lista completa de parámetros opcionales <filterQuery> se puede encontrar aquí.

En lugar de utilizar varias consultas de filas con diferentes parámetros <filterQuery>, se debe hacer una consulta y utilizar los filtros selectattr() o rejectattr() para filtrar las filas:

Para obtener una sola fila, utiliza la función de Hubl Hubdb_table_row().

Los nombres de las columnas incorporadas y personalizadas no distinguen entre mayúsculas y minúsculas. HS_ID funcionará igual que hs_id.

Para obtener los metadatos de una tabla, incluyendo su nombre, columnas, última actualización, etc., utiliza la función hubdb_table().

Para obtener información sobre una columna de la tabla, como su etiqueta, tipo y opciones, La utiliza la función hubdb_table_column()

El tipo de columna richtext funciona de forma similar al campo de texto enriquecido que se ve en los módulos.

Los datos se almacenan como HTML, y la interfaz de usuario de HubDB proporciona una interfaz de edición de texto. Sin embargo, al editar una tabla de HubDB a través de la interfaz de usuario de HubSpot, no puedes editar el código fuente directamente. Esto previene situaciones en las que un usuario no técnico pueda introducir un HTML no válido, evitando problemas involuntarios con la apariencia o funcionalidad de tu sitio. Para situaciones en las que necesites un código de inserción o más HTML personalizado, puedes utilizar la función de inserción en el editor de texto enriquecido para colocar tu código personalizado. 

• Aplicación de registro en eventos
• Cómo unir varias tablas de HubDB
• Cómo construir una página dinámica de miembros del equipo con HubDB
• Cómo agregar videos a páginas dinámicas
• Cómo construir páginas dinámicas multinivel usando HubDB
• Construyamos una página con un mapa utilizando HubDB