Bulk Upload Files

To upload multiple files such as pictures or presentations to empower® at once, use the following command:

backendCli.exe u -s "[SOURCE PATH]" -t "[TARGET PATH]" 

The basic command consists of the following:

  • u – Initiates the bulk upload of files.

  • --source [SOURCE PATH] (-s) – Defines the path containing the content to be imported.

  • --target [TARGET PATH] (-t) – Defines the folder to which the content should be imported.

    The folder can either be defined by a path or by its unique GUID in empower®. The GUID can be found in your empower® Database.

    For further information, see Valid Target Folders and File Types.

Optionally, you can make the command be executed in quiet mode to schedule the task.

To do so, add -q (--quiet) to the end of the command:

backendCli.exe u -s "[SOURCE PATH]" -t "[TARGET PATH]" -q 

Important

The source path must not end with a \ character.

The target path must not end with a > character.

Example

Source path

Correct: -s "C:\Users\[USER NAME]\Desktop\Pictures"

Incorrect: -s "C:\Users\[USER NAME]\Desktop\Pictures\"

Target path

Correct: -t "%CorporateDesignTemplates%>%Slides%"

Incorrect: -t "%CorporateDesignTemplates%>%Slides%>"

Valid Target Folders and File Types

The file paths to the folder on the machine and in the empower® Library must be specified in different ways.

For the paths that lead to files on your device, specify the path in the default path structure, separated by backslashes (\).

If you specify the folder in the empower® Library using a path instead of the GUID, use the following format:

%UserLibrary%>%MyContent%>[FOLDER NAME] 

The following table provides an overview of all valid folder paths and the respective supported file types that can be used within the command -t:

Folder Path

Section in Library

Supported File Types

%CompanyLibrary% 

Company Library

All supported file types in this table.

%CorporateDesignTemplates%>%CorporatePresentations% 

Corporate Presentations

.pptx, .pptm

%CorporateDesignTemplates%>%DocumentTemplates% 

Document Templates

.docx, .docm

%CorporateDesignTemplates%>%Icons% 

Icons

.jpg, .jpeg, .png, .gif, .svg, .tif

In addition, .tiff is only supported if the parameter -l is set to false.

%CorporateDesignTemplates%>%Images% 

OR

%CorporateDesignTemplates%>%Pictures% 

Pictures

.jpg, .jpeg, .png, .gif, .svg, .tif

In addition, .tiff is only supported if the parameter -l is set to false.

%CorporateDesignTemplates%>%MasterTemplates% 

Master Templates

.pptx, .pptm

%CorporateDesignTemplates%>%Slides% 

Slides

.pptx, .pptm

%UserLibrary%>%MyContent% 

OR

%UserLibrary% 

My Content

All supported file types in this table.

Important

The folder names of the data to be imported must not contain any periods.

Advanced Commands

If you want to specify more details for the bulk upload, you can add the following parameters to your command:

Command

Short Form

Description

Default

--includeSubfolders 

-i 

Defines if subfolders should be included.

This parameter can be set to true or false.

true 

--ignoreUnsupportedFiles 

-g 

Defines if unsupported files are skipped.

This parameter can be set to true or false.

If this parameter is disabled and there are unsupported files, the import is canceled and a message opens.

false 

--additionalInformationFile [PATH] 

-f 

Defines the relative path to an additional .csv file containing metadata to be uploaded with the files.

For further information, see Add Metadata to the Import.

-

--archiveSourceFolder [PATH] 

-r 

Defines the path to archive the import folder after successfully uploading the files.

The folder is then moved to the archive folder path and named after the time stamp.

false 

--updateNotification [MODE] 

-n 

Defines the update notification behavior.

This parameter can be set to force, update or disable.

This parameter does not affect Word files.

Update notifications are only supported for individual slides, presentations saved on a user's device, pictures in Word and pictures in PowerPoint uploaded via the parameter -l.

update 

--setTranslationsOutdated 

-x 

Defines if translations should be marked as outdated when files in a translation group are overwritten.

This parameter can be set to true or false.

This parameter depends on the parameter -n.

false 

--overwriteExistingFiles 

-o 

Defines if existing files in the empower® Library are overwritten. For this update to work, the imported file and the existing file must have the same name.

This parameter can be set to true or false.

If this parameter is disabled, existing files are skipped.

true 

--useIncrementalUpload 

-m 

Defines if only files are updated that have been changed since the last import.

This parameter can be set to true or false.

true 

--useLegacySlidesImageFormat 

-l 

Defines if the legacy picture format for empower® for PowerPoint is used.

This parameter can be set to true or false.

If this parameter is enabled, the picture files will only be imported to empower® for PowerPoint.

If this parameter is disabled, the picture files are uploaded in a global format which is compatible with empower® for PowerPoint, Word, Excel and Outlook.

false 

Important

If pictures are imported in the global file format which works for library content in all Office applications, updates do not work for empower® for PowerPoint. In addition, there is no version history for those files.

Therefore, the files are uploaded but the users do not receive update notifications.

For pictures in Word uploaded in the global file format, however, users do still receive update notifications.

Add Metadata to the Import

If you want to add metadata to your imported files, e.g. tags, you can create a separate .csv file containing this information.

During the import, the relative path to this file must be specified in the command.

Place the file in the import source folder or one of its subfolders.

Then, specify the relative path based on the source folder.

The content of the file should include the following, in the same order:

  • Relative path including file extension

  • Name (excluding file extension)

    • Defines a new file name to be stored in the empower® Library

    • If the name is not specified, the original file name from the import folder is used.

  • Tags to be displayed in the empower® Library

    • separated by semicolons

    • Put in double quotation marks (" ")

  • Single slide indicator

    • use x to define that only the first slide of a presentation should be imported.

    • If empty, the entire presentation is imported

The following excerpt provides an example for the structure of the .csv file:

 
Picture File 1.png;New Picture Name;"tag1;tag2;tag3";
Images\Picture File 2.png;;"tag4;tag5;tag6";
Slides\PowerPoint File 1.pptx;New Slide Name;"tag7;tag8";x
Presentations\PowerPoint File 2.pptx;;"tag9";

Note

If one of the specifications remains empty, e.g. if you do not want to specify a new name for the file, leave this space empty.

If so, there are two semicolons right next to each other (see line 2 and 4 in the sample structure).

Note

Not all files from the import folder need to be included in the .csv file.

Was this article helpful?

/

Comments

0 comments

Article is closed for comments.