Creare e popolare le tabelle di HubDB
Ultimo aggiornamento: novembre 20, 2024
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
Marketing Hub Enterprise |
Content Hub Professional , Enterprise |
HubDB è un database relazionale che consente di creare tabelle con uno schema flessibile per memorizzare i dati da utilizzare nelle pagine del sito web o da interrogare esternamente tramite l'API di HubDB.
- Per utilizzare i dati di HubDB per creare pagine dinamiche, è necessario disporre di Content Hub Professional o Enterprise.
- Gli account che hanno solo un abbonamento Marketing Hub Enterprise possono utilizzare HubDB solo per le e-mail di marketing.
Creare una tabella
- Nel tuo account HubSpot, passa a Contenuti > HubDB.
- In alto a destra, fare clic su Crea tabella.
- Nella finestra di dialogo, inserire l'etichetta e ilnome della tabella . Non è possibile modificare il nome di una tabella dopo averla creata.
- Fare clic su Crea.
Aggiungere e modificare i dati della tabella
Modificate le tabelle di HubDB direttamente nel vostro account HubSpot o caricate un CSV per unire automaticamente i dati esistenti alle righe delle vostre tabelle.
Aggiungere una colonna di tabella personalizzata
- Nella dashboard di HubDB, fare clic sull'etichetta di una delle tabelle.
- In alto a destra, fare clic su Azioni, quindi selezionare Aggiungi colonna.
- Nella finestra di dialogo, configurare la colonna:
- Inserire un'etichetta di colonna.
- Inserire un nome per la colonna. Questo nome può essere utilizzato per interrogare i dati con l'API di HubDB.
- Inserire una descrizione della colonna. Questa descrizione appare quando l'utente passa il mouse sull'icona info accanto al nome della colonna.
- Inserire un tipo di colonna.
- Fare clic su Aggiungi colonna.
- Per modificare o rimuovere una colonna, passarci sopra e fare clic sull'icona della freccia, quindi selezionare Modifica o Rimuovi.
Aggiungere righe di tabella
- Nella dashboard di HubDB, fare clic sull'etichetta di una tabella esistente.
- In alto a destra, fare clic su Azioni, quindi selezionare Aggiungi riga.
- Verrà creata automaticamente una nuova riga al di sotto di quelle esistenti. Inserire un valore per ogni colonna configurata per la tabella.
- Per clonare o rimuovere una riga, passare il mouse sull'ID della riga e fare clic sull'icona della freccia downCarat, quindi selezionare Clona o Rimuovi.
Importare i dati della tabella tramite un CSV
Se avete un foglio di calcolo esistente con dati che corrispondono allo schema della vostra tabella HubDB, potete importarlo in HubSpot per unire automaticamente i suoi dati alla vostra tabella.
Nota bene:
- Per importare un'immagine in una tabella di HubDB, aggiungere l'URL dell'immagine al file CSV. Per impostare le dimensioni dell'immagine, aggiungere la larghezza e l'altezza alla fine dell'URL, separate da virgole. Ad esempio: http: //www.hubspot.com/sample-image.jpg,100,300.
- Le date importate devono utilizzare la formattazione MM/GG/AAAA. Ad esempio, il 6 novembre 2022 sarà 11/06/2022.
- Nella dashboard di HubDB, fare clic sull'etichetta di una delle tabelle.
- In alto a destra, fare clic su Azioni, quindi selezionare Importa.
- Fare clic sul riquadro Aggiungi o sostituisci:
- Aggiungi: le righe del foglio di calcolo verranno aggiunte ai dati esistenti.
- Sostituisci: le righe del foglio elettronico sovrascrivono e sostituiscono i dati esistenti nella tabella. Se gli id delle righe sono inclusi nel foglio di calcolo, le righe verranno aggiornate anziché sostituite.
- Fare clic su Avanti.
- Fare clic su Scegli file.
- Cercare il CSV da caricare sul disco rigido del computer e fare clic su Apri.
- Per impostazione predefinita, HubSpot rileva la codifica dei dati nel CSV. Per specificare manualmente la codifica dei dati:
- Fare clic su Opzioni avanzate.
- Fare clic sul menu a discesa Personalizza codifica dati, quindi selezionare una codifica.
- Fare clic su Avanti.
- Specificare la mappatura del campo dal CSV alla colonna corrispondente della tabella HubDB:
- Fare clic sul menu a discesa Colonna tabella HubDB, quindi selezionare una colonna.
- Se non è stata configurata una colonna associata al campo CSV, fare clic su Aggiungi colonna. Nella finestra di dialogo, inserire un'etichetta, un nome e selezionare un tipo. Al termine, fare clic su Aggiungi colonna.
- Fare clic su Importa.
- Una volta completata l'importazione, fare clic su Fine.
Gestione delle impostazioni dei tavoli (solo Content Hub Professional e Enterprise)
Se si dispone di un account Content Hub Professional o Enterprise, è possibile gestire le impostazioni per ogni tabella di HubDB, ad esempio se la tabella è accessibile pubblicamente tramite API e se i dati possono essere usati per creare pagine dinamiche.
- Nel tuo account HubSpot, passa a Contenuti > HubDB.
- Fare clic sul nome di una tabella.
- In alto a destra, fare clic su Azioni > Gestisci impostazioni.
- Nella barra laterale destra, configurare le impostazioni della tabella:
- Consenti accesso API pubblico: per impostazione predefinita, è possibile accedere ai dati della tabella solo in HubSpot, tramite HubL o con chiamate API autenticate. Attivare questa impostazione per consentire alle chiamate API non autenticate di interrogare i dati della tabella. Per interrogare i dati, è necessario includere l'ID dell'account HubSpot in un parametro di query
portalId
. - Abilita la creazione di pagine dinamiche utilizzando i dati delle righe: attivare questa impostazione per abilitare la creazione di pagine dinamiche utilizzando i dati di HubDB. È quindi possibile configurare le seguenti opzioni aggiuntive:
- Usare i menu a discesa per selezionare quali colonne popoleranno le pagine dinamiche con i dati relativi alla meta descrizione, all'immagine in primo piano e all'URL canonico. Per le nuove tabelle, sarà necessario 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.
- Consenti l'uso di tabelle figlie: attivare questa impostazione per consentire i riferimenti ad altre tabelle HubDB in questa tabella. È inoltre possibile selezionare l'impostazione Crea automaticamente le pagine di lista per le tabelle figlio per consentire a HubSpot di creare automaticamente le pagine di lista intermedie. Per saperne di più sulla creazione di pagine dinamiche multilivello con HubDB
Attenzione: una tabella padre non può fare riferimento a una tabella figlio che fa riferimento anche alla tabella padre. In questo modo si crea un ciclo che provoca un errore quando si cerca di selezionare la tabella figlia all'interno della tabella madre.
- Usare i menu a discesa per selezionare quali colonne popoleranno le pagine dinamiche con i dati relativi alla meta descrizione, all'immagine in primo piano e all'URL canonico. Per le nuove tabelle, sarà necessario creare nuove colonne per contenere questi dati.
- Consenti accesso API pubblico: per impostazione predefinita, è possibile accedere ai dati della tabella solo in HubSpot, tramite HubL o con chiamate API autenticate. Attivare questa impostazione per consentire alle chiamate API non autenticate di interrogare i dati della tabella. Per interrogare i dati, è necessario includere l'ID dell'account HubSpot in un parametro di query
- Fare clic su Salva.
Pubblicare le tabelle
Una volta terminato il popolamento della tabella HubDB con i dati, è possibile pubblicarla per utilizzarla sulle pagine del sito web e renderla accessibile alle query tramite l'API di HubSpot.
- In alto a destra, fare clic su Pubblica.
- Nella finestra di dialogo, confermare che si è pronti a rendere pubblica la tabella, quindi fare clic su Pubblica.
Esportazione dei dati della tabella
- Nella dashboard di HubDB, fare clic sull'etichetta di una delle tabelle.
- In alto a destra, fare clic sul menu a discesa Azioni e selezionare Esporta, quindi selezionare un formato di file. Il download dei dati di HubDB inizierà immediatamente.
Nota bene: le immagini esportate da una tabella HubDB saranno formattate come URL immagine. Se le dimensioni dell'immagine sono state personalizzate, appariranno alla fine dell'URL.
Visualizza le dipendenze della tabella
Una volta creata una tabella, dalla dashboard di HubDB è possibile vedere dove viene utilizzata una tabella HubDB nei contenuti. Inoltre, quando si elimina una tabella HubDB, HubSpot avvisa se la tabella è attualmente utilizzata da qualche asset.
Per visualizzare le risorse che utilizzano una tabella di HubDB, nella dashboard di HubDB fare clic sul menu a discesa Azioni accanto a una tabella, quindi selezionare Mostra dipendenze.
Per saperne di più su HubDB, consultate la documentazione per sviluppatori di HubSpot.