Write File |
The Write File action writes a data string to a file.
You can configure the following properties for the Write File action:
Action
Name: Specifies the name of the action. If desired, you can replace the default name by typing a new name in the field.
Description: Allows you to save a description for the action.
Run Action: Allows you to specify how often you want to run the action.
Always: Specifies that the Integration Service will run the action each time it runs the integration.
Never: Specifies that the Integration Service will not run the action when it runs the integration.
Conditionally, based on variable: Specifies that the Integration Service will run the action only when a selected variable meets a specified condition. Use this option in situations where there is only one condition that determines whether or not the action will run. Once you have enabled this option, you can create the conditional statement in the input box provided.
Conditionally, based on expression: Specifies the conditions under which the Integration Service will run the action. Use this option for situations that require more than one conditional statement. Once you have enabled this option, you can create the conditional expression in the input box provided by creating the desired conditional statements. You create and edit your conditional expression on the Tree View tab. Click the Text View tab to see a read-only text view of the conditional expression.
Source
Source: Specifies the source for the data on which you want to perform the action.
Value: Use the input box provided to enter the data you want the action to use. Alternatively, you can add a variable to specify the data, or add a special character to the value you have entered.
Import: Opens the Open File dialog so that you can browse to and select a file containing the desired data. The contents of the file are imported into the Value input box.
Export: Opens the Save File dialog so that you can save the contents of the Value input box as an external file. You can save the value as a new file, or replace the contents of an existing file.
Variable:
Variable: Type the variable that you want to use for the source. Alternatively, you can add a variable.
External File:
Location: Specifies the file system where the source folder exists. File systems or locations can include local file systems or network shares, Librarian, or a supported cloud storage location. For more information about supported cloud storage locations, see Administration Console's
File Name: Specifies the file path. You can type the folder location and file name or click Browse to locate and select the desired file. Alternatively, you can add a variable to specify the desired file, or add a special character to the value you have entered.
File Encoding: Specifies the encoding used by the source file.
Destination
Location: Specifies the file system where the destination file exists. File systems or locations can include local file systems or network shares, Librarian, or a supported cloud storage location. For more information about supported cloud storage locations, see Administration Console's
File Name: You can type the folder location and file name or click Browse to locate and select the desired file. Alternatively, you can add a variable to specify the desired file or add a special character to the value you have entered.
File Encoding: Specifies the encoding to use when writing the data.
Append to file if it already exists: Specifies that if the destination file already exists in the folder, the new content will be appended to the file's existing content.
Replace file if it already exists: Specifies that if the destination file already exists in the folder, the new content will be saved to a file that replaces the existing file.
Make file name unique by appending serial number: Specifies that if the destination file already exists in the folder, the new content will be saved to a file that is made unique by appending a serial number to the file name.
Make file name unique by appending time stamp: Specifies that if the destination file already exists in the folder, the new content will be saved to a file that is made unique by appending a timestamp to the file name.
Fail if destination file exists: Specifies that if the destination file already exists in the folder, the new content will not be saved.
Locked-File Timeout: Specifies how long to attempt to open the file that is found to be initially locked by another application.
Saved path variable name: Specifies the variable to be used to store the saved file path so that it can be used in the other actions.
Test Write File
Test: Runs the action. The Message pane displays information on the success or failure of the action.
|
Clicking the Test button executes the action only and does not run the integration. Therefore the action will run without any data from the integration that you may have configured it to use. For information on testing your integration, refer to Using the Test Pane. |
User Account
Inherit from parent action: When enabled, the action inherits the user account credentials specified on the Actions property page. Alternatively, if the action is part of a Group action, it will inherit the user account credentials specified on the immediate parent Group action’s property page.
Specify user credentials: When enabled, the action runs using the credentials specified.
Error Handling and Diagnostics
Ignore errors and continue running actions: When enabled, specifies that if the action fails, the remaining actions will continue to run.
|
When this property is not enabled and the action fails, the resulting behavior depends on the following scenarios:
If the selected action is within a Group action, no actions outside of that Group action are affected. |
Retry if failed: When enabled, specifies that if the action fails, the Integration Service will try to run it again.
Maximum retries: Specifies the maximum number of times the Integration Service will try to run the action again. Available when Retry if failed is enabled.
Retry interval: Specifies the amount of time the Integration Service will wait after the action has failed before trying to run the action again. Available when Retry if failed is enabled.