Document toolboxDocument toolbox

(sv) Dataimport från DokumentNavet

 

Paketinnehåll och struktur för Dokumentnavet

Paket som överförs till FMA måste vara i .zip- filsformat. 

Denna .zip- fil ska ha en toppmapp med valfritt namn som ska innehålla alla filer för import, som t.ex. TIF- , TAF- (rasterfiler) och XML-filer (konfigurationsfiler). 




 

XML-innehåll i paket

<?xml version="1.0" encoding="utf-8"?> <HDocDatabase> <LogDocs> <LogDoc ID="" ExternalId="d423f317-01d7-4953-a6b1-cca1f105cad2" Status="add" DocType="VENTILATION"> <DocAttr Name="hd_docname" Value="V57.1-002" /> <DocAttr Name="hd_docfilename" Value="V57-1-002.dwg" /> <DocAttr Name="hd_docdescr" Value="ENTRÉPLAN 0tr, LUFTBEHANDLING " /> <DocAttr Name="hd_docrevdescr" Value="" /> <DocAttr Name="hd_docdate" Value="2009-01-16" /> <DocAttr Name="hd_docrevdate" Value="2012-04-19" /> <DocAttr Name="hd_scale_id" Value="1:100" /> <DocAttr Name="hd_consname" Value="" /> <DocAttr Name="hd_projnr" Value="" /> <DocAttr Name="hd_doccustom1" Value="" /> <DocAttr Name="hd_doccustom2" Value="" /> <DocAttr Name="hd_doccustom3" Value="" /> <DocAttr Name="hd_doccustom4" Value="A1" /> <DocAttr Name="document_type_id" Value="Ventilation" /> <PhysDoc AttachFrom="V57-1-002-V57-1-011.tif" Status="add" /> </LogDoc> </LogDocs> <Links> <ObjDocLinks> <Link Status="add"> <LogDoc ID="" /> <DBObject Type="hdv_h1_prop"> <ObjectAttr Name="fi2prop_name" Value="2394 - Dragarbrunn 20:2" /> <DBObject Type="hdv_h1_struct"> <ObjectAttr Name="fi2struct_name" Value="01" /> <DBObject Type="hdv_h1_floor"> <ObjectAttr Name="fi2spsys_name" Value="01" /> </DBObject> </DBObject> </DBObject> </Link> </ObjDocLinks> </Links> </HDocDatabase>

Observera rubrik och angivet ID

<LogDoc ID="" ExternalId="d423f317-01d7-4953-a6b1-cca1f105cad2" Status="add" DocType="VENTILATION">

ExternalID anges i importrapporten vilket innebär att alla dokument kan identifieras i det externa systemet.

Det är ett undantag från den grundläggande regeln där endast ett externt ID lagras.

För DokNavet-syften finns:

  • Externt dokument-ID + FMA-ID som överförs från Dokumentavet

  • Om FMA-ID inte skickas med skapas ett nytt dokument.

Om så är fallet är FMA-ID redan ett externt ID, men om Dokumentavet inte har lagrat FMA-ID än krävs ett extra "externt ID" så att dokumentdata som skickas tillbaka från FMA kan matchas när det har lagts till. Efter uppdateringen kommer både externt ID och FMA-ID att skickas tillbaka (som EID ID – se avsnitten konfiguration av extern domän och TOBIS).

OBS! I normala fall erhållsFMA ett "externt objekt" med dess ID. ID registreras som externt och känns igen för framtida begäran. Eftersom support krävs för äldre dokument som exporteras till FMA Classic lades denna lösning med "dubbla ID" till.

 

Konfiguration för extern domän

 

 

Importprocess

Korrekt objektstruktur för import till träd

 

Kontrollera först att den korrekta objektstrukturen visas i "Trädvyn".

Denna import kommer endast att innehålla dokument.

 

Strukturen måste förberedas utifrån information som anges i xml-filerna .

 

 

Skärmen nedan visar korrekt struktur för provpaketet från Dokumentnavet.

Ladda upp paket

 

Importprocess

Det är mycket viktigt att rätt Perspektiv (med fullständig objektstruktur) väljs för att importen ska fungera.

Exempel på objektmatchning

I provimportpaketet finns följande länksökväg:

F101 -> B -> 20


Det första objektet måste vara unikt. Objekt av den angivna klassen med värdet F101 söks.

Motsvarande struktur måste finnas i FMA-databasen:

 

För Fastighet, anges fältet prop_fullname som målfält med (etikett Popularnamn) – Match OK
F101 -> B -> 20

 

För Byggnad anges fält: struct_custom1 -> etikett, nummer

F101 -> B -> 20

Matchning för objekt B skulle misslyckas i detta fall. 

Övriga objekt måste matchas på samma sätt. Observera att FMA tar ett källfält som anges i paketet och söker efter mappning som konfigurerats för en given domän och försöker matcha objekten efter de specificerade fälten. 

DokumentNavet import kan ändra objektklass för befintligt objekt

Alternativet Konvertera objektklass som matchas med ID fält kan användas om objekt som matchas via ID-fält vid importen kommer som en annan objektklass än den som redan finns i FM Access databas.

Både tidigare objektklass och den nya måste finnas definierad i importdomänen för att detta ska fungera. 

Efter konverteringen kommer objektet att vara detsamma som innan (samma hdid behålls) men objekklassen kommer att vara den som angavs i importpaketet.

Ändring av objektklass kommer att göras för ALLA versioner, dvs objektet kommer att tillhöra den "nya" objektklassen även i tidigare versioner av databasen.