Professional Documents
Culture Documents
Prototyping With SAP Build: A Walk-Through Guide As of July 2018, Version (1807)
Prototyping With SAP Build: A Walk-Through Guide As of July 2018, Version (1807)
a Walk-Through Guide
as of July 2018, Version (1807)
Purpose:
The purpose of this guide is to enable you to explore the features of SAP Build by
creating a prototype of a real app. You will create a low-fidelity prototype, comprising
images and clickable areas, develop this into a realistic prototype, and import it into
SAP Web IDE, where your development team can use it as the code-base of the app.
By following this guide, and completing the exercises within, you will learn how to the
do the following:
- Create a low fidelity prototype in minutes
- Share your prototype with users and gather feedback
- Integrate data into your prototype by importing sample data, adding objects,
and defining data properties and formulas
- Import your prototype in WebIDE
2
Revision Log
Context .................................................................................................................................5
Part 1 - SAP Build User interface explained .........................................................................6
10 minutes
Part 2 - User profile ............................................................................................................11
5 Minutes
Part 3 – Low Fidelity prototyping ......................................................................................14
15 minutes
Part 4 - Feedback Studies...................................................................................................21
Create a Study .......................................................................................................................... 21
15 minutes
Take a user study ..................................................................................................................... 25
5 minutes
Review Study results ............................................................................................................... 28
10 minutes
Part 5 – Working with Ui5 Prototypes...............................................................................31
List of Alerts page .................................................................................................................... 31
40 minutes
Message Details page .............................................................................................................. 40
40 minutes
Device page .............................................................................................................................. 49
40 minutes
Part 6 - Import into WebIDE ..............................................................................................60
Configure Destinations in SAP Cloud Platform and SAP Web IDE...................................... 60
10 minutes
Import your SAP Build project in SAP Web IDE .................................................................... 64
5 minutes
3
Revision Log
Version Date Who Remarks
1 20160316 Thomas DUBREUIL Initial version – SAP Build Beta 4
2 20160629 Thomas DUBREUIL SAP Build Beta 5 screenshots
Reorganized sections
Added goals and intent
3 20160710 Thomas DUBREUIL Added additional goals
4 20161018 Thomas DUBREUIL Minor updates
5 20161118 Thomas DUBREUIL Minor updates
6 20170119 S PERE & JL Updated with January 2017 SAP Build
TERREE Version
7 20170208 Brian Murray Copy edit
8 20170213 Thomas Dubreuil Formatting
Part 1 Edit
9 20170425 Thomas Dubreuil Updated with March 2017 SAP Build
Version
10 20170518 Thomas Dubreuil Updated with May 2017 SAP Build
Version
11 20170719 Thomas Dubreuil Updated with June 2017 SAP Build
Version
12 20180719 Joelle El Hayek Updated with July 2018 SAP Build
Version
13 20180727 Thomas Dubreuil Edits and updates
4
Context
Our mission at SAP Design is to deliver solutions to scale design and enable our internal
and external customers to build the right apps with the right experience. With our
solutions, we want to help our users on their journey towards Digital Transformation
and the Intelligent Enterprise.
SAP Build is a complete set of cloud-based tools to design and build your enterprise
app, available at https://www.build.me .
With SAP Build, you don’t have to be a designer or a developer to design apps with a
great user experience. SAP Build offers the following:
• A series of comprehensive Learning Cards that teach you Design Thinking
methodologies for designing applications that have a great user experience (UX).
• Access to the knowledge and expertise of the SAP Build user-community and
experts via the SAP Build Community pages and SAP Build blog.
• Access to hands on help from design professionals via the SAP User Experience
(UX) Design Services.
• A public Gallery of projects that showcases design materials, including personas
and journey maps, and fully-responsive prototypes, that will inspire you, and
that you can clone and use as the basis for your own project!
• The Prototype tool that enables non-technical users to create interactive
prototypes that conform to the best design practices.
• The Feedback tool that enables you to gather feedback from users about your
design images and prototypes so that you can iterate and constantly improve.
• The ability to jumpstart development without writing a line of code by importing
and integrating your prototype code into an Integrated Development
Environment such as SAP Web IDE.
With SAP Build, your company can adopt the design-driven methodology that SAP
recommends and promotes. It enables everyone to build highly-usable prototypes
without being constrained by a lack of dedicated UX designers or specialized HTML5
developers.
For SAP employees, SAP Build supports the design-led development (DLD) process by
streamlining design-gate (D-Gate) submissions and reviews.
SAP Build is available in SAP Cloud Platform, where it is hosted and operated by SAP.
You can use a limited version of SAP Build for free. You can purchase SAP Build to get
the following advantages:
• A tenant dedicated to your company
• An Admin user to manage access
• An unlimited number of users
• An unlimited number of projects per user
• The ability to create studies on html5 prototypes
• The legal right to deploy in production an application designed with SAP Build
5
Part 1 - SAP Build User interface explained
10 Minutes
Let us walk you through the SAP Build User interface, and look at how it is organized,
and how the different components are related.
Right after you log in, you’ll see your SAP Build Home page. From here you can
navigate to different parts of the tool. This schema shows some of the most common
paths between pages or modules.
You just need to remember these following two features and you’ll never get lost:
1: The icon on the top left always returns you to your Home page.
6
2: Once you’re in a project, the Toolpicker in the header bar enables you to
switch between the Persona tool, the Prototype tool, the Files tool, and the Feedback
tool.
Now to the UI Editor. It is organized with a central canvas, a toolbar on top and
panels on either side.
• Change options of the display of the prototype (size, theme, grid, snap, zoom)
• Show/Hide side panels
• Undo/Redo
• Create a study, Publish and preview the prototype
7
From the top left panel, you can drag images, controls and data onto the canvas to
compose your prototype.
• The CONTROLS Tab lists all available controls for the prototype. The controls are
organized by type and ready to be dragged onto the canvas or in the Outline.
There are many controls, Search is a best practice.
• The IMAGES Tab displays images you can drop onto the canvas. If you want to
upload more files, use the menu in the header bar to navigate to the Files section.
• The DATA Tab displays your data model objects and properties and lets you
navigate to the Data Editor.
8
The OUTLINE in the BOTTOM LEFT Panel lists pages and a hierarchy of all objects in
them. Use it as an alternative way to select, reorder, rename or delete controls. It also
supports Copy and paste with keyboard shortcuts (Ctrl-c and Ctrl-v).
Use the DISCUSSION Tab in the RIGHT Panel to ask questions or leave comments
for other Team members. Discussions happen at page level.
The PROPERTIES Tab in the RIGHT Panel is divided into three sections.
• PROPERTIES, where you can adjust the way a control looks in the canvas. Note
that you can also use it as an alternate way to bind data. By default, some barely-
used properties are hidden in the Show More subsection.
• ACTIONS where you define the actions following an event on the control, for
example a Navigation when a button is pressed.
9
• CHILDREN where you can micro manage the hierarchy of controls. You can zoom
in, add or delete controls that are children of the one you are looking at.
Happy prototyping!
10
Part 2 - User profile
5 Minutes
In this section, you will learn how to manage your user profile settings and
information. This is important because:
- All users may not be allowed to access all organizations. For example, if you
create a project in a private organization and do not have the appropriate
security settings, you may not be able to share it with people outside this
organization. In doubt, ask your SAP Build Admin user!
- You can add a profile picture, so your colleagues know what you look like!
What to do Screenshot
Connect to https://www.build.me
11
Verify that your name, email, job title and
company name are correct. Edit your
details if necessary.
https://www.build.me/go/<Name_of_the
_organization>
12
Select Communication.
Check the box “I agree to receive SAP
Build newsletter and other product
information.”; we are now friends!
Just kidding, adjust the messaging to
your preferences. For the sake of the
exercises in this guide, keep
“Collaboration” checked!
Click Save
13
Part 3 – Low Fidelity prototyping
15 minutes
In this section, you will learn how to create an interactive prototype from sketches
using pre-existing images.
Assets for this exercise are available here:
https://www.build.me/splash/sites/default/files/Prototyping_with_BUILD_Assets_0.zip
In this example, you are building an application that enables farmers to better manage
their fields by reviewing the auto generated alerts and taking appropriate actions.
This application comprises three screens:
Images
14
Screen 3: The detailed information from
the sensor
Procedure Screenshot
15
Name the project Smart Farming
16
Each thumbnail represents a page in your
prototype. On each thumbnail, double-
click the page name, and enter the
following names:
• Alerts
• Message Details
• Device
17
On the Alerts page thumbnail, select,
drag, and release on the cell containing
Storm Alert to create a hotspot.
18
These screens being designed for a
Tablet application, select the Tablet
(Landscape) device in the toolbar. This
enables users to view the application at
the correct screen size.
19
Select Share to publish a URL for the
published project that you can share with
others.
20
Part 4 - Feedback Studies
In this section, you will learn how to share a prototype with users and ask for
feedback. You will then participate in the study - as if you were a target user - and
then review the feedback.
Create a Study
15 minutes
You will learn how to create questions that ask users to perform an action on an
interactive prototype, and how to create questions about static images.
What to do Screenshot
21
The prototype is now included in the
study as your first question.
Click the tile to open the question
22
Select Done to return to the Feedback
page.
23
Your study is now published
Okay
24
Take a user study
5 minutes
You will learn how to take the user study as if you are one of the participants.
25
1. Select on an area on the image to
leave comments and sentiments.
26
Close the browser tab
27
Review Study results
10 Minutes
You will review the feedback left by the participants and get insight on their behavior,
sentiments, and navigation while using your prototype
What to do Screenshot
28
Open the question to navigate and
review comments and sentiments for all
screens.
29
Select the Statistics tab.
30
Part 5 – Working with Ui5 Prototypes
In this section, you will learn how to work with common UI5 controls, align items, and
use realistic sample data, so that your prototype is as close as possible to the final
app.
For user validation, we recommend that you create feedback studies to gather
feedback each time you make significant changes.
We’ll start with making the UI looking close to the target prototype, then we’ll add
realistic data, then polish the prototype to display the data correctly. We’ll do this
page by page;
If you accidentally run into some unexpected manipulation of controls, do not panic!
You can restore the previous state using the Undo function from this toolbar icon
or, if you prefer that, use the good old Ctrl-z keyboard shortcut.
Note: If you do not want to start from scratch, you can clone an existing prototype
from the SAP Build Gallery and then customize to fulfill your needs! But during this
exercise, you will be starting from scratch.
Summary of work to be done in this page (after creating your project, inviting
participants, and choosing the appropriate template)
- Add the images for this project (to be used later on page 3)
- Add meaningful data from the data model
- Rename the 1st page
- Create and customize the list items
- Make sure the Search bar works as expected
- Set the navigation and transition from this page to the Message Details page
What to do Screenshot
31
Select Invite Team to invite colleagues to
participate to your project.
32
You will be redirected to the page map of
your new project.
33
Drag/drop all the four images from your
downloaded assets folder.
34
Before we start with working on the user
interface, let’s talk about data in SAP
Build so you understand better what we
are doing here.
The data model will be used to display
realistic data into the prototype. It also
allows context to be kept while
navigating, making the prototype more
meaningful to the users. It will also make
your prototype ready to work with
prototyping Actions like
Create/Read/Update/Delete of Data.
35
Next, you will start editing the first page
of your prototype and make it ready to
display the data from the data model.
Go to the OUTLINE section at the bottom
of the Left Panel. Double click Page 1 and
rename it to List of Alerts.
36
Choose the Controls tab at the top of the
left Panel and search for “Standard”. Drag
and drop the Standard List to your page
right under the List Page Header.
-Title: Desc
-Description: Status
-Info: Date
37
Now let’s add the binding for the message
icon.
The Icon field is one that you need to add
yourself to the data model a it is not in
the Excel file you added. We will calculate
it based on the message type.
Note:
Message Type is a Property
= is an Operator
Alert, sap-icon://warning and sap-
icon://message-information are Values
38
Now leave the Data editor and bind the
newly created “Icon” property to the
“Icon” field of the Standard List Item.
39
Message Details page
40 Minutes
What to do Screenshot
40
Your Object Header should look as
follows:
41
In the OUTLINE, make sure the first row
is selected
-Row 2:
Rename the Label to Status
Delete the Drop-Down List, add a Text
Bind the Text to the Status data property
-Row 3:
Rename the Label to Assigned to After data binding:
Delete the Drop-Down List, add a Text
Bind the Text to the Owner data property
-Row 4:
Rename the Label to Comment
Bind the Text to the Comment data
property
42
Choose the Controls tab and search for
Map. Drag and drop it to your page right
under the Form.
43
Staying in the Properties tab on the right,
scroll down to the Children section.
44
Delete each of the toolbar icons on the
right.
45
When you are done, your table will look
as follows in the screenshot on the right
46
Add an action to the Assign button such
that it opens a new dialog when clicked.
Choose Dialog 1 under Dialog Name. You
will notice that a new page (Dialog 1) gets
added in the outline.
47
Also, from the page Outline, right click on
each of the third and fourth Form Rows
to delete them.
48
Add three actions to the OK button as
shown in the screenshot on the right.
The first action is to change the Status of
the Alert to In Progress.
The second is to save the changes.
The third is to close the dialog.
Device page
40 Minutes
What to do Screenshot
49
Now, you will start editing the third page
of your prototype.
Go to the page Outline. Double click Page
3 and rename it to Device.
50
This page will display data from a Device.
Select the whole page and bind it to the
Device data object from the Properties
menu on the right.
51
Now Delete the Footer Bar that is inside
the Header.
52
Then delete the last two form rows so
that the form is left with only two rows
instead of four
53
Your form will look as follows in the
screenshot on the right.
54
Set Chart Dimension in the Properties
menu as Date.
55
Set its Chart Dimension in the Properties
menu as Date
56
Bind the Line Chart to the Hygrometry
Dataset
57
Now select the Sub Section in the Third
Section to start customizing it. Change its
title to Messages.
58
Your Feed List will look as follows in the
screenshot on the right.
59
Part 6 - Import into WebIDE
In this section, you are going to import your prototype to Web IDE to turn it into an
app and deploy it.
This task is normally performed by a developer. In order to get access to the
prototype from SAP Web IDE, the developer needs to be a member of the team in
SAP Build. This is also a good way to ensure feasibility. If not possible, the prototype
can still be exported as a Zip file from SAP Build.
SAP is offering a new release of SAP Web IDE (herein, “SAP Web IDE, multi-cloud
version”), side by side with the standard SAP Web IDE, which is no longer being
developed. When you navigate to the SAP Cloud Portal cockpit services, you will see
two different tiles, SAP Web IDE and the new SAP Web IDE, multi-cloud version.
The procedure below details the steps to be taken when working with SAP Web IDE
Multicloud. For SAP Web IDE standard, please refer to the SAP Build documentation.
If you are using a licensed version of SAP Build you can skip this section. All
destinations were created automatically when the SAP Build service was enabled for
your company SAP CP account.
If you are a freemium user, you need to do some configuration steps in SAP CP for
SAP Build and WebIDE to be able to communicate effectively.
What do do Screenshot
60
From the menu on the left, expand:
61
Once logged in SAP Cloud Platform,
Open “Destinations” from the left menu
62
Click the tile to display the links.
Go to SAP Web IDE service.
63
Import your SAP Build project in SAP Web IDE
5 Minutes
You will now import the SAP Build prototype into SAP Web IDE to get starter UI5
code through some config.
What do do Screenshot
Select Next.
Select Next.
64
Login if required. You need to login using
the email address and the password that
you use to login to SAP Build
Select Finish.
65
Congratulations, you did it!
66