HubDB-tabellen aanmaken en vullen

HubDB is een databasetool waarmee je gestructureerde tabellen met gegevens kunt aanmaken en beheren. Je kunt HubDB-tabellen gebruiken om dynamische pagina’s te maken en extern query’s uit te voeren op tabellen via de HubDB-API. HubDB slaat gestructureerde gegevens op (bijvoorbeeld productlijsten, teamoverzichten of evenementenkalenders), zodat de informatie op één centrale plek kan worden bijgewerkt in plaats van dat je meerdere pagina’s afzonderlijk moet aanpassen. Lees meer over HubDB in de ontwikkelaarsdocumentatie van HubSpot.

Voordat je aan de slag gaat

Lees, voordat je aan de slag gaat met HubDB-tabellen, de vereisten, beperkingen en aandachtspunten door.

Beperkingen en aandachtspunten begrijpen

• Alle nieuw aangemaakte tabellen krijgen de status 'concept'. Tabellen kunnen pas worden gebruikt om gegevens uit te voeren metHubL of de API nadat de tabel is gepubliceerd.
• Het opslaan van wijzigingen in een tabel leidt niet tot een update van de livepagina of e-mail. Om wijzigingen toe te passen, moet u de tabel na het opslaan publiceren. Als de livepagina of e-mail na het publiceren van de tabel nog steeds de oude inhoud toont, publiceer de pagina of e-mail dan opnieuw om een herverwerking te forceren.
• Bekijk de technische beperkingen van HubDB.

Een tabel aanmaken

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op 'Tabel aanmaken'.
3. Voer in het dialoogvenster een'Tabellabel' eneen 'Tabelnaam' in. Jekunt de naam van een tabelniet meer wijzigen nadat je deze hebt gepubliceerd.
4. Klik op'Aanmaken'.

Tabelgegevens toevoegen of importeren

Nadat u een tabel hebt aangemaakt, kunt u nieuwe kolommen en rijen toevoegen om de gegevens te structureren die op uw webpagina's of via de HubDB-API worden gebruikt. U kunt ook een CSV-bestand importeren om de gegevens daarin samen te voegen met een HubDB-tabel.

Kolommen aan de tabel toevoegen

Kolommen bepalen het type gegevens dat in elk deel van de tabel wordt opgeslagen. Wanneer u een kolom toevoegt, selecteert u een kolomtype en configureert u instellingen die bepalen hoe gegevens worden ingevoerd en gebruikt.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Klik rechtsboven op het vervolgkeuzemenu 'Acties' en selecteer 'Kolom toevoegen'.
4. Voer in het dialoogvenster een kolomlabel in.
5. Voer een kolomnaam in. U kunt deze naam gebruiken om uw gegevens op te vragen met de HubDB-API.
6. Voer een kolombeschrijving in. Deze beschrijving wordt weergegeven wanneer een gebruiker de muisaanwijzer op het informatiepictogram naast de kolomnaam plaatst.
7. Klik op het vervolgkeuzemenu 'Kolomtype' en selecteer een kolomtype. Bij sommige kolomtypes worden extra opties weergegeven (bijv. 'Selecteren' of 'Meervoudige selectie') die u kunt configureren.
8. Klik op 'Kolom toevoegen' wanneer u klaar bent.

Tabelrijen toevoegen

Rijen slaan afzonderlijke records op in de tabel. Voeg rijen toe om uw tabel te vullen met gestructureerde gegevens of werk bestaande rijen bij naarmate uw gegevens veranderen.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Klik rechtsboven op het vervolgkeuzemenu 'Acties' en selecteer 'Rij toevoegen'.
4. Er wordt een nieuwe rij aangemaakt. Als er al rijen in de tabel staan, wordt de nieuwe rij onder de bestaande rijen toegevoegd. Voer een waarde in voor elke kolom die u voor de tabel hebt geconfigureerd.

Tabelgegevens importeren met een CSV-bestand

Importeer gegevens uit een CSV-bestand om in één keer meerdere rijen aan uw HubDB-tabel toe te voegen. Dit is handig wanneer u met grote datasets werkt of bestaande informatie naar HubDB migreert.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naamvan een tabel.
3. Klik rechtsboven op het vervolgkeuzemenu 'Acties' en selecteer 'Importeren'.
4. Klik op de tegel 'Toevoegen of vervangen ':
   • Toevoegen: rijen uit uw spreadsheet worden toegevoegd aan uw bestaande gegevens.
   • Vervangen: rijen uit uw spreadsheet overschrijven en vervangen de bestaande gegevens in uw tabel. Als er rij-ID's in de spreadsheet zijn opgenomen, worden de rijen bijgewerkt in plaats van vervangen.
5. Klik op 'Volgende'.
6. Klik op de pagina 'Bestand selecteren ' op 'Bestand kiezen'.
7. Zoek het CSV-bestand in uw bestandssysteem en klik vervolgens op'Openen'.
8. Standaard detecteert HubSpot de codering van de gegevens in uw CSV-bestand. Om de gegevenscodering handmatig op te geven:
   • Klik op 'Geavanceerde opties'.
   • Klik op het vervolgkeuzemenu 'Gegevenscodering aanpassen ' en selecteer vervolgens een codering.
9. Klik op Volgende.
10. Geef op de pagina Kolommen toewijzen aan hoe u elk veld uit uw CSV-bestand wilt toewijzen aan de bijbehorende kolom in de HubDB-tabel:
    • Klik op het vervolgkeuzemenu 'HubDB-tabelkolom ' en selecteer vervolgens eenkolom.
    • Als u nog geen bijbehorende kolom voor het CSV-veld hebt geconfigureerd, klikt u op Kolom toevoegen. Voer in het dialoogvenster een label en een naam in en selecteer een type. Klik op Kolom toevoegen wanneer u klaar bent.
11. Klik op 'Importeren' wanneer u klaar bent.
12. Zodra het importeren is voltooid, klikt u op 'Gereed'.

Tabelgegevens beheren

Beheer de structuur en inhoud van uw HubDB-tabel door kolommen of rijen te verwijderen en de volgorde ervan aan te passen. Deze acties helpen de tabel overzichtelijk te houden en zorgen ervoor dat de gegevens correct zijn gestructureerd voor gebruik op uw website of via de HubDB-API.

Tabelkolommen verwijderen

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Beweeg de muisaanwijzer over een kolomlabel, klik op het vervolgkeuzemenu en selecteer vervolgens 'Verwijderen'.
4. Klik in het dialoogvenster op 'Verwijderen'.

Tabelrijen verwijderen

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Beweeg de muis over een rij-ID, klik op het vervolgkeuzemenu en selecteer vervolgens 'Verwijderen'.

De volgorde van kolommen en rijen in de tabel wijzigen

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Om de volgorde van een rij te wijzigen, beweeg je de muis over het rijnummer en klik je op het slepen-en-neerzetten-pictogram. Verplaats de rij vervolgens omhoog of omlaag naar een nieuwe positie.

4. Om de volgorde van een kolom te wijzigen, beweeg je de muis over de kolomen klik je op het dragHandleIcon-pictogram voor slepen en neerzetten. Verplaats de kolom vervolgens naar links of rechts naar een nieuwe positie.

Tabelinstellingen beheren

Beheer individuele HubDB-tabelinstellingen, waaronder opties voor openbare API-toegang en of de gegevens kunnen worden gebruikt om dynamische pagina's te maken.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op denaam van een tabel.
3. Klik rechtsboven op het vervolgkeuzemenu Acties en selecteer Instellingen beheren.
4. Schakel in het rechterpaneel de schakelaar 'Openbare API-toegang toestaan ' in om niet-geverifieerde API-aanroepen in te schakelen voor het opvragen van de gegevens van de tabel.
   • Standaard zijn de gegevens van de tabel in HubSpot alleen toegankelijk via HubL of geauthenticeerde API-aanroepen.
   • Om de gegevens op te vragen, moet je de HubSpot-account-ID opnemen in een ` portalId `-queryparameter.
5. Om dynamische pagina's te maken met behulp van de tabel, zet je de schakelaar 'Het maken van dynamische pagina's met behulp van rijgegevens inschakelen' aan. Vervolgens kun je de volgende aanvullende opties configureren:
   • Klik in het gedeelte 'Metadata' op devervolgkeuzemenu's en selecteer welke kolommen dynamische pagina's zullen vullen met metabeschrijvingen, uitgelichte afbeeldingen en canonieke URL-gegevens. Voor nieuwe tabellen moet je nieuwe kolommen aanmaken om deze gegevens op te nemen.
     • Metabeschrijving:moet een kolom van het type 'tekst' zijn.
     • Uitgelichte afbeelding:moet een kolom van het type ‘afbeelding’ zijn.
     • Canonieke URL:moet een kolom van het type URL zijn.
   • Selecteer in het gedeelte 'Ondertabellen' het selectievakje 'Gebruik van ondertabellen toestaan' om verwijzingen naar andere HubDB-tabellen in deze tabel in te schakelen.
   • Om automatisch tussenliggende lijstpagina's aan te maken, vink je het selectievakje 'Automatisch lijstpagina's voor onderliggende tabellen aanmaken' aan.Lees meer over het bouwen van dynamische pagina's met meerdere niveaus met behulp van HubDB.
6. Klik op 'Opslaan' wanneer u klaar bent.

Let op: een bovenliggende tabel kan niet verwijzen naar een onderliggende tabel die ook naar de bovenliggende tabel verwijst. Dit leidt tot een lus die een fout veroorzaakt wanneer wordt geprobeerd de onderliggende tabel binnen de bovenliggende tabel te selecteren.

Een tabel publiceren

Publiceer een HubDB-tabel om de nieuwste structuur en gegevens beschikbaar te maken voor gebruik op uw website of via de HubDB-API. Nadat u een tabel hebt aangemaakt of wijzigingen hebt aangebracht in kolommen of rijen, publiceert u de tabel zodat de wijzigingen worden toegepast.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Klik rechtsboven op 'Publiceren'.
4. Klik in het dialoogvenster op 'Publiceren' om uw wijzigingen live te zetten.

Tabelgegevens exporteren

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op de naam van een tabel.
3. Klik rechtsboven op het vervolgkeuzemenu 'Acties ' en selecteer 'Exporteren'. Selecteer vervolgens een bestandsformaat (bijv. CSV). De gegevens van de HubDB-tabel worden onmiddellijk gedownload.

Let op: afbeeldingen die uit een HubDB-tabel worden geëxporteerd, worden opgemaakt als afbeeldings-URL's. Als de afmetingen van de afbeelding zijn aangepast, worden deze aan het einde van de URL weergegeven.

Afhankelijke elementen van de tabel bekijken

Bekijk, voordat u een HubDB-tabel bijwerkt of verwijdert, welke assets ervan afhankelijk zijn. Door de afhankelijke elementen van de tabel te bekijken, krijgt u inzicht in de gevolgen van wijzigingen voor de inhoud van uw website of het gebruik van de API.

1. Klik in je HubSpot-account op Meer en navigeer vervolgens naar Content > HubDB. Als Meer niet wordt weergegeven in je account, navigeer dan direct naar Content > HubDB.
2. Klik op het vervolgkeuzemenu 'Acties ' en selecteer 'Afhankelijke items weergeven'.
3. Klik in het dialoogvenster op een asset-type (bijv. Blogberichten of Modules) om het gedeelte uit te vouwen en de afzonderlijke assets te bekijken.