From f45cd4ca5f7e4b13589b2c67aeaf67be11d12cc3 Mon Sep 17 00:00:00 2001
From: Nikhila Jain <99252011+jnikhila@users.noreply.github.com>
Date: Mon, 11 Mar 2024 17:40:18 +0530
Subject: [PATCH] feat: workflow docs (#2082)
## Description
Provide a concise summary of the changes made in this pull request.
- A new section for Workflows added to the sidebar
- Workflows
-
[Overview](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows)
- A brief about workflows, components, and links to get started.
- Tutorial
- [Create a basic
workflow](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows/tutorials/create-workflow)
- Trigger it from the Appsmith app
- Integrate on Appsmith events and execute the workflow
- Added an interactive Arcade so that users can learn in an interactive
mode
- How-To guides
- [Create Approval
Workflow](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows/how-to-guides/create-approval-workflow)
- How to create an approval workflow that showcases a refund approval
example
- Create a workflow to handle automated approvals and manual
approval/rejections
- Trigger workflow to add new refund requests to the workflow
- Read the pending refund requests in the Appsmith app
- Take action in the Appsmith app
- Resolve requests in Workflow
- Notify users of the outcome
- Reference
- [Workflow
Queries](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows/reference/workflow-queries)
- To give information on the type of workflow queries and their
parameters
- [Workflow
Functions](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows/reference/workflow-functions)
-
[Concept](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/workflows/concepts/workflows-in-appsmith)
- To provide information on the Workflow feature in Appsmith and its key
capabilities.
- Granular Access Control
- [ Roles >> Application
resources](https://appsmith-docs-git-feat-workflow-tutorial-get-appsmith.vercel.app/advanced-concepts/granular-access-control/roles#application-resources)
- Updates to add Workflow permissions
## Type of PR
Check the appropriate box:
- [ ] Review Fixes
- [ ] Documentation Overhaul
- [x] Feature/Story
- Link one or more Engineering Tickets
*
- [ ] A-Force
- [ ] Error in documentation
## Documentation tickets
Link to one or more documentation tickets:
- #2076
- #2118
- #2100
- #2099
## Checklist
Choose only the ones that are applicable.
- [x] Checked for Grammarly suggestions.
- [x] Adhered to the writing checklist.
- [x] Adhered the media checklist.
- [ ] Verified and updated cross-references or added redirect rules.
- [ ] Tested the redirect rules on deploy preview.
- [ ] Validated the modifications made to the content on deploy preview.
- [ ] Validated the CSS modifications on different screen sizes.
---
.../config/vocabularies/technical/accept.txt | 34 ++-
.../granular-access-control/roles.md | 2 +-
website/docs/workflows/README.md | 59 ++++-
.../how-to-guides/create-approval-workflow.md | 163 +++++++++++++
.../workflows/reference/workflow-functions.md | 127 ++++++++++
.../workflows/reference/workflow-queries.md | 107 ++++++++
.../workflows/tutorials/create-workflow.md | 229 ++++++++++++++++++
website/sidebars.js | 29 ++-
website/src/css/custom.css | 5 +
.../static/img/appsmith-workflow-concept.svg | 4 +
.../static/img/appsmith-workflow-overview.png | Bin 0 -> 322445 bytes
11 files changed, 754 insertions(+), 5 deletions(-)
create mode 100644 website/docs/workflows/how-to-guides/create-approval-workflow.md
create mode 100644 website/docs/workflows/reference/workflow-functions.md
create mode 100644 website/docs/workflows/reference/workflow-queries.md
create mode 100644 website/docs/workflows/tutorials/create-workflow.md
create mode 100644 website/static/img/appsmith-workflow-concept.svg
create mode 100644 website/static/img/appsmith-workflow-overview.png
diff --git a/.github/styles/config/vocabularies/technical/accept.txt b/.github/styles/config/vocabularies/technical/accept.txt
index c13a550269..b75930ec90 100644
--- a/.github/styles/config/vocabularies/technical/accept.txt
+++ b/.github/styles/config/vocabularies/technical/accept.txt
@@ -38,4 +38,36 @@ Login
Signup
reCAPTCHA
Edition
-Embed
\ No newline at end of file
+Embed
+Datasources
+Workflow
+Workflows
+Webhook
+workflow
+SMTP
+Postman
+assignRequest
+message
+resolutions
+requestName
+metadata
+requestToUsers
+requestToGroups
+Metadata
+Queries
+queries
+Functions
+functions
+JavaScript
+javascript
+Datasource
+datasource
+Human-in-the-Loop
+workflowInstanceId
+resolution
+payload
+executeWorkflow
+data
+Data
+Resolution
+workflows
\ No newline at end of file
diff --git a/website/docs/advanced-concepts/granular-access-control/roles.md b/website/docs/advanced-concepts/granular-access-control/roles.md
index 7f383cd40a..e679de697e 100644
--- a/website/docs/advanced-concepts/granular-access-control/roles.md
+++ b/website/docs/advanced-concepts/granular-access-control/roles.md
@@ -41,7 +41,7 @@ In this section, you'll find permissions related to the application and its reso
| **App** | Create pages and queries inside the app | Edit pages and queries inside the app. | Delete the app and its pages and queries. | View the app and its pages and queries. | - | Make the application public | Export that particular application. |
| **Page** | Create queries on the page. | Edit the page and its queries. | Delete the page and its queries. | View the page and its queries. | - | - | - |
| **Query** | - | Edit the query. | Delete the query. | View the query. | Execute the query. | - | - |
-
+| **Workflows** | Create new workflows and resources inside a workflow. | Required to make changes to the Workflow.| Required to delete a workflow. Users will need **Edit** permission to delete individual actions inside the workflow. | An **Edit** permission also enables the permission to view workflow run history.| An **Edit** permission also enables the **Execute** permission to run workflow.| - | -|
### Datasource and environments
diff --git a/website/docs/workflows/README.md b/website/docs/workflows/README.md
index 7b9b198130..09ef371cc9 100644
--- a/website/docs/workflows/README.md
+++ b/website/docs/workflows/README.md
@@ -1,5 +1,60 @@
---
-description: This page gives you an overview of workflows feature in Appsmith.
+description: This page provides an overview of the workflows feature in Appsmith, detailing its key components and functionality.
+title: Overview
+hide_title: true
---
+
-# Overview
+
+
Overview
+
+
+
+
+
+
+
+Appsmith Workflows are essential for automating tasks and orchestrating processes within applications. By integrating code-based and node-based systems, they provide a practical solution for automating tasks, managing workflows, enabling human-in-the-loop (HITL) interactions, and integrating with external services.
+
+## Workflow capabilities
+
+Appsmith Workflows are versatile and designed to handle a wide range of scenarios:
+
+### Automate business-critical processes
+
+Using app-building capabilities of Appsmith in workflows, developers can automate critical tasks based on business rules and requirements. From ticket assignments in customer support workflows to complex data processing operations, Workflows streamline processes efficiently.
+
+### Enable Human-in-the-Loop interactions
+
+Appsmith Workflows allow for human interventions within automated processes, facilitating informed decision-making through the Appsmith app. Decision points within workflows empower users to review and take appropriate actions, enhancing the efficiency and effectiveness of workflows.
+
+## Explore trigger types
+
+Appsmith supports different trigger types to configure actions and processes within workflows:
+
+- **Webhook**- Triggered by external events or HTTP requests, Webhook triggers enable real-time data processing and action execution based on incoming data. Learn how to use the Webhook triggers in the [Getting started with workflows](#getting-started-with-workflows) tutorial.
+
+- **Integrated Datasource for use in Appsmith Apps**- Seamlessly connect workflows with Appsmith applications using prebuilt integrations. This allows for seamless execution of operations within the app and direct management of workflows from the Appsmith interface. Delve deeper into integrated datasource triggers using Appsmith app in the [Getting started with workflows](#getting-started-with-workflows) tutorial.
+
+- **Scheduled Jobs (Cron Jobs)**- Scheduled to run at specific times or intervals, Scheduled Jobs automate tasks using Cron expressions. Stay tuned for updates on the availability and usage of Scheduled Jobs within Appsmith. (**Coming Soon**)
+
+## Getting started with workflows
+
+Begin exploring Appsmith Workflows with the comprehensive getting started tutorial.
+
+
+ Learn how to create your first workflow, configure webhook trigger to connect with external system, and integrate workflow natively with Appsmith app.
+
+
+
+
+
diff --git a/website/docs/workflows/how-to-guides/create-approval-workflow.md b/website/docs/workflows/how-to-guides/create-approval-workflow.md
new file mode 100644
index 0000000000..a71942d6aa
--- /dev/null
+++ b/website/docs/workflows/how-to-guides/create-approval-workflow.md
@@ -0,0 +1,163 @@
+---
+description: This page provides detailed steps to set up an approval Webhook workflow on Appsmith.
+title: Create Approval Workflow
+hide_title: true
+---
+
+
+
+
Create Approval Workflow
+
+
+
+
+
+
+
+In a human-in-the-loop approval workflow, such as processing refund requests, you can use workflows in Appsmith. The human intervention can happen through your Appsmith app. This page shows how to set up a human-in-the-loop approval workflow using Appsmith.
+
+
+
+
+## Prerequisites
+
+Before you start, make sure you have:
+
+* A self-hosted instance of Appsmith. Refer to the [Appsmith installation guides](/getting-started/setup/installation-guides) for detailed instructions on setting up your Appsmith instance.
+* Basic knowledge of creating a basic workflow in Appsmith. For more information, see [Tutorial - Create Basic Workflow](/workflows/tutorials/create-workflow).
+* Configured your datasource that manages your data and SMTP datasource (to notify users) in your workspace. If not, configure these datasources. For more information on configuring datasource, see the available [Datasources](/connect-data/reference) in Appsmith.
+
+## Create workflow
+
+Follow these steps to set up a webhook workflow within your workspace.
+
+1. Create a new workflow (_Refunds_) in your workspace.
+2. Configure it as a webhook workflow.
+3. Create a query to fetch order details (_getOrderDetails_) details. For example, the below query fetches the order details for the given `order_id` from the `orders` table.
+ ```sql
+ -- The order_id is a parameter, and replaced by actual value passed by the application
+ select * from public. "orders" where order_id = {{this.params.order_id}};
+ ```
+4. Create a query to update the order status once a refund is processed. For example, once a refund is approved, update the order status in the `order` table to `Refund Processed`. In case of rejection, the order status remains unchanged.
+ ```sql
+ -- The order_id are parameters and replaced by actual value passed by the application
+ -- highlight-next-line
+ Update public. "orders" set status = 'Refund Processed' where order_id = {{this.params.order_id}};
+ ```
+5. Create queries to send emails to inform users of the outcome. For example, you can create two queries:
+ * To notify approval (_notifyUser_):
+ * Parameterize the query to include:
+ * Customer name (`{{this.params.customer_name}}`) who raised the request.
+ * Customer email (`{{this.params.customer_email}}`) to send email notification.
+ * To notify rejection (_notifyRejectionToUser_):
+ * Parameterize the query to include:
+ * Customer name (`{{this.params.customer_name}}`) who raised the request.
+ * Customer email (`{{this.params.customer_email}}`) to send email notification.
+ * Rejection reason (`{{this.params.rejection_reason}}`).
+ * Pass these parameters from your app to the workflow.
+
+6. Click the **Publish** button to publish the workflow.
+
+## Set up automatic refunds
+
+When a user submits a refund request through your application, you may want to process automatic refunds based on predefined business rules. For example, you might automatically approve refunds where the refund amount is less than $10. Here's how you can handle this scenario:
+
+1. In your workflow, go to **Main** under _JS Objects_. In the JS code editor, replace the auto-generated code with the following snippet. This code fetches the order details with the given `order_id`. If the order value is less than $10, it initiates a refund and notifies the customer via email.
+
+ ```javascript
+ export default {
+ async executeWorkflow(order) {
+ if (order && order.order_id) {
+ console.log('data' + order.order_id);
+ // Fetch refund details based on the given refund detail
+ const order = await getOrderDetails.run({ "order_id": order.order_id });
+ // Iterate through requests
+ if(order){
+ // Verify the order value
+ if (order.amount < 10) {
+ // Add logic for refund processing if any
+ // Initiate refund for amounts less than $10
+ await initiateRefund.run({
+ "id": order.order_id,
+ "status": 'Refund Processed'
+ });
+ // Send refund approval email to the customer
+ await notifyUser.run({
+ "customer_email": refund_req.customer_email ,
+ "customer_name": refund_req.customer_name
+ });
+ }
+ }
+ }
+ }
+ }
+ ```
+2. Click the **Publish** button in the top right corner to apply your changes.
+3. Execute the workflow whenever a user submits a new refund request.
+
+## Handle approvals or rejections
+
+When managing approvals or rejections, create refund requests and track user actions for further processing. Follow these steps:
+
+1. In your workflow, go to **Main** under _JS Objects_, and add the following function. This function generates a pending request using the `assignRequest` workflow function. For more information, see the [assignRequest](/workflows/reference/workflow-functions#assign-request) function.
+ ```javascript
+ // manage refunds for amounts equal to or more than $10
+ async createandManageRequests(order) {
+ const response = await appsmith.workflows.assignRequest({
+ requestName: "getPendingRefundRequests",
+ message: "Refund raised by " + order.customer_name+ " for amount " + order.amount,
+ requestToUsers: [order.approver_email],
+ resolutions: ["Approve", "Reject"],
+ metadata: { "order": order }
+ });
+
+ if (response && response.resolution === "Approve") {
+ //Add logic for refund processing if any
+ // Initiate refund when user approves
+ await initiateRefund.run({
+ "id": order.order_id,
+ "status": 'Refund Processed'
+ });
+ // Send refund approval email to the customer
+ await notifyUser.run({
+ "customer_email": refund_req.customer_email ,
+ "customer_name": refund_req.customer_name
+
+ });
+ } else if (resolution && response.resolution === "Reject") {
+ // Send refund rejection email to the customer
+ // Supply the rejection reason as a parameter
+ await notifyRejectionToUser.run({
+ "customer_email": refund_req.customer_email ,
+ "customer_name": refund_req.customer_name,
+ "rejection_reason": refund_req.rejection_reason
+ });
+ }
+ }
+ ```
+2. Call the above function when the order value is equal to or more than $10.
+3. In your app, create a workflow query (_getRefundReqs_) to fetch these requests. Configure it as follows:
+ * **Workflow name** - Select **Refunds**.
+ * **Request type** - Select **Get requests**.
+ * **Request name** - Add `getPendingRefundRequests` to it. It is the same request name you added in your workflow _Main_ JS object in `appsmith.workflows.assignRequest()` in the step 1 of this section.
+4. Drag a Table widget and bind the **getRefundReqs** query to it. You may need to transform data based on your user interface requirements. In which case, use a JS object to execute the query, perform transformations, and bind the transformed data to the Table widget.
+5. Create another workflow query (_resolveReqs_) to capture **Approve** or **Reject** actions:
+ * **Workflow name** - Select **Refunds**.
+ * **Request type** - Select **Resolve Requests**.
+ * **Request Id** - Add `{{this.params.requestId}}` to it.
+ * **Resolution** - Add `{{this.params.resolution}}` to it.
+ * **Metadata** - Add `{"rejectionReason" : {{this.params.rejectionReason}}}` to it.
+6. Bind the query (_resolveReqs_) to the `onClick` event of **Approve** and **Reject** buttons, and pass appropriate parameters.
+7. Deploy your app to test the workflow.
+
+## Troubleshooting
+
+If you face issues, contact the support team using the chat widget at the bottom right of this page.
diff --git a/website/docs/workflows/reference/workflow-functions.md b/website/docs/workflows/reference/workflow-functions.md
new file mode 100644
index 0000000000..ae503ca469
--- /dev/null
+++ b/website/docs/workflows/reference/workflow-functions.md
@@ -0,0 +1,127 @@
+---
+description: This page provides detailed information on workflow functions available in Appsmith.
+title: Workflow Functions
+hide_title: true
+---
+
+
+
+
Workflow Functions
+
+
+
+
+
+
+
+Workflow functions are in-built framework functions that enables you to interact with different entities like datasources, queries, external systems, and human-in-the-loop interactions. This page provides information about the workflow functions available in Appsmith, including their signatures, parameters, and usage examples.
+
+## executeWorkflow()
+
+The `executeWorkflow()` function serves as a central control unit for executing workflows and marks the starting point of the workflow execution within Appsmith. This function allows you to create a workflow logic for execution of tasks.
+
+### Signature
+
+```javascript
+executeWorkflow(data: JSON): Promise
+```
+### Parameters
+
+Below are the parameters required by the `executeWorkflow()` function to execute:
+
+#### data `JSON`
+
+
+ The parameter `data` holds the data passed from your App to trigger and process the workflow. For example, consider the following data passed to the workflow where `data` holds the body of the post request when triggered via webhook, and holds `Trigger Data` property of the [Trigger Workflow](/workflows/reference/workflow-queries#trigger-workflow) query when workflow is executed from an Appsmith app.
+
+ ```javascript
+ {
+ "userId": 123,
+ "action": "updateProfile",
+ "data": {
+ "firstName": "John",
+ "lastName": "Doe",
+ "email": "john.doe@example.com"
+ }
+ }
+
+ ```
+ In your workflow, you can access properties within the `data` object like `userId` using dot notation. To access the `userId`, use `data.userId`.
+
+
+### Return type
+
+The `executeWorkflow()` returns a Promise that resolves to a boolean value, either `true` or `false`, indicating the success or failure of the workflow execution.
+
+## assignRequest()
+
+The `assignRequest()` function is part of the `workflows` object within the global `appsmith` object in Appsmith. It allows you to create a decision point in a workflow that require users intervention. The decision point is created as a pending request in the workflow and can be accessed later in your apps to enable users to take action by using [Get requests](/workflows/reference/workflow-queries#get-requests) workflow query. Once you create pending requests, the workflow pauses and awaits for user action.
+
+### Signature
+
+```javascript
+assignRequest({requestName: string, message: string, resolutions: string[], metadata:{key: string, value: any}, requestToUsers: string[], requestToGroups: string[] }) : Promise
+```
+
+### Parameters
+
+Below are the parameters required by the `assignRequest()` function to execute:
+
+#### requestName `String`
+
+
+ The name of the request, which serves as its identifier within the workflow. This name can be used to filter requests as part of [Get requests](/workflows/reference/workflow-queries#get-requests) workflow query by adding it in the `Request name` attribute.
+
+
+#### message `String` `Optional`
+
+ A descriptive message associated with the request, providing more context for users. For example, when creating a refund request, you might include a message like "Refund request raised by User 1".
+
+
+#### resolutions `String[]`
+
+ Represents the possible actions a user can take on the request. The applicable resolution passed to the [Resolve requests](/workflows/reference/workflow-queries#resolve-requests) workflow query to apply the selected resolution. For example, `['Approve', 'Reject']`.
+
+
+#### metadata `JSON` `Optional `
+
+ Add data that may be needed to process the request or display more information to the user in your app. For example, you can include a unique identifier for the record associated with the request. Use the identifier in your app to fetch and show the details to user.
+
+
+#### requestToUsers `String[]`
+
+ The `requestToUsers` parameter allows for targeted assignment of requests to specific Appsmith users. It specifies an array of emails for users to whom the pending requests will be assigned. The users specified here will be able to take action and resolve the pending request. These users need to be a part of the Appsmith instance for assigning the request to them. It's mandatory to supply either `requestToUsers` or `requestToGroups` atribute for request assignment.
+
+
+#### requestToGroups `String[]` `Optional`
+
+
+The `requestToGroups` parameter allows for targeted assignment of requests to specific User groups in Appsmith. If specifies the user group names to which the request will be assigned for resolution. When specified, the request will be assigned to all the users belonging to the groups. Each group name must be configured in your app and have appropriate permissions to perform actions. It's mandatory to supply either `requestToUsers` or `requestToGroups` atribute for request assignment. The workflow restarts upon the first action taken by any user within the assigned group.
+
+
+### Return type
+
+The `assignRequest()` function returns a Promise in a JSON format representing the generated response. The response includes the following data:
+
+#### workflowInstanceId `String`
+
+
+ Represents the unique identifier for the workflow instance.
+
+
+#### resolution `String`
+
+
+ Indicates the resolution applied to the request based on the user action.
+
+
+#### payload `JSON`
+
+
+ It holds the data from the `metadata` attribute used during the processing of the [Resolve Requests](/workflows/reference/workflow-queries#resolve-requests) workflow query.
+
+
\ No newline at end of file
diff --git a/website/docs/workflows/reference/workflow-queries.md b/website/docs/workflows/reference/workflow-queries.md
new file mode 100644
index 0000000000..9fd819918e
--- /dev/null
+++ b/website/docs/workflows/reference/workflow-queries.md
@@ -0,0 +1,107 @@
+---
+description: This page provides detailed information on workflow queries available in Appsmith.
+title: Workflow Queries
+hide_title: true
+---
+
+
+
+
Workflow Queries
+
+
+
+
+
+
+
+Workflow queries in Appsmith applications enable interaction with workflows, allowing users to execute operations within their apps. This page provides detailed information on workflow queries and their parameters.
+
+## Workflow name
+
+Specifies the workflow with which the Appsmith application will interact and execute operations. It allows users to select a specific workflow from all the workflows available in the workspace for interaction and execution.
+
+
+## Request type
+
+Request type defines the operation to execute on the workflow. The available types are:
+
+* **Trigger Workflow:** Triggers the workflow and executes it based on predefined conditions or events, along with the supplied parameters.
+* **Get Requests:** Retrieve information about the requests generated as part of the workflow.
+* **Resolve Requests:** Handles and concludes existing workflow requests raised as part of the `Get Requests` operation.
+
+
+### Trigger Workflow
+
+A `Trigger Workflow` request initiates a workflow run with supplied parameters, and executes the predefined operations within the workflow.
+
+
+#### Trigger data
+
+Trigger data supplies the parameters needed by the workflow to execute. The parameters are supplied in a JSON object. For example:
+```javascript
+{
+ "parameter1": "value1",
+ "parameter2": "value2"
+}
+```
+
+
+### Get requests
+
+A `Get Requests` request retrieves the requests created as part of the workflow, specific to the logged-in user. These requests require human intervention for the user to verify and take action.
+
+
+#### Request names
+
+Filters the requests based on their name. One or more request names can be added to retrieve requests.
+
+
+#### Request name
+
+Specifies the name of the request to fetch, as defined while creating request using the `assignRequests` workflow function. For more information, see [assignRequests](/workflows/reference/workflow-functions#assignrequest).
+
+
+#### Request status
+
+
+Filters requests based on their status. The available statuses are: `Pending` and `Resolved`.
+
+
+#### Limit
+
+
+Specifies the maximum number of requests to retrieve. The default value is set to `10`.
+
+
+#### Skip
+
+
+Specifies the number of requests to skip before returning data. The default value is set to `0`.
+
+
+### Resolve requests
+
+The `Resolve requests` request applies resolutions to existing workflow requests based on user actions.
+
+
+#### Request Id
+
+
+Specifies the ID of the request for which resolution is needed.
+
+
+#### Resolution
+
+
+Applies a resolution to the request based on the action taken. The resolution must match those specified while creating the request using the `assignRequests` workflow function. For example, during request creation, if you defined available resolutions as `Approve` and `Reject`, only these resolutions can be applied to the request when a user takes action. Therefore, when passing resolutions to this attribute, ensure they match the predefined options.
+
+
+#### Metadata
+
+
+Add data that may be needed to process the request or perform additional operation in the workflow. For example, you can include a unique identifier for the record associated with the request. Use the identifier in your workflow to fetch details and perform additional operation.
+
diff --git a/website/docs/workflows/tutorials/create-workflow.md b/website/docs/workflows/tutorials/create-workflow.md
new file mode 100644
index 0000000000..7e5f16180e
--- /dev/null
+++ b/website/docs/workflows/tutorials/create-workflow.md
@@ -0,0 +1,229 @@
+---
+description: This page provides detailed steps to set up a workflow on Appsmith.
+title: Create Basic Workflow
+hide_title: true
+---
+
+
+
+
Create Basic Workflow
+
+
+
+
+
+
+
+Appsmith Workflows allow you to automate processes, bringing efficiency and connectivity to your applications. This tutorial guides you through the process of setting up a basic workflow, configuring it as a webhook trigger, integrating and triggering the workflow execution from your Appsmith app.
+
+To learn workflows in Appsmith, you'll build workflow that sends a welcome notification email when new users join your organization. By the end of this tutorial, you will know how to:
+
+* Create a workflow and configure it as a webhook
+* Trigger the workflow from an external app (Postman)
+* Integrate and execute the workflow from your Appsmith app
+
+## Prerequisites
+
+Before you start, make sure you have the following:
+
+* A self-hosted instance of Appsmith with a [paid subscription](https://www.appsmith.com/pricing). Refer to the [Appsmith installation guides](/getting-started/setup/installation-guides) for detailed instructions on setting up your Appsmith instance.
+* If you are new to Appsmith, see [Tutorial - Basics](/getting-started/tutorials/start-building).
+* A REST client. For example, Postman.
+
+## Create workflow
+
+Follow these steps to build a notification workflow:
+
+To send notifications to the users you will create a workflow, and configure it as a webhook. Follow these steps to create a webhook workflow within your workspace. The newly created workflow can be accessed in all apps in the same workspace:
+
+
+
+
+
+
+
+1. Click the **Create New** button in your workspace, and choose **Workflow**. This action creates a new workflow in your workspace and takes you to the **Main** JS object code editor. Give a meaningful and unique name to your workflow by editing the name **Untitled Workflow 1** to _Send\_Email\_Workflow_.
+2. In the **Main** JS object code editor, you will see the `executeWorkflow` function (as shown below). This function executes whenever a workflow run is triggered. It serves as the main function for writing your logic. You'll update the `executeWorkflow()` function and add code in the [Write code in workflow to trigger email](#write-code-in-workflow-to-trigger-email) section.
+
+ ```javascript
+ export default {
+ /**
+ * Entry point for Workflow execution. All activities to be executed should be defined here.
+ * @param data This function takes in a json object as arguments (data) which can be passed when you trigger the workflow.
+ * @returns boolean Shall return true or false.
+ */
+ async executeWorkflow(data) {
+ // start writing your code here.
+
+ return true;
+ }
+ }
+ ```
+
+You've created your first workflow.
+
+## Configure SMTP datasource
+
+To send notifications from the workflow, you will need to set up an SMTP datasource and connect it with an email service provider. Follow these steps to set up an SMTP datasource:
+
+1. Click the **Data** tab. Click the **+** icon next to _Datasources in your workspace_ to add a new [SMTP](/connect-data/reference/using-smtp) datasource.
+
+2. Give it a meaningful and unique name. For example, _Send\_Email\_SMTP_
+
+3. Enter the following details in the SMTP connection parameter fields:
+ * **Host Address**: Add `smtp-relay.brevo.com` in the SMTP host address field.
+ * **Port**: Add `587` in the SMTP port field.
+ * **Username**: Add `demo.smtp.send.email@gmail.com` in the Username field.
+ * **Password**: Add the below key in the SMTP password field.
+ ```bash
+ xsmtpsib-b80d2e2a0c90517b7fc8f831270473d56621b3fa7b574f340f2f1687dbd904c4-zkJC7SarXVE3YPhg
+ ```
+
+4. Test and save the datasource configuration.
+
+## Write query to send email
+
+Follow these steps to write a query for sending email:
+
+1. Add a query to send a welcome email to the user and configure it as shown below:
+ * Rename the query to _Send\_Welcome\_Email_
+ * **Commands** - Select `Send email`.
+ * **From Email** - Add `demo.smtp.send.email@gmail.com`.
+ * **To Email** - Add your email address in this field.
+ * **Subject** - Add `Welcome to the Team!`.
+ * **Body** - Add the below text:
+ ```text
+ Dear Employee,
+
+ Welcome to the team!
+
+ We're thrilled to have you on board and look forward to working together.
+ Feel free to reach out if you have any questions or need help.
+
+ Let's achieve great heights together!
+
+ Best regards,
+ Company
+ ```
+2. Click the **Run** button to send an email. Check your inbox, you must have received an email from `demo.smtp.send.email@gmail.com`.
+3. Update the _Send\_Welcome\_Email_ query and remove your email from the **To** field, and add `{{this.params.send_email_to}}` to it. Adding `{{this.params.send_email_to}}` replaces the parameter `send_email_to` with the actual value at run time.
+4. Go to the _Main_ JS object and update the `executeworkflow()` function to read the email sent as a parameter.
+
+ ```javascript
+ export default {
+ async executeWorkflow(data) {
+ //pass email `send_email_to` the query to send email
+ const response = await Send_Welcome_Email.run({"send_email_to": data.email});
+ // log the response
+ console.log(response);
+
+ return true;
+ }
+ }
+ ```
+5. Click the **Publish** button to publish your latest changes.
+
+You've successfully integrated the email query in workflow.
+
+## Configure Webhook trigger
+
+Follow these steps to configure a webhook trigger for the workflow:
+
+
+
+
+
+
+
+1. Click the gear icon ⚙️ in the bottom left corner to configure the workflow settings.
+2. Toggle the **Webhook trigger** property to configure the workflow as a webhook.
+3. Copy and save the **URL** and the **Bearer Token**. If you wish to connect your workflow with an external app then you will need the **URL** and the **Bearer Token**. You'll see this in action in the [Send email using Postman](#send-email-using-postman) section.
+4. Click the **Publish** button in the top right corner to publish your workflow.
+
+You've configured the webhook trigger for the workflow, and it can be integrated and triggered from external apps.
+
+## Send email using Postman
+
+To simulate the workflow connection from external app, you will use Postman and execute the workflow. Follow these steps to trigger the workflow execution:
+
+1. Launch the Postman application on your system.
+2. Click on the **New** button, and choose **HTTP** request in Postman to create a new request.
+3. Choose the HTTP method as **POST**.
+4. Enter the workflow URL you copied in the [Configure Webhook trigger](#configure-webhook-trigger) section.
+5. On the _Body_ tab, select **raw**, and add the below code in the request body. Here you are setting the parameter value for `send_email_to`. Remember to replace `` with your email.
+ ```javascript
+ {
+ "email": ""
+ }
+
+ ```
+6. Click the **Send** button to execute the request.
+7. The below response is generated, and you will receive an email from `demo.smtp.send.email@gmail.com`.
+ ```javascript
+ {
+ "success": true,
+ "message": "Workflow instance started running successfully",
+ "data": {
+ "workflowInstanceId": "workflowInstance-rjwbe41QF1P1s90YwYw-1"
+ }
+ }
+ ```
+
+You've successfully executed your first workflow externally, and can integrate the workflow in your external or Appsmith app.
+
+## Send email using Appsmith app
+
+To interact with the workflow from your Appsmith app, Appsmith provides workflow queries. In this section, you'll:
+
+* Write a workflow query
+* Bind the workflow query to the Button widget
+* Pass parameter (_email_) from Appsmith app to workflow
+* Trigger the workflow by clicking the Button widget
+
+Follow these steps to send email from your app:
+
+
+
+
+
+
+
+1. In your application, drag an Input widget onto the canvas, name it _inp\_Email_, and set its label as **Email**.
+2. Drag a Button widget onto the canvas and configure it as shown below:
+ * Name it _btn\_SendEmail_
+ * Set the label as _Send Welcome Email_
+3. Under **Editor** > **Queries**, click **New query/API**.
+4. In the _Create new query/API_, click **Workflows Query**, and name it as _SendEmailQuery_.
+5. Add the below details to configure the workflow query:
+ * **Workflow name** - The workflow name dropdown has all the available workflows in your workspace. Select **Send_Email_Workflow**.
+ * **Request type** - Select **Trigger workflow**.
+ * **Trigger Data** - Trigger Data passes the parameters from app to the workflow for processing. Add the below code to pass email parameter to the workflow:
+
+ ```javascript
+ {
+ "email" : "{{inp_Email.text}}"
+ }
+ ```
+6. Bind the **onClick** event of the **Send Email** button to execute the `SendEmailQuery` query.
+7. Input your email in the **inp_Email** field, and click **Send Email** button. You'll see an _Email sent_ prompt. Check your inbox, you must have received an email from `demo.smtp.send.email@gmail.com`.
+
+You've successfully executed your workflow within your Appsmith app.
+
+🚩 Congratulations. You have built your first webhook workflow and integrated it with your Appsmith app.
+
+In this tutorial, you explored how to create a webhook workflow, pass parameters to the workflow, and execute workflow from your Appsmith app. You can use these skills to build your own workflow and integrate it with your apps.
+
+Happy Workflow Building!
+
+## See also
+
+* [How-to Guides](/workflows/how-to-guides/create-approval-workflow)
+* [Workflow Queries](/workflows/reference/workflow-queries)
+* [Workflow Functions](/workflows/reference/workflow-functions)
diff --git a/website/sidebars.js b/website/sidebars.js
index 2579774368..ef7175765d 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -626,9 +626,36 @@ const sidebars = {
{
type: 'category',
collapsed: false,
- label: 'Workflows',
+ label: 'Workflows (Beta)',
items: [
'workflows/README',
+ //category- Api
+ {
+ type: 'category',
+ label: 'Tutorial',
+ link: {
+ type: 'doc',
+ id: 'workflows/tutorials/create-workflow',
+ },
+ items: [
+ ],
+ },
+ {
+ type: 'category',
+ label: 'How-To Guides',
+ items: [
+ 'workflows/how-to-guides/create-approval-workflow'
+ ],
+ },
+ {
+ type: 'category',
+ collapsed: false,
+ label: 'Reference',
+ items: [
+ 'workflows/reference/workflow-queries',
+ 'workflows/reference/workflow-functions'
+ ],
+ }
]
}, //Workflows end
diff --git a/website/src/css/custom.css b/website/src/css/custom.css
index ff3c0c7cde..030ff4de8c 100644
--- a/website/src/css/custom.css
+++ b/website/src/css/custom.css
@@ -88,6 +88,11 @@
margin-right: -5px;
}
+.theme-doc-sidebar-item-category-level-2>.menu__list-item-collapsible>.menu__link--sublist {
+ margin-bottom: -6px;
+ margin-top: -6px;
+}
+
.theme-doc-sidebar-item-category-level-3>.menu__list-item-collapsible>.menu__link--sublist {
margin-bottom: -6px;
margin-top: -6px;
diff --git a/website/static/img/appsmith-workflow-concept.svg b/website/static/img/appsmith-workflow-concept.svg
new file mode 100644
index 0000000000..6215998775
--- /dev/null
+++ b/website/static/img/appsmith-workflow-concept.svg
@@ -0,0 +1,4 @@
+
+
+
+
\ No newline at end of file
diff --git a/website/static/img/appsmith-workflow-overview.png b/website/static/img/appsmith-workflow-overview.png
new file mode 100644
index 0000000000000000000000000000000000000000..dc9fc8fc2d90170765bee6c41c704a36f5b6b4ec
GIT binary patch
literal 322445
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