Matrix42 Trigger icon

Matrix42 Trigger

Starts the workflow when objects are created or updated in Matrix42

Matrix42 Trigger

AI-generated

Summary

Polls Matrix42 on the configured schedule and emits matching records that appeared since the previous check. Choose an event to watch new tickets, new objects, or created and updated objects; the first active poll establishes a starting watermark, and Fetch Test Event returns the newest matching record without changing that state.

Inputs

  • Poll Times (required) — One or more polling schedules: every minute, hour, day, week, or month; every X minutes or hours; or a custom cron expression. Defaults to every minute.
  • Authentication (required) — Select Webservice Token or Basic authentication and provide the corresponding Matrix42 credentials.
  • Event (required) — Choose Ticket Created, Object Created, or Object Created or Updated. Ticket Created watches the SPSActivityClassBase definition; Object Created watches a creation-date attribute; Object Created or Updated uses the universal TimeStamp rowversion.
  • Data Definition Name or ID (required) — For object events, choose or specify the class whose records to watch. Defaults to SPSActivityClassBase, which covers Service Desk tickets.
  • Type Filter Names or IDs — Optionally restrict results to selected configuration-item types. An empty selection includes all types.
  • Created-Date Attribute (required) — For Object Created, specify the class attribute containing the creation date. Defaults to CreatedDate; polling fails if the class does not have that attribute or it contains no usable date.
  • Additional Fields — Optionally add comma-separated Extra Columns, fetch the complete object as Object (one extra request per result), apply an ASQL condition combined with the watermark condition, or set a result limit. The limit defaults to 50 and is capped at 1000.

Output shape

A batch of JSON items, one per matching record; returns no items when there are no new matches.

Each result includes the fragment ID, object ID, and watermark attribute, plus requested extra columns. With Fetch Full Object enabled, the complete object is attached as Object when its type and ID can be resolved. The first active poll records the newest matching watermark and emits nothing, so only subsequent records are emitted. Fetch Test Event returns the newest matching record as a sample without updating trigger state.

Links

Discussion