Tabellen in HubDB maken en vullen

HubDB is een relationele database waarmee u tabellen met een flexibel schema kunt maken om gegevens op te slaan die u op uw websitepagina's kunt gebruiken of extern kunt opvragen via de HubDB API.

Een tabel maken

• Ga in je HubSpot-account naar Inhoud > HubDB.
• Klik rechtsboven op Tabel maken.
• Voer in het dialoogvenster een tabellabel entabelnaam in. U kunt de naam van een tabel niet wijzigen nadat u deze hebt gemaakt.
• Klik op Maken.

Tabelgegevens toevoegen en bewerken

Bewerk een HubDB tabel direct in je HubSpot account of upload een CSV om bestaande gegevens automatisch samen te voegen met de rijen in je tabel.

Een aangepaste tabelkolom toevoegen

• Klik op het HubDB Dashboard op het label van een van je tabellen.
• Klik rechtsboven op Acties en selecteer Kolom toevoegen.
• Configureer je kolom in het dialoogvenster:
  • Voer een Kolomlabel in.
  • Voer een Kolomnaam in. Je kunt deze naam gebruiken om je gegevens op te vragen met de HubDB API.
  • Voer een Kolombeschrijving in. Deze beschrijving verschijnt wanneer een gebruiker met de muis over het info info-pictogram naast de kolomnaam beweegt.
  • Voer een Kolomtype in.
• Klik op Kolom toevoegen.
• Om een kolom te wijzigen of te verwijderen, beweeg je met de muis over de kolom en klik je op het pijlpictogram.

Tabelrijen toevoegen

• Klik op het HubDB Dashboard op het label van een bestaande tabel.
• Klik rechtsboven op Acties en selecteer vervolgens Rij toevoegen.
• Er wordt automatisch een nieuwe rij gemaakt onder de bestaande rijen. Voer een waarde in voor elke kolom die je voor de tabel hebt geconfigureerd.
• Om een rij te klonen of te verwijderen, beweeg je met de muis over de ID van de rij en klik je op hetpictogram van de pijl downCarat. Selecteer vervolgens Klonen of Verwijderen.

Tabelgegevens importeren via een CSV

Als je een bestaande spreadsheet hebt met gegevens die overeenkomen met het schema van je HubDB tabel, kun je deze importeren in HubSpot om de gegevens automatisch samen te voegen met je tabel.

• Klik op het HubDB Dashboard op het label van een van je tabellen.
• Klik rechtsboven op Acties en selecteer vervolgens Importeren.
• Klik op de tegel Toevoegen of Vervangen:
  • Toevoegen: rijen uit je spreadsheet worden toegevoegd aan je bestaande gegevens.
  • Vervangen: rijen uit je spreadsheet worden overschreven en vervangen bestaande gegevens in je tabel. Als rij-id's in de spreadsheet zijn opgenomen, worden rijen bijgewerkt in plaats van vervangen.
• Klik op Volgende.
• Klik op Bestand kiezen.
• Blader op de harde schijf van je computer naar de CSV die je wilt uploaden en klik op Openen.
• HubSpot detecteert standaard de codering van de gegevens in je CSV. Om handmatig de gegevenscodering op te geven:
  • Klik op Geavanceerde opties.
  • Klik op het vervolgkeuzemenu Gegevenscodering aanpassen en selecteer een codering.
• Klik op Volgende.
• Geef aan hoe je elk veld uit je CSV wilt koppelen aan de bijbehorende kolom in de HubDB tabel:
  • Klik op het vervolgkeuzemenu HubDB Table Column en selecteer vervolgens een kolom.
  • Als je geen gekoppelde kolom voor het CSV-veld hebt geconfigureerd, klik je op Kolom toevoegen. Voer in het dialoogvenster een label en naam in en selecteer een type. Klik op Kolom toevoegen als je klaar bent.
• Klik op Importeren.

• Klik op Gereed wanneer het importeren is voltooid.

Tabelinstellingen beheren (alleen Content Hub Professional en Enterprise)

Als je een Content Hub Professional of Enterprise account hebt, kun je de instellingen voor elke HubDB tabel beheren, zoals of de tabel openbaar toegankelijk is via API en of de gegevens kunnen worden gebruikt om dynamische pagina's te maken.

• Ga in je HubSpot-account naar Inhoud > HubDB.
• Klik op de naam van een tabel.
• Klik rechtsboven op Actiereeks > Instellingen beheren.
  
  
• Configureer de instellingen van de tabel in de rechter zijbalk:
  • Allow public API access: standaard zijn de gegevens van de tabel alleen toegankelijk in HubSpot, via HubL of met geauthenticeerde API calls. Zet deze instelling aan om niet-geauthenticeerde API calls toe te staan om de tabelgegevens op te vragen. Om de gegevens op te vragen, moet je de HubSpot account ID opnemen in een portalId query parameter.
  • Aanmaken van dynamische pagina's met behulp van rijgegevens inschakelen: schakel deze instelling in om het aanmaken van dynamische pagina's met behulp van HubDB-gegevens in te schakelen. Je kunt dan de volgende extra opties configureren:
    • Gebruik de vervolgkeuzemenu's om te selecteren welke kolommen dynamische pagina's zullen vullen met meta description, uitgelichte afbeelding en canonieke URL gegevens. Voor nieuwe tabellen moet je nieuwe kolommen maken om deze gegevens te bevatten.
      • Meta description: moet een kolom van het type text zijn.
      • Uitgelichte afbeelding: moet een kolom van het type afbeelding zijn.
      • Canonieke url: moet een kolom van het type URL zijn.
    • Gebruik van kindtabellen toestaan: schakel deze instelling in om verwijzingen naar andere HubDB tabellen in deze tabel toe te staan. Je kunt ook de instelling Automatisch publicatiepagina's maken voor kindtabellen selecteren om HubSpot automatisch tussenliggende publicatiepagina's te laten maken. Meer informatie over het bouwen van dynamische pagina's op meerdere niveaus met HubDB
      
      

      Let op: een ouder tabel kan niet verwijzen naar een kind tabel die ook verwijst naar de ouder tabel. Dit creëert een lus die resulteert in een foutmelding wanneer je probeert de kind-tabel te selecteren binnen de ouder-tabel.

• Klik op Opslaan.

Tabellen publiceren

Als je klaar bent met het vullen van je HubDB tabel met gegevens, kun je deze publiceren voor gebruik op je websitepagina's en toegankelijk maken voor opvragen via de HubSpot API.

• Klik rechtsboven op Publiceren.
• Bevestig in het dialoogvenster dat je klaar bent om je tabel openbaar te maken en klik dan op Publiceren.

Tabelgegevens exporteren

• Klik op het HubDB Dashboard op het label van een van je tabellen.
• Klik rechtsboven op het vervolgkeuzemenu Acties en selecteer Exporteren. De HubDB gegevens worden onmiddellijk gedownload.

Let op: afbeeldingen die geëxporteerd worden uit een HubDB tabel worden geformatteerd als URL's voor afbeeldingen. Als de dimensies van de afbeelding zijn aangepast, zullen deze aan het einde van de URL verschijnen.

Tabelafhankelijken weergeven

Zodra een tabel is gemaakt, kun je in het HubDB dashboard zien waar een HubDB tabel wordt gebruikt in je content. Als je een HubDB tabel verwijdert, zal HubSpot je bovendien waarschuwen als de tabel momenteel wordt gebruikt door een toepassing.

Om assets te bekijken die een HubDB tabel gebruiken, klik je op het HubDB dashboard op het Actions dropdown menu naast een tabel en selecteer je Show dependents.

Lees meer over HubDB in de HubSpot documentatie voor ontwikkelaars.