Key Resources
XML file contribution
If your tech team can generate structured information about your content as an XML file, you can contribute to the Digital New Zealand search and data sharing gateway (API access) this way.
What XML schemas does DigitalNZ accept?
Generally if it is valid and well formed XML, we can work with it. We don’t prescribe particular schemas.
So far we’ve worked with:
- RDF XML / Dublin Core (simple and extended)
- MARC XML
- METS
- Locally defined schema.
What kind of information should the XML include?
You must include an element for:
- A URL for each unique content ‘item’ that users can follow to get to the content from a search result page
- A title for each unique content ‘item’
- Rights information (we strongly encourage you to encode this as a URL)
We also recommend you include:
- The URL of a high-resolution version of the digital content item
- A link to a thumbnail (mandatory if you are contributing images).
To really work well in DigitalNZ search, content items should also have some form of description, date, creator or author, and other descriptive information.
How do I get the file to you?
Depending on the size of your XML file/s there are a number of methods you can use for sending us your data. Some common ones include:
- Email: Because of limits on the size of email attachments, you may need to use a programme such as WinZip to compress your file/s before sending them to info@matapihi.org.nz
- CD/DVD/Thumbdrive: Mail to DigitalNZ, National Digital Library / National Library of New Zealand / PO Box 1467 / Wellington 6140
- FTP transfer
Please let us know the preferred form of your name for listing as a Content Provider, and the name of the website where the content is available.
What happens then?
Behind the scenes we transform the elements from your XML file into Dublin Core and other fields for the DigitalNZ database – so if your XML file contains Dublin Core elements, all the better!
We’ll let you know when we’ve loaded everything into the test system for you to take a look at.
