Modules

Export and import a module

Export a custom module's structure to a file and import it into another workspace, and read what an import adds, leaves out, and refuses.

A custom module built in Studio can be exported to a file and imported into another module list. The file holds the module's structure only: its fields, stages, sub pages, and layout. It never holds records, people, connectors, or keys.

Export a module

Open the module in Studio and select Export in its top bar. The module downloads as a file. Studio says what the file holds: this module's structure only.

Import a module

  1. Open Studio's Projects page and select Import module.
  2. Choose the file under Module file. Studio reads it and shows what it would add and what it leaves out.
  3. Read the list. Nothing changes until you apply it.
  4. Apply the change. Undo takes it back, and the module can be deleted and restored like any other. See Delete and restore a custom module.

What an import leaves out

The review lists each part that could not come along:

  • A field that links to another module is left out.
  • A calculated field that depends on a left out field is left out too.
  • A field whose access could not be read stays with Super Admins.
  • A field that names a role this workspace does not have is left off the list of who may see or change it.
  • A field that names access groups of another workspace is left off. Choose this workspace's groups in the field's properties.
  • A record type that refers only to things outside the file is left out.

What an import refuses

A file is refused, with a reason, when:

  • It is larger than the size limit shown.
  • It is not a module file, or cannot be read as one.
  • It comes from another version of Agaro.
  • It holds something a module file never carries, such as records, people, connectors, or keys.
  • It has something Agaro cannot accept, and the message names where.
  • It is nested too deeply to read.
  • Nothing in it can be used here, because every field refers to something outside the file.

Troubleshooting

The file could not be read

Export the module again and import the new file. Do not edit the file by hand.