Skip to main content

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

FieldRequiredDescription
ConnectionNoLeave empty to act on this workspace's records. Pick a Brightspot connection to act on content in that CMS.
SiteNoShown 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 TypeDependsThe record's type. Needed to create a record, and to look one up by any field other than the id.
Lookup FieldNoHow 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 ValueDependsThe 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.
OperationYesWhat 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 dari SDK produces with diff(...) or toDifferences(). 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:

FieldDescription
idThe 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.

Was this page helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.