Creare e popolare le tabelle di HubDB

HubDB è uno strumento di database utilizzato per creare e gestire tabelle di dati strutturate. È possibile utilizzare le tabelle HubDB per creare pagine dinamiche ed eseguire query sulle tabelle esternamente tramite l'API HubDB. HubDB memorizza dati strutturati (ad esempio, elenchi di prodotti, directory dei team o programmi di eventi) in modo che le informazioni possano essere aggiornate in un unico punto centrale invece di aggiornare singolarmente più pagine. Per ulteriori informazioni su HubDB, consulta la documentazione per sviluppatori di HubSpot.

Prima di iniziare

Prima di iniziare a utilizzare questa funzione, assicurati di comprendere appieno quali passaggi devono essere eseguiti in anticipo, nonché le limitazioni della funzione e le potenziali conseguenze del suo utilizzo. 

Comprendi i limiti e le considerazioni

• Tutte le nuove tabelle create vengono impostate con lo stato di bozza. Le tabelle non possono essere utilizzate per produrre dati conHubL o API fino a quando non vengono pubblicate.
• Esamina i limiti tecnici di HubDB.

Creare una tabella

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic su Crea tabella.
3. Nella finestra di dialogo, inserisciun'etichetta eun nomeper la tabella.Non è possibile modificare il nome di una tabella dopo averla pubblicata.
4. Fare clicsu Crea.

Aggiungi o importa i dati della tabella

Dopo aver creato una tabella, puoi aggiungere nuove colonne e righe per strutturare i dati utilizzati nelle pagine del tuo sito web o tramite l'API HubDB. Puoi anche importare un file CSV per unire i suoi dati in una tabella HubDB.

Aggiungere colonne alla tabella

Le colonne definiscono il tipo di dati memorizzati in ciascuna parte della tabella. Quando si aggiunge una colonna, è necessario selezionare un tipo di colonna e configurare le impostazioni che determinano come vengono inseriti e utilizzati i dati.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nome di una tabella.
3. In alto a destra, fare clic sul menu a discesa Azionie selezionare Aggiungi colonna.
4. Nella finestra di dialogo, inserire un'etichetta Colonna.
5. Inserisci un Nome colonna. Puoi utilizzare questo nome per eseguire query sui tuoi dati con l'API HubDB.
6. Inserisci una descrizione della colonna. Questa descrizione apparirà quando un utente passerà con il mouse sull'icona delle informazioni accanto al nome della colonna.
7. Fai clic sul menu a discesa Tipo di colonna e seleziona un tipo di colonna. Alcuni tipi di colonna mostreranno opzioni aggiuntive (ad esempio, Seleziona o Selezione multipla) da configurare.
8. Al termine, fai clic su Aggiungi colonna.

Aggiungere righe alla tabella

Le righe memorizzano i singoli record nella tabella. Aggiungi righe per popolare la tabella con dati strutturati o aggiorna le righe esistenti man mano che i dati cambiano.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fai clic sul nome di una tabella.
3. In alto a destra, fai clic sul menu a discesa Azionie seleziona Aggiungi riga.
4. Verrà creata una nuova riga. Se nella tabella sono già presenti delle righe, la nuova riga verrà aggiunta sotto quelle esistenti. Inserisci un valore per ogni colonna che hai configurato per la tabella.

Importare i dati della tabella con un file CSV

Importa i dati da un file CSV per aggiungere più righe alla tabella HubDB contemporaneamente. Ciò è utile quando si lavora con set di dati di grandi dimensioni o si migrano informazioni esistenti in HubDB.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nomedi una tabella.
3. In alto a destra, fai clic sul menu a discesa Azionie seleziona Importa.
4. Fai clic sul riquadro Aggiungi o Sostituisci:
   • Aggiungi: le righe del foglio di calcolo verranno aggiunte ai dati esistenti.
   • Sostituisci: le righe del foglio di calcolo sovrascriveranno e sostituiranno tutti i dati esistenti nella tabella. Se nel foglio di calcolo sono inclusi gli ID delle righe, queste verranno aggiornate anziché sostituite.
5. Fai clic su Avanti.
6. Nella pagina Seleziona file, clicca su Scegli file.
7. Individua il file CSV nel tuo file system, quindi clicca suApri.
8. Per impostazione predefinita, HubSpot rileverà la codifica dei dati nel CSV. Per specificare manualmente la codifica dei dati:
   • Clicca su Opzioni avanzate.
   • Clicca sul menu a tendina Personalizza codifica dati, quindi seleziona una codifica.
9. Fai clic su Avanti.
10. Nella pagina Mappa colonne, specifica come desideri mappare ciascun campo del tuo CSV alla colonna corrispondente della tabella HubDB:
    • Fai clic sul menu a discesa Colonna tabella HubDB, quindi seleziona unacolonna.
    • Se non hai configurato una colonna associata per il campo CSV, fai clic su Aggiungi colonna. Nella finestra di dialogo, inserisci un'etichetta, un nome e seleziona un tipo. Al termine, fai clic su Aggiungi colonna.
11. Al termine, fai clic su Importa.
12. Al termine dell'importazione, fai clic su Fine.

Gestire i dati della tabella

Gestisci la struttura e il contenuto della tabella HubDB rimuovendo colonne o righe e modificandone l'ordine. Queste azioni aiutano a mantenere la tabella organizzata e garantiscono che i dati siano strutturati correttamente per l'utilizzo sul tuo sito web o tramite l'API HubDB.

Rimuovi colonne della tabella

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nome di una tabella.
3. Passa con il mouse su un'etichetta di colonna e fai clic sul menu a discesa, quindi seleziona Rimuovi.
4. Nella finestra di dialogo, fai clic su Elimina.

Rimuovi righe della tabella

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nome di una tabella.
3. Passa con il mouse su un ID riga e clicca sul menu a tendina, quindi seleziona Rimuovi.

Riorganizza le colonne e le righe della tabella

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nome di una tabella.
3. Per modificare l'ordine di una riga, passa con il mouse sul numero della riga e fai clic sull'icona di trascinamento dragHandleIcon. Quindi sposta la riga verso l'alto o verso il basso in una nuova posizione.

4. Per modificare l'ordine di una colonna, passa con il mouse sulla colonnae fai clic sull'icona dragHandleIcon trascina e rilascia. Quindi sposta la colonna a sinistra o a destra in una nuova posizione.

Gestisci le impostazioni della tabella

Gestisci le impostazioni delle singole tabelle HubDB, comprese le opzioni per l'accesso pubblico all'API e la possibilità di utilizzare i dati per creare pagine dinamiche.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sulnome di una tabella.
3. In alto a destra, fai clic sul menu a discesa Azioni e seleziona Gestisci impostazioni.
4. Nel pannello di destra, attiva l'opzione Consenti accesso API pubblico per abilitare le chiamate API non autenticate per interrogare i dati della tabella.
   • Per impostazione predefinita, è possibile accedere ai dati della tabella in HubSpot solo tramite HubL o chiamate API autenticate.
   • Per interrogare i dati, è necessario includere l'ID account HubSpot in un parametro di query portalId.
5. Per creare pagine dinamiche utilizzando la tabella, attiva l'opzione Abilita creazione di pagine dinamiche utilizzando i dati delle righe. Puoi quindi configurare le seguenti opzioni aggiuntive:
   • Nella sezione Metadati, fai clic suimenu a discesa e seleziona quali colonne popoleranno le pagine dinamiche con meta descrizione, immagine in primo piano e dati URL canonici. Per le nuove tabelle, dovrai creare nuove colonne per contenere questi dati.
     • Meta descrizione:deve essere una colonna di tipo testo.
     • Immagine in primo piano:deve essere una colonna di tipo immagine.
     • URL canonico:deve essere una colonna di tipo URL.
   • Nella sezione Tabelle figlie, seleziona la casella di controllo Consenti l'uso di tabelle figlie per attivare i riferimenti ad altre tabelle HubDB in questa tabella.
   • Per creare automaticamente pagine di elenco intermedie, seleziona la casella di controllo Crea automaticamente pagine di elenco per tabelle secondarie.Scopri di più sulla creazione di pagine dinamiche multilivello utilizzando HubDB.
6. Al termine, fai clic su Salva.

Nota: una tabella padre non può fare riferimento a una tabella figlio che a sua volta fa riferimento alla tabella padre. Ciò creerebbe un ciclo che causerebbe un errore quando si tenta di selezionare la tabella figlio all'interno della tabella padre.

Pubblicare una tabella

Pubblica una tabella HubDB per rendere disponibili la struttura e i dati più recenti sul tuo sito web o tramite l'API HubDB. Dopo aver creato una tabella o aver apportato modifiche alle colonne o alle righe, pubblica la tabella in modo che le modifiche vengano applicate.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fai clic sul nome di una tabella.
3. In alto a destra, fai clic su Pubblica.
4. Nella finestra di dialogo, fare clic su Pubblica per rendere effettive le modifiche.

Esportare i dati della tabella

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul nome di una tabella.
3. In alto a destra, clicca sul menu a discesa Azioni e seleziona Esporta. Quindi seleziona un'opzione di formato file (ad esempio CSV). Il download dei dati della tabella HubDB inizierà immediatamente.

Nota: le immagini esportate da una tabella HubDB saranno formattate come URL di immagini. Se le dimensioni dell'immagine sono state personalizzate, appariranno alla fine dell'URL.

Visualizza i dipendenti della tabella

Prima di aggiornare o eliminare una tabella HubDB, visualizza quali risorse dipendono da essa. La visualizzazione delle dipendenze della tabella ti aiuta a comprendere l'effetto delle modifiche sul contenuto del tuo sito web o sull'utilizzo dell'API.

1. Nel tuo account HubSpot, passa a Contenuti > HubDB.
2. Fare clic sul menu a discesa Azioni e selezionare Mostra dipendenti.
3. Nella finestra di dialogo, fai clic su un tipo di risorsa (ad esempio, Post del blog o Moduli) per espandere la sezione e visualizzare le singole risorse.