CSV-importör

CSV-importör

CSV-importören kan användas för att importera och uppdatera stora mängder data till CollectionPro-systemet. Det kan handla om enkla listor, hierarkisk tesaurus eller bild- och objektdata.

Du kan till exempel skapa data i Microsoft Excel, Apple Numbers eller Notepad++. Om du arbetar med Excel eller Numbers bör du spara data i .csv format med UTF-8- eller UTF-16-kodning innan du importerar. Filtyperna .xls, .xlsx eller .numbers stöds inte .

Allmän information

  1. Kodning: CSV-filen måste vara kodad i antingen UTF-8- eller UTF-16-format. Detta säkerställer att bokstäver som å, ä, ö och specialtecken importeras korrekt.
  2. Kolumnavgränsare: Kolumner kan avgränsas med kommatecken, semikolon eller tabb. CollectionPro upptäcker automatiskt avgränsaren.
  3. Hantering av text: Text som innehåller kommatecken, semikolon, tabbar eller radbrytningar ska omges av citattecken. CollectionPro upptäcker detta automatiskt.
  4. Kolumnrubriker: CSV-filen skall innehålla kolumnrubriker. Du kan välja rubriker fritt, men du måste manuellt mappa käll- och destinationsfälten (se inställningar).
  5. Automatisk fältmappning: Om du använder CollectionPros interna fältnamn som kolumnrubriker i CSV-filen mappas fälten automatiskt. Det enklaste sättet att få de interna fältnamnen är att först ladda ned en post i CSV-format och kopiera kolumnrubrikerna från den.
  6. Unik identifierare: Använd alltid en unik identifierare när det är möjligt. Endast den här identifieraren kan användas för att uppdatera befintliga datauppsättningar senare.

Notera följande exempel när du importerar text med citattecken:

Text som ska importerasText i CSV-filen
”Text inom citattecken för import.””””Text inom citattecken för import.”””
En enkel text som innehåller ”citattecken”.”Enkel text som innehåller ”citattecken””.”
”Text inom citattecken som också innehåller ”citattecken”.””””Text inom citattecken som också innehåller ”citattecken”.”””
”Det här är ett citat”, sa person Y.“””Det här är ett citat.”” sa person Y.”
Person Y sa: ”Det här är ett citat.””Person Y sa ”Det här är ett citat.”””

Inställningar

CSV-importören erbjuder flera inställningar och alternativ, som förklaras nedan. Läs också den allmänna informationen innan du importerar data med hjälp av CSV-importören.

Importera inställningar

När du har laddat upp filen till fältet ”CSV-fil” är följande alternativ tillgängliga:

InställningBeskrivning
Välj först den CSV-fil som ska importeras. Du kan ta bort filen med ”X”-knappen.
CSV-fältnamnVälj den rad där kolumnnamnen finns så att de inte importeras som poster.
Målfältets namnVälj den rad som innehåller namnen på målfälten för automatisk importmappning.
ObjekttypVälj den objekttyp som du vill importera data till.
PoolVälj den pool där du vill skapa nya poster. Poolen är endast inställd för nya poster. Om befintliga poster uppdateras med hjälp av CSV-importören ändras inte poolen. Använd gruppredigeraren för detta ändamål.
MaskVälj den mask som ska användas för importen.
FiluppladdningstypVälj hur du vill ladda upp dina filer.
Direkt: Filen laddas ned och importeras sedan med hjälp av /eas/put.
URL (fjärråtkomst): Filen kommer inte att laddas ned och /eas/put-adressen kommer att nås direkt från filens URL. Filen laddas från servern och importeras. (Det här alternativet är det snabbaste).
Ignorera filer: Alla filer ignoreras och importeras inte.
MetadatamappniningarVälj den metadatamappning som ska användas vid import av filer.
Importera taggarVälj om taggar från CSV-filen ska läggas till eller ersätta befintliga taggar vid uppdatering av poster.
Uppdatera fältVälj ett fält för att identifiera och uppdatera befintliga poster.
Lägg till kapslade värden i befintliga värdenVälj om du vill lägga till innehållet i CSV-filen i befintliga kapslade fält.
Lägg till inverterade kapslade värden till befintliga värdenVälj om du vill lägga till innehållet i CSV-filen i befintliga inverterade kapslade fält.
Skapa länkade objektAnge om du vill skapa länkade poster under importen.
Pool för länkade objektStäll in olika pooler för de länkade posterna.
KommentarLägg till en kommentar till CSV-importen som visas i ändringshistoriken för importerade/uppdaterade poster.
PaketstorlekStorleken på bearbetningsbitarna som skickas till servern. Vid mycket komplexa datamodeller och datavolymer kan en timeout inträffa. Försök i så fall att använda en mindre paketstorlek.
Visa lokaliserade namnVälj om du vill visa visningsnamn eller interna fältnamn för CollectionPro-fält.

Status

Statusen visar en översikt över importen efter förberedelsen. Kryssrutorna används för att filtrera visningen av tabellen.

Importera mappning

Fält som inte är mappade kommer inte att ändras när du uppdaterar poster som redan finns i systemet. Fält som har mappats men som inte har något innehåll i CSV-filen rensas när posterna uppdateras.

Tabellvy

I tabellvyn kan du se data i din CSV-fil. Efter förberedelse och import läggs ytterligare information till automatiskt (känns igen på kolumnrubrikerna ”fylr|”). Mer information om det här finns i avsnittet ”Protokoll” i slutet av den här artikeln.

Förhandsgranskning av post

I fliken ”Förhandsgranskning av post” kan du se de data som skulle importeras enligt importmappningen. Observera att detta bara är en förhandsgranskning av mappade fält. När du uppdaterar befintliga poster kan slutresultatet bli annorlunda.

JSON förhandsgranskning

I fliken ”JSON-förhandsgranskning” kan du se de data som skulle importeras enligt importmappningen i JSON-schemat.

Alternativ

Längst ner i CSV-importören hittar du följande funktioner:

KnappBeskrivning
Ladda omLäs in CSV-filen på nytt och ta bort alla data som redan har förberetts.
Spara CSVUnder förberedelsen och sparandet skapas ytterligare data och skrivs tillbaka till din CSV-fil (se tabellen nedan). Med knappen ”Ladda ner CSV” kan du spara den här filen på din dator.
Ladda ner inställningarLadda ner de konfigurerade importinställningarna och importmappningen som en JSON-fil.
Ladda upp inställningarImportera en JSON-fil som innehåller importinställningarna och importmappningen.
FörberedFörbereder CSV-importen. Detta inkluderar datavalidering och sökning efter befintliga och länkade poster.
InfogaStartar den faktiska CSV-importen och lägger till nya poster. Poster som redan finns kommer inte att uppdateras.
UppdateraStartar den faktiska CSV-importen och uppdaterar de befintliga posterna. Inga nya poster skapas. Observera dock att tomma kolumner i CSV-filen rensar innehållet i dessa fält i posterna.
Lägg till och uppdateraUtför både infogning och uppdatering direkt i följd.

Protokoll

Efter förberedelse och import genererar systemet viss information. Dessa kan ses i CSV-importörens tabellvy eller laddas ner som en CSV-fil efter importen.

RadBeskrivning
row_idx
Radnummer, från 0
operationEn åtgärd som ska utföras (”infoga”, ”uppdatera”, ”ta bort”).
statusImportstatus (”klar”, ”ogiltig”, ”misslyckad”, ”slutförd”). Det går inte att importera en rad med statusen ”ogiltig” (t.ex. felaktigt datumformat). Rader som har statusen ”misslyckades” importeras inte korrekt (t.ex. överträdelse av ett obligatoriskt fält).
timestampDatum + tid då CSV-importen/uppdateringen/borttagningen inträffade.
status_textInnehåller mer information om felet som uppstod vid statusarna ”ogiltig” och ”misslyckad”.
warning_textGer ytterligare information om ett försök har gjorts att importera ogiltig JSON till fält av en anpassad datatyp.
idID för posten som finns i CollectionPro (för poster som skapats med CSV-importören kommer den här kolumnen att vara tom).
versionPostens version
id_parentÖverordnat ID (endast för hierarkiska objekttyper).
depthPostdjup (endast för hierarkiska objekttyper), med början från 0.
pathSökvägen till posten (endast för hierarkiska objekttyper).
eas_ids|fileInnehåller det interna EAS-ID:t för filen som laddats upp med hjälp av CSV-importören (se Importera filer).
eas_ids|file|metadataInnehåller metadata som hämtats från en fil som laddats upp med hjälp av CSV-importören (se Importera filer).
object type|maskEn separat kolumn skapas för varje länkad objekttyp. Efter förberedelse kommer du att kunna se om posterna i fråga redan finns (de kommer att markeras), om de är nyligen skapade (de kommer att markeras som ”nya”) eller, om alternativet ”Skapa länkade objekt” är inaktiverat, om de inte har hittats (de kommer att visas som ”söker”).
Var artikeln till hjälp?