--- parser: v2 author_name: Win Acharya author_profile: https://github.com/WinAcharya auto_validation: true time: 10 tags: [ tutorial>beginner, software-product>sap-business-technology-platform, tutorial>free-tier ] primary_tag: software-product>sap-build-process-automation slug: spa-add-email-notification canonical_url: https://developers.sap.com/tutorials/spa-add-email-notification --- # Add Mail Notifications to a Process Add mail notifications to your business process via the process builder ## Prerequisites - Complete the mission: [Build Your First Business Process with SAP Build Process Automation](mission.sap-process-automation) - [Configure SMTP Destination](https://help.sap.com/docs/PROCESS_AUTOMATION/a331c4ef0a9d48a89c779fd449c022e7/4f2d36db614241c9850b9ec80f9e0c1b.html) ## You will learn - How to create and send Mail notification - How to retrieve the sample project from the Store --- **Mail** feature allows you to add mail notifications to your business process via the process builder, allowing you to send preconfigured emails to recipients while a process is running. ## Intro In this tutorial, you will learn how to use **Mail** in a business process to inform the user when the sales order is approved manually. ### Create and configure mail notification Now that you have designed the process with forms, you can define the mail notifications to send when the sales order is approved manually. We intend to replace the existing **Order Confirmation Form** with the **Mail**. 1. The current process looks like the following: ![The Sales Order Process](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Current-Process.png) 2. First, remove the **Order Confirmation Form**. - Open the **Process Builder**. - Select **Order Confirmation Form**. - Choose **Remove**. ![Remove Order Confirmation Form](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Remove-Order-Confirmation.png) 3. Now add Mail for approval flow. To add a **Mail** do the following: - Select **+** corresponding to **Approve** of the **Approval Form**. - Choose **Mail**. ![Add mail for approval](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Add-Mail-for-Approval.png) The mail notification is added to the process and the settings are displayed in the side panel. ![Mail Added](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Mail-Added.png) 4. Click **Open Mail Body Editor** and configure the mail body. ![Click Open Mail Body Editor](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Click-Open-Mail-Body-Editor.png) The mail body can include the following: - Text - Process context information (such as the Form fields in the example) - Process metadata (such as the 'Process Started By' information) ![Add mail Body Editor](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Mail-Body-Editor-Approval-Email.png) - Click **Apply** 5. Configure the Mail Header fields - **To** : The recipient of the mail notifications. Either add specific mail addresses or use information taken from process metadata or context. - **Subject** :The subject of the mail itself. Either add specific text here or use information taken from process metadata or context. - **CC** : The copied recipient of the mail notifications. Either add specific mail addresses or use information taken from process metadata or context. - **BCC** : The blind copied recipient of the mail notifications. Either add specific mail addresses or use information taken from process metadata or context. ![Approval Mail Details](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Approval-Mail-Details.png) > The mail notification is added to the process, with mails sent to recipients when a process is running. You might need to drag the components after the artifacts are deleted in the process builder 6. Save your work. The process should now look like the following: ![Sales Order with Mail Notifications](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Final-Outcome.png) ### Release, deploy and run the business process 1. Run the business process. Release, deploy and run the business process with the **Order Processing Form** details as below: ![Add inputs to Approval Form](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Order-Approval-Request-Form.png) 2. Fill the form and choose **Submit**. 3. After you select the submit button, a notification will inform you that the form has been successfully submitted. This means that the workflow has been triggered and the approval process has been started. ![Submit The Form](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Submit-New.png) ### Test Results You will receive the below mail in your inbox after the workflow is successfully approved by the approver: ![Email Notification Test Results](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/Email-Notification-Test-Results.png) This completes the Mail notification addition to the business process for manual approval flow. ### Retrieve sample project from the store This sample project can be downloaded from the SAP Build Store. To retrieve this sample, please follow these steps: 1. From the SAP Build Lobby, navigate to Store. 2. Search for the sample project: **Sales Order Management (TU02)**. 3. Choose **Create from Template** to retrieve the sample and save it as a new project in your lobby. ![Store](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/store.png) 4. Choose **Create**. ![Create](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/create.png) Your project gets created in editable version. You may release and deploy it and run the project. 5. Navigate back to the lobby by clicking on the SAP logo. ![Project](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/project.png) You can see your project is available in the lobby. ![Lobby](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/spa-add-email-notification/lobby.png) ---