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
- 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.
- Kolumnavgränsare: Kolumner kan avgränsas med kommatecken, semikolon eller tabb. CollectionPro upptäcker automatiskt avgränsaren.
- Hantering av text: Text som innehåller kommatecken, semikolon, tabbar eller radbrytningar ska omges av citattecken. CollectionPro upptäcker detta automatiskt.
- 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).
- 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.
- 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 importeras | Text 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ällning | Beskrivning |
|---|---|
| Välj först den CSV-fil som ska importeras. Du kan ta bort filen med ”X”-knappen. | |
| CSV-fältnamn | Välj den rad där kolumnnamnen finns så att de inte importeras som poster. |
| Målfältets namn | Välj den rad som innehåller namnen på målfälten för automatisk importmappning. |
| Objekttyp | Välj den objekttyp som du vill importera data till. |
| Pool | Vä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. |
| Mask | Välj den mask som ska användas för importen. |
| Filuppladdningstyp | Vä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. |
| Metadatamappniningar | Välj den metadatamappning som ska användas vid import av filer. |
| Importera taggar | Välj om taggar från CSV-filen ska läggas till eller ersätta befintliga taggar vid uppdatering av poster. |
| Uppdatera fält | Välj ett fält för att identifiera och uppdatera befintliga poster. |
| Lägg till kapslade värden i befintliga värden | Vä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ärden | Välj om du vill lägga till innehållet i CSV-filen i befintliga inverterade kapslade fält. |
| Skapa länkade objekt | Ange om du vill skapa länkade poster under importen. |
| Pool för länkade objekt | Ställ in olika pooler för de länkade posterna. |
| Kommentar | Lägg till en kommentar till CSV-importen som visas i ändringshistoriken för importerade/uppdaterade poster. |
| Paketstorlek | Storleken 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 namn | Vä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:
| Knapp | Beskrivning |
|---|---|
| Ladda om | Läs in CSV-filen på nytt och ta bort alla data som redan har förberetts. |
| Spara CSV | Under 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ällningar | Ladda ner de konfigurerade importinställningarna och importmappningen som en JSON-fil. |
| Ladda upp inställningar | Importera en JSON-fil som innehåller importinställningarna och importmappningen. |
| Förbered | Förbereder CSV-importen. Detta inkluderar datavalidering och sökning efter befintliga och länkade poster. |
| Infoga | Startar den faktiska CSV-importen och lägger till nya poster. Poster som redan finns kommer inte att uppdateras. |
| Uppdatera | Startar 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 uppdatera | Utfö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.
| Rad | Beskrivning |
|---|---|
row_idx | Radnummer, från 0 |
| operation | En åtgärd som ska utföras (”infoga”, ”uppdatera”, ”ta bort”). |
| status | Importstatus (”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). |
| timestamp | Datum + tid då CSV-importen/uppdateringen/borttagningen inträffade. |
| status_text | Innehåller mer information om felet som uppstod vid statusarna ”ogiltig” och ”misslyckad”. |
| warning_text | Ger ytterligare information om ett försök har gjorts att importera ogiltig JSON till fält av en anpassad datatyp. |
| id | ID för posten som finns i CollectionPro (för poster som skapats med CSV-importören kommer den här kolumnen att vara tom). |
| version | Postens version |
| id_parent | Överordnat ID (endast för hierarkiska objekttyper). |
| depth | Postdjup (endast för hierarkiska objekttyper), med början från 0. |
| path | Sökvägen till posten (endast för hierarkiska objekttyper). |
| eas_ids|file | Innehå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|metadata | Innehåller metadata som hämtats från en fil som laddats upp med hjälp av CSV-importören (se Importera filer). |
| object type|mask | En 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”). |