Créer et alimenter les tables HubDB

Créer un tableau

• Dans votre compte HubSpot, accédez à Contenu > HubDB. 
• En haut à droite, cliquez sur Créer une table.
• Dans la boîte de dialogue, entrez un libellé de tableau  et un nom de tableau  . Vous ne pouvez pas modifier le nom d'une table après l'avoir créée.
• Cliquez sur Créer.

Ajouter et modifier les données d'un tableau

Modifiez une table HubDB directement dans votre compte HubSpot ou téléchargez un fichier CSV pour fusionner automatiquement les données existantes avec les lignes de votre table.

Ajouter une colonne de tableau personnalisée

• Sur le tableau de bord HubDB, cliquez sur le libellé de l'une de vos tables.
• En haut à droite, cliquez sur Actions, puis sélectionnez Ajouter une colonne.
• Dans la boîte de dialogue, configurez votre colonne :
  • Saisissez un libellé de colonne.
  • Entrez un nom de colonne . Vous pouvez utiliser ce nom pour interroger vos données avec l'API HubDB.
  • Saisissez une description de la colonne . Cette description apparaît lorsque l'utilisateur survole l'icône info info à côté du nom de la colonne. 
  • Saisir une colonne Type de colonne.
• Cliquez sur Ajouter une colonne.
• Pour modifier ou supprimer une colonne, survolez-la et cliquez sur l'icône en forme de flèche  , puis sélectionnez Editer ou Supprimer.

Ajouter des lignes de tableau

• Sur le tableau de bord HubDB, cliquez sur le libellé d'une table existante .
• En haut à droite, cliquez sur Actions, puis sélectionnez Ajouter une ligne.
• Une nouvelle ligne sera automatiquement créée en dessous des lignes existantes. Entrez une valeur pour chaque colonne que vous avez configurée pour la table.
• Pour cloner ou supprimer une ligne, survolez l'identifiant de la ligne et cliquez sur l'icône flèche downCarat , puis sélectionnez Cloner ou Supprimer.

Importer les données d'un tableau via un fichier CSV

Si vous avez une feuille de calcul existante avec des données qui correspondent à votre schéma de table HubDB, vous pouvez l'importer dans HubSpot pour fusionner automatiquement ses données avec votre table.

• Sur le tableau de bord HubDB, cliquez sur le libellé de l'une de vos tables.
• En haut à droite, cliquez sur Actions, puis sélectionnez Import.
• Cliquez sur la tuile Addou Replace:
  • Ajouter : lignes de votre feuille de calcul seront ajoutées à vos données existantes.
  • Remplacer : les lignes de votre feuille de calcul écraseront et remplaceront toutes les données existantes dans votre tableau. Si les identifiants des lignes sont inclus dans la feuille de calcul, les lignes seront mises à jour au lieu d'être remplacées. 
• Cliquez sur Suivant.
• Cliquez sur Choisir un fichier.
• Recherchez sur le disque dur de votre ordinateur le fichier CSV à télécharger et cliquez sur Open.
• Par défaut, HubSpot détectera l'encodage des données dans votre CSV. Pour spécifier manuellement l'encodage des données :
  • Cliquez sur Options avancées.
  • Cliquez sur le menu déroulant Customize data encoding, puis sélectionnez un encodage .
• Cliquez sur Suivant.
• Spécifiez comment vous voulez faire correspondre chaque champ de votre CSV à la colonne correspondante de la table HubDB :
  • Cliquez sur le menu déroulant HubDB Table Column, puis sélectionnez une colonne .
  • Si vous n'avez pas configuré de colonne associée pour le champ CSV, cliquez sur Ajouter une colonne. Dans la boîte de dialogue, entrez un Libellé , un nom  , et sélectionnez un type . Lorsque vous avez terminé, cliquez sur Ajouter une colonne.
• Cliquez sur Import.

• Lorsque l'importation est terminée, cliquez sur Done.

Gérer les paramètres dans les Paramètres de la table (Pro et Entreprise seulement)

Si vous avez un compte Content Hub Professional ou Entreprise, vous pouvez gérer les paramètres du contenu de chaque tableau HubDB, par exemple si le tableau est accessible au public via l'API et si les données peuvent être utilisées pour créer des pages dynamiques.

• Dans votre compte HubSpot, accédez à Contenu > HubDB.
• Cliquez sur le nom  d'une table.
• En haut à droite, cliquez sur Actions > Gérer les paramètres. 
  
  
• Dans la barre latérale droite, configurez les paramètres du tableau :
  • Autoriser l'accès public à l'API : par défaut, les données de la table ne sont accessibles que dans HubSpot, via HubL, ou par des appels API authentifiés . Activez ce paramètre pour permettre à d'effectuer des appels non authentifiés à l'API pour interroger les données de la table. Pour interroger les données, vous devez inclure l'identifiant du compte HubSpot dans un paramètre de requête portalId .
  • Activer la création de pages dynamiques utilisant des données de ligne : activez ce paramètre pour permettre la création de pages dynamiques en utilisant les données de HubDB. Vous pouvez ensuite configurer les options supplémentaires suivantes :
    • Utilisez les menus déroulants  pour sélectionner les colonnes qui alimenteront les pages dynamiques en méta-descriptions, images vedettes et URL canoniques. Pour les nouveaux tableaux, vous devrez créer de nouvelles colonnes pour contenir ces données.
      • Meta description : doit être une colonne de type texte.
      • Image en vedette : doit être une colonne de type image.
      • URL canonique : doit être une colonne de type URL.
    • Allow use of child tables: activez ce paramètre sur pour autoriser les références à d'autres tables HubDB dans cette table. Vous pouvez également sélectionner le paramètre Automatically create listing pages for child tables pour permettre à HubSpot de créer automatiquement des pages de référencement intermédiaires. En savoir plus sur la construction de pages dynamiques à plusieurs niveaux en utilisant HubDB.
      
      

      Remarque : une table parent ne peut pas faire référence à une table enfant qui fait également référence à la table parent. Cela créera une boucle qui se traduira par une erreur lors de la sélection du tableau enfant dans le tableau parent.

• Cliquez sur Enregistrer.

Publier des tableaux

Lorsque vous avez fini de remplir votre table HubDB avec des données, vous pouvez la publier pour l'utiliser sur les pages de votre site web et la rendre accessible pour des requêtes via l'API HubSpot.

• Dans l'angle supérieur droit, cliquez sur Publier.
• Dans la boîte de dialogue, confirmez que vous êtes prêt à rendre votre tableau public, puis cliquez sur Publier.

Exporter les données du tableau

• Sur le tableau de bord HubDB, cliquez sur le libellé de l'une de vos tables.
• En haut à droite, cliquez sur le menu déroulant Actions et sélectionnez Export, puis choisissez un format de fichier . Les données de HubDB commenceront à être téléchargées immédiatement.

Remarque : les images exportées à partir d'une table HubDB seront formatées en tant qu'URL d'image. Si les dimensions de l'image ont été personnalisées, elles apparaîtront à la fin de l'URL. 

Afficher les dépendances du tableau

Une fois qu'une table a été créée, vous pouvez voir où une table HubDB est utilisée dans votre contenu à partir du tableau de bord HubDB. De plus, lors de la suppression d'une table HubDB, HubSpot vous avertira si la table est actuellement utilisée par un actif.

Pour afficher les actifs qui utilisent une table HubDB, sur le tableau de bord HubDB, cliquez sur le menu déroulant Actions à côté d'une table, puis sélectionnez Show dependents.

Pour en savoir plus sur HubDB, consultez le site . La documentation de HubSpot destinée aux développeurs est disponible à l'adresse.