Request Collections

A request collection is a local directory that contains saved Dynomate requests. A request can contain one or more DynamoDB operations.

Use collections to keep related requests together. For example, one collection can contain requests for order support, release checks, or test data.

Access

Request tabs are available during a trial and with Professional or Enterprise access. Community and Indie access can show saved requests in the sidebar, but the request tab is locked.

Create a Collection

1. Open Request Collections in the sidebar.
2. Select the + button.
3. Enter a collection name.
4. Select Browse.
5. Select the parent directory for the collection.
6. Select Create.

Dynomate creates a directory with the collection name. It also creates a collection.toml marker in that directory. Dynomate uses this marker to identify the directory as a collection.

A collection name cannot contain /, \, :, *, ?, ", <, >, or |.

Create and Save a Request

1. Expand a collection in the sidebar.
2. Select New Request.
3. Select the generated request name in the editor header.
4. Enter a new name.
5. Select Add Operation.
6. Configure the operation.
7. Select Save.

The editor Save button saves the complete request. It saves all operations and request variables together. Dynomate does not save each operation separately.

You can rename a saved request from the editor header. Dynomate renames the request file and updates its internal name. The request name collection is reserved.

To build a request with more than one operation, continue with Multi-Operation Requests.

Local Files

Dynomate stores each saved request as <request-name>.toml in the collection directory. Collection environments are stored as JSON files under environments/. The collection itself is not exported as one JSON file.

Select the collection menu and then select Reveal to open its directory. Dynomate watches tracked collection directories. A valid request file that appears in a tracked collection is loaded into the sidebar.

Share a Collection

Dynomate does not provide collection JSON export or import. Share the collection directory through a file transfer or a version-control repository.

1. Select Reveal for the collection.
2. Save any open request before you copy the directory.
3. Copy the complete collection directory.
4. Place the directory below a tracked collection base path on the other Dynomate installation.
5. Restart Dynomate to load the added collection.

Review collection environment files before you share or commit them. A value marked as secret is masked in the Dynomate editor, but the local environment file still contains the value.

Use Variables to keep request structure separate from values that change between environments.