Chapter 1: Creating an Appian Quick App
In this chapter, you will have your first contact with the Appian platform and create your first app. Creating an app will give you an impression of how the Appian user interface (UI) looks. You will define the data fields of a case as the foundation of that app. Appian will then automatically generate a framework of ready-made functionality around case management, task assignment, document management, and reporting.
The use case for this Quick App is the management of improvement requests by the quality assurance (QA) department. Typically, you will receive improvement requests by email, a phone call, or in a nice chat at the coffee machine. You enter and manage them in the Quick App to improve collaboration and transparency in your team.
We'll be covering the following topics in this chapter:
- Login and first contact with Appian
- Naming your Quick App
- Defining case data
- Setting permissions and generating an app
- Testing your app
Getting your own Appian Community Edition is simple. Create an account at community.appian.com, go to your profile page, and request and manage your own Appian environment.
Login and first contact with Appian
To get started, you will need to log in to your Appian environment (the Community Edition or a corporate one). If your company enabled single sign-on (SSO), you do not need to enter a username and password and you can skip step 3. The following steps will guide you to the Quick Apps Designer:
- Enter the web address of your Appian environment. If you use the Community Edition, you will need to accept the license agreement.
- Once you are done with that, you will get the login screen. There, you will need to enter your credentials and click Sign In.
- Appian Community Edition greets you with a nice screen with information on how to learn more about the Appian platform, as illustrated in the following screenshot:
- From the waffle menu at the top right of the screen, select Quick Apps Designer, as illustrated in the following screenshot:
In case you do not see the Quick Apps Designer item in the waffle menu, please follow the next five simple steps:
Tip
This will only work if you are an administrator user in your environment. So, contact your system administrator if you are working in a corporate environment and do not see that menu item.
- Open the Appian Administration Console by clicking the Admin Console item in the waffle menu, as illustrated in the following screenshot:
- Click the Add Users to the Quick App Creators role link, as illustrated in the following screenshot:
- Click ADD MEMBERS in the membership list of the Quick App Creators group, as illustrated in the following screenshot:
- Enter Designers and click ADD, as illustrated in the following screenshot:
- Appian will reload the screen to reflect that change. Now, all users who have access to the Appian design environments also have access to the Quick Apps Designer, as reflected in the following screenshot:
You have now modified the permissions in the Appian environment and made the Designers group a member of Quick App Creators. As you are a member of Designers, you now have permission to access the Quick Apps Designer as well. If you want to allow everybody to create Quick Apps, add the All Users group instead. You might need to reload the browser window or log out and log in for the permission changes to take effect.
Click the NEW QUICK APP button in the top left of the screen, as illustrated in the following screenshot, to initiate a simple four-step wizard:
Naming your Quick App
To get started, think about a proper name and description for your new Quick App. Then, give the entries a name that implies what to enter. This helps your team to understand what the new app is about. Next, proceed as follows:
- Appian asks for some basic information, as shown in the following screenshot, which you enter according to the use case idea of improvement management:
Defining case data
The default fields are a good starting point. Leave them as they are. I will explain how to add the following fields to enable proper data management:
- Description: A paragraph to describe the improvement
- Department Manager: The manager responsible for the implementation
- Department: The name of the department in which the improvement would need to be implemented
The default fields are shown in the following screenshot:
For each field, you define the name, a data type, and whether it is required or not. Some fields have additional options, which we will have a look at later.
Let's follow the next series of screenshots to add these three fields, as follows:
- Click the New Field button, as indicated in the following screenshot:
- Add another field and enter Department Manager for the label and select User as the type, as highlighted in the following screenshot:
- Name the last field Department and give it the type of Text.
- After adding the three fields, let's look at how the form and the dashboard will look. Click the PREVIEW FORM button to do so, as illustrated in the following screenshot:
Appian will display a preview of the form, and you can already enter data to see whether it fits your requirements, as indicated in the following screenshot:
- Click the DASHBOARD button highlighted in Figure 1.17 to switch to a preview of how the screen for each improvement will look. This is the result:
Setting permissions and generating an app
In the Access step, add users to the Owners field to define who is allowed to modify the app—for example, to add another field. By adding users to the Collaborators field, you enable them to participate in using the app.
Select an icon you'd like to represent the app's use case, as highlighted in the following screenshot:
Click the CREATE QUICK APP button to make Appian generate the final app. This takes a bit of time, so let's use that to recap what you did to create a Quick App, as follows:
- Define an app and record name.
- Define a name and type for the record's fields.
- Define who can work with the app and who can modify it later on.
- Wait a bit…
- Click the following link to open the Quick App:
The generated Quick App contains the following three tabs:
- IMPROVEMENTS
- TRENDS
- MY TASKS
Check all the tabs. Since you have not entered any data yet, there is not much to see, as the following screenshot shows:
Testing your app
Testing is an important step in any software development, even in low-code with Appian and in a no-code approach when creating a Quick App. Later in this book, we will have a closer look at how testing and QA in Appian works. For now, let's create some new improvements to make sure the app works as designed. Proceed as follows:
- Click the + NEW IMPROVEMENT button, as illustrated in the following screenshot:
- You now see a screen to add a new improvement. This screen looks very similar to the one you saw just minutes ago in the preview function of the Quick Apps Designer, as we can see here:
- Enter some data to create a new improvement record item. An example of what to add is provided in the following screenshot:
- After clicking the SUBMIT IMPROVEMENT button, you should see a list showing your just created item, as depicted in the following screenshot:
- Click the new item to open it. You will see the data you entered a moment ago in the format as defined in the Quick Apps Designer, as illustrated in the following screenshot:
This app is instantly available on your mobile device. Download the Appian app from your mobile app store, start it and follow these four simple steps:
- Set up a new account.
- Add a new account.
- Enter the server name of your Appian environment.
- Enter your credentials.
The preceding steps are illustrated in the following screenshot:
Voilà—your first mobile app! Take a look:
Tap that list item to open the improvement. The following information is shown in the next figure:
Hence, with this we are done with testing our very first application.
Summary
There you go—congratulations! This is your first app in Appian: your personal Hello World. You learned how to open the Quick Apps Designer, assign a name, define the data and collaborators, and finally have Appian generate a Quick App. Play with your new app and collaborate with the colleagues you added. If you find out that there is a field missing, go back to the Quick Apps Designer and add it. And by adding more users as collaborators, you have your whole team on board in no time.
This is just the first chapter in this book, and there is so much more to discover in Appian. In the next chapter, you will learn more about how to get the most out of your new Quick App.
Further reading
Here are some further sources of information for you to take a look at: