UnderAutomation
⌘Q
Diese Seite ist nur auf Englisch verfügbar.

Manage controller files

Create, import, rename, delete, copy and move the files of a controller like in the Explorer: buttons and menu of the Files node, one confirmation per gesture with a copy of every replaced or deleted file, Cut, Copy, Paste and drag and drop between controllers and your PC, Replace or Keep Both, and what Fanuc and Yaskawa cannot do.

  • What changes the controller
  • Buttons and menus
  • New File and New Folder
  • Import files and folders
  • Rename
  • Delete
  • Cut, copy, paste and drag and drop
  • Replace, Keep Both or Cancel
  • The confirmation
  • A free user
  • What a controller cannot do
  • What to read next

This page explains how to create, import, rename, delete, copy and move the files of a controller from the Files node of the Controllers view, the way you do in the Explorer of VS Code. It applies to Fanuc and Yaskawa controllers, with the differences listed at the end. To browse and open the files, see Open controller files.

What changes the controller

Every action that creates, replaces, renames or deletes a file is a write. It follows the steps of every write: license, one confirmation, a copy of the old file, audit log. See Send a file to the controller.

FreePro
Open to the Side, Open With..., Download..., Copy Path, Refresh, Collapse All, Cut, Copy, and the paste of controller files into the ExplorerNew File..., New Folder..., Import Files..., Import Folder..., Rename..., Delete, Paste, and the drag and drop onto a controller
  • One confirmation for one gesture. Deleting three files, or pasting a folder with its files, opens one dialog that lists every change. Cancel: nothing is sent.
  • A copy before TouchUp replaces or deletes a file. The dialog says it: Delete /MD/HOME.LS (copied first).
  • The button Cancel has the focus when a file is replaced or deleted, so that one press of Enter never changes the controller.
  • The audit log has a line for each file and each folder. See Send a file to the controller.
  • The controller is checked again just before the change. When a file changed on the controller since you confirmed, TouchUp changes nothing and asks you to confirm again.

An action that the controller cannot do is greyed or hidden. When you run it, TouchUp says why and sends nothing.

Buttons and menus

Put the pointer on the Files node or on a folder: the buttons New File..., New Folder..., Import Files..., Refresh and Collapse All (on the Files node only) appear on the row, as in the title of the Explorer.

The buttons of the Files node and of a folder, in the free edition: the lock marks the actions that need Pro. The simulated Fanuc controller of this image has folders, so New Folder is offered.

Right click a file or a folder for the other commands.

The menu of a file of the controller, in the free edition: Rename (Pro) and Delete (Pro) carry the mark of the paid actions.
CommandWhat it does
Open to the SideOpens the file in a second editor, beside the first one
Open With...Opens the file, then asks which editor to use. See Parameter and variable files
Download...Saves a copy of the file on your PC. TouchUp asks for the place. A job is saved in the encoding that the editor uses for it
Cut, Copy, PasteThe clipboard of the Files node, see below
Copy PathPuts the path of the file on the controller in the clipboard of your PC
Rename... (F2)Renames a file. The name is selected without its extension
Delete (Delete)Deletes the files and folders you selected
Compare with Last BackupSee Compare backups and controllers
Restore This File from a Backup...See Back up a controller. It is a write: Pro

Select several rows with Ctrl or Shift and a click: Delete, Cut, Copy and the drag and drop act on all of them. The files must belong to one controller.

Refresh reads the folder again and keeps the open folders open. Collapse All closes them.

A user of the free edition sees the commands that change the controller with a lock and (Pro), for example Delete (Pro). See A free user.

New File and New Folder

New File... asks for the name in an input box. The grey example is the program of the brand: program.ls for a Fanuc controller, program.jbi for a Yaskawa controller.

New File in the folder MD of a Fanuc controller.
  • The file is created in the folder you clicked.
  • When the name ends with .ls or .jbi, the file is a program with the minimum content that the controller accepts: its header, no instruction. The name line of the program is written from the file name, in capitals. Any other file is empty.
  • The new file opens in the editor.
  • A Fanuc program name starts with a letter, then letters, digits or _, 36 characters at most. A Yaskawa job name follows the rules that the editor shows for a job name.
  • Every name: no / \ : * ? " < > |, no control character, no space at the start or the end, and not a name that exists in the folder (the case does not matter).

The dialog of the confirmation says New file /MD/PICK2.ls. TouchUp never replaces a file with New File.

New Folder... creates a folder the same way, on the controllers that have folders.

Import files and folders

Import Files... opens the file dialog of your PC. Select one or more files: they are sent to the folder.

  • A name that exists in the folder asks <name> exists in <folder> of <controller>. Replace? with Replace and Cancel. A replaced file is copied first.
  • A file of more than 5 MB, or files of more than 50 MB together, are refused with the reason. A file of a controller is rarely that big.

Import Folder... sends a whole folder of your PC, with its folders and files.

  • Names that start with a dot (hidden files and folders) and linked files and folders are not imported. The confirmation lists them.
  • At most 2000 files and folders.
  • A folder that already exists on the controller is refused: there is no merge. Open it and use Import Files....

Rename

Rename... renames a file on the controller. The file is kept, so there is no copy.

  • Only a file can be renamed. A folder cannot, yet.
  • A program (.ls on Fanuc, .jbi on Yaskawa) cannot be renamed: its name is also written inside the program. TouchUp says so, before the license check: Copy it with a new name, then delete it. Create the program again with New File..., or copy and edit it.
  • The new name follows the rules of New File.... On a Fanuc controller, a name with a space, * or ? is refused, and a file stays on its device.

Delete

Delete (or the Delete key) deletes the selected files and folders. The confirmation lists them one by one.

Two programs selected: one confirmation, each program is copied first.
  • A folder is deleted with its files and folders. The confirmation lists them, and the files are copied first.
  • The result is one message: TouchUp: HOME.LS deleted, PLACE.LS deleted. When some changes are refused, it lists what was done and what was refused with the reason.

Cut, copy, paste and drag and drop

Drag the selected files onto a folder, or use Cut or Copy, then Paste on the target folder. The result depends on the source and the target:

A move inside one controller, a copy to another controller, an upload from your PC and a download to your PC.A move inside one controller, a copy to another controller, an upload from your PC and a download to your PC.
A move inside one controller, a copy to another controller, an upload from your PC and a download to your PC.
FromToResult
A controllerThe same controllerDrag and drop, and Cut, move the files. Copy copies them
A controllerAnother controllerA copy. The source stays on the first controller, even after Cut
Your PC (drag and drop)A controllerAn upload
A controllerThe Explorer of VS Code (drag and drop, or Paste Controller Files)A download
  • Inside one controller, a move is a rename. It works for the files that can be renamed: a program and a folder cannot be moved, and TouchUp tells you to copy it, then delete the original.
  • A move never replaces a file, and never deletes one. When the name exists in the target folder, the question offers Keep Both or Cancel only.
  • Onto another controller, the file is copied, and the source stays on the first controller: TouchUp never deletes on a controller as a side effect of a paste. The confirmation says it.
  • From your PC, drag files or folders from the Explorer of VS Code or from the file manager of your PC onto the Files node or a folder. The rules are the ones of Import Files... and Import Folder...: hidden files and links are left out, the same limits.
  • Into the Explorer, drag a file of the controller onto a folder of the Explorer, or copy it and run Paste Controller Files in the menu of a folder of the Explorer. It is a download, it is free, and TouchUp asks before it replaces a file of your PC. A name that your PC cannot accept, for example a name with : or *, is left out.
  • The clipboard of the Explorer cannot be read by TouchUp. To send a file from your PC, drag it or use Import Files....
  • Cut waits: if you decline a paste, the files stay cut, as in the Explorer.

Replace, Keep Both or Cancel

When a name already exists in the target folder, a question asks what to do, as the Explorer does:

Paste of a file whose name exists in the folder: Replace, Keep Both or Cancel.
AnswerWhat it does
ReplaceThe old file is copied, then replaced. Not offered for a folder (there is no merge), for a file onto itself, or for a move
Keep BothThe new file gets a free name: NAME_1.EXT, NAME_2.EXT... Not offered for a program, whose name is inside the file
CancelNothing is changed

Two files with the same name in one gesture are refused: paste or drop them in two steps.

The confirmation

One dialog lists each change, in plain words:

RowMeaning
New file <path>A file that does not exist yet
Replace <path> (the file on the controller is copied first)A file is replaced
Rename <path> to <name> (the file is kept, no copy)A rename
Delete <path> (copied first)A file is deleted
New folder <path>A folder is created
Delete the folder <path>: 2 files and 1 folder insideA folder is deleted with what it holds

A change that TouchUp or the controller refuses stays in the list with Refused: and the reason. The other changes can go on. When every change is refused, Confirm is greyed.

After you confirm, TouchUp makes the changes one by one and reports once: what was done, then what was refused or failed, each with its reason. When the link with the controller is lost, the remaining changes are not tried, and the message says Outcome unknown for the one in progress: check the controller and the audit log before you try again.

A free user

The commands that change the controller are visible with a lock and (Pro). When a free user runs one, TouchUp shows the dialog of TouchUp Pro: the reason, what Pro adds, what stays free, and the way to try it. See Editions and license. Nothing is asked first (no name, no file dialog) and nothing is sent to the controller.

The commands that only read stay free: Open to the Side, Open With..., Download..., Copy Path, Refresh, Collapse All, Cut and Copy.

What a controller cannot do

BrandNot available
FanucNew Folder..., Import Folder..., and the copy or delete of a folder are not available yet. You can browse the folders and work on the files inside them. A program (.ls, .tp, .pc) can be created only at the top of the MD: device. A file stays on its device when you rename it. A .LS or .VA at the top of MD: cannot be deleted: it is the listing that the controller makes of a .TP or a .VR. Delete the .TP or the .VR instead
YaskawaNo Rename... and no folder: the name of a job is inside the job, and the controller has no folders. Copy a job with a new name, then delete the old one. A .prm file is never deleted nor sent: see Load a parameter file at the pendant

A job or a program whose name line names another program is refused. Edit the name line first.

What to read next

  • Open controller files
  • Send a file to the controller
  • Back up a controller
  • Editions and license