(Example) Create and Run a Form-Based App with an Existing AgilePoint Data Entity

Video: Form-Based App (Modern)

Video: Know Your App Builder IDE (Modern)

Prerequisites

• AgilePoint NX OnDemand (public cloud), or AgilePoint NX PrivateCloud or AgilePoint NX OnPremises v8.0 or higher.

Good to Know

• You can create other types of form-based apps that are not shown in this example. For more information, refer to:
  • Form-Based App with an Existing AgilePoint Data Entity as the Data Source (Modern)
  • Form-Based App with a Database as the Data Source (Modern)
  • Form-Based App with Salesforce as the Data Source (Modern)
  • Form-Based App with SharePoint as the Data Source (Modern)
  • Form-Based App with Microsoft Excel as the Data Source (Modern)
• This topic provides an example based on the Customer Request app, which you can download from the App Store.
• By default, the runtime app user can change the form, but you can set the app permissions to configure which AgilePoint NX users can create or update form data.
• After you create a form-based app, you cannot change the app to use a different data source. For example, you can not change a form-based app to use a different entity or SharePoint list than the one specified when the app was created. This limitation also applies to cloned apps. That is, you cannot clone a form-based app, and then change the data source in the cloned app.

The first step is to create a form-based app that uses an entity in AgilePoint NX Data Entities as its data source.

How to Start

1. Click App Builder.

   
   
   

2. On the App Builder Home screen, click Add App.

   
   
   

Procedure

1. On the What type of app would you like to build? screen, click Form-Based App.

   
   
   

2. Click Next.
3. On the How will people identify your app? screen, in the App Name field, enter Customer Request App.

   
   
   

4. In the Category field, select Customer Service.

   
   
   

5. Click Next.
6. On the Do you want to create widget form (not typical)? screen, click Not Required.

   
   
   

7. Click Next.
8. On the Where do you want to store the data for your app? screen, select Data Entities.

   
   
   

9. Click Next.
10. On the How do you want to set up your entity? screen, in the Data Source Name field, enter CustomerRequestEntity.

    
    
    

11. In the Primary Entity list, select Customer Request.

    
    
    

12. Click the Fields tab.

    
    
    

13. On the Fields tab, select these fields and deselect the other fields:
    • Customer Id
    • Date Of Birth
    • EmailId
    • First Name
    • Gender
    • Last Name

    
    
    

14. Click Next.
15. On the Anything else right now? screen, click Next.

    
    
    

16. On the Who can access your app? screen, click Next.

    
    
    

    The Sit back and relax while we configure your app screen opens.

    
    
    

17. On the Information screen, click OK.

    
    
    

    The eForm Builder opens the Form Settings screen for the Create form, New Customer Request.

    
    
    

Create an eForm in the eForm Builder.

Good to Know

• Every form-based app has 3 form types:
  • Create form
  • Update form
  • View form

  This procedure shows how to create the Create form, which is the form that runtime app users use to enter data.

Procedure

1. On the Form Settings screen, click General tab.

   
   
   

2. On the General tab, in the Form Title field, enter Customer Details.

   
   
   

3. To save the changes, click Close Screen .

   The eForm Builder opens the eForm.

   
   
   

Add form controls to the eForm.

Good to Know

• In a form-based app, form controls are mapped to fields from the data model in the associated data source. In this example, the form controls are mapped to fields in the associated entity.

Procedure

1. On the Data Model screen, in the dataSource list, drag the FirstName variable onto your eForm.

   
   
   

2. Drag the LastName variable onto your eForm.

   
   
   

3. Drag the DateOfBirth variable onto your eForm.

   
   
   

4. Drag the Gender variable onto your eForm.

   
   
   

5. Drag the EmailId variable onto your eForm.

   
   
   

Next, save, check in, and publish the form-based app.

For more information, refer to (Example) Save, Check In, and Publish a Form-Based App

Next, run the app.

For more information, refer to My Apps screen

Complete the eForm.

Procedure

1. On the My First Form-Based App screen, click Add .

   
   
   

2. On the Customer Details Form screen, in the First Name field, enter Jane.

   
   
   

3. In the Last Name field, enter Jackson.

   
   
   

4. In the Date Of Birth field, select 09/04/1990 from the calendar.

   
   
   

5. In the Gender field, enter Male.

   
   
   

6. In the EmailId field, enter jane.jackson@gmail.com.

   
   
   

7. Click Submit.

   The View form shows. the name you entered in the records list.

   
   
   

Optionally, you can change the data you entered in the Create form.

Good to Know

• This step uses the Update form that was configured in the Publish step. In this example, the Update form looks the same as the Create form, but behind the scenes, they are different eForms. You can change the Update form if necessary.

Procedure

1. Select the record with the value Jane.

   
   
   

2. Click Edit .

   
   
   

3. In the First Name field, change the value to John.

   
   
   

4. Click Submit.

   The View form shows the data in the records list with the new value, John.