> For the complete documentation index, see [llms.txt](https://docs.elsaworkflows.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elsaworkflows.io/getting-started/concepts.md). # Concepts ## Workflow A workflow is a sequence of steps called **activities** that represents a process. Workflows can be created visually or programmatically. In Elsa, a workflow is represented by an instance of the `Workflow` class. The Workflow class has a `Root` property of type `IActivity`, which is scheduled for execution when the workflow starts. ## Workflow Instance A workflow instance represents a database-persisted instance of a workflow in execution, encapsulated by the `WorkflowInstance` class. [Read more](/getting-started/concepts/workflow-context.md) ## Activity An activity is a unit of work executed by the workflow engine. In Elsa, these are classes implementing the `IActivity` interface and can be linked or composed together to form a workflow. ## Bookmark A bookmark signifies a pause point in a workflow, enabling the workflow to be resumed later. It is typically created by blocking activities such as the `Event` or `Delay` activity. ## Trigger A trigger is an activity with its `Kind` metadata set to `Trigger` and is able to start new workflow instances of the containing workflow. For example, the `HttpEndpoint` activity is a trigger that enables the containing workflow to be executed when a given URL is requested. ## Blocking Activity Blocking activities are those which do not complete execution immediately upon initiation. They often create bookmarks, halting the workflow's progress until resumed. This halting nature coins the term "blocking." ## Burst of Execution This term describes the period during which the workflow runner actively executes activities. A workflow executing continuously from start to finish occurs in a single burst, whereas a workflow interrupted by a blocking activity results in multiple bursts, resuming on subsequent triggers. ## Correlation ID A Correlation ID is a flexible identifier linking related workflows and external entities. It aids in tracing workflows in distributed, asynchronous, or hierarchical systems. Assigning a Correlation ID allows tracking of related workflows and ties them to specific business objects like documents, customers, or orders. [Read more](/getting-started/concepts/correlation-id.md) ## Outcome Activities in a flowchart are connected that defines the logic of the workflow. Each activity can have one ore more *potential* results, which are referred to as *outcomes*. These outcomes are visually displayed as "ports" on the activity. For example, the `Decision` activity has two potential outcomes: `True` and `False`. When using the designer, the user can connect a subsequent activity to these outcomes. This powerful mechanism simplifies workflows by eliminating the need for separate decision activities to evaluate an activity's result. [Read more](/getting-started/concepts/outcomes.md) ## Input In Elsa, input can refer to two things: * Input to an activity. * Input to a workflow. ### Activity Input Most activities have at least one input, represented as public properties. For instance, the `WriteLine` activity has a `Text` property used to display a string in the console window. ### Workflow Input Workflows can receive input from the application. For example, a workflow processing an order can get the Order ID through an input like `OrderId`. ## Output In workflows, activities can produce *output* data for later steps. Outputs pass info like numbers or text to the next activity. Activities can create results and outputs. You can generate outputs, like booleans, for decision-making, but it's easier to use outcomes. Use outputs for data, like database results, when no decisions are needed. ## Variable Variables can be set at the workflow level to store data. Use dynamic expressions to set or retrieve these variables. Activity outputs can update a variable automatically, allowing them to be used by the next activities. This makes it easy to transfer and store data for activities. {% hint style="info" %} **In Elsa Studio**: Learn how to reference variables in expressions using JavaScript and C# in the [Expressions guide](/guides/studio/expressions.md). {% endhint %} [Read more](/getting-started/concepts/workflow-context.md) ## Incident An incident is an error event that occurred in the workflow. For example, if an activity faults, an incident is recorded as part of the workflow execution. ## Alteration An alteration represents a change that can be applied to a given [workflow instance](#workflow-instance). Using alterations, you can modify a workflow instance's state, schedule activities, and more. ## Workflow Context Workflow execution in Elsa spans workflow-level state, activity-level state, scoped variables, bookmarks, incidents, and execution logs. [Read more](/getting-started/concepts/workflow-context.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.elsaworkflows.io/getting-started/concepts.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.