action:File_Actions
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| action:File_Actions [2019/06/25 07:41] – peternlewis | action:File_Actions [2024/11/10 06:42] (current) – [How To Use] peternlewis | ||
|---|---|---|---|
| Line 3: | Line 3: | ||
| This Action is actually a multipurpose Action that provides the following Options: | This Action is actually a multipurpose Action that provides the following Options: | ||
| (Most Options can be used with either a File or Folder, except as indicated.) | (Most Options can be used with either a File or Folder, except as indicated.) | ||
| - | * Move (and/ | + | |
| + | * Create Unique File (v10.0+) | ||
| + | | ||
| + | * Rename | ||
| + | * Move or Rename | ||
| * Copy | * Copy | ||
| * Duplicate | * Duplicate | ||
| * Move to Trash | * Move to Trash | ||
| * Delete File (permanently) | * Delete File (permanently) | ||
| - | * Reveal in Finder | ||
| * Delete Directory (permanently) | * Delete Directory (permanently) | ||
| - | {{:action: | + | Delete is obviously dangerous, and Delete Directory is extremely dangerous. Ensure you have full system backups before using this action. |
| ===== How To Use ===== | ===== How To Use ===== | ||
| - | You can either insert | + | Select |
| - | + | ||
| - | {{: | + | |
| Click the File Chooser button on the right of an action to select an existing file or folder on disk. Option-click on the File Chooser button to show the currently selected file or folder in the Finder (assuming it exists already). | Click the File Chooser button on the right of an action to select an existing file or folder on disk. Option-click on the File Chooser button to show the currently selected file or folder in the Finder (assuming it exists already). | ||
| Line 24: | Line 25: | ||
| ^ Option ^ Description ^ | ^ Option ^ Description ^ | ||
| - | ^ Copy | copies a file or folder. You must specify a name and location for the copy. | | ||
| - | ^ Delete | deletes a file (but not a folder) with no warnings or confirmation messages. The file is deleted and not moved to the Trash. Be careful with this action. | | ||
| - | ^ Duplicate | duplicates a file within the same folder and adds // copy// to the filename. | | ||
| - | ^ Move | moves and/or renames a file or folder. | | ||
| ^ Reveal | brings the Finder to the front with the file or folder selected. | | ^ Reveal | brings the Finder to the front with the file or folder selected. | | ||
| - | ^ Trash | moves a file or folder to the Trash from where it can easily be recovered. | | + | ^ Create Unique File (v10.0+) | create a new unique file based on the path you supply, adjusting the base name to something unique, and returning the new file path in the specified variable. | |
| + | ^ Move (v11.0+) | moves a file or folder. | | ||
| + | ^ Rename (v11.0+) | renames a file or folder. | | ||
| + | ^ Move or Rename | moves and/or renames a file or folder. | | ||
| + | ^ Copy | copies a file or folder. You must specify a name and location for the copy.\\ Since this requires a destination for the copy, if you want to just copy the file to the Clipboard, see [MACRO: | ||
| + | ^ Duplicate | duplicates a file within the same folder and adds // copy// to the filename. | | ||
| + | ^ Trash | moves a file or folder to the Trash (on remote volumes, the system may immediately delete the file) | | ||
| + | ^ Delete File | deletes a file (but not a folder) with no warnings or confirmation messages. The file is deleted and not moved to the Trash. Be careful with this action. | | ||
| ^ Delete Directory | Be **extremely careful** with this action as it deletes the folder and all its contents with no warnings or confirmation messages. | | ^ Delete Directory | Be **extremely careful** with this action as it deletes the folder and all its contents with no warnings or confirmation messages. | | ||
| ==== Move and/or Rename ==== | ==== Move and/or Rename ==== | ||
| - | {{: | + | The option _Move_or_Rename_ allows you to do three different things, based on the data you supply in the _to_ field. |
| + | |||
| + | If you specify a folder in the _to_ field (eg `~/ | ||
| - | This Action Option can be confusing because although the Option popup shows only _Move_, it in fact **allows | + | If you specify a file name (without any slash `/`) (eg `NewName.jpg`), then the file will be renamed. |
| - | === Operations Available === | + | If you specify a full path to a new location with a new name (optionally the same name) (eg `~/ |
| + | The _Move_ option requires the _to_ field to specify an existing folder and moves the specified source file or folder to the new location. | ||
| - | ^ Operation ^ Description ^ To Field ^ Example ^ | + | The _Rename_ option requites |
| - | ^ Move _Only_ | Moves the Item to a Different Folder, and keeps the same Item Name | Full Path to the existing Destination _Folder_ | ~/ | + | |
| - | ^ Rename _only_ | Renames the Item, which stays in its original Folder | Can be either just the _new_ Item Name (including extension, if any)\\ OR Can be the full path to the item with its _new_ name. | Some New File Name.txt | | + | |
| - | ^ Move _and_ Rename | Moves the Item to a Different Folder with a _new_ name | Must be the _Full Path_ to the Item, with its _new_ Item name and existing Destination Folder. | ~/ | + | |
| === Overwrite Existing File(s) === | === Overwrite Existing File(s) === | ||
action/File_Actions.1561448478.txt.gz · Last modified: by peternlewis