(Example) Configure the Sequence Number Form Control

Result

This example shows how to create the Sequence Number form control that is configured in the Sales Invoice app to show an alphanumeric string with a number that increments each time a new instance of an eForm starts.

Prerequisites

• This example uses the Sales Invoice app from the AgilePoint NX App Store.

  For more information, refer to How to Get the App

  ​

Good to Know

• Sales Invoice is an app that creates an invoice for the products sold. This app provides a Sales Invoice Request eForm to enter the details for the invoice. When you configure the Sequence Number form control in the request eForm, the invoice number increments each time a new instance of an eForm starts. This results in a unique number for the eForm instance, which serves as an invoice number.
• If a form user starts a new instance of an eForm, and then cancels it without submitting the form, the sequence number created for the eForm instance becomes unusable. The next time an eForm instance is created, a new sequence number is created.

How to Start

1. Click Build Apps .

   
   
   

2. On the Application Explorer screen, on the My Applications pane, click Sales Invoice > Processes > Sales Invoice > Forms > Task Forms > Sales Invoice Request.

   
   
   

Procedure

1. On the Sales Invoice Request form, put your cursor over the Invoice Number form control, and the form control toolbar shows.

   
   
   

2. Click Edit Properties .

   
   
   

3. On the Field Settings - Sequence Number screen, on the General tab, in the Label field, enter Invoice Number.

   
   
   

   When you click the Internal Name field, this field complete by default based on the value you enter in the Label field.

   
   
   

4. Click the Configure tab.

   
   
   

5. In the Start Value field, enter 1 that shows the first number in the increment series.

   
   
   

6. In the Increment By field, enter 1 to increment the invoice number each time by 1.

   
   
   

7. In the Prefix field, enter INV00 to show before the invoice number.

   
   
   

8. To save the changes, click Close Screen .

   The Sales Invoice Request form shows.

   
   
   

   To check the Sequence Number form control, you must publish and run the app to create an instance of the eForm.

Next, publish the application so people can use it.

Procedure

1. To publish the app, refer to Publish a process-based application.
2. To run the app, refer to Start your process.

Prerequisites

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

Good to Know

• This procedure is optional. It is provided so you can test the example with an out-of-the-box app.
• This is part of the Background and Setup procedures, but many users preferred this step to appear after the example, not before it.

Procedure

1. Click App Store .

   
   
   

2. In the CATEGORY section, click Sales.

   
   
   

3. Click the Sales Invoice app.

   
   
   

4. On the Sales Invoice screen, click Add.

   
   
   

5. On the Trust App screen, click Trust it.
6. Click Return to site.