Creare e popolare le tabelle di HubDB
Ultimo aggiornamento: luglio 29, 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 dati che possono essere utilizzati nelle pagine del sito web o interrogati 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 con un abbonamento Marketing Hub Enterprisepossono 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 della tabella.
Aggiungere una colonna di tabella personalizzata
- Nella dashboard di HubDB, fate clic sull'etichetta di una delle vostre 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 alla 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 si dispone di un foglio di calcolo esistente con dati che corrispondono allo schema della tabella HubDB, è possibile importarlo in HubSpot per unire automaticamente i suoi dati alla tabella.
Attenzione:
- Per importare un'immagine in una tabella HubDB, aggiungete l'URL dell'immagine al file CSV. Per impostare le dimensioni dell'immagine, aggiungete la larghezza e l'altezza alla fine dell'URL, separati 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 come si desidera mappare ogni campo del 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.
- Al termine dell'importazione, fare clic su Fine.
Gestire le impostazioni della tabella (solo Content Hub Professional ed Enterprise)
Se si dispone di un account Content Hub Professional o Enterprise, è possibile gestire le impostazioni per ogni tabella 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, i dati della tabella possono essere consultati solo in HubSpot, attraverso 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 le colonne che popoleranno le pagine dinamiche con i dati relativi alla meta descrizione, all'immagine in evidenza 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 figlio: attivare questa impostazione per consentire i riferimenti ad altre tabelle HubDB in questa tabella. È inoltre possibile selezionare l'impostazione Crea automaticamente pagine di elenco per le tabelle figlio per consentire a HubSpot di creare automaticamente pagine di elenco intermedie. Ulteriori informazioni 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 le colonne che popoleranno le pagine dinamiche con i dati relativi alla meta descrizione, all'immagine in evidenza e all'URL canonico. Per le nuove tabelle, sarà necessario creare nuove colonne per contenere questi dati.
- Consenti accesso API pubblico: per impostazione predefinita, i dati della tabella possono essere consultati solo in HubSpot, attraverso 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 nelle 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.
Esportare i 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. I dati di HubDB inizieranno a essere scaricati immediatamente.
Attenzione: le immagini esportate da una tabella di 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 una tabella HubDB viene utilizzata nei contenuti. Inoltre, quando si elimina una tabella HubDB, HubSpot avvisa se la tabella è attualmente utilizzata da qualche risorsa.
Per visualizzare le risorse che utilizzano una tabella HubDB, nella dashboard HubDB fate clic sul menu a discesa Azioni accanto a una tabella, quindi selezionate Mostra dipendenti.
Per saperne di più su HubDB, consultare la documentazione per sviluppatori di HubSpot.