The Save File From DropBox job step type is save the contents of a single data file from a specific column/row/date coordinate of a Matrix.

 

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

 

If more than one file meets the targeting criteria defined in the job step the job step will fail.

 

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:

 

DropBox tab:

•Destination File: The fully qualified name to use when saving the data file stored in the DropBox.  Data File Property information can be included in the file name using the appropriate Macro.

•Reset {UNITY-SOURCE-FILE} and related tokens: Regardless of what file triggered the job to execute, or the value stored in the Source File parameter of the job definition, this option gives you the ability to override the value of {UNITY-SOURCE-FILE}, {UNITY-SOURCE-FILE-NAME}, and {UNITY-SOURCE-FILE-PATH} tokens that are then provided to subsequent job steps with the name of the file attachment that is saved during this step.

•Selection Mode: Determines the type of logic used to target the DropBox to insert the file into.

•Data File ID: Choose this option when the ID of the data file you wish to target is explicitly known.

•Data File ID: The ID of the data file to save from the system.

•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 removal of reference files.

•Target Date: The periodic date/time value to target for the data file being saved.  Time is ignored.

•File Name Filter (Optional): A regular expression that can be used to further refine the targeting of a file by name.

•Tag Filter (Optional): A regular expression that can be used to further refine the targeting of a file by tag.

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

The job will fail if the Processor Agent account does not have permission to save the file to destination path specified.

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

 

Copyright © 2024 pasUNITY, Inc.

 

Send comments on this topic.