Document toolboxDocument toolbox

(sv) Dataimport från MS Excel

Zip-paket med Excel-filer för import  

Zip-paketstruktur

.zip-paket ska innehålla följande en toppmapp med följande innehåll:

  1. Formatmallsfil .xlsm
  2. Den mapp som utgör den högsta hierarkiklassen, som anges (med kolumnnamn) i formatmallsfilen. 
    Till exempel innehåller provpaketet formatmallen "METADATAREG_Hamnen11- 12.xlsm" och toppnivåklassen är Fastighet.

Excelblad

Calculating path to imported file from stylesheet

Zip-paketet ska innehålla mappstruktur och filer som ska importeras.

Mappstruktur och filnamn ska motsvara specifika kolumnnamn i xls-formatmallen:

  • Sökväg – Relativ sökväg (till Excel-fil) som anger mapp som innehåller de filer som ska importeras.
  • Filnamn – Namnet på en fil som ska importeras till den mapp som anges i kolumnen Sökväg .
  • Ext Filtillägg som anges i kolumnen Filnamn .

 

[Sökväg] \ [Filnamn] [Ext.] exempel: [Hamnen 11-12\Arkitekt\Raster] \ [10000086] [.cal]

Alla kolumner måste anges för alla dokumentobjekt som ska importeras, i den ordning som du vill att importerade xls-filer ska placeras i zip-paketet.

Observera att alla kolumner är skiftlägeskänsliga – Var noggrann när du skapar kalkylbladet.

Konfigurationsguide för extern domän

  • Skapa extern domän för Excel 
  • Alla klasser som nämns i formatmallsfilens kolumner ska läggas till i den externa domänkonfigurationen med identifierande fält specificerade i fliken Klassfält.
  • För de klasser som endast anges per kolumn i XLS-formatmallen (som t.ex. Fastighet) kan du utgå ifrån att identifieraren är Objekt-ID.
  • Fältmappning måste läggas till mellan källobjekt och målobjekt så att FM Access vet vilket fält i den mottagande objektklassen som ska användas för att matcha objekttypen. För detta används kolumnen Dokumenttyp

important

 För dokumentklasser som har rader som anger dokumentobjekt listade xls-formatmallen måste identifieraren vara Filnamn.

 

 

Exempel på domänkonfiguration för den externa klassen "Fastighet"

Fliken Objektklasser

Följande exempel visar alla klasser som krävs för import, baserad på formatmallen "METADATAREG_Hamnen11- 12.xlsm"

Fliken Objektmappning

Glöm inte att lägga till mappning till alla obligatoriska fält från källklassfälten.

Vid import från Excel används mappning för att identifiera objekt. Eftersom Excel-filer inte innehåller några ID som är unika eller kända för FM Access måste ett fält som används för matchning anges. 

I de flesta fall är detta även ett Etikettfält (etikettfält kan identifieras i Administratörspanelen under klasskonfiguration).

 

Fliken Objektidentitet (TOBIS)

Tänk på att specificera Identitetsfält för alla importerade klasser.

Importprocess

Överföring av .zip-paket, Excel

Överföring genomförs med knappen Överför .
Välj XLS i Importtyp.

 

Importera dokument från Excel-paket

 

  1. Skapa erforderliga trädobjekt (i exemplet behövs Fastighet, hus och plan )



  2. Gå till importpanelen och fyll i Importformuläret



    Rotobjektets ID och klass ska hänvisa till det objekt i Trädperspektivet som är överordnat toppnivåobjekt för import (i vårt exempel det överordnade objektet för Fastighet)



  3.  Klicka på knappen Importera och kontrollera resultatet i fliken Importlogg

 Felsökning 

  • Den vanligaste situationen är när ett dokument som ska importeras från XLS-ark inte kan kopplas till målobjekt i Trädet eftersom  objektet inte finns skapat i databasen.

Ovanstående situation kommer att resultera i importstatus Avslutad med fel. I avsnittet Rapporter kommer Objektfliken att lista fram dokument som inte har importerats. 

Felmeddelande kommer att visas och kommer innehålla namnet på objekt som inte hittades i databasen.

exempel på felmeddelande:

Hierarchy matching for object failed during matching: id Rotundan 3/Byggnad 1/Plan 01 - KV -3TR, source class 105 and destination: id 006537225584, destination class 110

Ovanstående felmeddelande betyder att ett dokument med externt ID 006537225584 (FM Access-destinationsklass 110) inte kan kopplas till objekt av klass 105 som har sökvägen Rotundan 3 / Byggnad 1 / Plan 01 - KV -3TR i Perspektiv som används för import. I detta fall existerade inte Plan 01 - KV -3TR.

  • TOBIS-fältet är inte inställt för klass - detta kommer att rapporteras under omatchad-fliken
  • Objekt som finns i XLS-arket men utan mappning i domänkonfiguration - kommer att rapporteras under omatchad-fliken

  • Dokument tillagt men innehållet saknas- Detta kan inträffa när sökvägen till filen (som består av 3 kolumner i excel) inte är fullt ifylld. Sådan situation kommer att vara synlig både under Objekt och omatchade-fliken i importrapporten.

XLS-formatmallen måste vara i .xlsm-format.


Provpaket: sample_package.zip

 

 

 

Välj rätt Perspektivurval med passande Perspektiv och dess tillgängliga klasser för att se de importerade dokumenten.