Skip to content

Commit 90a21e4

Browse files
committed
Adding Use Case Buddy Tutorials
1 parent fe6dfab commit 90a21e4

54 files changed

Lines changed: 647 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
---
2+
auto_validation: false
3+
time: 30
4+
level: Intermediate
5+
tags: [ tutorial>intermediate, topic>cloud, software-product>sap-business-technology-platform, software-product>sap-build, software-product>sap-build-work-zone--advanced-edition, software-product>sap-build-apps, software-product>sap-build-process-automation ]
6+
primary_tag: software-product>sap-build
7+
author_name: Friederike Marby
8+
author_profile: https://github.com/FriederikeMa
9+
parser: v2
10+
---
11+
12+
# Modify the process of your Use Case Buddy and connect it to your Work Zone site and app
13+
<!-- description --> This tutorial will show you how to implement the Use Case Buddy's approval process to your app and configure the necessary elements to set the process up for you. This is possible because you already imported the templates and initially got your project started in the first tutorial - now is the time to connect everything and get your Use Case Buddy up to speed.
14+
15+
## You will learn
16+
- How to connect SAP Build Apps and SAP Build Process Automation destinations
17+
- How to customize templates and get your Use Case Buddy to a first version
18+
19+
## Prerequisites
20+
- You went through the first Use Case Buddy Tutorial ["Get your Use Case Buddy started"](https://developers.sap.com/tutorials/build-use-case-buddy.html) and got your project started.
21+
22+
## Intro
23+
Within this tutorial you will implement the Use Case Buddy's approval process and configure necessary elements to set it up.
24+
25+
>Objective of this tutorial: Connect all content packages from SAP Build Apps, Build Process Automation and SAP Build Work Zone as well as change up necessary personalized settings for a first working version of the Use Case Buddy.
26+
27+
28+
### Configure the needed process changes on the template
29+
You'll need to set up the correct email configurations so that the right people in your organisation are the reviewers. The first email step in this process is to send a notification to the IT team/SAP Build Admins. They can then review the submitted use case information. Now you will configure the email notification that will be sent to them when a new Use Case idea is submitted.
30+
31+
1. Open your imported automation for the Use Case Buddy within SAP Build Process Automation.
32+
33+
1. Change up the correct address of your reviewer. This person will get all the notifications about new submitted use cases, so this might be your IT Admin or CoE team. The email address can be entered in the email header.
34+
35+
<!-- size:500px -->
36+
![](visuals/emailaddress.png)
37+
38+
1. Feel free to also change up the content of the mail. Edit the mail body to reflect your thoughts on how such a email should look like. Make sure to change the link of the inbox.
39+
40+
<!-- size:300px -->
41+
![](visuals/mailbody.png)
42+
43+
1. Similarily, edit the email body of the other email steps - for instance if an Use Case gets denied.
44+
45+
1. Go to the approval step and enter the email address of your SAP Build Admin/IT admin.
46+
Following the same approach, also change the recipient for the use case auto approval form to this person.
47+
48+
<!-- size:500px -->
49+
![](visuals/Approval.png)
50+
51+
52+
### Forward and show submitted ideas in the SAP Build Work Zone site
53+
54+
In the previous [tutorial](https://developers.sap.com/tutorials/build-use-case-buddy.html), you created an action project that will post the ideas in a chosen workspace of SAP Build Work Zone. Now you will insert that action project in this approval process so that approved ideas get displayed on the Work Zone site.
55+
56+
1. Click on the **+** icon under the left branch of the approval form (success branch) to add a step. Select **Actions** now.
57+
58+
<!-- size:500px -->
59+
![](visuals/addaction.png)
60+
61+
2. Now search for the action project you created and add it.
62+
63+
<!-- size:500px -->
64+
![](visuals/addaction2.png)
65+
66+
3. Rename the step to *Submit idea to Build COE*. Make sure a destination variable is selected, if not, please create one.
67+
Under **Run step on behalf of**, select **Approval form**. Leave the input parameters as it is.
68+
69+
<!-- size:500px -->
70+
![](visuals/Actionconfig.png)
71+
72+
Go to the Inputs tab, map, choose **postmessage** to *Content* and **title** to *Name*
73+
74+
<!-- size:500px -->
75+
![](visuals/Actioninput.png)
76+
77+
4. Similarily add another action project under the **Auto approval form** in the default branch of the Condition.
78+
79+
<!-- size:500px -->
80+
![](visuals/Actionconfig2.png)
81+
82+
5. After all the configuration, make sure to **save** it and **release** it.
83+
84+
<!-- size:500px -->
85+
![](visuals/release.png)
86+
87+
6. After releasing, deploy your project. Select the target you created to connect to SAP Build Work Zone to define the target variable.
88+
89+
<!-- size:500px -->
90+
![](visuals/Destination.png)
91+
92+
93+
### Integrate your use case approval process with the Use Case Buddy App
94+
In order for the Use Case Buddy to be able provide submitted ideas to your process you have to connect SAP Build Apps and SAP Build Process Automation. You will do this using a **destination** in the following step.
95+
96+
1. Make sure your [process automation destination setup](https://developers.sap.com/tutorials/spa-create-service-instance-destination.html) is completed.
97+
98+
1. Open your process in SAP Build Process Automation. Check out which values are triggering your process. Navigate to the data type *Use Case Buddy*, where you can see the parameters.
99+
100+
<!-- size:500px -->
101+
![](visuals/datatypes.png)
102+
103+
2. Make sure your SAP Build Process Automation project is **deployed**. Once deployed, go to the monitoring tab of your Build lobby and select **Process and Workflows**.
104+
105+
<!-- size:500px -->
106+
![](visuals/processandwork.png)
107+
108+
Search for your process, and select it.
109+
110+
3. Copy the definition ID, you will use it later in your SAP Build Apps project.
111+
112+
<!-- size:500px -->
113+
![](visuals/DefinID.png)
114+
115+
4. Open your SAP Build Apps project and check the data connection **Workflow**.
116+
117+
- Make sure the correct destination is selected to access your SAP Build Process automation. *Please note: the name should match with name given when creating your process automation destination in the first step.*
118+
- The resource schema from SAP Build Apps should match the data types in SAP Build Process Automation.
119+
120+
121+
<!-- size:400px -->
122+
![](visuals/Schema.png)
123+
124+
5. Select the **Create** tab and open the formula for *Request body mapper*.
125+
126+
<!-- size:400px -->
127+
![](visuals/RBM.png)
128+
129+
6. Use the formula editor to replace the destination id of your deployed process. This is the id you copied in step 4.
130+
131+
*Context information:*
132+
*Through the destination, SAP Build applications can access the SAP Build Process Automation service, and by using the definition id of the process, the application will be able to identify the correct process to respond to. This data connection identifies the process and returns the values according to the data type schema created in the process automation project.*
133+
134+
<!-- size:400px -->
135+
![](visuals/Formula.png)
136+
137+
### Reality Check
138+
139+
✅ You just modified your process so that the right people are notified.
140+
141+
✅ You connected your process to your Work Zone site so that submitted ideas will be displayed.
142+
143+
✅ You connected your process to your app so that submitted ideas will get forwarded and processed.
144+
145+
You successfully integrated SAP Build Apps, SAP Build Process Automation and SAP Build Apps Work Zone Advanced Edition! **Your Use Case Buddy is now setup.**
146+
147+
Now you finally only need to customize the app to your needs (f.ex. the branding, the questions) and deploy it in the last tutorial: ["Customize the Use Case Buddy App to your needs"](https://developers.sap.com/tutorials/build-use-case-buddy-customize.html) of the Use Case Buddy. See you there!
148+
131 KB
Loading
162 KB
Loading
155 KB
Loading
331 KB
Loading
254 KB
Loading
189 KB
Loading
91 KB
Loading
61.2 KB
Loading
167 KB
Loading

0 commit comments

Comments
 (0)