Créer et alimenter les tables HubDB

HubDB est un outil de base de données utilisé pour créer et gérer des tableaux de données structurés. Vous pouvez utiliser des tableaux HubDB pour créer des pages dynamiques et interroger des tableaux en externe via l’API HubDB. HubDB stocke des données structurées (par exemple, des listes de produits, des répertoires d’équipes ou des calendriers d’événements) afin que les informations puissent être mises à jour dans un emplacement central au lieu de mettre à jour plusieurs pages individuellement. Découvrez-en davantage sur HubDB dans la documentation des développeurs de HubSpot.

Avant de commencer

Avant de commencer à utiliser cette fonctionnalité, assurez-vous de bien comprendre les étapes à suivre à l'avance, ainsi que les limites de la fonctionnalité et les conséquences potentielles de son utilisation. 

Compréhension des limites et des considérations

• Tous les nouveaux tableaux créés ont le statut de brouillon. Les tableaux ne peuvent pas être utilisés pour sortir des données avec HubL ou l’API tant que le tableau n’est pas publié.
• Passez en revue les limites techniques de HubDB.

Créer un tableau

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur Créer un tableau.
3. Dans la boîte de dialogue, entrez un libellé de tableau  et un nom de tableau  . Vous ne pouvez pas modifier le nom d’un tableau après l’avoir publié.
4. Cliquez sur Créer.

Ajouter ou importer des données de tableau

Une fois que vous avez créé un tableau, vous pouvez ajouter de nouvelles colonnes et lignes pour structurer les données utilisées sur les pages de votre site web ou via l’API HubDB. Vous pouvez également importer un fichier CSV pour fusionner ses données dans un tableau HubDB.

Ajouter des colonnes de tableau

Les colonnes définissent le type de données stockées dans chaque partie du tableau. Lorsque vous ajoutez une colonne, vous sélectionnez un type de colonne et configurez les paramètres qui déterminent la manière dont les données sont saisies et utilisées.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Dans l’angle supérieur droit, cliquez sur le menu déroulant Actions et sélectionnez Ajouter une colonne.
4. Dans la boîte de dialogue, saisissez un libellé de colonne.
5. Saisissez un nom de colonne. Vous pouvez utiliser ce nom pour interroger vos données avec l’API HubDB.
6. Saisissez une description de colonne. Cette description apparaît lorsqu’un utilisateur survole l’icône info info à côté du nom de la colonne.
7. Cliquez sur le menu déroulant Type de colonne et sélectionnez un type de colonne. Certains types de colonnes afficheront des options supplémentaires (par exemple, Sélection ou Sélection multiple) à configurer.
8. Lorsque vous avez terminé, cliquez sur Ajouter une colonne.

Ajouter des lignes de tableau

Les lignes stockent les fiches d’informations individuelles dans le tableau. Ajoutez des lignes pour remplir votre tableau avec des données structurées ou mettez à jour des lignes existantes en fonction de l’évolution de vos données.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Dans l’angle supérieur droit, cliquez sur le menu déroulant Actions et sélectionnez Ajouter une ligne.
4. Une nouvelle ligne sera créée. Si vous avez des lignes existantes dans le tableau, la nouvelle ligne sera ajoutée sous toutes les lignes existantes. Saisissez une valeur pour chaque colonne que vous avez configurée pour le tableau.

Importer les données d’un tableau avec un fichier CSV

Importez des données à partir d’un fichier CSV pour ajouter plusieurs lignes à votre tableau HubDB à la fois. Cela s’avère utile lorsque vous travaillez avec de grands jeux de données ou que vous migrez des informations existantes vers HubDB.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Dans l’angle supérieur droit, cliquez sur le menu déroulant Actions et sélectionnez Importer.
4. Cliquez sur la vignette Ajouter ou remplacer :
   • 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 des ID de lignes sont inclus dans la feuille de calcul, les lignes seront mises à jour au lieu d’être remplacées.
5. Cliquez sur Suivant.
6. Sur la page Sélectionner un fichier , cliquez sur Choisir un fichier.
7. Recherchez le fichier CSV dans votre système de fichiers, puis cliquez sur Ouvrir.
8. 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 .
9. Cliquez sur Suivant.
10. Sur la page Mapper les colonnes , spécifiez comment vous souhaitez mapper chaque champ de votre fichier CSV à la colonne de tableau HubDB correspondante :
    • 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, saisissez un libellé, un nom et sélectionnez un type. Lorsque vous avez terminé, cliquez sur Ajouter une colonne.
11. Lorsque vous avez terminé, cliquez sur Importer.
12. Lorsque l'importation est terminée, cliquez sur Done.

Gérer les données du tableau

Gérez la structure et le contenu de votre tableau HubDB en supprimant des colonnes ou des lignes et en modifiant leur ordre. Ces actions permettent d’organiser le tableau et de garantir que les données sont correctement structurées pour une utilisation sur votre site web ou via l’API HubDB.

Supprimer les colonnes du tableau

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Passez le curseur sur le libellé d’une colonne et cliquez sur le menu déroulant, puis sélectionnez Supprimer.
4. Dans la boîte de dialogue, cliquez sur Supprimer.

Supprimer des lignes du tableau

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Passez le curseur sur un ID de ligne et cliquez sur le menu déroulant, puis sélectionnez Supprimer.

Réorganiser les colonnes et les lignes du tableau

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Pour modifier l’ordre d’une ligne, passez le curseur sur le numéro de la ligne et cliquez sur l’icône glisser-déposer dragHandleIcon. Déplacez ensuite la rangée vers le haut ou vers le bas vers une nouvelle position.

4. Pour modifier l’ordre des colonnes, placez le curseur sur la colonne et cliquez sur l’icône glisser-déposer dragHandleIcon. Déplacez ensuite la colonne vers la gauche ou la droite vers une nouvelle position.

Gérer les paramètres du tableau

Gérez les paramètres de chaque tableau HubDB, y compris les options d’accès API public et si les données peuvent être utilisées pour créer des pages dynamiques.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom  d'une table.
3. Dans l’angle supérieur droit, cliquez sur le menu déroulant Actions et sélectionnez Gérer les paramètres.
4. Dans le panneau de droite, activez l’option Autoriser l’accès public à l’API pour activer les appels d’API non authentifiés pour interroger les données du tableau.
   • Par défaut, les données du tableau ne sont accessibles dans HubSpot que via HubL ou des appels d’API authentifiés.
   • Pour interroger les données, vous devez inclure l’ID du compte HubSpot dans un paramètre de portalId requête.
5. Pour créer des pages dynamiques en utilisant le tableau, activez l’option Activer la création de pages dynamiques avec des données de ligne. Vous pouvez ensuite configurer les options supplémentaires suivantes :
   • Dans la section Métadonnées , cliquez sur les menus déroulants et sélectionnez les colonnes qui rempliront les pages dynamiques avec une méta-description, une image en vignette et des données d’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.
   • Dans la section Tableaux enfants , sélectionnez la case à cocher Autorisez l’utilisation de tableaux enfants pour activer les références aux autres tableaux HubDB de ce tableau.
   • Pour créer automatiquement des pages de listing intermédiaires, sélectionnez la case à cocher Créer automatiquement des pages de listing pour les tableaux enfants . Découvrez-en davantage sur la création de pages dynamiques à plusieurs niveaux avec HubDB .
6. Lorsque vous avez terminé, cliquez sur Enregistrer.

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.

Publier un tableau

Publiez un tableau HubDB pour mettre à disposition la structure et les données les plus récentes et disponible pour une utilisation sur votre site web ou via l’API HubDB. Après avoir créé un tableau ou mis à jour des colonnes ou des lignes, publiez le tableau afin que les modifications soient appliquées.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Dans l'angle supérieur droit, cliquez sur Publier.
4. Dans la boîte de dialogue, cliquez sur Publier pour appliquer vos modifications.

Exporter les données du tableau

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le nom d’un tableau.
3. Dans l’angle supérieur droit, cliquez sur le menu déroulant Actions et sélectionnez Exporter. Sélectionnez ensuite un format de fichier (par exemple, CSV). Les données du tableau HubDB commenceront à se télécharger 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

Avant de mettre à jour ou de supprimer un tableau HubDB, consultez les ressources qui en dépendent. L’affichage des dépendances du tableau vous aide à comprendre l’effet des changements sur le contenu de votre site web ou l’utilisation des API.

1. Dans votre compte HubSpot, accédez à Contenu > HubDB.
2. Cliquez sur le menu déroulant Actions et sélectionnez Afficher les dépendances.
3. Dans la boîte de dialogue, cliquez sur un type d’élément (par exemple, Articles de blog ou Modules) pour développer la section et afficher les éléments individuels.