HubDB-Tabellen erstellen und auffüllen

HubDB ist ein Datenbanktool zum Erstellen und Verwalten strukturierter Datentabellen. Sie können HubDB Tabellen verwenden, um dynamische Seiten zu erstellen und Tabellen extern über die HubDB API abzufragen. HubDB speichert strukturierte Daten (z. B. Produktlisten, Teamverzeichnisse oder Veranstaltungskalender), sodass die Informationen an einem zentralen Ort aktualisiert werden können, anstatt mehrere Seiten einzeln zu aktualisieren. Erfahren Sie in der HubSpot-Entwicklerdokumentation mehr über HubDB.

Bevor Sie loslegen

Bevor Sie mit dieser Funktion beginnen, sollten Sie sich im Voraus darüber im Klaren sein, welche Schritte unternommen werden sollten und welche Einschränkungen die Funktion mit sich bringt und welche Konsequenzen sich daraus ergeben können. 

Einschränkungen und Wissenswertes

• Alle neu erstellten Tabellen erhalten den Status eines Entwurfs. Tabellen können erst dann zur Ausgabe von Daten mit HubL oder API verwendet werden, wenn die Tabelle veröffentlicht ist.
• Überprüfen Sie die technischen Beschränkungen von HubDB.

Tabelle erstellen

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf Tabelle erstellen.
3. Geben Sie im Dialogfeld ein Label für die Tabelle  und einen Namen für die Tabelle  ein. Sie können den Namen einer Tabelle nicht mehr ändern, nachdem Sie sie veröffentlicht haben.
4. Klicken Sie auf Erstellen.

Tabellendaten hinzufügen oder importieren

Nachdem Sie eine Tabelle erstellt haben, können Sie neue Spalten und Zeilen hinzufügen, um die auf Ihren Website Seiten oder im HubDB API verwendeten Daten zu strukturieren. Sie können auch eine CSV-Datei importieren, um deren Daten in einer HubDB-Tabelle zusammenzuführen.

Tabellenspalten hinzufügen

Spalten definieren den Datentyp, der in jedem Teil der Tabelle gespeichert ist. Wenn Sie eine Spalte hinzufügen, wählen Sie einen Spaltentyp aus und konfigurieren Einstellungen, die bestimmen, wie Daten eingegeben und verwendet werden.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf das Dropdown-Menü Aktionen und wählen Sie Spalte hinzufügen aus.
4. Geben Sie im Dialogfeld eine Spaltenbezeichnung ein.
5. Geben Sie einen Spaltennamen ein. Mit diesem Namen können Sie Ihre Daten mit dem HubDB API abfragen.
6. Geben Sie eine Spaltenbeschreibung ein. Diese Beschreibung wird angezeigt, wenn ein Benutzer den Mauszeiger über das info Info-Symbol neben dem Spaltennamen bewegt.
7. Klicken Sie auf das Dropdown-Menü Spaltentyp und wählen Sie einen Spaltentyp aus. Bei einigen Spaltentypen werden zusätzliche Konfigurationsoptionen (z. B. Auswählen oder Mehrfachauswahl) angezeigt.
8. Wenn Sie fertig sind, klicken Sie auf Spalte hinzufügen.

Tabellenzeilen hinzufügen

Zeilen speichern einzelne Datensätze in der Tabelle. Fügen Sie Zeilen hinzu, um Ihre Tabelle mit strukturierten Daten zu füllen, oder aktualisieren Sie vorhandene Zeilen, wenn sich Ihre Daten ändern.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf das Dropdown-Menü Aktionen und wählen Sie Zeile hinzufügen aus.
4. Es wird eine neue Zeile erstellt. Wenn Sie vorhandene Zeilen in der Tabelle haben, wird die neue Zeile unter allen vorhandenen Zeilen hinzugefügt. Geben Sie einen Wert für jede Spalte ein, die Sie für die Tabelle konfiguriert haben.

Tabellendaten mit einer CSV-Datei importieren

Importieren Sie Daten aus einer CSV-Datei, um mehrere Zeilen gleichzeitig zu Ihrer HubDB-Tabelle hinzuzufügen. Dies ist nützlich, wenn Sie mit großen Datensätzen arbeiten oder vorhandene Informationen nach HubDB migrieren.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf das Dropdown-Menü Aktionen und wählen Sie Importieren aus.
4. Klicken Sie auf die Kachel Hinzufügen oder Ersetzen :
   • Hinzufügen: Zeilen aus Ihrer Kalkulationstabelle werden zu den vorhandenen Daten hinzugefügt.
   • Ersetzen: Zeilen aus Ihrer Kalkulationstabelle überschreiben und ersetzen alle vorhandenen Daten in Ihrer Tabelle. Wenn Zeilen-IDs in der Tabelle enthalten sind, werden die Zeilen aktualisiert anstatt ersetzt.
5. Klicken Sie auf Weiter.
6. Klicken Sie auf der Seite Datei auswählen auf Datei auswählen.
7. Suchen Sie die CSV-Datei in Ihrem Dateisystem und klicken Sie dann auf Öffnen.
8. Standardmäßig erkennt HubSpot die Kodierung der Daten in Ihrer CSV-Datei. Um die Datenkodierung manuell festzulegen:
   • Klicken Sie auf Erweiterte Optionen.
   • Klicken Sie auf das Dropdown-Menü Datencodierung anpassen und wählen Sie dann eine Codierungaus.
9. Klicken Sie auf Weiter.
10. Geben Sie auf der Seite Spalten zuordnen an, wie Sie jedes Feld aus Ihrer CSV-Datei der entsprechenden HubDB-Tabellenspalte zuordnen möchten:
    • Klicken Sie auf das Dropdown-Menü HubDB-Tabellenspalte und wählen Sie dann eine Spalteaus.
    • Wenn Sie keine zugehörige Spalte für das CSV-Feld konfiguriert haben, klicken Sie auf Spalte hinzufügen. Geben Sie im Dialogfeld ein Label und einen Namen ein und wählen Sie einen Typ aus. Wenn Sie fertig sind, klicken Sie auf Spalte hinzufügen.
11. Wenn Sie fertig sind, klicken Sie auf Importieren.
12. Wenn Ihr Import abgeschlossen ist, klicken Sie auf Fertig.

Tabellendaten verwalten

Verwalten Sie die Struktur und den Inhalt Ihrer HubDB-Tabelle, indem Sie Spalten oder Zeilen entfernen und deren Reihenfolge anpassen. Diese Aktionen helfen dabei, die Tabelle zu organisieren und sicherzustellen, dass die Daten korrekt strukturiert sind, um sie auf Ihrer Website oder im HubDB API zu verwenden.

Entfernen von Tabellenspalten

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Bewegen Sie den Mauszeiger über eine Spaltenbeschriftung , klicken Sie auf das Dropdown-Menü und wählen Sie dann Entfernen aus.
4. Klicken Sie im Dialogfeld auf Löschen.

Entfernen von Tabellenzeilen

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Bewegen Sie den Mauszeiger über eine Zeilen-ID , klicken Sie auf das Dropdown-Menü und wählen Sie dann Entfernen aus.

Neuanordnen von Tabellenspalten und -zeilen

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Um die Reihenfolge einer Zeile zu ändern, bewegen Sie den Mauszeiger über die Zeilennummer und klicken Sie auf das dragHandleIcon Drag-&-Drop-Symbol. Verschieben Sie dann die Reihe nach oben oder unten an eine neue Position.

4. Um die Reihenfolge einer Spalte zu ändern, bewegen Sie den Mauszeiger über die Spalte und klicken Sie auf das dragHandleIcon Drag-&-Drop-Symbol. Verschieben Sie dann die Spalte nach links oder rechts an eine neue Position.

Tabelleneinstellungen verwalten

Verwalten Sie individuelle HubDB-Tabelleneinstellungen, einschließlich Optionen für den öffentlichen API-Zugriff und ob die Daten zum Erstellen dynamischer Seiten verwendet werden können.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf das Dropdown-Menü Aktionen und wählen Sie Einstellungen verwalten aus.
4. Aktivieren Sie im rechten Bereich den Schalter Zugriff auf öffentliche API zulassen , um nicht authentifizierte API-Aufrufe zur Abfrage der Daten der Tabelle zu aktivieren.
   • Standardmäßig können die Daten der Tabelle in HubSpot nur über HubL oder authentifizierte API-Aufrufe aufgerufen werden.
   • Um die Daten abzufragen, müssen Sie die HubSpot-Account-ID in einen portalId Abfrageparameter einschließen.
5. Um dynamische Seiten mithilfe der Tabelle zu erstellen, aktivieren Sie den Schalter Erstellen dynamischer Seiten mithilfe von Zeilendaten aktivieren. Sie können dann die folgenden zusätzlichen Optionen konfigurieren:
   • Klicken Sie im Abschnitt Metadaten auf die Dropdown-Menüs und wählen Sie aus, welche Spalten dynamische Seiten mit Metabeschreibung, Feature-Bild und kanonischen URL-Daten füllen. Bei neuen Tabellen müssen Sie neue Spalten erstellen, um diese Daten zu enthalten.
     • Metabeschreibung: muss eine Textspalte sein.
     • Feature-Bild: muss eine Spalte vom Typ Bild sein.
     • Kanonische URL: muss eine Spalte vom Typ URL sein.
   • Aktivieren Sie im Abschnitt Untergeordnete Tabellen das Kontrollkästchen Verwendung von untergeordneten Tabellen zulassen, um Verweise auf andere HubDB-Tabellen in dieser Tabelle zu aktivieren.
   • Um automatisch Zwischen-Listing-Seiten zu erstellen, aktivieren Sie das Kontrollkästchen Automatisch Listing-Seiten für untergeordnete Tabellen erstellen .Erfahren Sie mehr über das Erstellen von dynamischen Seiten mit mehreren Ebenen mithilfe von HubDB .
6. Wenn Sie fertig sind, klicken Sie auf Speichern.

Bitte beachten Sie: eine übergeordnete Tabelle kann nicht auf eine untergeordnete Tabelle verweisen, die ebenfalls auf die übergeordnete Tabelle verweist. Dadurch wird eine Schleife geschaffen, die zu einem Fehler führt, wenn versucht wird, die untergeordnete Tabelle in der übergeordneten Tabelle auszuwählen.

Veröffentlichen einer Tabelle

Veröffentlichen Sie eine HubDB Tabelle, um die neuesten Strukturen und Daten für die Verwendung auf Ihrer Website oder über die HubDB API verfügbar zu machen. Nachdem Sie eine Tabelle erstellt oder Spalten oder Zeilen aktualisiert haben, veröffentlichen Sie die Tabelle, damit die Änderungen übernommen werden.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf Veröffentlichen.
4. Klicken Sie im Dialogfeld auf Veröffentlichen, um Ihre Änderungen zu veröffentlichen.

Tabellendaten exportieren

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf den Namen einer Tabelle.
3. Klicken Sie oben rechts auf das Dropdown-Menü Aktionen und wählen Sie Exportieren aus. Wählen Sie dann eine Dateiformatoption (z. B. CSV) aus. Die HubDB-Tabellendaten werden sofort heruntergeladen.

Bitte beachten Sie: Bilder, die aus einer HubDB-Tabelle exportiert werden, werden als Bild-URLs formatiert. Wenn die Abmessungen des Bildes angepasst wurden, werden sie am Ende der URL angezeigt.

Abhängigkeiten der Tabelle anzeigen

Bevor Sie eine HubDB-Tabelle aktualisieren oder löschen, sollten Sie sich ansehen, welche Elemente auf sie angewiesen sind. Das Anzeigen von tabellenabhängigen Elemente hilft Ihnen zu verstehen, wie sich Änderungen auf den Inhalt Ihrer Website oder die API-Nutzung auswirken.

1. Gehen Sie in Ihrem HubSpot-Account zu Content > HubDB.
2. Klicken Sie auf das Dropdown-Menü Aktionen und wählen Sie Abhängige anzeigen aus.
3. Klicken Sie im Dialogfeld auf einen Elementtyp (z. B. Blog-Beiträge oder Module), um den Abschnitt zu erweitern und die einzelnen Elemente anzuzeigen.