Skip to content

Add tutorial articles explaining standard actions and triggers - #1584

Merged
andrewreshitko merged 5 commits into
masterfrom
docs/actions-and-triggers-tutorials
Sep 15, 2026
Merged

andrewreshitko merged 5 commits into
masterfrom
docs/actions-and-triggers-tutorials

Conversation

@andrewreshitko

Copy link
Copy Markdown
Contributor

Adds three getting-started tutorials covering the recurring action/trigger vocabulary (Upsert Object, Lookup Objects, Make Raw Request, polling/webhook/real-time triggers, etc.) shared across most components: what each one means, why components are named generically, and how to choose between them when building a flow.

andrewreshitko and others added 4 commits September 7, 2026 16:06
Adds three getting-started tutorials covering the recurring
action/trigger vocabulary (Upsert Object, Lookup Objects, Make Raw
Request, polling/webhook/real-time triggers, etc.) shared across most
components: what each one means, why components are named generically,
and how to choose between them when building a flow.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Rounds out the Getting Started > Platform Features list, which previously
skewed toward auth/admin topics (Component Overview, Webhooks, OpenID,
Recipes, Copy/Export, Re-auth) with little coverage of the core
flow-building capabilities that differentiate the platform.

Each article is a concise, concept-first explainer in the style of the
existing "Understanding Actions and Triggers" tutorial, linking out to
the full deep-dive guide in the Integrator Guide rather than duplicating
its content:

- Content-Based Routing
- Real-Time Flows
- Rebound Feature
- Custom Error Handler
- Flow Linking
- Scheduled Executions
- Data Mapping
- Embedded Recipe

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Add Subscribe to Events as a third trigger type in the vocabulary
  table, and generalize "real-time stream" language to "event
  subscription" since many of these triggers work outside real-time
  flows too — that requirement is usually named in the trigger itself.
- Swap the AFAS example link for Microsoft Dynamics Business Central.
- Drop Delta Detection from the trigger-picking guide (it has no
  triggers).
- Trim a redundant decision-guide line in Choosing an Action.
- Remove a redundant/ungrammatical sentence in Mapping Data.
- Correct Real-time flows: a step starts when a trigger receives a
  message, not when the flow itself is started.
- Remove the duplicate content/_guides/rebound.md page, keeping
  content/_developers/rebound.md as the canonical version, and repoint
  the one dangling link at it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The previous commit misapplied three of these fixes to old, unrelated
_guides files instead of the newly-added getting-started companion
articles (Data Mapping, Real-Time Flows, Rebound Feature):

- Remove content/_getting-started/rebound-overview.md entirely.
- Real-Time Flows: a step starts "when a trigger receives a message",
  not "produces" one.
- Data Mapping: drop the redundant required/optional-fields aside.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
layout: article
section: Tutorials
order: 4
description: A practical guide to the trigger types you'll find across components — polling, webhooks, and real-time streams — and how to decide between them.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

real-time streams -> real-time flows

- Append "Overview" to the four Getting Started article titles that
  exactly duplicated an Integrator Guide title (Content-Based Routing,
  Custom Error Handler, Embedded Recipe, Scheduled Executions), and
  update the one same-collection link that referenced the old title.
- Choosing a Trigger: fix description wording, "real-time streams" ->
  "real-time flows".
- Rename Flow Linking -> Linking Flows (file and title), and add the
  Batch component as a fourth flow-linking mechanism: it hands off
  messages in groups via Add message to batch / Get ready batches and
  a shared Correlation ID, rather than one at a time.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@andrewreshitko
andrewreshitko merged commit b9038b2 into master Sep 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants