diff --git a/en/docs/quick-start-guides/schedule-your-first-automation.md b/en/docs/quick-start-guides/schedule-your-first-automation.md index 9afe3ca..d90755d 100644 --- a/en/docs/quick-start-guides/schedule-your-first-automation.md +++ b/en/docs/quick-start-guides/schedule-your-first-automation.md @@ -49,6 +49,36 @@ This redirects you to the **Create New Integration in VS Code** page. 3. Add an appropriate commit message and commit. 4. Click **Sync Changes** to push the changes to remote. +## Optional: Test the Automation manually + +You can execute your automation directly from the environment card on the **Overview** page: + +1. On the Overview page, locate the **Development** card. +2. Click **Test** to run your automation immediately. + + !!! info "Inject Dynamic Values into Your Application as Command-Line Arguments" + To pass dynamic values to your application when testing manually, follow these steps: + + 1. Click the drop-down icon next to **Test** and then click **Test with Arguments**. + 2. In the **Runtime Arguments** pane, enter the arguments you want to pass to your application. + 3. Click **Execute**. This triggers the task with the specified arguments. + + The capability to run a manual task with arguments is supported for the following build presets: + + === "WSO2 MI" + To explore a WSO2 MI-based manual task with arguments, try out the [Weather to Logs Task](https://github.com/wso2/choreo-samples/tree/main/weather-to-logs-mi-manual-task) sample. For instructions, see the `README.md` file in the sample repository. + + !!! info + When working on WSO2 MI projects and deploying a WSO2 MI integration as a manual task in Choreo, use the WSO2 MI automation mode. For details, see [Running the Micro Integrator in Automation Mode](https://mi.docs.wso2.com/en/latest/install-and-setup/install/running-the-mi-in-automation-mode/). + + === "WSO2 BI" + To explore a Ballerina manual task with arguments, try out the [Weather to Email Task](https://github.com/wso2/choreo-samples/tree/main/weather-to-email-integration) sample. For instructions, see the `README.md` file in the sample repository. + + !!! info + If you want to pass arguments to Ballerina main functions, use the **Test with Arguments** capability. For details on the arguments you can pass, see the [Ballerina documentation](https://ballerina.io/learn/by-example/main-function/). You can also override configurable values in the same manner. For more information, see [Provide values to configurable variables](https://ballerina.io/learn/provide-values-to-configurable-variables/#provide-via-command-line-arguments). + !!! note + As user portal features are added, testing and other actions will be accessible directly from the **Overview** page, making it easier to manage and validate your automations. + ## Step 5: Schedule Automation 1. Once you push the changes, the overview page of the Devant automation will automatically refresh and show you the **Latest Commit** and automatically build your automation showing the **Build Status**. @@ -70,7 +100,12 @@ This redirects you to the **Create New Integration in VS Code** page. 10. After successfully testing, you can promote your automation to production by clicking the **Promote** button. -11. In critical environments (Production), you will be able to see automation metrics such as: +11. Once promoted to production, click **Run** to run your automation immediately. + + !!!info + If you want to pass runtime arguments when running in production, use the **Run with Arguments** option in the same way as described above in the [Test the Automation manually](#optional-test-the-automation-manually) section. + +12. In critical environments (Production), you will be able to see automation metrics such as: - **Error Rate**: Percentage of failed executions - **Average Duration**: Average time taken for executions