(Example) Configure a Convert Date Format activity

This example shows how to configure a Convert Date Format activity in a process-based app.

Background and Setup

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:

News Letter Approval Preview
When you complete this example procedure, the finished process looks like this:

News Letter Approval Final

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


Input Start Date

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


Custom Attributes Result

Prerequisites

Good to Know

How to Start

  1. Click App Builder.

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

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

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

    Click Edit

Step 1: Configure a Convert Date Format activity

First, add and configure the Convert Date Format activity.

Procedure

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

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

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

    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:

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

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


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

    Input Format
  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.


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

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


    Output Format
  10. Click Finish.

    The Process Builder screen shows with the Convert Date Format activity


    Output Format

Step 3: (Optional) Run the 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.


    Newsletter Approval Request
  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).


    Dropbox repository

How to Get the App

This example is based on the Newsletter Approval app from the AgilePoint NX App Store. Use this procedure to get the app.

Prerequisites

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.

    App Store
  2. In the CATEGORY section, click Marketing.

    App Store screen
  3. Click the Newsletter Approval app.

    Marketing screen
  4. On the Newsletter Approval screen, click Add.

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