Configuring Additional Channels
For every Votiro Cloud for Web Downloads, you can configure several channels.
Define each channel as follows:
<Channel Name="[name]"
In="[In_folder]"
Out="[Out_folder]"
[PolicyParam1="value1" PolicyParam2="value2"...]/>
Specify [In_folder] and [Out_folder] using the following syntax:
Protocol |
Syntax |
|---|---|
FTP |
ftp://[username]:[password]@[IP_address_or_hostname]/[folder]/ Note Make sure you add a "/" at the end of the path. |
FTPS |
ftps://[username]:[password]@[IP_address_or_hostname]/[folder]/ Note Make sure you add a "/" at the end of the path. |
CIFS/UNC |
\\[IP_address or domain_name]\[username]:[password]@[IP_address or hostname]\[folder]\ Note Make sure you add a "\" at the end of the path. |
Note
Ensure that the path, file name, user name, and password you specify meet with the requirements listed in .
The following parameters are available for a channel:
Parameter |
Description |
|---|---|
| Name |
Unique channel name. This property makes logs more easily readable. It is recommended to choose a name that is descriptive of the channel. The channel name appears in the UI. Mandatory. |
| In |
Path of input folder. The folder must be accessible for read, list, write, modify and delete permissions. Mandatory. |
| Out |
Path of output folder. The folder must be accessible for read, list, write, modify and delete permissions. Mandatory. |
| PolicyConfigurationName |
The named policy that the channel will use. If left undefined, the channel will apply a default policy. |
| User | Active Directory username. |
| MaxFileSizeInBytes |
Maximum file size permitted to be processed. Files larger than the specified size remain in the input folder. The default value is long.maxvalue. Optional. |
IgnoreEmptyFile |
Specifies if files of 0 bytes must be processed. Disregarded files remain in the input folder. The default value is true. |
IgnoreFilesWithoutExtension |
Specifies if files without extension must be processed. Disregarded files remain in the input folder. The default value is false. |
| DeleteAfterSanitization |
Specifies if processed files must be deleted from the input folder. If files remain, they are renamed with the extension .Done. The default value is true. |
| InProcessItemsLimit |
The maximum number of files that a channel can mark as InProcess. If no limit is set, all the files inside the input folder will be marked as InProcess for a given channel. This prevents all other file connectors configured for this folder from processing those files. The default value is 3000. Note The maximum value is 999999999. |
| FileNotChangedInSeconds |
Number of seconds to wait for a file’s size or last modified property to change before it can be marked as InProcess. The default value is 2. |
ExcludedExtensions |
File extensions to ignore. In case you are using the File Connector for scanning a browser download folder, it is recommended to add the following temporary extensions to this parameter: "internet explorer" Value=".partial" "firefox" Value=".part" "chrome" Value=".crdownload"" The default value is " ". |
| ContextIdentifier |
Identifier that enables easy identification. Note An empty string "" is considered a legal value for this parameter. If you specify "$LastFolder", the subfolder (under the path defined for In) that contained the processed file is the identifier. If the file was in the root folder, however, an empty string "" is returned. The default value is [MachineID]-[Channel Name]. |
Illegal Characters
Avoid using the following characters when configuring a path, file name, user name, or password:
| n | < (less than) |
| n | > (greater than) |
| n | : (colon), except where the syntax requires it, as in: ftp://XXX.XXX.XXX.XXX |
| n | " (double quote) |
| n | / (forward slash), except where the syntax requires it, as in: ftp://XXX.XXX.XXX.XXX |
| n | \ (backslash), except where the syntax requires it, as in: \\XXX.XXX.XXX.XXX |
| n | | (vertical bar or pipe) |
| n | ? (question mark) |
| n | * (asterisk) |
Escaping Characters in Username or Password
| n | The colon and at sign (: and @) can be used in the username field by escaping them first with a backslash (\). |
| n | The colon, at sign, forward slash, and backslash (:, @, /, and \) can be used in the password field by escaping them first with a backslash (\). |
Example
The following example illustrates the configuration of channels that use all the supported protocols.
<Channels>
<Channel Name ="FC1" In="c:\sdsroot\FC\in\"
Out="c:\sdsroot\FC\out\"
PolicyConfigurationName="DefaultPolicy" IgnoreEmptyFile="true"
DeleteAfterSanitization="true" InProcessItemsLimit="3000"
FileNotChangedInSeconds="2" ExcludedExtensions=""
IgnoreFilesWithoutExtension="False"
ContextIdentifier="HR_files"/>
<Channel Name ="FC_FTP"
In="ftp://user1:password1@10.105.1.25/IN"
Out="ftp://user1:password1@10.105.1.25/OUT"
PolicyConfigurationName="DefaultPolicy"
IgnoreEmptyFile="true"
DeleteAfterSanitization="true"
InProcessItemsLimit="3000"
FileNotChangedInSeconds="2"
ExcludedExtensions=""
IgnoreFilesWithoutExtension="False"/>
<Channel Name ="FC_FTPS"
In="ftps://user2:password2@10.105.1.28/IN"
Out="ftps://user2:password2@10.105.1.28/OUT"
PolicyConfigurationName="DefaultPolicy"
IgnoreEmptyFile="true"
DeleteAfterSanitization="true"
InProcessItemsLimit="3000"
FileNotChangedInSeconds="2"
ExcludedExtensions=""
IgnoreFilesWithoutExtension="False"/>
<Channel Name ="FC_UNC
In="\\10.105.1.22\User3:Password3@10.105.1.22\In\"
Out="\\10.105.1.22\User3:Password3@10.105.1.22\Out\"
PolicyConfigurationName="DefaultPolicy"
IgnoreEmptyFile="true"
DeleteAfterSanitization="true"
InProcessItemsLimit="3000"
FileNotChangedInSeconds="2"
ExcludedExtensions=""
IgnoreFilesWithoutExtension="False"/>
</Channels>
Comments
0 comments
Please sign in to leave a comment.