MetaServer > Help > Export to Alfresco

030-060 MetaServer Export – Export to Alfresco

With the MetaServer Export to Alfresco action, you can export documents to the Alfresco Community Edition or the Alfresco Content Services Enterprise Edition.

You can construct the folder structure and file name using fixed elements and variables or metadata fields.

Select a custom document type and map variables or metadata fields with its properties.

The export connector makes use of Alfresco’s versioning feature and when a document with the same name is exported a new version of the document will be created.

To add an Export to Alfresco action, select the action after which you want to insert the Export to Alfresco action and press Add -> Export -> to Alfresco. The Setup window will automatically open.

You can also open the setup window of an existing Export to Alfresco action by double clicking the action or by pressing the setup button on the right side of the action or in the ribbon, as shown below.

In our example, we will use the “CB – INSPECTION REPORTS” workflow as a reference. This workflow is automatically installed with CaptureBites MetaServer.

TIP: The thumbnail on the right will follow you, so you can easily refer to the Setup window. Click on the thumbnail to make the image larger.

Don't forget to add a description to your action.

01 - File Source: press the dropdown button to specify the source of your files.

By default, Processed PDF is selected. This means that the output will be a PDF, no matter what the original imported file type was.

- PDF/TIF/JPG/PNG attachment: refers to PDF, TIF, JPG or PNG files that were imported by means of the Import Email action.

- Email PDF: refers to the email body converted to PDF format.

- Email EML: refers to the complete imported Email including all its attachments in EML format.

- Email MSG: refers to the complete imported Email including all its attachments in MSG format.

- Imported PDF/TIF/JPG/PNG: refers to the original PDF, TIF, JPG or PNG files that were imported by means of an Import from Folder action.

- Processed PDF: refers to the PDF after every prior action. For example, if you've applied a Scale Page(s) action before exporting to a folder, it will export the scaled PDF

- Processed TIF: refers to the TIF version of an imported document or attachment converted to TIF with a Convert to Multipage TIF action.

NOTE: Technically any imported file format such as TIF, JPG and PNG are internally converted to PDF first. So, if you want to separate an imported multipage TIF file and export the separated TIF files, you need to add a Convert to Multipage TIF action before exporting. In the export action, select "Processed TIF" as the File Source.

1) Labels: you can change the labels of each file source if you want to use them later as metadata values in your settings.

Here you can enter your Alfresco server information. By default, we prefill the settings of a standard Alfresco LOCALHOST install. Change these settings to your own Alfresco settings.

01 – Address: enter your Alfresco server address. The address typically looks like:

02 – User name: the user name of your Alfresco account. When in doubt, contact your IT department.

03 – Password: enter your Alfresco server password. When in doubt, contact your IT department.

04 – Protocol: select CMIS 1.1 with Alfresco version 5.0b or more recent.

05 – Timeout: it’s recommended to use the default 100 seconds. If you experience regular timeouts, change it to a higher value.

01 – Repository: select your destination repository and/or folder by pressing the “…” button.

02 – Document name: you can set up your document name by combining fixed values, variables and metadata fields. Click on the drop-down arrow to pick from a list of possible values. You can see a preview of your document name below the input field.

You can also use the file name to dynamically make subfolders by simply inserting a “/” (forward slash). For example, if you want to add a dynamic subfolder based on the import date’s year, you would use a file name like this:

{ Import Date, YYYY }/{ Field, Date }_{ Field, Account Number }{ File Sequence Number }{ File Type Extension }

03 – Cache folder structure: the connector loads the Alfresco folder structure to retrieve the id of a folder. To speed up this process when the Alfresco’s folder structure is very large, you can enable this option. The cached folder structure will be reloaded after the specified duration (in minutes).

When we don’t find the id of a folder in the cached folder structure, we will create the folder in Alfresco and add it to the cache.

If a folder is cached but has been deleted in the meantime, the id does not exist anymore, and we will automatically recreate the cache and correctly create the folder.

04 – Description: each Alfresco document has a description. You can set up your description by combining fixed values, variables and metadata fields and. Click on the drop-down arrow to pick from a list of possible values.

05 – Content type: press the drop-down button to select the correct content type. All the Alfresco properties of the selected content type will be listed in the field mapping table.

06 – Aspects: aspects are global properties that can be used with any Alfresco document type.

Press the “Aspects” button to select aspects from a list. A content type is mandatory, aspects are optional. It is also possible to select multiple aspects.

The Alfresco fields list shows the fields of the content and your selected aspects.

NOTE: it could take some time until your complete list of aspects are loaded and your selected aspects are added to your list of Alfresco fields, please be patient.

NOTE: Aspects are implemented with CMIS 1.1 and CMIS 1.1 Basic Authentication. The “Aspects” button is disabled with other protocols.

07 – Field mapping: here you can map Alfresco properties with fixed values, variables and metadata fields.

1) Alfresco Field:this column shows all existing properties in the selected content type.

2) Value: in the value column, you can enter fixed values or use the drop-down arrow to compose the value using the current Workflow’s metadata fields or variables.

08 – Date format: the “Date format” is relevant when you map a DateTime Alfresco field type.

DateTime type Alfresco fields will only accept valid dates and times in a consistent format. It’s very important to enter the correct input DateTime format as it was extracted by MetaServer. This way, the Export to Alfresco action can automatically convert the DateTime values and correctly update the date property.

For example:
You want to export the extracted Inspection Date that has a “MM/DD/YYYY” format to a Date type field in Alfresco.
You specify the following input format in the Date format input field:
{ Date, MM }/{ Date, DD }/{ Date, YYYY }

TIP: you can copy the current settings and paste them in another setup window of the same type. Do this by pressing the Settings button in the bottom left of the Setup window and by selecting Copy. Then open another setup window of the same type and select Paste.