Fullscreen Image

Import With Packages

You can import large quantities of documents and their metadata properties to Meridian Cloud using import packages.

The import process requires the following steps to be performed in the order listed. These steps involve large amounts of data that can require significant time to import so plan accordingly. We also provide data migration tools to assist you with this process. Learn more about our Data Migration Tools.

You must be a member assigned to the Senior DC or DC Operations groups to perform this task.

For help with performing this import process, contact Accruent Support.

ClosedStep 1: Notify Support

Before you proceed, contact Accruent Support and provide the following information:

  • Name of the tenancy to which the data will be imported.

  • Estimated amount of time that you expect to be importing.

ClosedStep 2: Download the Metadata Spreadsheet Template

Download the metadata spreadsheet template for your Meridian Cloud account as described for the Import Profile option in Create an import package. You will use this in the next step to provide the document metadata for the imported files.

ClosedStep 3: Populate the Spreadsheet(s)

Populate one or more copies of the spreadsheet template with the required metadata for the documents to be imported. Specify relative paths to the document files that will be uploaded in a future next step.

Notes about Populating Spreadsheets

  • The workbook must contain the worksheets and columns defined in the template that you downloaded in step 2. Custom properties will be automatically appended as additional columns.

  • The columns in the Document worksheet must meet the requirements listed in the following table. The order of the columns is not important.

  • Paths to source files must be less than 150 characters and cannot contain special characters. An alternative is to upload a folder instead, which supports up to 220 characters in the path and special characters.

  • Thumbnail images will not be generated.

  • References may point to any revision of items in the same import package. References may only point to the latest revision of items previously imported into the repository. In the latter case, placeholder references will appear as warnings in the import audit log as described in View the import audit log. An error will occur if multiple documents with the same value for Document Number are found for a single reference.

  • Import of project copy references to previous master (Masters root folder) revisions is not supported. All project copy references will be to the latest revision of its master document.

  • By default, documents will not be scanned for reference integrity. This can be enabled upon request.

  • To export documents and their metadata from an on-premises Meridian Enterprise vault, see Archive documents.

  • The MicroStation Reference Type used for MicroStation Model Reference is MicroStationModelReference.

ClosedStep 4: Create Source Archive Files (optional)

In most scenarios, you should upload the document content source files directly without any preparation. In uncommon scenarios, it can be more manageable to upload sets of source files contained in archive (ZIP) packages as follows.

Create one or more archive files that contain the source files that you want to import. The ZIP files should contain relative paths that you have specified in the metadata spreadsheet described above.

To import documents to the Archive root folder, in addition to creating a separate source archive file, specify values for the Archive Root and Archive Year columns in the metadata worksheets.

The Root_Archive column in the Masters Import spreadsheet is the same thing as ArchiveRoot. It is only used for documents to be archived. The Root_Archive usually contains the year in which the document was archived.

ClosedStep 5: Upload the Source Files

Upload the source files (ZIPped or not) via FTP to a staging location in Meridian Cloud where the Meridian Explorer package import process can access them. This is described in Upload Import Sources To Your Repository.

ClosedStep 6: Create the Import Packages in Meridian Explorer

In Meridian Cloud, use the standard import package functionality described in Import With Packages to create one import package for each combination of a metadata spreadsheet and its corresponding source files. Select the import profile that corresponds to the destination root folder of the source files as listed in the following table.

Disable the Use content from a folder option when you create the import package(s).

Import profiles
Profile Description

Documentation Import

Source archive files destined for the Documentation root folder.

Masters Import

Source files destined for the Masters root folder.

Projects Import

Source files destined for the Projects root folder.

References Import

For creating references between existing items in the repository.

Tag Import

Source files destined for the Tags root folder.

We highly recommend that you test the metadata in the worksheets as described in Create an import package and resolve all discrepancies before you submit the import package(s). The import will start automatically.

For optimum results, we recommend that you only run one scan or import job at a time.

ClosedStep 7: Monitor the Results In Meridian Explorer

As each package is imported, you can monitor its progress as described in View and edit an import package. After each import package has finished you can view the results as described in View the import audit log.

ClosedStep 8: Report the Results

Report the results of the import to Accruent Support when the import has completed.

The following table describes the valid values for each standard property column in the metadata spreadsheet. Some properties are not present in all templates. Custom properties may be added.

Metadata requirements

Column

Required

Description

<CustomPropertyInternalName>

Configurable

Internal name of custom properties that are defined in Meridian Cloud.

#

Yes

Unique sequence number. Sort order for revisions instead of Revision Number as described below.

For import only, not stored in Meridian Cloud.

AlternativeID

Configurable

One or more alternative reference identifiers, for example, assigned by an external document creator.

AlternativeRevisionID

Configurable

Alternative revision number or letter, for example, assigned by an external document creator.

ApprovalDate

Configurable

Date when the last reviewer approved the document.

ApprovedBy

Configurable

Name(s) of the last reviewer(s) who approved the document. Multiple values delimited by the asterisk character (*). For example, *User1* for a single user or *User1*User2* for multiple users.

ArchiveRoot

Yes

Destination folder in the Archive branch of the Meridian Cloud repository.

When importing archived documents only.

ArchiveYear

Yes

Year when the documents were archived.

When importing archived documents only.

BuildingLevel2

Configurable

Building identifier within the specified plant.

BuildingLevel3

Configurable

Floor identifier within the specified building.

BuildingLevel4

Configurable

Room identifier within the selected floor.

BusinessUnit

Configurable

Division within the organization responsible for the facility. Should be a value from the lookup defined in Meridian Cloud for the property Business Unit.

Classification

Yes

Category (label) within the engineering discipline. Can be used to specify a distribution list, for example, of recipients of review packages. Should be a value from the lookup list defined in Meridian Cloud for the property Classification.

When the provided value does not match the values in a destination lookup list (for example, Classification), the value is imported but not added to the lookup list. The respective provided value for Organization ID, DisciplineCode, or ClassificationCode will not be imported.

Created By

Configurable

Full name of the user who created the document.

CreateDate

Configurable

Date when the document was created.

Discipline

Yes

Engineering discipline (label). Can be used to specify a distribution list, for example, of recipients of review packages. Should be a value from the lookup list defined in Meridian Cloud for the property Discipline.

When the provided value does not match the values in a destination lookup list (for example, Classification), the value is imported but not added to the lookup list. The respective provided value for Organization ID, DisciplineCode, or ClassificationCode will not be imported.

Document Name

Yes

File name and extension. Does not need to be unique. New documents are automatically assigned a value that is used to calculate the file name together with the file extension in this column. New revisions are assigned this value as the filename. We recommend using Document Number plus the file extension.

Document Number

Yes

Unique identifier to group revisions of the same document. Rows with the same value in this column will be imported as revisions of the same document (ordered by #). We recommend this be the value of Document Name without the file extension. Rows with the same value for Document Number and for Revision Number will be imported as hybrid documents.

Meridian Cloud will attempt to match incoming documents to existing documents in these locations in the order listed:

\Archive\<Year>\Projects\<Project Type>\<Project>

\Archive\<Year>\<not Projects>

\Projects\<Project Type>\<Project>

\<not Projects>

Document Number must only be unique within each of these locations.

Document Type

Yes

One of these values depend on the import profile used:

Masters Import profile: FacilityDocument, TransmissionDocument

Projects Import profile: FacilityDocument, ProjectDocument, TransmissionDocument

Documentation Import profile : GenericDocument

For import only, not stored in Meridian Cloud.

ESignature No

Allows you to set an e-signature for migrated or legacy data. If an e-signature is mapped in the spreadsheet, one of two things will happen:

  • If a rendition is not provided with the import, the e-signature text will be imported from the spreadsheet and used in the rendition generation.

  • If a rendition is provided with the import, the e-signature text will not be used in rendition generation.

Importance

Yes

One of these values: Critical, High, Low, Medium, None

Intellectual Property

Yes

One of these values: Critical, High, Low, Medium, None

Library

Yes

One of these values depending on the import profile used:

Tag Import profile: Tags, Archive

Masters Import profile: Masters, Archive

Projects Import profile: Projects, Archive

Documentation Import profile: Documentation, Archive

Reference Import profile: any

LocationLevel0

No

Region level in the Facility Document and Transmission Document type hierarchies. Geographical area (label) where the facility or system is located (eg. EU - Europe).

LocationLevel1

Configurable

Plant level in the Facility Document type hierarchy. Name of the facility or system within the selected Region.

Type level in the Transmission Document type hierarchy. System type within the selected Region.

LocationLevel2

Configurable

Area level in the Facility document type hierarchy. Geographical space within the selected plant.

Sub-Type level in the Transmission Document type hierarchy. Sub-type within the selected Type.

LocationLevel3

Configurable

Unit level in the Facility Document type hierarchy. Physical unit within the selected Area.

Transmission ID level in the Transmission Document type hierarchy. Line within the selected Sub-Type.

LocationLevel4

Configurable

System level in the Facility document type hierarchy. Functional system within the selected unit.

Component level in the Transmission Document type hierarchy. Component within the selected Transmission ID.

OrganizationDescription

Yes

Organization (label) that created the document. Should be a value from the lookup list defined in Meridian Cloud for the property Organization Description.

When the provided value does not match the values in a destination lookup list (for example, Classification), the value is imported but not added to the lookup list. The respective provided value for Organization ID, DisciplineCode, or ClassificationCode will not be imported.

Page Layout No The view within the source document to render.
Page Orientation No The orientation of the page to render to: Landscape (default) or Portrait.
Page Size No The size of the page to render to. The default page size is A0.
Pen Settings File No The Pen Settings File associated with the document.
Print Quality No Print quality to use with PDFTron. You can enter a value between 1 and 15. Higher values result in higher quality, but takes longer to render. Values between 3 and 6 are suitable for most purposes. Beyond 6, quality increases by diminishing amounts. If no value is set, the default value of 1 is used.

Project Phase

 

Selected from a lookup list, which has the following values as default:

  • Preliminary Design

  • Detailed Design

  • For Construction

  • For As-Built

  • For Commissioning

  • For Handover

Project Number

No

Text that identifies the destination project folder. This is matched with the Project Number Property specified as described in Create an import profile.

PurchaseOrderID

Configurable

Financial system reference ID.

ReleasePurpose

No

Intended purpose of a specific revision. Should be a value from the lookup defined in Meridian Cloud for the property Release Purpose.

Render Color No The color depth to render to: Color or Black and white (default).

Rendition Path

No

Relative path to the PDF rendition.

For import only, not stored in Meridian Cloud.

ReviewDate

Configurable

Date when the lead reviewer(s) reviewed the content.

ReviewedBy

Configurable

Name(s) of the lead reviewer(s) who reviewed the content. Multiple values delimited by the asterisk character (*). For example, *User1* for a single user or *User1*User2* for multiple users.

Revision Number

Configurable

Text field to accept any revision numbering scheme. Because this cannot be reliably sorted, specify the order of revisions in the # column instead. Rows with the same value for Document Number and for Revision Number will be imported as hybrid documents by default. If you will be importing rows with the same value for Document Number and for Revision Number that are distinct revisions but not hybrid drawings, provide an index prefix with the Revision Number value in the form n::<RevisionNumber> where n starts at 1, is applied to the first duplicate revision and is incremented for successive revisions.

For example:

First revision=A

Second revision=1::A

Third revision=2::A

And so on.

RevisionPurpose

Configurable

Reason for a specific revision.

Root

Yes

Destination root folder in the Meridian Cloud repository: Objects, Masters, Documentation, Projects, or Archive.

For import only, not stored in Meridian Cloud.

SheetCount

No

Total number of sheets in the set.

SheetNumber

No

Up to 10 characters that represent the ordinal number of the document within the sheet set.

Source Path

Yes

Relative path to the content file. Must be unique only if reference scanning is enabled.

For import only, not stored in Meridian Cloud.

Title

Yes

Short subject description.

Title2

Configurable

Short subject description.

Workflow State

No

We recommend leaving this column empty. By default, the document will be imported as Released.

For import only, not stored in Meridian Cloud.

XOD Resolution No A value at which to view and generate renditions with PDFTron. Lower values may lack sufficient clarity. Higher values may cause slower viewing and publishing.