Skip to main content

The TransformScript Editor

The TransformScript Editor provides a numbered, syntax-highlighted field with a language reference and integration with the AI Assistant. Access the editor within the web interface for Automations, the options for a Transform File action, or an Expectation's Content Validation criteria.

Editor Modes

The editor appears inline in whatever form you're filling in, sized for a script you're reading rather than writing at length.

Expanding it opens the same editor in a window of its own, which is the better place to write anything substantial. Nothing about the script changes; only the room you have to work in does. In the expanded view, activating the AI Assistant docks the chat window with your script, so you can see the script and the conversation about it at the same time.

The editor automatically checks your script syntax as you type. A list of errors with their line references appears below your editor field. Clicking the header of a reported error moves your cursor directly to the error in your script.

TransformScript Reference

TransformScript Reference shows a panel with quick reference information. It explains the shape of a script and the available output formats. The reference also shows some short examples.

Ask AI

While you're editing a TransformScript, using Ask AI to open the AI Assistant automatically shares your script with the assistant, so you can describe what you want in plain language instead of starting from a blank field. Because it can read what's already there, you can also point at a specific part of an existing script and ask for a change to that part alone.

You can start from the AI Assistant by asking for a valid TransformScript to solve a problem. When the Assistant writes a script, it appears in the conversation with a Use Script button to copy it into the editor. Without pressing the button, the Assistant doesn't replace your script. That leaves you free to ask for several attempts and take the one you want.