{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"61238332-bf9b-4488-b70b-6e3bac86513a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c4d3f7d6-82a9-4778-af33-6fd7dc6cffa8"}}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"About Import Service ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The imports service will accept uploads in a specific XML format, and will import the records found in that request. Successfully imported records become available in nuxeo shell, nuxeo workbench, and cspace.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are importing Location / Movement / Inventory records, or any other types of records that can be \"locked\" and prevented from further modification, please see the special note on ","type":"text"},{"text":"Specifying the lifecycle for imported records","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/edit-v2/3582885927#Specifying-the-lifecycle-for-imported-records"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"The request","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sending the request:","type":"text"}]},{"type":"paragraph","content":[{"text":"(In both of the following examples, be sure to substitute the actual name of your import file for ","type":"text"},{"text":"myimportfile.xml","type":"text","marks":[{"type":"code"}]},{"text":".)","type":"text"}]},{"type":"paragraph","content":[{"text":"In CollectionSpace v2.2 and above, by submitting your XML input file as an 'application/xml' part of a 'multipart/form-data' payload:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d2171792-ee61-4fcb-92db-7b6b1eee6446"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"curl http://localhost:8180/cspace-services/imports?type=xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -i","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -u admin@core.collectionspace.org:Administrator","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -F \"file=@myimportfile.xml;type=application/xml\"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"In any recent version of CollectionSpace, including v2.2 and above, by submitting your XML input file as an 'application/xml' payload:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"68033efb-b5d2-4366-a3ac-7f22a5fa1c76"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"curl -X POST http://localhost:8180/cspace-services/imports","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -i","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -u admin@core.collectionspace.org:Administrator","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -H \"Content-Type: application/xml\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" -T myimportfile.xml","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example Request","type":"text"}]},{"type":"paragraph","content":[{"text":"The example requests above both uploaded an XML-based import file named ","type":"text"},{"text":"myimportfile.xml,","type":"text","marks":[{"type":"code"}]},{"text":" from the local filesystem to a CollectionSpace server.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here's an example, in turn, of what an import file looks like. This import file creates two Object Exit records, with each record containing data in two fields, ","type":"text"},{"text":"exitNumber","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"exitNote","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"386c79dc-2e76-4b30-bb90-e4878751d20e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" OE2010.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Puedo comer vidrio, no me hace daño. Je peux manger du verre, ça ne me fait pas mal.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" OE2010.2","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" This USASCII OBJECT has been declared a World Heritage Nuisance and must be disposed of forthwith - Sebastian","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The following example import file creates two Person Authority records. (Each authority can, in turn, contain zero or more person terms.) The first Person Authority in the payload will be assigned a random CollectionSpace ID (CSID), while the second will be created with a supplied ID.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0cdd92dc-b361-4dea-9b51-31f216121bb1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" American Poets","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" americanpoets","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:core.collectionspace.org:Personauthorities:name(americanpoets)'American Poets'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" French Poets","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" frenchpoets","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" urn:cspace:core.collectionspace.org:Personauthorities:name(frenchpoets)'French Poets'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Requests","type":"text"}]},{"type":"paragraph","content":[{"text":"There are also two samples of Import files included in CollectionSpace's source code tree, for testing. These files can be used to import, respectively:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A Cataloging record, with all or nearly all of its standard fields, including repeating (multivalued) fields:","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/services/blob/master/services/imports/service/src/test/resources/requests/collectionobject-request.xml"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Two Person Authority records (identical to the import file also shown in one of the examples above):","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/services/blob/master/services/imports/service/src/test/resources/requests/authority-request.xml"}},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Structure of the request:","type":"text"}]},{"type":"paragraph","content":[{"text":"The body of an imports request is an XML document, which contains data for one or more CollectionSpace records to import.","type":"text"},{"type":"hardBreak"},{"text":"There are three main elements in this document:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0a989e5e-d1e7-4c26-8318-1c98a3ef8b7d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Element","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Notes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"A container element for multiple records to be imported.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Identifies an import of one record into a particular CollectionSpace service (e.g. Cataloging, Acquisitions, Loans Out, Persons, Organizations). You can set attributes for this record as shown below.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Contains the actual data for one part of that record, conforming to a particular schema. You can have multiple ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" elements (parts) per record. These might include ","type":"text"},{"text":"schema","type":"text","marks":[{"type":"code"}]},{"text":" elements for a record's common part - the default set of fields for that type of record - and (optionally) one or more extension parts. This data conforms to the format used by the Nuxeo import and export services.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The format of the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element is discussed further below in ","type":"text"},{"text":"Determine the correct values to put into a /imports/import/schema element","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/edit-v2/3582885927#Determine-correct-values-for-%22%2Fimports%2Fimport%2Fschema%22-element"}}]},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Attribute values in the request","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Here are the available attributes for the three main elements:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"199b9557-1320-41f4-8e38-4cc63aa2ee13"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Element","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Attribute","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Required/Optional","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Value","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"imports","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"–","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"import","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"service","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This routes you to the correct service.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This declares your document type as Nuxeo sees it.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"CSID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This may be absent. If present, it must be a value as returned from UUID. If present, it forces the record to use the CSID as its CSID, which is also the nuxeo document ID.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"seq","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This value does not appear in an imported document at all.","type":"text"},{"type":"hardBreak"},{"text":"It is only present to help determine which element caused a problem in the event of bad data.","type":"text"},{"type":"hardBreak"},{"text":"This number will appear in status reports from the imports service.","type":"text"},{"type":"hardBreak"},{"text":"Currently, the import is done in file order.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"createdAt","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This gives the record a user-supplied createdAt timestamp, rather than simply reflecting the date and time when the record was imported. Useful for preserving metadata (such as original creation dates and times) when importing legacy data.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"createdBy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This gives the record a user-supplied identifier for the creator of the record. Useful for preserving metadata when importing legacy data.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"updatedAt","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This gives the record a user-supplied updatedAt timestamp, rather than simply reflecting the date and time when the record was imported. Useful for preserving metadata when importing legacy data.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"updatedBy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"Optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"This gives the record a user-supplied identifier for the last updater of the record. Useful for preserving metadata when importing legacy data.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"schema","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":"–","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"heading","attrs":{"level":6},"content":[{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph"}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e6405101-0bc0-4540-801a-c3aca19313b1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"915f27ff-360d-405d-a2a3-402dcf07113b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7bec39e4-320d-4489-beac-d3572e25b3db"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Example:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d2a1eb62-6073-452b-8827-36eba955509a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Find the service and type values","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You can find the acceptable values for service and type for your tenant in the ","type":"text"},{"text":"$CSPACE_JEESERVER_HOME/cspace/config/services/tenants/{tenantname}/tenant-bindings.merged.xml","type":"text","marks":[{"type":"code"}]},{"text":" file. (If you are importing records that use a custom schema extension specific to your tenant, you can instead find these values in the ","type":"text"},{"text":"tenant-bindings-delta.xml","type":"text","marks":[{"type":"code"}]},{"text":" file for your tenant.)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The service attribute value can be found as the name attribute of the ","type":"text"},{"text":" tenant:serviceBindings ","type":"text","marks":[{"type":"code"}]},{"text":"element.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The type can be found as the name attribute of the ","type":"text"},{"text":" service:object ","type":"text","marks":[{"type":"code"}]},{"text":"element.","type":"text"},{"type":"hardBreak"},{"text":"https://raw.githubusercontent.com/collectionspace/services/master/services/common/src/main/cspace/config/services/tenants/tenant-bindings-proto-unified.xml","type":"text","marks":[{"type":"link","attrs":{"href":"https://raw.githubusercontent.com/collectionspace/services/master/services/common/src/main/cspace/config/services/tenants/tenant-bindings-proto-unified.xml"}}]}]}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"5fc6ca62-f9a6-42e0-a063-f55d9f2838ef"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generate your own CSID value","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The Imports service will automatically create unique identifiers (","type":"text"},{"text":"CSIDs","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":") for your records. If you wish, you can instead manually specify the CSIDs to be given to some or all of the records you import, as noted above in ","type":"text"},{"text":"Attribute values in the request","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/edit-v2/3582885927#Attribute-values-in-the-request"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"CSID must be a Type 4 UUID. This format can be generated by any number of publicly available tools.","type":"text"},{"type":"hardBreak"},{"text":"Here's how you do it in Java:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b09fd825-af6b-4fc7-8786-8604bcdbf71f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"String csid = java.util.UUID.randomUUID().toString();","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"There is a trivial Java class that you can easily compile and run to generate (","type":"text"},{"text":"CSIDs","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3579052033"}}]},{"text":") here:","type":"text"},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/Tools/blob/master/scripts/GenerateUUID.java"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Determine correct values for \"/imports/import/schema\" element","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"First, create and save a data record in the a running CollectionSpace system that contains any customizations you have created for your deployment. If you plan to import data into fields that are part of multi-value or repeating groups (those with a plus-sign icon above the field or fields), make sure the record you have created includes data in those repeating fields.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You then need the CSID of the new record, which is not displayed when you have created the record. Use the keyword search capability (or Find and Edit) to find and display your new record. The CSID will be displayed at the end of the URL. An example for a collectionobject record is 6bcc588e-1343-4f91-8409 from the URL:","type":"text"}]},{"type":"paragraph","content":[{"text":"http://demo.collectionspace.org:8180/collectionspace/ui/core/html/cataloging.html?csid=6bcc588e-1343-4f91-8409","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can change this URL directly, or construct one in a new browser tab or window, so that it looks like this instead, with the same CSID but with a different path preceding it:","type":"text"}]},{"type":"paragraph","content":[{"text":"http://demo.collectionspace.org:8180/cspace-services/collectionobjects/6bcc588e-1343-4f91-8409","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When entering this URL in your browser, you will be prompted to supply a user name and password. Use the same information that you use to login to the regular CollectionSpace user interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The appropriate XML record should be returned in the browser window. (Depending on your browser, you may need to \"view source\" or \"view page source\" to be able to copy a version of that record that you can readily paste into a text editor, etc.)","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The URL for an authority record (person, organization, taxon, and so on) is more complex because you have to include the instance of the authority that the record appears in. If the record is in the default instance of the person authority, for example, the URL will look like:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fa74a4ed-8290-4b1a-98b4-62226bbeb238"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"http://demo.collectionspace.org:8180/cspace-services/personauthorities/default/items/fea3b33b-a504-4a01-be5c","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"or","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"af9797f2-1352-448d-8310-299653a1b6b7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"http://demo.collectionspace.org:8180/cspace-services/personauthorities/persons/items/fea3b33b-a504-4a01-be5c","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"XML records obtained in this way require an additional transformation step in order to fit the requirements of the Import Service. Specifically, the namespaces are needed for each element. An XSLT can be used to insert this information, or you can edit the resulting schema by hand. For example, foreName element in the person authority will need to be edited from","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e21c6303-2bf7-4424-9b8f-9d16d409ea5c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Chris","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"to","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7b591727-48da-4c53-b7f2-c4f06ad8255f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Chris","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"This method, using the Nuxeo administrator console, only works in version of CollectionSpace ","type":"text"},{"text":"earlier","type":"text","marks":[{"type":"strong"}]},{"text":" than 2.0","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fire up the Nuxeo Workbench:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Locally, if you have started Nuxeo:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://localhost:8080/nuxeo/login.jsp","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8080/nuxeo/login.jsp"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On CollectionSpace's nightly server:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"http://nightly.collectionspace.org:8080/nuxeo/login.jsp","type":"text","marks":[{"type":"link","attrs":{"href":"http://nightly.collectionspace.org:8080/nuxeo/login.jsp"}}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on \"Default domain\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on \"Workspaces\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on a service you want to know the format of, e.g. \"Personauthorities\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the export icon.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the top right of the nuxeo workbench web page are two icons: one for export, one to print.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The export icon looks like this (click on thumbnail to see detail image here):","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This will save the whole folder as a zip file.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open that zip file and navigate to the document.xml file contained within one of the CSID-named folders.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The XML file that you have obtained will contain many elements and sections that you will not need for your import format. You only want to look at the \"/document/schema\" element that has an attribute of the schema part you want.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, we are only concerned with ","type":"text"},{"text":"/document/schema/","type":"text","marks":[{"type":"code"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"e748dfdb-13ef-4108-b298-d1604a385f91"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Test Person Authority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" persontest1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"So for Personauthorities, the schema part name is \"personauthorities_common\".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6ad4c0f6-7d70-4b48-8d28-94da5e4f5c53"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Test Person Authority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" persontest1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" PersonAuthority","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"This is exactly the format that Nuxeo expects on import.","type":"text"},{"type":"hardBreak"},{"text":"Sections like this must then be wrapped in an \"/imports/import\" element. And you may have multiple /imports/import/schema elements as shown above.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Variables supported in expansion of request","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1ee91949-7d80-4a03-99c9-1257fd01b54f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"${docID}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"this will be the CSID.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"You may refer to the CSID anywhere in the schema upload.","type":"text"},{"type":"hardBreak"},{"text":"For example, to show the CSID in the displayName, you would do this in your request file","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"efb1900d-e0fa-47d8-bd8c-5e6890b180fe"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Perf Test Person Auth ${docID}","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Remember that the CSID attribute is not required, and should be absent if empty. If you provide it, it becomes the docID and the CSID that cspace uses.","type":"text"},{"type":"hardBreak"},{"text":"If you provide it, it will expand where ${docID} is found. If you don't provide it, ${docID} will be expanded with a value generated by the system.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Internal variables","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"These are supported in the expansion of the ","type":"text"},{"text":"service-document.xml","type":"text","marks":[{"type":"code"}]},{"text":" template:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/services/blob/master/services/imports/service/src/main/resources/templates/service-document.xml"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"You would not use these in the imports request, but be aware that these are reserved words, when present with the dollar-sign and braces.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"23d2d7a9-63d3-41af-bf9e-b7f8a444e988"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"${Schema}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"this will be the body of each of the schema parts you send in.","type":"text"},{"type":"hardBreak"},{"text":"You would NOT use this in a schema upload.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"${ServiceType}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"this will be the service type, such as \"Personauthority\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"${ServiceName}","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"this will be the service name, such as \"Personauthorities\"","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Error logs","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Nuxeo errors show up in one of these two files:","type":"text"}]},{"type":"paragraph","content":[{"text":"$CSPACE_JEESERVER_HOME/logs/cspace-services.log","type":"text"},{"type":"hardBreak"},{"text":"$CSPACE_JEESERVER_HOME/logs/catalina.out","type":"text"}]},{"type":"paragraph","content":[{"text":"where $CSPACE_JEESERVER_HOME=/usr/local/share/apache-tomcat-6.0.33, this would be:","type":"text"}]},{"type":"paragraph","content":[{"text":"/usr/local/share/apache-tomcat-6.0.33/logs/cspace-services.log","type":"text"},{"type":"hardBreak"},{"text":"/usr/local/share/apache-tomcat-6.0.33/logs/catalina.out","type":"text"}]},{"type":"paragraph","content":[{"text":"This error doesn't seem to apply:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"914d8f9b-278b-4056-b85c-234829f5cf44"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"[org.nuxeo.ecm.core.io.impl.AbstractDocumentReader:60] no ID for document, won't add org.nuxeo.ecm.core.io.impl.ExportedDocumentImpl@1c7aae9d","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Results","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The result of the POST is a report showing which files were imported, and which workspaces they were imported to.","type":"text"},{"type":"hardBreak"},{"text":"For example, our POST above results in this being sent as the reponse:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7c7cdee6-13a5-46bf-a14c-3e2e8134bbfb"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"HTTP/1.1 100 Continue","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Server: Apache-Coyote/1.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"X-Powered-By: Servlet 2.4; JBoss-4.2.3.GA (build: SVNTag=JBoss_4_2_3_GA date=200807181439)/JBossWeb-2.0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Set-Cookie: JSESSIONID=5DB37B19B46D9F2BE3F94074FA55F84B; Path=/","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Content-Type: application/xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Content-Length: 295","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Date: Thu, 14 Apr 2011 19:56:47 GMT","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"SUCCESS","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"READ: /private/var/folders/gj/gjyPnAPuH7qFUS27+IsYwk+++TM/-Tmp-/imports-fefc12c1-cd53-4860-b692-05daa0f9a7a9/CollectionObjects/5d15f3eb-0600-4582-bab9-452df9c7d189/document.xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"/CollectionObjects/5d15f3eb-0600-4582-bab9-452df9c7d189","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"This means that a schema was wrapped in a document, placed in a temp dir on the cspace server, and imported into the nuxeo workspace called /CollectionObjects/ and given the documentID 5d15f3eb-0600-4582-bab9-452df9c7d189.","type":"text"},{"type":"hardBreak"},{"text":"You will get one such line for each schema part imported.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Import Exported Records","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Note: If you have exported records via the Nuxeo workbench, using the steps described in ","type":"text"},{"text":"Determine the correct values to put into an \"/imports/import/schema\" element","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/edit-v2/3582885927?draftShareId=cca24e2a-d983-471c-a9b3-11e6fc8d8497#Determine-correct-values-for-%22%2Fimports%2Fimport%2Fschema%22-element"}}]},{"text":", you will have downloaded a ","type":"text"},{"text":".zip","type":"text","marks":[{"type":"code"}]},{"text":" file. Expand that file, and you will get many individual directories - one per record - each containing a single XML file named ","type":"text"},{"text":"document.xml","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If you wish to import these records, either into the same CollectionSpace system or a different system, the following Ruby script can help pull the relevant data out of these export files into a single import file, in the correct structure for submitting that file to the Imports Service:","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://github.com/collectionspace/Tools/blob/master/scripts/pkg-records-for-import.rb"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"To install Ruby (1.8 or higher), as required by this script:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Aptitude-compatible Linux (e.g. Debian, Ubuntu): ","type":"text"},{"text":"sudo aptitude install ruby","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"sudo apt-get install ruby-full","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Yum-compatible Linux (e.g. RedHat, Fedora): ","type":"text"},{"text":"sudo yum install ruby","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Windows: ","type":"text"},{"text":"RubyInstaller for Windows","type":"text","marks":[{"type":"link","attrs":{"href":"http://rubyinstaller.org/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mac OS X: Ruby 1.8 or higher is included with Mac OS X 10.4 Tiger and above","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To run this script:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save it into a new file, within the folder ","type":"text"},{"text":"that contains one or more sub-folders","type":"text","marks":[{"type":"em"}]},{"text":", each containing a record to be imported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the values in the ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"code"}]},{"text":" section near the top of the script.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the script at your command prompt via the command ","type":"text"},{"text":"ruby pkg-records-for-import.rb","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note that the script needs to be configured via constants, and that some cleanup or other manual modification of records may still be required after running the script, as described in comments near the top of the script.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Specifying the lifecycle for imported records","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"By default, imported records are given the default lifecycle. (A \"lifecycle\" is a specific set of states into which a record can be placed, such as active and deleted, and the associated set of transitions between those states.)","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are importing Location / Movement / Inventory records, or any other types of records that can be 'locked' and prevented from further modification, you will need to ensure that those records are given the ","type":"text"},{"text":"cs_locking","type":"text","marks":[{"type":"code"}]},{"text":" lifestyle, which includes a ","type":"text"},{"text":"locked","type":"text","marks":[{"type":"code"}]},{"text":" state.","type":"text"}]},{"type":"paragraph","content":[{"text":"Before importing such records:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the file ","type":"text"},{"text":"$CSPACE_JEESERVER_HOME/cspace/config/services/resources/templates/service-document.xml","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the value of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"cs_locking","type":"text","marks":[{"type":"code"}]},{"text":"; e.g.","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" cs_locking","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"After importing such records:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the file ","type":"text"},{"text":"$CSPACE_JEESERVER_HOME/cspace/config/services/resources/templates/service-document.xml","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the value of ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" to ","type":"text"},{"text":"cs_default","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"These changes take effect immediately and do not require a server restart.","type":"text"}]}],"version":1}

Browser not supported