-
Title
How to troubleshoot File Operations -
Description
This knowledge base article explains the various components of the File Operations object and how to troubleshoot a problem encountered within the element. -
Resolution
The File Operations object provides the ability to Copy, Delete, Move and Rename files and folders. File Operations support local, mapped and network drive paths as well as a generous portion of operation options.
File Operation
Operation: Select Copy, Move/Rename, Delete or Create Folder from the Operation list to specify the action to execute on the specified files.
Source Folder: Specify the folder on which the selected Operation will act upon.
Source File(s): Specify the files on which the selected Operation will act upon.
Destination Folder: For Copy, Move/Rename or Create Folder operations, specify the folder to be used as the destination for the selected Operation.
Destination file(s): For Copy or Move/Rename operations, specify the file names to be used for the destination of the selected Operation.
Options
Only Files: Select this check box to enable extra File Operation options. When enabled, select changed before, changed after, changed between, changed on and older than from the list
Changed Before: Select changed before, for the selected operation to act on all files last modified prior to the specified date.
Changed After: Select changed after, for the selected operation to act on all files last modified after the specified date.
Changed Between: Select changed between, for the selected operation to act on all files last modified between (and including) the specified dates.
Changed On: Select changed on, for the selected operation to act on all files last modified on the specified date.
Older Than: Select older than, for the selected operation to act on all files older than the specified number of days.
Last Accessed Before: Select last accessed before, for the selected operation to act on all files that were last accessed before the specified date.
Last Accessed After: Select last accessed after, for the selected operation to act on all files that were last accessed after the specified date.
Last Accessed Between: Select last accessed between, for the selected operation to act on all files that were last accessed between the specified dates.
Last Accessed On: Select last accessed on, for the selected operation to act on all files that were last accessed on the specified date.
Last Accessed More than X Days: Select last accessed more than X days, for the selected operation to act on all files that were last accessed more than the specified number of days ago.
Include subdirectories: Select this check box to include all subdirectories of the Source Folder in the selected Operation. Clear this check box to exclude all Source Folder subdirectories in the selected Operation.
Continue on error: Select this check box to continue performing the selected Operation regardless of any errors that occur during the execution of the action. Clear this check box to stop the selected Operation if an error occurs.
Include hidden/system files: Select this check box to include all hidden and system files in the selected Operation. Clear this check box to ignore all hidden and system files in the selected Operation.
Overwrite read-only files: Select this check box for the selected operation to overwrite or delete read-only files. Clear this check box for the selected operation to ignore all read-only files.
Overwrite existing files: For Copy or Move/Rename operations, select this check box for the operation to overwrite existing files. Clear the check box for the operation to ignore existing files.
Overwrite older files: For Copy or Move/Rename operations, select this check box for the operation to overwrite existing files if the destination file is older than the source file. Clear the check box for the overwrite operation to ignore overwriting destination files that are older than the source files.
Perform copy asynchronously: Select this box to perform the selected operation asynchronously. In asynchronous mode, the File Operations element will execute at the same time as other File Operations elements. If this check box is cleared, applications will run sequentially one after another. Each application must complete before the next one will begin.
Redirect to 32 bit folder on 64 bit operating systems: Select this box to force the operation to copy files to the corresponding 32-bit folder, when performing the operation on 64-bit operating systems.
Show progress bar: Show the progress of the file operation.
1. Select the Validation Logic tab to set the validation rules to client machines for this element.
2. To complete the process click the Save button, followed by clicking the Replicate button in the lower left corner and selecting Yes in the Replication when prompted to replicate.
3. Check the Sltrace File for any errors or return codes.
Return Codes:
All return codes are Microsoft return codes. The text for a return code can be obtained by dropping to a command prompt and typing NET HELPMSG followed by the return code number. For example: If a Return code: 5 is encountered, typing NET HELPMSG 5 [Enter] will return the text “Access is denied.”
Additional Information:
If the specified file and/or folder resides on a network share, that the user launching the application must possess the appropriate privileges to access the file and/or folder on the source and target share.
Troubleshooting:
To aid in troubleshooting, it's best to setup Validation Logic only for one test user or test workstation so you can determine that the element is working the way it is intended before applying the settings to multiple users or machines.
1. Check the SLTrace File. (%temp%\Desktop Authority\SLTrace.htm)
- Verify that the element validated and the settings attempted to apply.
- Verify the settings for the element are showing as expected.
2. How would you accomplish the File Operation without Desktop Authority?
- Run the command manually on the user’s machine. Did the command work as expected? Do you receive any errors?
Example: Use the XCOPY command to manually attempt a copy.
3. If the element validates correctly, and the file operation works manually but doesn't appear to work when Desktop Authority runs, then Contact Support.