////
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at
  http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
////
:documentationPath: /workflow/actions/
:language: en_US
:description: The Process result filenames action allows you to copy, move or delete a number of files and/or folders to alternate locations on your file system.

= Process result filenames

== Description

The `Process result filenames` action allows you to copy, move or delete a number of files and/or folders to alternate locations on your file system.

== Options

[options="header", width="90%", cols="1,3"]
|===
|Option|Description
|Workflow action name|The name of the workflow action.
|Action a|Choose one of

* Copy (default)
* Move
* Delete
|Destination folder|Define the target folder
|Create destination folder|use this option to create the destination folder when it does not exist
|Replace existing file|use this option to overwrite existing files
|Remove source filenames from result|use this option to remove the processed filenames from the list of result filenames
|Add destination filenames to result|use this option to add the the processed target filenames to the list of result filenames
|Add date to filename|add the date to the target filename, e.g. yyyyMMdd
|Add time to filename|add the time to the target filename, e.g. HHmmss
|Specify date time format|allows you to specify your own date-time format, e.g. yyyyMMdd_HHmmss
|Add date before extension|when this option is not checked, the date/time is appended after the file extension
2+|Limit to
|Limit action to|Define include and exclude wildcards
|Wildcard (RegExp)|The regular expression wildcard to use to include files
|Exclude Wildcard (RegExp|The regular expression wildcard to use to exclude files
2+|Success On
|Success on a|Success condition : select one of these option:

* Success when all works fine
* Success when at least x files moved (specify x in the limit field below)
* Success when number of errors lesser than (specify the max number of errors in the limit field below)
|Nr errors lesser than|The number of errors or number of files specified in the `Success on` option above.
|===