Opening

This group opens an existing plain-text file and loads it into the workflow, so the instructions that follow can add to it. Without it a workflow could only start from the empty file made by Create txt file.

Prerequisite: none. This is an entry-point instruction: it does not need a document to exist in the workflow beforehand — it brings one in by reading a file from disk. A workflow that appends to a .txt you already have begins here instead of with Create txt file.

These concepts are explained here once.

• The file to open (the source): the .txt file that is read from disk. If it is left empty, the instruction does nothing and no document is loaded.
• ⚠ Name and Path (the destination to save to) — leaving both empty overwrites the file you opened: where the opened text will be written when you save it later. Leave them both empty and it saves over the file you opened; fill them in and it is a save as. Whatever you leave empty is taken from the source, so a File path on its own keeps the original file name, and a File name on its own keeps its folder. The file name is inherited whole, extension included: opening notes.log and leaving the destination empty writes over notes.log itself. A File name you type is a name without extension, so that one takes the format’s own.
• Document: the Document key names the opened document so later instructions can target it. If you leave it empty, the opened text becomes the current document.
• Dynamic values @name: every field in this group is a text field, so all of them accept a saved value: type @ followed by its name and the value is substituted when the workflow runs.
• Nothing is written when the file is opened. The text is read into memory and only reaches the disk when a save instruction runs, at the destination given by File name and File path.

• Open txt file

Open txt file

Opens an existing plain-text file (.txt) from disk and makes it the document the workflow works on. Its whole content is loaded, so anything added afterwards goes after the text that was already there.

When to use it: to keep adding to a text file you already have — a running log, a list that grows every time the workflow runs — instead of starting an empty one each time.

Parameter	Meaning	Default	Required
File to open	The .txt file to read from disk (accepts @name)	(empty)	Yes
File name	File name the opened text will be saved under; empty = the name of the file you opened (accepts @name)	(empty)	No
File path	Folder the opened text will be saved to; empty = the folder of the file you opened (accepts @name)	(empty)	No
Document key	Names the opened document so later instructions can target it. Empty = current document (accepts @name)	(empty)	No

Important behavior: if File to open is empty, nothing happens and no document is loaded. The text is read as UTF-8, or as the encoding announced by a byte-order mark at the start of the file. The file is read once and then let go, so the original is never held open while the workflow runs, and it is rewritten only if the destination points back at it — which is what leaving File name and File path empty does. If the file does not exist, the workflow stops with an error. If the name in Document key is already in use by another open document, the workflow stops rather than discarding that document.

---