{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Sample package: ","type":"text"},{"text":"sample_package.zip","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/download/attachments/2589662/sample_doknavet_package.zip?version=1&modificationDate=1699372829000&cacheVersion=1&api=v2"}}]}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"2589662"}},"macroMetadata":{"macroId":{"value":"613f6677-34df-412d-854c-adfd63b28c1c"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a6adc5d5-2788-422e-ba8f-29ad2cd92977"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"DokumentNavet package content and structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Package for upload to HDC have to be a ","type":"text"},{"text":".zip ","type":"text","marks":[{"type":"strong"}]},{"text":"file. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"This ","type":"text"},{"text":".zip","type":"text","marks":[{"type":"strong"}]},{"text":" file should have ","type":"text"},{"text":"top folder","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":" of any name and inside all files for import like ","type":"text"},{"text":"TIF","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"TAF's","type":"text","marks":[{"type":"strong"}]},{"text":" (raster files) and ","type":"text"},{"text":"XML","type":"text","marks":[{"type":"strong"}]},{"text":" files (configuration files). ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":7274,"__fileMimeType":"image/png","width":486,"id":"cd202ed0-36ee-47b3-9d43-afb04a010837","collection":"contentId-2589662","type":"file","__fileName":"image2015-12-4 11:45:17.png","height":124}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":78427,"__fileMimeType":"image/png","width":597,"id":"f2220127-23f8-4afb-8026-694b46cfc621","collection":"contentId-2589662","type":"file","__fileName":"image2015-9-24 10:9:47.png","height":548}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Package XML content","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note the header and provided ID","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"ExternalId will be returned in the import report so that each document can be identified in the external system.","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"This is unusual change in basic rule, where we store only one external ID.","type":"text"}]},{"type":"paragraph","content":[{"text":"For DocNavet purposes, we have:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"External document ID + HyperDoc ID that is passed from DokNavet","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If HyperDoc ID is not passed, a new document is created","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In that case, HyperDoc ID is already an external ID, but if DokNavet does not have HyperDoc ID stored yet, we need additional \"external ID\" so that we are able to match the document data sent back from HyperDoc once it was added. After update, we will send back both External and HyperDoc ID (as EID ID - see external domain configuration and TOBIS section).","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: Normally, we would receive \"external object\" with its ID. We would register that ID as external and recognize it with future requests. Since we needed support for legacy documents exported to HyperDoc Classic, this \"double ID\" solution was added.","type":"text"}]},{"type":"paragraph","content":[{"text":"Documents matching logic:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If ID is present in source XML and object with such ID is found in target database then this object is updated.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If ID is present in source XML but there is no such object in target database new object is created with ID from XML.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if ID is not present in XML then new object is created with random ID.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"External Domain configuration","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Importing process","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Correct Object Structure for Import in Tree","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Before importing make sure you have correct object structure visible in a Tree view Tesslet.","type":"text"}]},{"type":"paragraph","content":[{"text":"This import will import only documents.","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Structure must be prepared based on information provided in ","type":"text"},{"text":"xml ","type":"text","marks":[{"type":"strong"}]},{"text":"files. Matching for hierarchy is done in non case-sensitive matter. ","type":"text"},{"type":"hardBreak"},{"text":"But imported documents are matched case sensitive.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Below, screen presenting correct structure for sample Dokumentnavet package.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":78939,"__fileMimeType":"image/png","width":1171,"id":"9299c12e-b709-4ec9-a065-8dbbe1017e2d","collection":"contentId-2589662","type":"file","__fileName":"image2015-9-23 14:32:43.png","height":909}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Uploading package","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":441,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":14782,"__fileMimeType":"image/png","width":352,"id":"a57a1ca0-c906-4ea2-af57-4495c562e7ec","collection":"contentId-2589662","type":"file","__fileName":"image2015-9-23 14:27:52.png","height":250}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Import process","type":"text"}]},{"type":"paragraph","content":[{"text":"Choosing correct Perspective in which Objects structure is ready) is crucial for this import to perform.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":441,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":18578,"__fileMimeType":"image/png","width":467,"id":"fc172ea4-b402-402c-878c-44b2a6f3e7e0","collection":"contentId-2589662","type":"file","__fileName":"image2015-12-4 11:19:6.png","height":381}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Matching Objects Example","type":"text"}]},{"type":"paragraph","content":[{"text":"Looking at the sample import package, we can see the following linking path:","type":"text"}]},{"type":"paragraph","content":[{"text":"F101 -> B -> 20","type":"text","marks":[{"type":"textColor","attrs":{"color":"#3366ff"}},{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"HDC requires, that the first object is unique. We will look for object of indicated class and value F101.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":33021,"__fileMimeType":"image/png","width":711,"id":"c3d1787d-3559-4cd5-811c-77c5a8106e43","collection":"contentId-2589662","type":"file","__fileName":"image2016-2-11 12:30:42.png","height":319}}]},{"type":"paragraph","content":[{"text":"Coresponding structure should be present in HDC database:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":28229,"__fileMimeType":"image/png","width":367,"id":"eb7ac926-ac94-4240-9208-164a6518dd8f","collection":"contentId-2589662","type":"file","__fileName":"image2016-2-11 12:31:2.png","height":331}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"For Fastighet, we indicate field prop_fullname as our target field with (label Popularnamn) – Match OK","type":"text"},{"type":"hardBreak"},{"text":"F101","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"-> B -> 20","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":16078,"__fileMimeType":"image/png","width":346,"id":"29d7fcd4-bd98-4a43-a328-799c8cd50ae7","collection":"contentId-2589662","type":"file","__fileName":"image2016-2-11 12:31:18.png","height":220}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"For Bygnad, we indicate field: struct_custom1 -> label Nummer","type":"text"}]},{"type":"paragraph","content":[{"text":"F101 -> ","type":"text","marks":[{"type":"strong"}]},{"text":"B","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}},{"type":"strong"}]},{"text":" -> 20","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Match for object B would FAIL in that case. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":11542,"__fileMimeType":"image/png","width":329,"id":"b106494d-3b08-42ac-ad92-7517bbafb281","collection":"contentId-2589662","type":"file","__fileName":"image2016-2-11 12:31:30.png","height":165}}]},{"type":"paragraph","content":[{"text":"Other object should be matched in similar way. Please note, that HDC will take a source field indicated in the package, look for mapping as configured for given domain, and at the end try to match object by specified field. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DocumentNavet import to change class of matched object","type":"text"}]},{"type":"paragraph","content":[{"text":"New import option ","type":"text"},{"text":"Convert class of objects matched by Guid Field","type":"text","marks":[{"type":"strong"}]},{"text":" for DocumentNavet type of import has been added. ","type":"text"}]},{"type":"paragraph","content":[{"text":"When used, if imported document is matched by Guid Field (present already in database) and it's class is different in incoming package (than in actual state of database) then document class will change along with any other update.","type":"text"},{"type":"hardBreak"},{"text":"Both document subclasses must be added in External Domain configuration.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"After conversion it will still be same object (same hdid) but with different class after import.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":444,"widthType":"pixel"},"content":[{"type":"media","attrs":{"__fileSize":42072,"__fileMimeType":"image/png","width":526,"id":"4ce7c111-bf72-4265-acb9-74a2c0b8c030","collection":"contentId-2589662","type":"file","__fileName":"image2022-3-30_12-12-39.png","height":714}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Currently the change is cross-version. That is, once object's class is changed it will be changed in all versions of database. As if it always was of this new class.","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}