Salesforce

File Archive - Methods (Magic xpi 4.14)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

File Archive – Methods

Use the following methods to configure the File Archive component:

The following table lists the methods and parameters that can be used. Parameters in bold are mandatory.

Name

Parameters

Description

Archive method archives selected files.

File to Archive

The name of the file to archive. You can enter wildcard characters (such as *or ?) to indicate a group of files. For example, if you have a group of files that begin with the word Stop, enter Stop* to archive all files that begin with Stop.

If a wildcard (*.* or *.txt) character is used as the source file name, it will create a zip file called archive.zip if the multiple files are on the root directory.

If multiple files are on a directory or folder such as c:\temp\*.* the zipped file's name will contain the name of directory (for example, temp.zip).

Archived file name

Enter the file name and path of the new archived file.

When you archive a file into a folder or directory with the same name as a file that is in that directory, the original file is overwritten. For example, if you archive a.txt as a.zip and then archive b.txt as a.zip in the same folder, the new file overwrites the original file.

Encryption Password

Provide the password that you would like to encrypt the archive with. The maximum allowed length for the password is 30 characters.

If the parameter is left empty, the Archive will not be password protected.

The same password will be required when extracting the file.

The password handling mechanism with respect to Unicode characters (multilingual/special characters) may not be consistent for different zip tools. Due to this, your experience may vary across tools. To be sure that packing and unpacking of such archives is smooth between xpi and the external tools, it is recommended to not use non-English or special characters in the password.

Tools like WinRAR, and 7-Zip are found okay to work in these special cases. You are still recommended to run your own tests.

Since version: 4.13.4

Return file as BLOB

Select Yes or No from the drop-down list to indicate whether to return the file as a BLOB.

Error Code

This parameter is returned, with the corresponding error code, when an error occurs.

Click to open the Variables List. Select a variable where the error code is returned, and then click Select.

Extract method extracts selected archived files.

Source File to Extract

Enter the file name and path of the file to extract.

Location to Extract

Enter the file name and path of the folder where the file is to be extracted.

Encryption Password

Use this parameter to extract the archive file protected with the password. If the archive is not password protected, then this parameter should be left blank.

Since version: 4.13.4

Error Code

This parameter is returned, with the corresponding error code, when an error occurs.

Click to open the Variables List. Select a variable where the error code is returned, and then click Select.

Related Topics

How to Use Direct Access Methods

Reference
Attachment 
Attachment