Content action
Saves or deletes one record. In the action picker it is Content, under Content Actions. With no connection it acts on the content types defined in this workspace on the Content Types page; with a Brightspot connection it acts on content in that CMS, where it also offers the CMS's own verbs. One node, one operation picked from what the chosen store can do.
Fields
| Field | Required | Description |
|---|---|---|
| Connection | No | Leave empty to act on this workspace's records. Pick a Brightspot connection to act on content in that CMS. |
| Site | No | Shown only for a Brightspot connection: the site to act on. Blank means the connection's site when it pins exactly one, otherwise every site the connection reaches. |
| Content Type | Depends | The record's type. Needed to create a record, and to look one up by any field other than the id. |
| Lookup Field | No | How the record is identified. Leave it blank, and the placeholder reads the content id, or pick one of the type's unique fields, such as a slug or an external id. The picker lists only the id and the fields marked Unique on the content type. |
| Lookup Value | Depends | The value the lookup field must equal, usually bound to an upstream node's content id. Every operation needs one except a Save that creates. If you bind a variable here and it resolves to nothing, the step fails rather than treating the empty value as a request to create. |
| Operation | Yes | What to do. The workspace offers Save, Delete, Archive and Restore; a Brightspot connection adds Publish, Transition, Post Comment and Complete Work Stream Item. Every verb exists once; each store says which it offers. |
Naming the record works the same way as on Content Fetch: by id unless you pick a unique field. A lookup by a field that finds nothing fails the step for every operation but a Save with Create If Missing.
Save
Creates or updates a record. Which one it does follows from what you set on the node:
- A Lookup Value means update the record it names, whether by id or by a unique field.
- A Content Type with no Lookup Value means create a new record.
- Create If Missing, shown once a Lookup Value is set, turns a lookup that finds nothing into a create instead of a failure: under the given id when looking up by id, or with the lookup field set to the lookup value otherwise, so the next lookup finds it. Needs a Content Type.
Values is where the record's values come from, one or the other:
- Simple Fields — one row per top-level field, each with a value that accepts variables. The field picker lists the chosen type's plain fields — text, true/false, number, dates and times, and lists and sets of those. A field that holds another record (a reference, an embedded object, rich text, a file) is set through Differences instead, where the value keeps the shape it is stored in. Right for a record whose values are plain, such as updating a title or setting a status.
- Differences — a JSON object of field changes keyed by record id, the shape a Script node's
dariSDK produces withdiff(...)ortoDifferences(). Use it for records a script builds, including anything with embedded objects; the SDK knows the content model, so the script never deals with the stored shape.
A Save that matches a record and changes no value fails rather than reporting a silent success; a Save with Create If Missing is exempt, since finding the record already as asked is the request being satisfied.
Under a dry run a Save writes nothing and logs what it would have done: which fields would change on the record it found, or that a record would be created, or the reason it would fail.
Delete, Archive, Restore
Delete removes the record for good. Archive is the reversible alternative: the record leaves every listing and Restore brings it back. Both work on workspace records and on content in a connected CMS.
Output
Every operation reports the record it acted on:
| Field | Description |
|---|---|
id | The id of the record saved, deleted, or otherwise acted on. |
Scope
A workspace's records are the records of the content types it defines, owned by it, and nothing else. A content id or type id from another workspace reads as not found at run time, not only in the form. With a connection, the same is true of content the connection cannot reach.