My Archive!

{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Complex objects are an advanced form of ingest workflow in MediaHaven which is not available to all customers. ","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Complete Example","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"dfee226f-b141-4a28-b4e6-a8a6b2960f91","collection":"contentId-71281785","type":"file"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"KB_JB306_1915-02-19_01.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n BELSPO\n \n \n KBR\n \n \n \n \n \n \n \n \n My Archive!\n My description about the archive\n \n \n \n \n \n \n \n \n \n \n My PDF!\n My description about the pdf\n \n \n \n \n \n \n \n \n \n \n \n \n \n KBR-Events\n 8545875115\n \n OCR creation\n 2014-10-21\n\t\t\t\t Detailed info\n \n y\n \n \n KBR-Employee\n John Doe\n \n \n KBR-ID\n KB_JB306_1915-02-19_01-mets\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 \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":"heading","attrs":{"level":2},"content":[{"text":"Requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"The following requirements are imposed by the Complex Ingest workflow that go beyond the well-formatted XML and the validation by the provided XSDs.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every file in the archive must be referenced by the METS. If files are not referenced or if a referenced file is missing, the entire archive is rejected.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The MD5 checksums provided in the XML are compared against the calculated MD5 checksums. The entire archive is rejected if one check fails.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The file paths used in the METS are paths relative to the root the accompanying archive.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"METS Validation","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"70f8cc22-664b-46d9-ba08-3c19bbe3d8fc","collection":"contentId-71281785","type":"file"}}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"5df6fda9-4921-4300-bf00-6ea0e2ec5437","collection":"contentId-71281785","type":"file"}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not use a default namespace for the METS tags but use the explicit namespace prefix ","type":"text"},{"text":"mets","type":"text","marks":[{"type":"code"}]},{"text":", e.g. ","type":"text"},{"text":"mets:agent","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"exactly one","type":"text","marks":[{"type":"strong"}]},{"text":" tag ","type":"text"},{"text":"mets:fileGrp","type":"text","marks":[{"type":"code"}]},{"text":" under which all tags ","type":"text"},{"text":"mets:file","type":"text","marks":[{"type":"code"}]},{"text":" are placed. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The value of the attribute ID is of the type xsd:id which means it must be ","type":"text"},{"text":"unique","type":"text","marks":[{"type":"strong"}]},{"text":" accross the XML document and be a valid CNAME. ","type":"text"},{"text":"This means that it must start with a letter or underscore, and can only contain letters, digits, underscores, hyphens, and periods. More info ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.datypic.com/sc/xsd/t-xsd_ID.html"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The tag ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" must be provided with the self-closed tag ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" in order have a valid METS XML.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"TIP","type":"text"}]},{"type":"paragraph","content":[{"text":"It is important to validate the METS which you generate with the provided XSDs ","type":"text"},{"text":"before","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" uploading them to the platform. This will prevent the need for fixing common errors. You can validate the XML using online tools, for example: ","type":"text"},{"text":"http://www.xmlvalidation.com/","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.xmlvalidation.com/"}}]},{"text":". It is important that you place the XSD xlink.xsd in the same folder as mets.xsd.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Common mistakes","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"The value of the attribute ID must be a valid XML tag name which has the following rules:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Must start with a letter or underscore","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cannot start with the letters xml (or XML, or Xml, etc)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Can contain letters, digits, hyphens, underscores, and periods","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Cannot contain spaces","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Because the value of the attribute ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"xlink:href","type":"text","marks":[{"type":"code"}]},{"text":" must be a valid URI, you will have to URI encode its value if the path to the file contains illegal URI symbols such as ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"?","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"%","type":"text","marks":[{"type":"code"}]},{"text":" etc.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step-by-step building of the METS","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The XML Header","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"XML Header","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The XML header contains the different namespaces using in METS, namely ","type":"text"},{"text":"mets","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"xlink","type":"text","marks":[{"type":"code"}]},{"text":". MediaHaven validates the METS with the XSDs provided on this page regardless of the URI provided in the optional tag ","type":"text"},{"text":"xsi:schemaLocation","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The METS header","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"METS Header","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n BELSPO\n \n \n KBR\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The METS header is mandatory must at least provide one agent.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The File Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes the ","type":"text"},{"text":"each and every file","type":"text","marks":[{"type":"strong"}]},{"text":" in the archive, no exceptions.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"File Section","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n ... \n ... \n ... \n\t \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Single File Section","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes a single file through a number of attributes and the relative path in the ZIP archive. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Single File Section","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Metadata"},"legacyAnchorId":{"value":"ComplexObjectsReference-Metadata"}},"macroMetadata":{"macroId":{"value":"bbd775a2-d146-4322-a063-94d2ef09deb1"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"427e0f6f-fce6-4b64-8493-566b85a7e6f5"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Metadata","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n \n My Archive!\n My description about the archive\n \n \n \n \n\n \n \n \n \n \n My PDF!\n My description about the pdf\n \n \n \n \n \n...\n\n \n \n ...\n \n \n ...\n \n ..","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Premis"},"legacyAnchorId":{"value":"ComplexObjectsReference-Premis"}},"macroMetadata":{"macroId":{"value":"ce7e111f-902d-4cda-9e92-5df424a2ab3a"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"18831865-c488-4daa-912c-0351dd81283c"}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Events","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n \n \n KBR-Events\n 8545875115\n \n OCR creation\n 2014-10-21\n\t\t\t\t Detailed info\n \n y\n \n \n KBR-Employee\n John Doe\n \n \n KBR-ID\n KB_JB306_1915-02-19_01-mets\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":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Because the value of the attribute ","type":"text"},{"text":"xlink:href","type":"text","marks":[{"type":"code"}]},{"text":" must be a valid URI, you will have to URI encode its value if the path to the file contains illegal URI symbols such as ","type":"text"},{"text":"?","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"%","type":"text","marks":[{"type":"code"}]},{"text":" etc.","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ID: The value if of the type xsd:id which means it must be ","type":"text"},{"text":"unique","type":"text","marks":[{"type":"strong"}]},{"text":" accross the XML document and it ","type":"text"},{"text":"must start with a letter or underscore, and can only contain letters, digits, underscores, hyphens, and periods. More info ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.datypic.com/sc/xsd/t-xsd_ID.html"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CHECKSUMTYPE: Fixed value \"MD5\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CHECKSUM: The MD5 checksum of the referenced file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"USE: PRESERVATION, FIXITY, VIRTUAL, see ","type":"text"},{"text":"Complex Objects Reference","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=71281785"}}]},{"text":" for more information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MIMETYPE: Optional parameter","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"xlink:href: The path provided here must","type":"text"},{"text":" be relative to the root of the archive","type":"text","marks":[{"type":"strong"}]},{"text":". See the concrete example archive below to evaluate this requirement. Using other values for path will cause the METS to be rejected because the referenced files will not be found inside the archive.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ADMID:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you provide as value the ID of a ","type":"text"},{"text":"mets:sourceMD","type":"text","marks":[{"type":"code"}]},{"text":" in the METS, the embedded XML under this tag will be used a sidecar metadata for the referenced file. In the example above the values ","type":"text"},{"text":"METADATA-SIP","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"METADATA-PDF","type":"text","marks":[{"type":"code"}]},{"text":" refer to matching embedded sidecars in the format ","type":"text"},{"text":"MediaHAVEN_external_metadata","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you provide as value the ","type":"text"},{"text":"ID","type":"text","marks":[{"type":"code"}]},{"text":" of a ","type":"text"},{"text":"mets:digiprovMD","type":"text","marks":[{"type":"code"}]},{"text":" in the METS, the embedded Premis event under this tag will be recognized by MediaHaven and be visible in the future metadata exports for this file. In the above example the values ","type":"text"},{"text":"PREMIS-EVENT-01","type":"text","marks":[{"type":"code"}]},{"text":" and PREMIS-EVENT-02 refer to matching embedded Premis events.","type":"text"}]}]}]}]}]}],"version":1}

Browser not supported