Import and Export Folders

When you want to import or export an entire structure of folders, use the Options Folders-> Import or Folders-> Export .

The Option Export will export OPD current folder and creates a file system folder structure equivalent to that in OPD. Before starting the export, OPD will present a screen to define different characteristics of the export. The possible options and their effects are:

• One level: If you select this option, only the selected folder will be exported, otherwise, OPD will continue recursively until all the structure go below the current folder.
• Include documents: If you select this option, the export documents include the contents of each of the folders. Otherwise, just export your folders.
• Include Metadata: If you select this option, the export will generate the same level and with the same name as the element, a file ". opd" with the object's metadata (folder or document ). Otherwise, just is created in the file system the folder or document.
• The destination folder indicates the file system folder under which to create the structure of folders and documents.

Export only include the documents for which the user has access permissions, therefore should not be assumed that the entire tree has exported unless the user has access permissions to all branches and documents.

After the export, OPD will present a summary containing the number of folders exported and the number of documents. If an error occurs, a message will be presented with the reason for the error.

In web version, the metadata of the folder and all the documents of the first level with their metadata included are exported in opd format (an XML text file with utf-8 encoding) and each EMBEDDED document in XML in base64 format. The OPD file containing everything (metadata folder + metadata documents + documents) will be downloaded to the browser and can be saved for later import in the same or a different system.

Should be noted that to avoid unwanted effects on import, OPD does not include definitions during export. Therefore, the definitions of elements such as document type (with metadata correspondence), ACL, mime type, etc.. must exist at the time of import (in the current system or at a different location). To export the definitions should be used explicitly maintenance functions of the administration screens.

The Option Import imports a structure of the filesystem in the current OPD folder and creates a folder structure equivalent to that in the file system. Before starting the imortación, OPD will display a screen where to define different characteristics of the import. The possible options and their effects are:

• One level: If you select this option, only the selected folder will be imported, otherwise, OPD will continue recursively to go all the structure below the current folder.
• Include documents: If you select this option, import the documents included in each of the folders. In another case, only folders will be imported.
• Include Metadata: If you select this option, the import will use, at the same level and with the same name as the element, an ". opd" file with the object's metadata (folder or document). Otherwise, will be used file name as a title and file date as the date of the document.
• Folder Type: If you do not import metadata (by choice or because it is a file system that does not contain them), this parameter indicates the type of folder to be assigned to folders imported. The type can not be include mandatory metadata, since the import will fail.
• Document Type: If you do not import metadata (by choice or because it is a file system that does not contain them), this parameter indicates the document type to be assigned to imported documents. The type can not be include mandatory metadata, since the import will fail.
• Source Folder: Indicates the file system folder from which you will start to import the structure of folders and documents.
• Strict: When this flag is turned on, Openprodoc will try to do the whole import in a transactional way. If something fails, the entire operation will be canceled. It is not convenient to activate it when the folder and document structure is very large (tens of thousands).
• Javadoc: When this flag is turned on, Openprodoc will try to import the folder structure as Javadoc (or as a set of interrelated html pages). The pages on disk will be modified before being imported so that the references / url of all the pages or images would be not static but instead reference the documents within the Openprodoc server itself.

In Web version, OPD presents a dialog to choose (or drag) the file of type ".opd" where the metadata of the folder and documents are stored.

When ends importing, OPD will present a summary the number of folders containing imported and the number of documents. If an error occurs, a message will be presented with the reason for the error.

At the time of import, should exist the definitions of:

• Documents Types and folder types: Although not necessarily be identical, must contain at least the same metadata.
• ACLs: Similarly must exist but need not match the definition.
• Mime Type: Similarly must exist but need not exactly match the definition.

During import, OPD will ignore the following values​​:

• Modification User: will be assigned the user performing the import.
• Modification Date: will be assigned the current date.
• Repository: will be assigned and use the repository that corresponds to the document type at the time of importation.
• Unique Identifier (PDID): will be assigned a new ID.
• Folder: current folder will be assigned at the time of importation.