- Tietämyskanta
- CRM
- Tuo ja vie
- Tuontitiedostojen muotoilu
Tuontitiedostojen muotoilu
Päivitetty viimeksi: 14 huhtikuuta 2026
Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:
Ennen kuin tuot tietoja HubSpotiin, varmista, että tiedostosi täyttävät vaaditut muoto- ja tekniset rajoitukset. Jotkin rajoitukset riippuvat tilauksesta. Tutustu tuettuihin tiedostotyyppeihin, ominaisuusarvojen jäsentelyyn ja muotoiluun sekä siihen, kuinka monta riviä ja tiedostoa voit tuoda tietyn ajanjakson aikana.
Tutustu ennen tuontia artikkeliin ”Aloita tuonti”.
Tekniset vaatimukset ja rajoitukset
Kaikkien HubSpotiin tuotavien tiedostojen on:- Olla .csv-, .xlsx- tai .xls-tiedostoja.
- sisältää vain yhden taulukon
- Sisältää otsikkorivin, jossa jokainen sarakkeen otsikko vastaa HubSpotin ominaisuutta. Sarakkeiden otsikot voidaan järjestää missä tahansa järjestyksessä ilman, että se vaikuttaa tuontiin. Voit tarkistaa, onko otsikkoasi vastaavaa oletusominaisuutta jo olemassa , tai luoda mukautetun ominaisuuden ennen tuontia. Lue lisää ominaisuusvaatimuksista.

- Sisältää alle 1 000 saraketta.
- Tiedoston on oltava UTF-8-koodattu, jos se sisältää vieraskielisiä merkkejä.
- Jos tuot Excel-tiedoston:
- Tiedosto saa sisältää enintään Excelin laskentataulukon ja työkirjan enimmäisrajojen mukaisen määrän tietoja.
- Sisältää numeroformaatin soluja, kun tuodaan päivämäärä- ja aikavalitsimen ominaisuuksia.
Tuontityökaluun sovelletaan muita teknisiä rajoituksia HubSpot-tilauksesi mukaan. Näihin rajoituksiin kuuluvat tuontitiedoston koko- ja rivirajat sekä se, kuinka monta tiedostoa ja riviä voit tuoda päivässä.
- Jos käytät HubSpotin ilmaisia työkaluja, voit:
- Tuoda tiedostoja, joiden koko on enintään 20 Mt.
- Suorittaa enintään 50 tuontia päivässä.
- Tuoda enintään 500 000 riviä päivässä. Tiedostojen, jotka sisältävät yli 500 000 riviä, tuonti kestää useita päiviä.
- Käynnistää enintään 3 tuontia samanaikaisesti. Enintään 2 näistä tuonneista voi olla yli 10 000 riviä. Jos käynnistät 4 tai useampia samanaikaisia tuonteja, ne asetetaan jonoon.
- Jos tililläsi on Smart CRM -tilaus tai Starter-, Professional- tai Enterprise -tilaus, voit:
- Tuoda tiedostoja, joiden koko on enintään 512 Mt.
- Suorittaa jopa 500 tuontia päivässä.
- Tuoda enintään 10 000 000 riviä päivässä, rajoituksena 1 048 576 riviä tiedostoa kohti. Jos tuot tiedostoja tuontirajapinnan kautta, voit tuoda enintään 80 000 000 riviä päivässä.
- Käynnistää enintään 3 tuontia samanaikaisesti. Enintään 2 näistä tuonneista voi olla yli 10 000 riviä. Jos käynnistät 4 tai useampia samanaikaisia tuonteja, ne asetetaan jonoon.
Nämä rajoitukset koskevat 24 tunnin jaksoa, eikä niitä nollata tiettynä kellonaikana. Lue lisääHubSpot-tilauksestasi ja sen rajoituksista.
Muotoile ominaisuusarvot
Voit lisätä arvoja ominaisuuskolumneihin tuontitiedostosi jokaiselle riville. Arvon muotoilu riippuu ominaisuuskentän tyypistä ja tuonnin tavoitteesta.
Arvojen muotoilu ominaisuuskentän tyypin mukaan
Ominaisuuskentän tyypistä riippuen on tiettyjä muotoiluvaatimuksia:
| Kenttätyyppi | Vaatimukset |
| Päivämäärän valitsin Päivämäärä- ja aikavalitsin |
Kuukaudet voivat olla numeroita, kolme kirjainta tai täydellinen nimi (10, OCT, Oct, OCTOBER, October), vuodet voivat olla kaksi- tai nelinumeroisia (2023, 23) ja erottimina voidaan käyttää kauttaviivaa, väliviivaa tai pistettä (10/28/2023, 10-28-2023, 10.28.2023). Kelvollisia päivämäärämuotoja ovat päivä kuukausi vuosi (esim. 28/10/2023), kuukausi päivä vuosi (esim. 10-28-23) tai vuosi kuukausi päivä (esim. 2023.OCT.28). Jos olet määrittänyt vahvistussäännöt, tuotujen arvojen on noudatettava sääntöjä, muuten niitä ei tuoda. |
| Päivämäärän ja kellonajan valitsin |
Aikaleimat voidaan lisätä muodossa Aikavyöhykkeen poikkeamat suhteessa tilisi aikavyöhykkeeseen voidaan lisätä muodossa |
| Kesto |
Ominaisuuksissa, jotka sisältävät keston, kuten Puhelun kesto -ominaisuus, arvot on muotoiltava UNIX-aikaleimana millisekunteina. Lue lisää aikaleima-arvojen muotoilusta ja päivämäärän muuntamisesta UNIX-muotoon. |
| Luettelointi |
Tuontitiedoston arvojen on vastattava joko ominaisuuden määriteltyjen vaihtoehtojen nimeä tai sisäistä arvoa. HubSpotin oletusluettelointiominaisuuksien (esim. Elinkaaren vaihe, Toimiala) arvojen on vastattava sisäistä arvoa tai nimeä englanniksi. |
| Tiedosto |
Jos haluat lisätä olemassa olevia tiedostoja tiedostomääritteeseen, lisää tiedoston tunnus arvoksi. Löydät tiedoston tunnuksen tiedoston tietojen Yleiset-osiosta. |
| Useita valintaruutuja |
Jos haluat tuoda useita arvoja, lisää jokaisen arvon väliin puolipiste ilman välilyöntejä (arvo 1;arvo 2). Nämä ominaisuusvaihtoehdot on luotava ennen tuontia. Jos haluat lisätä tai liittää arvoja, lisää puolipisteensimmäisen arvon eteen (;arvo 3;arvo 4). Tämä liittää arvon olemassa olevan ominaisuusarvon sijaan. Lue lisää useiden valintaruutujen arvojen tuonnista. |
| Luku |
Muotoile arvo luodun numeromääritteen tyypin mukaan:
|
| Yksittäinen valintaruutu |
Luo sarake yksittäiselle valintaruutukentälle ja aseta kunkin rivin arvoksi TruetaiYes, jotta se näkyy HubSpotissa Yes-merkkinä tai valittuna, taiFalsetaiNo,jotta se näkyy HubSpotissa No-merkkinä tai valitsemattomana. |
| Sopimusehtojen ominaisuudet |
Rivikohteen ominaisuus Term (Kesto) tulee lisätä ISO-8601-päivämäärämuodossa PnYnMnD tai PnW. Esimerkiksi P12M tai P24M vuosittaisille kestoille. Jos kenttä jätetään tyhjäksi, asetetaan oletusarvot. |
| Teksti |
Jos olet asettanut validointisäännöt, tuontiarvojen on noudatettava sääntöjä, muuten niitä ei tuoda. |
| Käyttäjä (omistaja) |
Omistajan määrittäminen tietueelle tai toiminnolle tuonnin aikana:
|
Lisäyhteyshenkilöiden sähköpostiosoitteet tai yritysten verkkotunnukset
Jos tuot yhteystietoja, joilla on useampi kuin yksi sähköpostiosoite, lisää sarakkeeseen Additional email addresses niiden toissijaiset sähköpostiosoitteet. Jos tuot yrityksiä, joilla on useampi kuin yksi verkkotunnus, lisää sarakkeeseenAdditional domains niiden toissijaiset verkkotunnukset. Jos haluat lisätä useita sähköpostiosoitteita tai verkkotunnuksia samaan soluun, erota arvot puolipisteillä (esim. email@email.com; emailtwo@email.com).
Jos tuot tietoja luodaksesi kontakteja tai yrityksiä, et voi asettaa uuden kontaktin sähköpostiosoitteeksi tai uuden yrityksen verkkotunnukseksi sähköpostiosoitetta tai verkkotunnusta, joka on jo olemassa olevan toisen tietueen lisäosoite tai -verkkotunnus.
Tyhjät solut
Tuontityökalu ohittaa taulukon tyhjät solut, joten kun tuot uusia ominaisuusarvoja, jätä solut tyhjiksi niille tietueille, joilla ei ole arvoa kyseiselle ominaisuudelle. Jos olemassa olevalla tietueella on jo arvo kyseiselle ominaisuudelle HubSpotissa, tyhjät solut eivät poista olemassa olevaa ominaisuusarvoa. Jos haluat poistaa olemassa olevat ominaisuusarvot kerralla, voit muokata arvoja manuaalisesti tai käyttää Muokkaa tietueita -työnkulun toimintoa .Kaupan yhteistyökumppanit
Jos lisäät yhteistyökumppaneita kauppaan tuonnin kautta, lisää Kaupan yhteistyökumppani -otsikko. Jokaiseen soluun on lisättävä vähintään kaksi käyttäjää, erotettuna puolipisteillä (esim. user1@example.com;user2@example.com).Tuotteen voimassaoloaika ja laskutusväli
Jos tuot Term-ominaisuusarvon, voit muotoilla arvon Term-sarakkeessa kuukausina ilmaistuna lukuna (esim. 10 = 10 kuukautta), muodossa PXM , jossa X on kuukausien lukumäärä (esim. P6M= 6 kuukautta) tai muodossa PXY, jossa X on vuosien lukumäärä (esim. P1Y= 1 vuosi).
Jos tuot ominaisuusarvon Laskutusväli, käytä kuukausittain, vuosittain tai neljännesvuosittain, jos tuotteella on toistuva hintatyyppi. Jätä solu tyhjäksi, jos tuotteella on kertaluonteinen hinta.
Sisällytä vaaditut ominaisuudet
Riippuen siitä, mitä objekteja tai toimintoja tuot, seuraavat ominaisuudet ovat pakollisia tietueiden luomiseksi, ja ne on sisällytettävä tiedostoihisi sarakkeiden otsikoina. Jos päivität tietueita, sinun on sisällytettävä yksilöllinen tunniste (esim. tietueen tunnus, sähköpostiosoite, yrityksen verkkotunnus).
Vaikkase ei ole pakollista, voit tuoda lisäominaisuuksia jokaiselle objektille, mukaan lukien mukautetut ja oletusominaisuudet. Katso oletusominaisuudet yhteyshenkilöille, yrityksille, kaupoille, tiketeille, puheluille, sähköposteille, kokouksille, muistiinpanoille ja tehtäville. Voit myös tarkastella kaikkia ominaisuuksia ja niiden arvoja ominaisuusasetuksissasi.
- Yhteystiedot: vähintään yksi seuraavista: Etunimi, Sukunimi tai Sähköposti.
- Yritykset: vähintään yksi seuraavista: nimi tai yrityksen verkkotunnus.
Huomaa: Yrityksen verkkotunnus -ominaisuus hyväksyy vain ylätason verkkotunnuksen (esim. .com, .edu). Arvot, joiden perässä on merkkijono (esim. .edu/home), poistetaan automaattisesti tuonnin yhteydessä.
- Kaupat: jos luot uusia kauppoja,Kaupan nimi, Myyntiputki ja Kaupan vaihe.Myyntiputken jaKaupan vaiheen on vastattava tilisi olemassa olevia vaihtoehtoja, ja Kaupan vaiheen on oltava kyseisen myyntiputken kelvollinen vaihe.
- Tiketit: jos luot uusia tikettejä, tiketin nimi, myyntiputki ja tiketin tila.
- Tapaamiset: Tapaamisen alkamisaika. Tapaamisen alkamisaika tulee muotoillapäivämäärä-aika-ominaisuudeksi.
- Kurssit: Kurssin nimi.
- Ilmoitukset: Nimi.
- Palvelut: Nimi, myyntiputki ja myyntiputken vaihe.
- Tuotteet: jos päivität tuotteita, tietueen tunnus tai SKU.
- Jos päivität tuotteita tilillä, jossa on yksi valuutta,yksikköhinta ja nimi.
- Jos päivität tuotteita tilillä, jossa on useita valuuttoja,hinta [valuutan lyhenne] (esim. hinta USD) ja nimi.
- Tilaukset: Nimi, myyntiputki ja myyntiputken vaihe.
- Ostoskorit: Nimi.
- Rivit: Nimi, Määrä, Hinta sekäniihin liittyvien kauppojen tietueen tunnus tai kaupan nimi. Lisää tuotteen tuotetunnus, jos liität rivin myös tuotteeseen, jolloin se määritetään rivin ominaisuudeksi tuonnin aikana.
Huomaa: kun tuot rivikohtaisia tietoja kaupoista, tuonti ei päivitä kaupan summaa. Voit päivittää siihen liittyvän kaupan summan muokkaamalla rivikohtaisia tietoja manuaalisesti tai liittämällä rivikohtaiset tiedot kauppaan HubSpotissa.
- Puhelut: Puhelumuistiinpanot. Kun tuodaan uusia puheluita, on suositeltavaa sisällyttää myös Toimintapäivä.
- Sähköpostit: Sähköpostin tekstija Sähköpostin vastaanottaja.
- Kokoukset:Kokouksen kuvaus, kokouksen alkamisaika ja kokouksen päättymisaika. Kun tuodaan uusia kokouksia, on suositeltavaa sisällyttää myös Toiminnan päivämäärä. Aloitusajan, päättymisajan ja toimintapäivän arvot tulee muotoilla päivämäärä-aika-ominaisuuksiksi.
- Muistiinpanot: Muistiinpanon teksti.
- Tehtävät:Tehtävän otsikkojaMääräaika. Määräaika tulee muotoilla päivämäärä-aika-ominaisuudeksi.
Huomaa: Vaikka se ei ole pakollista, on suositeltavaa sisällyttää toimintojen päivämäärä, kun tuodaan uusia toimintoja, jotta voidaan määrittää päivämäärä ja kellonaika, jolloin toiminto tapahtui. Jos et sisällytä tätä ominaisuutta, toimintojen päivämääräarvot asetetaan automaattisesti tuonnin päivämääräksi ja kellonajaksi.
Vaatimukset
olemassa olevien
tietueiden päivittämiseksi tai päällekkäisyyksien välttämiseksi
Jotta olemassa olevia tietueita voidaan päivittää ja päällekkäisyyksiä välttää, tiedostoissasi on oltava jokaiselle objektille oma yksilöllinen tunnisteominaisuus. Kaikkien objektien osalta voit viedä olemassa olevat tietueet ja käyttää tietueen tunnusta yksilöllisenä tunnisteena tai käyttää mukautettua ominaisuutta, joka vaatii yksilöllisiä arvoja. Yhteystietojen osalta voit käyttää myös sähköpostiosoitetta. Yritysten osalta voit käyttää myös yrityksen verkkotunnusta.
Jos tuot useita objekteja ja sisällytät tietueiden tunnisteet, on suositeltavaa erottaa tiedoston sarakkeiden otsikot toisistaan, jotta tunnisteet voidaan yhdistää oikeisiin objekteihin (esim. yksi sarake nimeltä Tietueen tunniste – Yhteystiedot ja toinen nimeltä Tietueen tunniste – Yritykset).
Huomaa:seuraava toiminta pätee, jos tiedostossasi on mukana Sähköposti tai Yrityksen verkkotunnus :
- Jos käytät mukautettua yksilöllisen arvon ominaisuutta yhteystietojen päällekkäisyyksien poistamiseen, Sähköposti -ominaisuus vaatii edelleen yksilöllisiä arvoja.
- Jos käytät mukautettua yksilöllisen arvon ominaisuutta yritysten päällekkäisyyksien poistamiseen, yrityksen verkkotunnus -ominaisuus ei vaadi yksilöllisiä arvoja. Tämä tarkoittaa, että voit tuoda päällekkäisiä yritysten verkkotunnuksia. Jos et halua useita yrityksiä, joilla on sama verkkotunnus, sinun tulee poistaa päällekkäiset verkkotunnukset tiedostostasi ennen tuontia tai käyttää yrityksen verkkotunnusta yksilöllisenä tunnisteena.
- Voit käyttää toissijaista sähköpostiosoitetta yksilöllisenä tunnisteena olemassa oleville kontakteille, joilla on toissijainen sähköpostiosoite HubSpotissa. Jos käytät toissijaista sähköpostiosoitetta etkä sisällytä tiedostoon RecordID -saraketta, toissijainen sähköpostiosoite ei korvaa ensisijaista sähköpostiosoitetta. Jos kuitenkin sisällytät tiedostoon sekä toissijaisen sähköpostiosoitteen että Record ID -sarakkeen, toissijainen sähköpostiosoite korvaa ensisijaisen sähköpostiosoitteen.
Tietueiden yhdistämisen vaatimukset
Yhdistä yhdistykset yhteen tiedostoon
Yhdessä tiedostossa voit yhdistää kaksi tai useampia tietueita riviä kohden. Lisää tiedot yhdistetyistä tietueista ja/tai aktiviteeteista samaan riviin ja lisää yksilöllinen tunniste jokaiselle objektille. Jos haluat yhdistää yhden tietueen useisiin aktiviteetteihin tai toisen objektin tietueisiin, lisää tietueen yksilöllinen tunniste useisiin riveihin jokaiselle tietueelle, jonka haluat yhdistää.
Esimerkiksi Luke Danes on johtaja Luke's Dinerissa, mutta alihankkija The Dragonfly Innissä. Jos haluat liittää hänet molempiin yrityksiin, sinun on sisällytettävä kaksi riviä Luke Danesille, joissa on sarakkeet Sähköposti (tai Tietueen tunnus) ja Yrityksen verkkotunnus (tai Tietueen tunnus) kummallekin yritykselle.
Huomaa: jos et lisää yksilöllisiä tunnisteita (esim. Sähköposti, Yrityksen verkkotunnus, Tietueen tunnus), tuonti luo päällekkäisiä tietueita sen sijaan, että liittäisi ne samaan tietueeseen.

Jos tuot samojen objektien liitoksia, on olemassa lisävaatimuksia.
Tuo liitokset kahdessa tiedostossa
Liittääksesi kahden objektin tietueet kahdessa tiedostossa, käytä yhteistä saraketta yhdistämään kunkin tiedoston tietueet. Voit katsoa esimerkkitiedostoista lisäohjeita tietueiden tuontiin ja liittämiseen.
Saman objektin liitännät
Voit tuoda yhden tiedoston liittääksesi saman objektin tietueet joukkotiedostona. Tuontiprosessin aikana sinun on valittava valintaruutu, jotta saman objektin liitännät sisällytetään.
Kun määrität tiedostoasi, sisällytä tiedot liitetyistä tietueista samaan riviin ja lisää jokaiselle tietueelle yksilöllinen tunniste. Seuraavat lisävaatimukset koskevat nimenomaan saman objektin tuontia:
- Ainakin yhden tietueparin tietueen on oltava jo olemassa HubSpotissa ennen tuontia. Voit esimerkiksi tuoda uuden kontaktin ja liittää sen olemassa olevaan kontaktiin, muttaet voituoda kahta uutta kontaktia luodaksesi ja liittääksesi ne toisiinsa.
- Kun liität olemassa olevia kontakteja/yrityksiä, voit käyttää ainoastaan ensisijaistasähköpostiosoitetta/yrityksen verkkotunnusta yksilöllisenä tunnisteena. Toissijaisia sähköpostiosoitteita tai verkkotunnuksia ei tueta.
- Jos liität useita tietueita yhteen tietueeseen, erota tietueiden yksilölliset tunnistearvot puolipisteellä samassa solussa (esim.luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com).
Alla olevassa esimerkkitiedostossa Rory ja Jackson ovat uusia yhteystietoja, jotka liitetään olemassa oleviin yhteystietoihin yksilöllisillä tunnisteilla käyttäen niidensähköpostiosoitteitayksilöllisinä tunnisteina. Sookie on olemassa oleva yhteystieto, joka liitetään kahteen olemassa olevaan yhteystietoon, joilla on sama tunniste. Ensimmäisellä rivillä liitetunniste on osa tunnisteparia, mikä tarkoittaa, että kun tuonti on valmis, liitetyllä tietueella on tunnisteParent ja Roryllaon pariksi kuuluva tunnisteChild.
Vanhempi/lapsi-yhdistykset
Jos haluat luoda lapsi-vanhempi-yritysyhdistyksiä tuonnin kautta, lue lisää tytäryritysten tuonnista.
Mukautetut yhdistämistunnisteet
Tilaus edellytetään Mukautettujen yhdistämistunnisteiden käyttö edellyttää Professional- tai Enterprise- tilausta.
Voit tuoda yhdistämistunnisteita lisäämällä Association label-sarakkeen. Tämä sarake tulisi lisätä vain, jos haluat lisätä tunnisteita kuvaamaan yhdistämisiä. Jos et tarvitse tunnisteita yhdistämisille, saraketta ei tarvita.
- Sinun on luotava suhteenimikkeet HubSpotissa ennen tuontia.
- Jos haluat asettaa yritysyhteyden ensisijaiseksi, lisää arvo Primary kyseisen rivin Association label -sarakkeeseen.
- Jos haluat asettaa useita tunnisteita kuvaamaan kahden tietueen välistä suhdetta, voit lisätä yhteen soluun useita assosiaatiotunnisteiden arvoja, jotka erotetaan toisistaan puolipisteellä (esim. Esimies; Laskutusyhteyshenkilö).
- Jos tuot assosiaatiotunnisteita usean tiedoston tuonnissa, sinun on sisällytettävä samaan tiedostoon Association label -sarakkeeseen ja assosioitavan objektin yksilöllinen tunniste.
- Jos tuotpariliitteitä:
- Objektien välisissä assosiaatioissa lisää vain yksi tunnisteista Assosiaatiotunniste-sarakkeeseen. Tunnisteet määritetään oikealle objektille tuontiprosessin aikana.
- Saman objektin assosiaatioiden osaltaAssociated [yksilöllinen tunniste] -sarakkeen tietue saa tunnisteen, joka on lisättytuontiprosessin aikanatai sisältyy tiedoston tunniste-sarakkeeseen. Rivin toinen tietue saa parin toisen tunnisteen.
Esimerkkitiedostot
Tuontiprosessin alussa voit luoda esimerkkitiedoston, jossa on valittujen objektien ja toimintojen tarvittavat ominaisuudet. Jos haluat tarkastella lisää esimerkkejä, joissa on lisäominaisuuksia, katso tämä artikkeli, jossa on esimerkkitiedostoja.
Seuraavat vaiheet
Nyt kun tuontitiedostosi on valmis, noudata asianmukaisia tuontiohjeita:
