(Example) Create an eForm to Start the Process (Create Absence Request)

This example shows how to create a Create Absence Request eForm to start the Absence Request app.

Background and Setup

Target Result

When you complete this step, the finished eForm will look like this.


Target Result

Good to Know

  • The Create Absence Request form is used to submit an absence request with required information about an employee and leave details.
  • An employee completes this form to request leave and submits it to HR and the Manager for approval.

Prerequisites

How to Start

  1. Open Process Builder.

    For information about how to open this screen, refer to Process Builder.


    Open Process Builder

Step 1: Create an eForm (Create Absence Request)

First, create a Create Absence Request eForm to start the process in Absence Request app.

Procedure

  1. In Process Builder, on the eForms tab, drag the Start Task activity onto your process.

    Drag Start Task
  2. On the eForm Configuration screen, click Add New Form.

    Click Add New Form
  3. On the Form Details screen, in the Form Name field, enter Create Absence Request.

    Enter Form Name
  4. Click Next.
  5. On the Choose Form Layout screen, click Blank Form.

    Select Blank Form
  6. Click Finish.

    The eForm Builder shows the Form Settings screen for the Create Absence Request form.


    Create Absence Request

Step 2: Start Formatting the eForm

Next, format the columns for the Create Absence Request eForm.

How to Start

  1. On the Form Settings screen, click Close Screen Close Screen icon.

    Close Form Settings

Procedure

  1. On the eForm Builder screen, click Columns.

    Click Columns
  2. On the Column Layout screen, click 2.

    Select Columns
  3. Click OK.
  4. The eForm Builder shows the Create Absence Request form with 2 columns.

    Create Absence Request

Step 3: Show a Logo Image on the eForm

Next, show a logo image on the form using the Image form control.

Good to Know

  • This example uses a logo image stored in App Builder.

    There are other ways to reference a logo image:

    • Upload an image with the Image form control.
    • Upload a shared image for the app in App Builder.
    • Use an image stored in an external location can be accessed by a URL from your app at runtime.

Procedure

  1. On the eForm Builder screen, in the Tool Box, open the Common Controls Common Controls icon tab.

    Common Controls tab
  2. On the Common Controls tab, drag a Image Image icon form control onto your eForm.

    Drag Image Control
  3. On the Field Settings - Image screen, in the Label field, enter Company Logo.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  4. To save the changes, click Close Screen Close Screen icon.
  5. On the Create Absence Request form, put your cursor over the Image form control, and the Form Control Quick Menu shows.

    Form Control Quick Menu Shows
  6. On the Form Control Quick Menu, click Image Picker Image Picker icon.

    Click Image Picker
  7. On the Image Picker screen, select the logo image.

    Select Logo Image
  8. Click OK.

    The form shows the logo image.


    Shows Logo Image

Step 4: Create a Title (Create Absence Request)

Next, create a title for the Create Absence Request form using the Heading form control.

Procedure

  1. On the Common Controls tab, drag a Heading Heading icon form control onto your eForm.

    Drag Heading Control
  2. On the Field Settings - Heading screen, in the Label field, enter Create Absence Request.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Behavior tab.

    Click Behavior Tab
  4. On the Behavior tab, in the Text Align field, select Center.

    Select Text Align
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the Create Absence Request form, expand the Create Absence Request form control to the width to show on the eForm.

    Expand Heading Control

Step 5: Create a Heading (Employee Information)

Next, create the Employee Information heading in the Create Absence Request form using the Heading form control.

Procedure

  1. On the Common Controls tab, drag a Heading Heading icon form control onto your eForm.

    Drag Heading Control
  2. On the Field Settings - Heading screen, in the Label field, enter Employee Information.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, in the Heading Style field, select Extra Large.

    Select Heading Style
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the Create Absence Request form, expand the Employee Information form control to the width to show on the eForm.

    Expand Heading Control

Step 6: Configure a Text Box Form Control (Employee Name)

Next, configure a Text Box form control to show the full name of the employee — usually the runtime app user — on the eForm.

Procedure

  1. On the Common Controls tab, drag a Text Box Text Box icon form control onto your eForm.

    Drag Text Box Control
  2. On the Field Settings - Text Box screen, in the Label field, enter Employee Name.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click App Data > System Data.

    Expand App Data
  4. In the Default Value field, drag the User Full Name system data variable.

    Drag User Full Name
  5. Click the Behavior tab.

    Click Behavior Tab
  6. On the Behavior tab, deselect Enabled.

    Deselect Enabled
  7. To save the changes, click Close Screen Close Screen icon.

Step 7: Configure a Date Form Control (Date Prepared)

Next, configure a Date form control to enter the date for the absence request on the eForm.

Procedure

  1. On the Common Controls tab, drag a Date Date icon form control onto your eForm.

    Drag Date Control
  2. On the Field Settings - Date screen, in the Label field, enter Date Prepared.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. In the Default Value field, select Current Date.

    Select Current Date
  4. To save the changes, click Close Screen Close Screen icon.

Step 8: Configure a Text Box Form Control (Designation)

Next, configure a Text Box form control to enter the job title on the eForm.

Procedure

  1. On the Common Controls tab, drag a Text Box Text Box icon form control onto your eForm.

    Drag Text Box Control
  2. On the Field Settings - Text Box screen, in the Label field, enter Designation.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. In the Default Value field, enter Support Engineer.

    Enter Default Name
  4. To save the changes, click Close Screen Close Screen icon.

Step 9: Configure an Auto-Suggest Form Control (Department)

Next, configure an Auto-Suggest form control to select the department on the eForm.

Procedure

  1. On the Common Controls tab, drag a Auto-Suggest Auto-Suggest icon form control onto your eForm.

    Drag Auto-Suggest Control
  2. On the Field Settings - Auto-Suggest screen, in the Label field, enter Department.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Shows Internal Name
  4. On the Configure tab, in the List Options section, click Add Option 6 times to add a total of 7 rows.

    Add Options
  5. In the Name and Value fields, enter these values.
    • Engineering
    • HR
    • Professional Service
    • Accounts
    • Sales
    • Support
    • Marketing

    Enter the Values
  6. To save the changes, click Close Screen Close Screen icon.

Step 10: Configure a Text Box Form Control (Manager Name)

Next, configure a Text Box form control to show the name of the manager on the eForm.

Procedure

  1. On the Common Controls tab, drag a Text Box Text Box icon form control onto your eForm.

    Drag Text Box Control
  2. On the Field Settings - Text Box screen, in the Label field, enter Manager Name.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click App Data > System Data.

    Expand App Data
  4. In the Default Value field, drag the User Manager Name system data variable.

    Drag User Full Name
  5. Click the Configure tab.

    Configure Tab
  6. On the Configure tab, select Required.

    Select Required
  7. To save the changes, click Close Screen Close Screen icon.

Step 11: Configure a People Picker Form Control (Select Manager Name)

Next, configure a People Picker form control to select the manager name on the eForm.

Procedure

  1. On the Advanced Controls tab, drag a People Picker People Picker icon form control onto your eForm..

    Drag People Picker Control
  2. On the Field Settings - People Picker screen, in the Label field, enter Select Manager Name.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, click Add New Mapping.

    Click Add New Mapping
  5. In the Property field, select UserName.

    Select UserName
  6. In the Control field, select ManagerName.

    Select Control
  7. To save the changes, click Close Screen Close Screen icon.

Step 12: Create a Heading (Leave Details)

Next, create the Leave Details heading in the Create Absence Request form using the Heading form control.

Procedure

  1. On the Common Controls tab, drag a Heading Heading icon form control onto your eForm.

    Drag Heading Control
  2. On the Field Settings - Heading screen, in the Label field, enter Leave Details.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, in the Heading Style field, select Extra Large.

    Select Heading Style
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the Create Absence Request form, expand the Leave Details form control to the width to show on the eForm.

    Expand Heading Control

Step 13: Configure a Subform Form Control

Next, configure a Subform form control to specify the dates, total hours, and type of absence on the eForm.

Procedure

  1. On the Common Controls tab, drag a Subform Subform V8 icon form control onto your eForm.

    Drag Text Box Control
  2. On the Field Settings - Subform screen, in the Label field, enter Leave Details.

    Enter Label
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, in the Display Style field, select Columns.

    Select Columns
  5. In the Maximum Occurrence field, enter 20.

    Enter Maximum Occurrence
  6. Click the Appearance tab.

    Click Appearance Tab
  7. On the Appearance tab, in the Font Style field, click Bold.

    Select Bold
  8. To save the changes, click Close Screen Close Screen icon.
  9. On the Create Absence Request form, expand the Subform form control to the width to show on the eForm.

    Expand Subform Control

Step 14: Design the Subform

Next, design the subform with the columns.

Procedure

  1. On the Create Absence Request form, put your cursor over the Subform form control, and the form control toolbar shows.

    Toolbar Shows
  2. Click Design Subform Design Subform icon.

    Click Design Subform
  3. Click Add Column Add Column icon to show the Leave Details subform with 3 columns.

    Click Add Column

Step 15: Configure a Drop-Down List Form Control (Absence Type)

Next, configure a Drop-Down List form control to select the type of absence on the subform.

Procedure

  1. On the Common Controls tab, drag a Drop-Down List Drop-Down List icon form control onto your eForm.

    Drag Drop Down Control
  2. On the Field Setting - Drop-Down List screen, in the Label field, enter Absence Type.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, select Required.

    Select Required
  5. In the List Options section, click Add Option 3 times to add a total of 4 rows.

    Add Options
  6. In the Name and Value fields, enter these values.
    • Casual Leave
    • Sick Leave
    • Comp Off
    • Vacation

    Enter the Values
  7. To save the changes, click Close Screen Close Screen icon.

Step 16: Configure a Date Form Control (Absence Date)

Next, configure a Date form control to select the date of the absence on the subform.

Procedure

  1. On the Common Controls tab, drag a Date Date icon form control onto your eForm.

    Drag Date Control
  2. On the Field Setting - Date screen, in the Label field, enter Absence Date.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, select Required.

    Select Required
  5. To save the changes, click Close Screen Close Screen icon.

Step 17: Configure a Number Box Form Control (Hours)

Next, configure a Number Box form control to enter the total number of hours of absence on the subform.

Procedure

  1. On the Common Controls tab, drag a Number Box Number Box icon form control onto your eForm.

    Drag Number Box Control
  2. On the Field Setting - Number Box screen, in the Label field, enter Hours.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, select Required.

    Select Required
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the subform, to save the changes, click Close Screen Close Screen icon.

    Click Close Screen

Step 18: Create a Heading (Comments)

Next, create the Comments heading in the Create Absence Request form using the Heading form control.

Procedure

  1. On the Common Controls tab, drag a Heading Heading icon form control onto your eForm.

    Drag Heading Control
  2. On the Field Settings - Heading screen, in the Label field, enter Comments.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, in the Heading Style field, select Extra Large.

    Select Heading Style
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the Create Absence Request form, expand the Comments form control to the width to show on the eForm.

    Expand Heading Control

Step 19: Configure a Text Area Form Control (Employee Comments)

Next, configure a Text Area form control to enter comments on the eForm.

Procedure

  1. On the Common Controls tab, drag a Text Area Text Area icon form control onto your eForm.

    Drag Text Area Control
  2. On the Field Settings - Text Area screen, in the Label field, enter Comments.

    Enter Label
  3. Click the Configure tab.

    Click Configure Tab
  4. On the Configure tab, in the Display Rows field, enter 6.

    Enter Display Rows
  5. To save the changes, click Close Screen Close Screen icon.

Step 20: Configure a Formula Form Control (Total Hours Requested)

Next, configure a Formula form control to calculate the total number of hours of absence requested by the runtime app user.

Procedure

  1. On the Advanced Controls tab, drag a Formula Formula icon form control onto your eForm.

    Drag Formula Control
  2. On the Field Settings - Formula screen, in the Label field, enter TotalHoursRequested.

    Enter Label

    When you click the Internal Name field, the Internal Name field shows the value you entered in the Label field with no spaces.


    Shows Internal Name
  3. Click the Behavior tab.

    Click Behavior Tab
  4. On the Behavior tab, deselect Visible.

    Deselect Visible
  5. To save the changes, click Close Screen Close Screen icon.
  6. On the Create Absence Request form, put your cursor over the Formula form control, and the Form Control Quick Menu shows.

    Form Control Quick Menu Shows
  7. On the Form Control Quick Menu, click Formula Formula icon.

    Click Formula
  8. On the Formula Builder screen, in the Formula field, enter this formula.
    sum( ${LeaveDetails/Hours:[*]})

    Enter Formula
  9. To make sure the formula is correct, click Validate.

    Click Validate
  10. Click OK.

Step 22: Complete the eForm (Create Absence Request)

Next, complete the Create Absence Request eForm and return to the Absence Request process.

Target Result

When you complete this step, the finished eForm will look like this.


Target Result

Procedure

  1. On the eForm Builder screen, click Save > Save and Check In.

    Save and Check In

    The eForm Builder screen closes and the eForm Configuration screen shows in the Process Builder.


    Eform Configuration screen
  2. On the eForm Configuration screen, select the Create Absence Request eForm.

    Eform Configuration screen
  3. Click Next.
  4. On the General Configuration screen, in the Display Name field, enter Create Absence Request.

    Eform Configuration screen
  5. Click OK.
  6. The Process Builder shows the process model with the Create Absence Request start task.

    Create Absence Request Start Task