(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.

    Build Apps screen
  2. On the Application Explorer screen, click News Letter Approval > Processes > News Letter Approval > Process Model > News Letter Approval.

    Sales Quotation Process Model

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 2: (Optional) Complete the Process

Next, save and validate your process model.

Procedure

  1. To validate a process, refer to Validate a Process.
  2. On the Save quick menu, click Save and Check In.

    Save Newsletter Approval

Step 3: (Optional) Publish and Run the App

Next, publish the app so people can use it.

Procedure

  1. To publish the app, refer to Publish a process-based app.
  2. To run the app, refer to Start your process.
  3. 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
  4. 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.


    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 icon.

    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.