Tworzenie i wypełnianie tabel HubDB

HubDB to narzędzie bazodanowe służące do tworzenia i zarządzania ustrukturyzowanymi tabelami danych. Tabele HubDB można wykorzystywać do tworzenia dynamicznych stron i zewnętrznego wysyłania zapytań do tabel za pośrednictwem interfejsu API HubDB. HubDB przechowuje dane ustrukturyzowane (np. listy produktów, katalogi zespołów lub harmonogramy wydarzeń), dzięki czemu informacje można aktualizować w jednym centralnym miejscu, zamiast aktualizować wiele stron osobno. Więcej informacji na temat HubDB można znaleźć w dokumentacji dla programistów HubSpot.

Zanim zaczniesz

Przed rozpoczęciem pracy z tą funkcją należy dokładnie zapoznać się z krokami, które należy wykonać przed jej uruchomieniem, a także z ograniczeniami funkcji i potencjalnymi konsekwencjami jej użycia. 

Zrozum ograniczenia i kwestie do rozważenia

• Wszystkie nowo utworzone tabele mają status wersji roboczej. Tabele nie mogą być używane do wyświetlania danych za pomocąHubL lub API, dopóki nie zostaną opublikowane.
• Zapoznaj się z ograniczeniami technicznymi HubDB.

Utwórz tabelę

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij opcję Utwórz tabelę.
3. W oknie dialogowym wprowadźetykietę tabeli inazwętabeli.Nie można zmienić nazwy tabeli po jej opublikowaniu.
4. Kliknij opcjęUtwórz.

Dodaj lub zaimportuj dane tabeli

Po utworzeniu tabeli możesz dodać nowe kolumny i wiersze, aby uporządkować dane używane na stronach witryny internetowej lub za pośrednictwem interfejsu API HubDB. Możesz również zaimportować plik CSV, aby scalić jego dane z tabelą HubDB.

Dodaj kolumny tabeli

Kolumny określają typ danych przechowywanych w każdej części tabeli. Podczas dodawania kolumny należy wybrać typ kolumny i skonfigurować ustawienia określające sposób wprowadzania i wykorzystywania danych.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. W prawym górnym rogu kliknij menu rozwijane Akcjei wybierz Dodaj kolumnę.
4. W oknie dialogowym wprowadź etykietę kolumny.
5. Wprowadź nazwę kolumny. Nazwy tej można używać do wysyłania zapytań dotyczących danych za pomocą interfejsu API HubDB.
6. Wprowadź opis kolumny. Opis ten pojawi się, gdy użytkownik najechał kursorem na ikonę informacji obok nazwy kolumny.
7. Kliknij menu rozwijane Typ kolumny i wybierz typ kolumny. Niektóre typy kolumn wyświetlają dodatkowe opcje (np. Wybierz lub Wybierz wiele), które można skonfigurować.
8. Po zakończeniu kliknij Dodaj kolumnę.

Dodaj wiersze tabeli

Wiersze przechowują poszczególne rekordy w tabeli. Dodaj wiersze, aby wypełnić tabelę uporządkowanymi danymi lub aktualizuj istniejące wiersze w miarę zmian danych.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. W prawym górnym rogu kliknij menu rozwijane Działaniai wybierz Dodaj wiersz.
4. Zostanie utworzony nowy wiersz. Jeśli w tabeli znajdują się już wiersze, nowy wiersz zostanie dodany poniżej istniejących wierszy. Wprowadź wartość dla każdej kolumny skonfigurowanej dla tabeli.

Importuj dane tabeli za pomocą pliku CSV

Zaimportuj dane z pliku CSV, aby dodać wiele wierszy do tabeli HubDB jednocześnie. Jest to przydatne podczas pracy z dużymi zbiorami danych lub migracji istniejących informacji do HubDB.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwętabeli.
3. W prawym górnym rogu kliknij menu rozwijane Akcjei wybierz Importuj.
4. Kliknij kafelek Dodaj lub Zastąp:
   • Dodaj: wiersze z arkusza kalkulacyjnego zostaną dodane do istniejących danych.
   • Zastąp: wiersze z arkusza kalkulacyjnego nadpiszą i zastąpią wszelkie istniejące dane w tabeli. Jeśli w arkuszu kalkulacyjnym znajdują się identyfikatory wierszy, wiersze zostaną zaktualizowane zamiast zastąpione.
5. Kliknij Dalej.
6. Na stronie Wybierz plik kliknij Wybierz plik.
7. Znajdź plik CSV w systemie plików, a następnie kliknijOtwórz.
8. Domyślnie HubSpot wykrywa kodowanie danych w pliku CSV. Aby ręcznie określić kodowanie danych:
   • Kliknij opcję Opcje zaawansowane.
   • Kliknij menu rozwijane Dostosuj kodowanie danych, a następnie wybierz kodowanie.
9. Kliknij Dalej.
10. Na stronie Mapuj kolumny określ, w jaki sposób chcesz zmapować każde pole z pliku CSV do odpowiedniej kolumny tabeli HubDB:
    • Kliknij menu rozwijane Kolumna tabeli HubDB, a następnie wybierzkolumnę.
    • Jeśli nie skonfigurowałeś powiązanej kolumny dla pola CSV, kliknij Dodaj kolumnę. W oknie dialogowym wprowadź etykietę, nazwę i wybierz typ. Po zakończeniu kliknij Dodaj kolumnę.
11. Po zakończeniu kliknij Importuj.
12. Po zakończeniu importu kliknij przycisk Gotowe.

Zarządzanie danymi tabeli

Zarządzaj strukturą i zawartością tabeli HubDB, usuwając kolumny lub wiersze i dostosowując ich kolejność. Działania te pomagają utrzymać porządek w tabeli i zapewniają prawidłową strukturę danych do wykorzystania na stronie internetowej lub za pośrednictwem interfejsu API HubDB.

Usuń kolumny tabeli

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. Najedź kursorem na etykietę kolumny i kliknij menu rozwijane, a następnie wybierz opcję Usuń.
4. W oknie dialogowym kliknij przycisk Usuń.

Usuń wiersze tabeli

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. Najedź kursorem na identyfikator wiersza i kliknij menu rozwijane, a następnie wybierz opcję Usuń.

Zmiana kolejności kolumn i wierszy tabeli

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. Aby zmienić kolejność wierszy, najedź kursorem na numer wiersza i kliknij ikonę przeciągania i upuszczania dragHandleIcon. Następnie przesuń wiersz w górę lub w dół do nowej pozycji.

4. Aby zmienić kolejność kolumn, najedź kursorem na kolumnęi kliknij ikonę przeciągania i upuszczania dragHandleIcon. Następnie przesuń kolumnę w lewo lub w prawo do nowej pozycji.

Zarządzaj ustawieniami tabeli

Zarządzaj indywidualnymi ustawieniami tabeli HubDB, w tym opcjami publicznego dostępu do API oraz możliwością wykorzystania danych do tworzenia stron dynamicznych.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknijnazwę tabeli.
3. W prawym górnym rogu kliknij menu rozwijane Actions (Działania) i wybierz opcję Manage settings(Zarządzaj ustawieniami).
4. W prawym panelu włącz przełącznik Zezwalaj na publiczny dostęp do API, aby włączyć nieautoryzowane wywołania API w celu wysyłania zapytań do danych tabeli.
   • Domyślnie dostęp do danych tabeli w HubSpot jest możliwy tylko poprzez HubL lub uwierzytelnione wywołania API.
   • Aby uzyskać dostęp do danych, należy podać identyfikator konta HubSpot w parametrze zapytania portalId.
5. Aby utworzyć dynamiczne strony przy użyciu tabeli, włącz przełącznik Włącz tworzenie dynamicznych stron przy użyciu danych wiersza. Następnie możesz skonfigurować następujące dodatkowe opcje:
   • W sekcji Metadane kliknijmenu rozwijane i wybierz kolumny, które będą wypełniać strony dynamiczne metadanymi opisu, obrazem wyróżnionym i danymi kanonicznych adresów URL. W przypadku nowych tabel należy utworzyć nowe kolumny, które będą zawierać te dane.
     • Opis meta:musi być kolumną typu tekstowego.
     • Wyróżniony obraz:musi być kolumną typu obraz.
     • Kanoniczny adres URL:musi to być kolumna typu adres URL.
   • W sekcji Tabele podrzędne zaznacz pole wyboru Zezwalaj na używanie tabel podrzędnych , aby włączyć odniesienia do innych tabel HubDB w tej tabeli.
   • Aby automatycznie tworzyć pośrednie strony z listami, zaznacz pole wyboru Automatycznie twórz strony z listami dla tabel podrzędnych.Dowiedz się więcej o tworzeniu wielopoziomowych stron dynamicznych przy użyciu HubDB.
6. Po zakończeniu kliknij przycisk Zapisz.

Uwaga: tabela nadrzędna nie może odwoływać się do tabeli podrzędnej, która również odwołuje się do tabeli nadrzędnej. Spowoduje to utworzenie pętli, która spowoduje błąd podczas próby wybrania tabeli podrzędnej w tabeli nadrzędnej.

Opublikuj tabelę

Opublikuj tabelę HubDB, aby udostępnić najnowszą strukturę i dane do wykorzystania na swojej stronie internetowej lub za pośrednictwem interfejsu API HubDB. Po utworzeniu tabeli lub wprowadzeniu zmian w kolumnach lub wierszach opublikuj tabelę, aby zmiany zostały zastosowane.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. W prawym górnym rogu kliknij opcję Opublikuj.
4. W oknie dialogowym kliknij opcję Publikuj, aby wprowadzić zmiany.

Eksportowanie danych tabeli

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij nazwę tabeli.
3. W prawym górnym rogu kliknij menu rozwijane Akcje i wybierz opcję Eksportuj. Następnie wybierz opcję formatu pliku (np. CSV). Dane tabeli HubDB zaczną się natychmiast pobierać.

Uwaga: obrazy eksportowane z tabeli HubDB będą sformatowane jako adresy URL obrazów. Jeśli wymiary obrazu zostały dostosowane, pojawią się one na końcu adresu URL.

Wyświetl elementy zależne od tabeli

Przed aktualizacją lub usunięciem tabeli HubDB sprawdź, które zasoby są od niej zależne. Wyświetlenie zależności tabeli pomaga zrozumieć wpływ zmian na zawartość witryny internetowej lub wykorzystanie interfejsu API.

1. Na swoim koncie HubSpot przejdź do Treści > HubDB.
2. Kliknij menu rozwijane Akcje i wybierz opcję Pokaż elementy zależne.
3. W oknie dialogowym kliknij typ zasobu (np. Wpisy na blogu lub Moduły), aby rozwinąć sekcję i wyświetlić poszczególne zasoby.