The Add File To Remote DropBox job step type is used to insert a single data file into a specific column/row/date coordinate of a Matrix stored in a separate pasUnity application farm.

 

Matrix functionality requires either a subscription to the hosted pasPortal collaboration application or the development of custom interfaces.

 

The job will fail if the storage limit for the matrix is exceeded or if the maximum number of files for the DropBox has been reached.

 

This job step type extends basic job step functionality.  For details common to all job step types click here.

 

In addition to the common attributes shared by all job steps this job step type has the following attributes:

 

Remote DropBox tab:

•Source File or ID: The fully qualified name of the existing file to upload to the DropBox or the ID of a data file from the local pasUnity instance as an alternate.

•Ignore Zero-Length Files: Skips job step operation if the file to upload is detected as have a size of 0 bytes indicating no content.

•Endpoint Name: The endpoint from the current machines application configuration file that describes the remote endpoint to connect to.

•Endpoint Address (Optional): URL of the endpoint if you wish to override what is provided by the application configuration file.

•Certificate Subject Name (Optional): Certificate Subject (usually the DNS name) of the endpoint if you wish to override what is provided by the application configuration file.

•User Name: The user name for accessing the remote endpoint.

•Password: The password for accessing the remote endpoint.

•Test Connection: This button will test the user name and password against the Endpoint to see if it is valid.

•Selection Mode: Determines the type of logic used to target the DropBox into which the file will be inserted.

•Specific DropBox: Choose this option when the exact column and row values of the DropBox can be determined when authoring the job.

•DropBox: The exact DropBox (specified using column/row) that the file is to be deposited into.

•Dynamic DropBox: Choose this option when the column and row of the DropBox cannot be determined until the job is executing.

•Matrix: The name of the matrix that contains the DropBox you wish to target.

•Matrix Column Name: The name of the column used to target the DropBox.

•Matrix Row Name: The name of the row used to target the DropBox.

•Allow Reference Files: When checked the Target Date can be omitted enabled the upload of reference files.

•Target Date: The periodic date/time value to target for the data file being added.  The default value is {UNITY-WORK-QUEUEDATE} - the date and time the work was enqueued.  Optional when Allow Reference Files is checked.

•Tag (Optional): An optional value which can be used to filter impellers or simply provide additional information about a file.

•Contributor (Optional): An optional value which can be set using a Macro or Parameter to communicate the email address of the user providing the file.

•Data File ID Output Parameter (Optional): If a value is provided the DataFileID of the newly created data file will be stored in a parameter named for the value provided.

NOTE: The Endpoint Name, User Name, and Password must be completed and correct prior to Selection Mode setup.

The job will fail if the Processor Agent account does not have permission to read the content of the file to save to the DropBox.

After making changes be sure to press the Update button to save your changes.

 

Copyright © 2024 pasUNITY, Inc.

 

Send comments on this topic.