(Example) Configure a Convert Date Format activity

Result

This example shows how to add and configure the Convert Date Format activity in the News Letter Approval app to change the date-time format for a Date Time form control.

When you add the News Letter Approval app from the App Store to the App Builder, and open the process, it looks like this:

When you complete this example procedure, the finished process looks like this:

When the process starts, the input format for the Requested On field on the Newsletter Approval Request form looks like this:

After the Convert Date Format activity runs, the output format for the Requested On field on the Newsletter - Manager Approval form looks like this:

Prerequisites

• This example uses the News Letter Approval app from the AgilePoint NX App Store.

  For more information, refer to How to Get the App

Good to Know

• For more information about the format pattern of the date-time, refer to Customize Your Date-Time Format.

How to Start

1. Click App Builder.

   
   
   

2. On the App Builder Home screen, click All Apps.

   
   
   

3. On the All Apps screen, on the News Letter Approval app, click Edit .

   
   
   

4. On the App Details screen, hover over the News Letter Approval form, and click Edit .

   
   
   

Procedure

1. On the Process Builder screen, in the Activity Library, click Add Stencils > Utilities

   
   
   

2. On the Utilities tab, drag the Convert Date Format activity onto your process.

   
   
   

3. On the General Configuration screen, in the Display Name field, enter Convert Newsletter Requested Date Format.

   
   
   

4. Click Next.
5. On the Convert Date screen, in the Input Date Time section, select Custom Attribute.
   Optional: You can also use the Static or Now option to change the date-time format:

   • Static - Specifies a static date and time.
   • Now - The date and time the system activity starts at runtime.

   
   
   

6. In the Custom Attribute field, drag the NewsletterRequestedOn variable.

   The variable NewsletterRequestedOn is an internal name of the Requested On field.

   
   
   

7. In the Input Format field, select MM/dd/yyyy HH:mm:ss.

   
   
   

8. On the Output section, in the Date String field, drag the NewsletterRequestedOn variable that you entered in the Custom Attribute field.

   This example shows how to change the date-time format of the same variable. Optionally, you can enter a different output variable to store the value from the input date-time value, and also convert the value to the specified format.

   
   
   

9. In the Output Format field, select MM/dd/yyyy.

   The output variable shows the date-time value in this format at runtime.

   
   
   

10. Click Finish.

    The Process Builder screen shows with the Convert Date Format activity

    
    
    

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

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

Next, run the app.

Procedure

1. To run the app, refer to My Apps screen.
2. Complete and submit the Newsletter Approval Request form.

   When you open the form, the Requested On field on the Newsletter Approval Request form shows in the input format.

   
   
   

3. On the My Tasks tab, open the Manager Approval task, and complete the eForm as necessary.

   When you open the task, the Requested On field on the Newsletter - Manager Approval form shows in the output format.

   For more information, refer to Open a Task (Modern Work Center).

   
   
   

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.

Get the App

1. Click App Store.

   
   
   

2. In the CATEGORY section, click Marketing.

   
   
   

3. Click the Newsletter Approval app.

   
   
   

4. On the Newsletter Approval screen, click Add.

   
   
   

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