CSV-tuoja

CSV-tuojan avulla voidaan tuoda ja päivittää suuria määriä tietoja Collection Pro -järjestelmään. Tämä voi sisältää yksinkertaisia luetteloita, hierarkkisia tesauruksia tai kuva- ja objektitietoja.

Voit luoda tiedot esimerkiksi Microsoft Excelissä, Apple Numbersissa tai Notepad++:ssa. Jos työskentelet Excelillä tai Numbersilla, sinun tulee tallentaa tiedot .csv-muodossa UTF-8 tai UTF-16 -koodauksella ennen tuontia. Tiedostotyyppien .xls, .xlsx tai .numbers käyttöä ei tueta.

Lue myös yleiset huomautukset. Kohdasta ”Tietotyypit” voit lukea, miten tiedot muotoillaan CSV-tiedostossa. Vaiheittaiset ohjeet löytyvät kohdasta ”Esimerkit”, ja kaikki CSV-tuontiohjelman vaihtoehdot on kuvattu täällä.

Yleiset tiedot CSV-tuonnista

1. Tiedoston koodaus: CSV-tiedoston tulee olla koodattu joko UTF-8 tai UTF-16 -muotoon. Tämä varmistaa, että ä- ja ö-kirjaimet sekä erikoismerkit tuodaan oikein.
2. Sarake-erotin: Sarakkeita voi erottaa pilkulla, puolipisteellä tai sarkaimella. Collection Pro tunnistaa erottimen automaattisesti.
3. Tekstin rajaaminen: Tekstit, jotka sisältävät pilkkuja, puolipisteitä, sarkaimia tai rivinvaihtoja, tulee rajata lainausmerkeillä. Collection Pro tunnistaa tämän automaattisesti.
4. Sarakkeiden otsikot: CSV-tiedostossa tulee olla sarakkeiden otsikot. Voit valita otsikot vapaasti, mutta tällöin lähde- ja kohdekenttien yhdistäminen on tehtävä manuaalisesti (katso asetukset).
5. Automaattinen kenttien yhdistäminen: Jos käytät CSV-tiedostossa Collection Pro:n sisäisiä kenttänimiä sarakeotsikkoina, kenttien yhdistäminen tapahtuu automaattisesti. Sisäiset kenttänimet saat helpoiten lataamalla ensin tietueen CSV-muodossa ja kopioimalla sarakeotsikot siitä.
6. Yksilöllinen tunniste: Käytä aina mahdollisuuksien mukaan yksilöllistä tunnistetta. Vain tätä tunnistetta voidaan käyttää olemassa olevien tietojoukkojen päivittämiseen myöhemmin.

Huomioi seuraavat esimerkit lainausmerkkejä sisältävän tekstin tuonnissa:

Tuotava teksti	Teksti CSV-tiedostossa
”Lainausmerkeillä rajattu teksti tuotavaksi.”	”””Lainausmerkeillä rajattu teksti tuotavaksi.”””
Yksinkertainen teksti, joka sisältää ”lainausmerkkejä”.	”Yksinkertainen teksti, joka sisältää ””lainausmerkkejä””.”
”Lainausmerkeillä rajattu teksti, joka sisältää myös ”lainausmerkkejä”.”	”””Plain text in quotation marks, but which also contains ””quotation marks””.”””
”Tämä on lainaus.” sanoi Henkilö Y.	”””Tämä on lainaus.”” sanoi Henkilö Y.”
Henkilö Y sanoi ”Tämä on lainaus.”	”Henkilö Y sanoi ””Tämä on lainaus.”””

Asetukset

CSV-tuoja tarjoaa useita asetuksia ja vaihtoehtoja, jotka selitetään alla. Lue myös yleiset tiedot ennen tietojen tuontia CSV-tuojalla.

Tuontiasetukset

Ladattuasi tiedoston ”CSV-tiedosto” -kenttään, seuraavat asetukset ovat käytettävissä:

Asetus	Kuvaus
CSV-tiedosto	Valitse ensin CSV-tiedosto tuontia varten. Voit poistaa tiedoston ”X”-painikkeella.
CSV-kenttien nimet	Valitse rivi, jolla sarakkeiden nimet sijaitsevat, jotta niitä ei tuoda tietueina.
Kohdekentän nimi	Valitse rivi, joka sisältää kohdekenttien nimet automaattista tuontikartoitusta varten.
Objektityyppi	Valitse objektityyppi, johon haluat tuoda tiedot.
Pooli	Valitse pooli, johon uudet tietueet luodaan. Pooli asetetaan vain uusille tietueille. Jos olemassa olevia tietueita päivitetään CSV-tuojalla, poolia ei muuteta. Käytä tähän tarkoitukseen ryhmäeditoria.
Maski	Valitse tuonnissa käytettävä maski.
Tiedoston tuontityyppi	Valitse tiedostojen lataustapa. Suora: Tiedosto ladataan ja viedään sitten /eas/put-ohjelmalla. URL (etäkäyttö): Tiedostoa ei ladata, ja /eas/put-osoitteeseen siirrytään suoraan tiedoston URL-osoitteesta. Tiedosto ladataan palvelimelta ja ladataan. (Tämä vaihtoehto on nopein). Ohita tiedostot: Kaikki tiedostot jätetään huomiotta eikä niitä tuoda.
Metatietojen kartoitus	Valitse tiedostoja tuotaessa käytettävä metatietojen kartoitus.
Tunnisteiden tuonti	Valitse, lisätäänkö CSV-tiedoston tunnisteet olemassa oleviin vai korvaavako ne ne.
Päivityskenttä	Valitse kenttä olemassa olevien tietueiden tunnistamiseen ja päivittämiseen.
Lisää sisäkkäisiä arvoja olemassa oleviin arvoihin	Valitse, lisätäänkö CSV-tiedoston sisältö olemassa oleviin sisäkkäisiin kenttiin.
Lisää käänteisiä sisäkkäisiä arvoja olemassa oleviin arvoihin	Valitse, lisätäänkö CSV-tiedoston sisältö olemassa oleviin käänteisiin sisäkkäisiin kenttiin.
Luo linkitettyjä objekteja	Määritä, luodaanko linkitetyt tietueet tuonnin aikana.
Pooli linkitetyille objekteille	Määritä eri poolit linkitetyille tietueille.
Kommentti	Lisää kommentti CSV-tuontiin, joka näkyy tuotujen/päivitettyjen tietueiden muutoshistoriassa.
Eräkoko	Määritä palvelimelle lähetettävien käsittelyerien koko.
Näytä lokalisoidut nimet	Valitse, näytetäänkö Collection Pro -kenttien näyttönimet vai sisäiset kenttänimet.

Tila

Tilan alla näytetään tuonnin yleiskatsaus valmistelun jälkeen. Valintaruutuja käytetään taulukon näkymän suodattamiseen.

Tuontikartoitus

Kentät, joille ei ole valittu kartoitusta, eivät muutu päivitettäessä jo järjestelmässä olevia tietueita. Kentät, joille on valittu kartoitus, mutta joille ei ole sisältöä CSV-tiedostossa, tyhjennetään tietueita päivitettäessä.

Taulukkonäkymä

Taulukkonäkymässä näet CSV-tiedostosi tiedot. Valmistelun ja tuonnin jälkeen lisätietoja lisätään automaattisesti (tunnistettavissa sarakeotsikoista ”fylr|”). Lisätietoja näistä tiedoista löydät tämän ohjeen lopusta ”Protokolla”-osiosta.

Tietueen esikatselu

”Tietueen esikatselu” -välilehdellä näet tiedot, jotka tuotaisiin tuontikartoituksen mukaisesti. Huomaa, että tämä on vain kartoitettujen kenttien esikatselu. Päivitettäessä jo olemassa olevia tietueita lopputulos voi poiketa tästä.

JSON-esikatselu

”JSON-esikatselu” -välilehdellä näet tiedot, jotka tuotaisiin tuontikartoituksen mukaisesti JSON-rakenteessa.

Valinnat

CSV-tuojan alaosassa on seuraavat toiminnot:

Painike	Kuvaus
Lataa uudelleen	Lataa CSV-tiedoston uudelleen ja hylkää kaikki jo valmistellut tiedot.
Tallenna CSV	Valmistelun ja tallennuksen yhteydessä luodaan lisätietoja, jotka kirjoitetaan takaisin CSV-tiedostoosi (katso alla oleva taulukko). ”Lataa CSV” -painikkeella voit tallentaa tämän tiedoston tietokoneellesi.
Lataa asetukset	Lataa määritetyt tuontiasetukset ja tuontikartoituksen JSON-tiedostona.
Tuo asetukset	Tuo JSON-tiedosto, joka sisältää tuontiasetukset ja tuontikartoituksen.
Valmistele	Valmistelee CSV-tuonnin. Tämä sisältää tietojen tarkistuksen sekä olemassa olevien ja linkitettyjen tietueiden etsinnän.
Lisää	Aloittaa varsinaisen CSV-tuonnin ja lisää kaikki uudet tietueet. Jo olemassa olevia tietueita ei päivitetä.
Päivitä	Aloittaa varsinaisen CSV-tuonnin ja päivittää olemassa olevat tietueet. Uusia tietueita ei luoda. Huomaa kuitenkin, että CSV:n tyhjät sarakkeet tyhjentävät näiden kenttien sisällön tietueissa.
Lisää ja päivitä	Suorittaa sekä lisäykset että päivitykset suoraan peräkkäin.

Protokolla

Valmistelun ja tuonnin jälkeen järjestelmä luo tiettyjä tietoja. Nämä voidaan nähdä CSV-tuojan taulukkonäkymässä tai ladata CSV-tiedostona tuonnin jälkeen.

Rivi	Kuvaus
row_idx	Rivin numero, alkaen 0
operation	Suoritettava toiminto (”insert”, ”update”, ”delete”).
status	Tuonnin tila (”valmis”, ”virheellinen”, ”epäonnistunut”, ”valmis”). Riviä, joiden tila on ”virheellinen”, ei voida tuoda (esimerkki: väärä päivämäärämuoto). Rivejä, joiden tila on ”failed”, ei ole tuotu oikein (esimerkki: pakollisen kentän rikkominen).
timestamp	Päivämäärä + kellonaika, jolloin CSV-tuonti/päivitys/poisto tapahtui.
status_text	Sisältää lisätietoja virheestä, joka tapahtui, kun kyseessä on tila ”invalid” ja ”failed”.
warning_text	Sisältää lisätietoja, jos mukautetun tietotyypin kenttiin on yritetty tuoda virheellistä JSONia.
id	Collection Prosta löytyneen tietueen ID (CSV-tuonnilla luotujen tietueiden osalta tämä sarake jää tyhjäksi).
version	Tietueen versio
id_parent	Ylätason ID (vain hierarkkisten objektityyppien osalta).
depth	Tietueen syvyys (vain hierarkkisten objektityyppien osalta), alkaen 0:sta.
path	Tietueen polku (vain hierarkkisten objektityyppien osalta).
eas_ids|file	Sisältää CSV-tuojalla ladatun tiedoston sisäisen EAS-tunnuksen (katso kohta Tuo tiedostoja).
eas_ids|file|metadata	Sisältää metatiedot, jotka on otettu CSV-tuojalla ladatusta tiedostosta (katso kohta Tuo tiedostoja).
object type|mask	Kaikille linkitetyille objektityypeille luodaan erillinen sarake. Valmistelun jälkeen näet, ovatko kyseiset merkinnät jo olemassa (niille näytetään tunniste), ovatko ne äskettäin luotuja (ne näkyvät merkinnällä ”new”) tai, jos vaihtoehto ”Luo linkitettyjä objekteja” on poistettu käytöstä, onko niitä ei löydetty (ne näkyvät merkinnällä ”searching”).