CSV Requirements

In order for the CSV Import Wizard to be able to parse your CSV, the file contents must meet the following requirements:

• The first line is a header row that lists the names of the columns found in the subsequent rows.

• The header defines “Path” and “Class” columns (case-insensitive).

• Each line representing a data row has the same number of delimited fields (i.e., columns) as the header and is formatted according to the CSV specification RFC 4180.

Once your data has been loaded into a table, the wizard will attempt to map the columns to the following import-related fields based on their name.

Load the CSV File

1. Press the CSV Import button on the Work Explorer window to start the CSV Import Wizard and carry out an import using a CSV file.

2. Load a CSV by clicking the Open… button on the right to select the file path.

3. The Wizard will automatically display the Base file path and the option to select a different one by clicking the Select Folder button, and the Target Library which can be modified using the dropdown menu to select from available libraries.

4. Once the CSV paths and library have been selected, the Wizard will show a preview of the CSV data.

5. Click Next to continue.

Template Configuration

Use this to configure the CSV export based on the Template from Template Manager.

• Select the relevant template from the list. Now all column fields and ordering will be set based on the template.

Validate the data

The following window will display the validated data from the CSV file, in case there is data with errors, it will be highlighted in red color. There is an option to Hide Valid Rows on the right, activate it to display the rows that have conflicts only.

Validation Scenarios

Workspace or Folder Ids will display in red if:

• No workspaces match the specified workspace criteria

• More than one workspace matches the criteria

• More than one folder matches the folder criteria

• No folders match the folder criteria and:

  • The default folder option is enabled and more than one folder matches the default folder name

  • The default folder option is disabled

• The folder criteria is "Folder Path" and at least one folder in the specified path is duplicated

The Ids will be yellow when:

The default folder option is enabled and:

• The criteria field (e.g., "TargetFolderName", "TargetFolderPath") is blank

• More than one folder matches the criteria (e.g;, two root folders have the same class)

if the column Comments has not been filled in, it will be displayed grayed out. This indicates there is no information, but the import will still proceed.

6. Click Next to continue.

Select Default Values

7. Set the default values from the combo menus as needed, such as Author or Operator. There is also an option to perform a Date Conversion where you can select the Time Zone that best suits your needs.

Additionally, the Owner can be selected here. The owner setting always defaults to the current user. You can only select enabled users as an a owner. When you run an import job that creates folders, the owner of the new folders matches the user selected in the “Owner” setting.

Confirm Document Profiles

8. Next, this page shows the list of documents that will be imported, as well as their file types and size. It will also display a summary including the number of files and the total size of the import. If a file from the list is selected, the properties of the selected document and the Custom Metadata will be displayed on the right. If there were issues to pay attention to, some values or fields in the preview would be shown in red.

Configure Destination Criteria

If you have specified values for the appropriate workspace attributes, you can automatically set the destinations for each item via the Workspace Criteria section selecting up to three Fields using the combo menus.

8. Use the Folder Criteria options to Identify the target folder by a class or subclass or indicate if a name is exact, starts with, or ends with a parameter. Alternatively, the folder path could be used as the identifier.

• You can also select the checkbox Import into Default Folder if no Match Found to set a folder to import the files in that case. A name for the folder has to be introduced.

9. Click Next.

Confirm Import Destinations

10. In this step, you can review the list of file names along with their Workspace IDs and Folder IDs. You will also find the links to the destination workspace and folder.

• Here you can hide valid inputs by clicking Hide Valid Rows.

Review Import

11. The last step of the import wizard shows a summary of the import job including.

• Job Name

• Files to Import

• Target Workspaces

• Target Folders

• New Folders

• Import Size

12. Click Next and then Finish to exit the wizard.

13. The progress of the import job can be followed by opening the Job Manager.

Sample CSVs

File	Description

File	Description
Open	A sample to import into PD from a local fileset. Of course this depends on your directories, files and folders. You can use the Generate CSV option from Tools-> Generate CSV