Open and Prepopulate a TrueContext Form from the ServiceMax Go App

The TrueContext Mobile App can receive a “request” or “call” from the ServiceMax Go app on the same device. An inbound App‑to‑App request directs the TrueContext Mobile App to launch in the foreground and complete an action.

This topic describes how to send an App‑to‑App request from ServiceMax Go using the following process:

  1. Create User-defined Custom Actions in ServiceMax.

  2. Add an SFM Wizard step in ServiceMax.

  3. Test the configuration in ServiceMax Go.

Available on all tiers:

Essentials
Advanced
Enterprise

Note:Ensure that you meet the Prerequisites for Using App-to-App Communication with ServiceMax Go

Contents

Create User-defined Custom Actions in ServiceMax

  1. Sign in to your ServiceMax Core org.

    Shows how to go to the ServiceMax Setup to select Service Flow Manager and Custom Actions.

  2. Go to ServiceMax Setup, and then select Service Flow Manager.

    Result: The system displays the Service Flow Manager dropdown list.

  3. Select Custom Actions.

    Result: The system displays the Custom Actions page.

  4. From the Manage Custom Actions For list, select Work Order.

    Shows how to select Work Order from the Manage Custom Actions for dropdown list on the Custom Actions page.

    Result: The system displays the Pre-configured Custom Actions and User-defined Custom Actions sections.

  5. In the User-defined Custom Actions section, select New.

    Shows how to select New from the User-defined Custom Actions section on the Custom Actions page.

    Result: The system displays the Custom Action details for Work Order page.

  6. From the Action Type list, select App-to-App.

    Shows how to select App-to-App from the Custom Action details for Work Order page.

    Result: The system expands the Custom Action details for Work Order section for further configuration.

    Tip: If your front-line workers access the ServiceMax work orders from a browser (instead of the Go app), select the URL Action Type.

  7. Enter a descriptive Action Title, a unique Action ID, and the TrueContext App‑to‑App URL scheme.

    Info:We're now TrueContext.

    Use truecontext:// or tcxt:// in your App‑to‑App calls.

    To maintain existing integrations, TrueContext will continue to support prontoforms:// and the alternative https://prontofor.ms/.

    For more detailed information about what’s changing, visit https://support.truecontext.com/hc/en-us/articles/19516168513556

    Shows how to enter a descriptive Action Title and a unique Action ID. Also, how to enter the TrueContext URL scheme and callback actions.

    • The Action Title must be descriptive.

      The system displays this title in the ServiceMax Go Actions menu. When an app user selects this title, an App‑to‑App action is triggered.

    • The Action ID is a unique identifier and can include alphanumeric and special characters.

    • The Description is optional.

    • The Schema Name must be truecontext or prontoforms—as per the registered App‑to‑App URL scheme.

      Tip:If you selected the URL Action Type, use the truecontext://x-callback-url/action format for URL to Launch. This format requires a supported callback action.

    • The Path must include an x-callback-url to trigger specific actions from the ServiceMax app.

      For example, x-callback-url/open opens a form or list of forms in the TrueContext Mobile App from the user’s Inbox, Forms, or Drafts.

      Info:The topic App‑to‑App Actions provides a list of actions you can trigger from the ServiceMax app.

  8. Define the list of parameters to be sent from the ServiceMax app to the TrueContext Mobile App:

    Shows where to enter the required ProntoForms parameter to open a Form and map it to the static text for form name. Also, shows where to map the unique identifier in TrueContext to a ServiceMax field that stores a value.

    • Enter a Parameter Name based on the TrueContext specifications for the callback action additional parameters or use a question unique identifier.
    • For example:

      Parameter Description
      name Open a form or list of forms based on the form name.
      tag Open a form or a list of forms based on one or more form tags.
      formID Open a form or list of forms based on the form ID. This is the unique identifier of an empty form.

      Info:The topic App‑to‑App Action Details provides a list of additional parameters and their use case.

    • The Parameter Value Type enables you to send static text or values stored in ServiceMax fields. Do you want to send static text from ServiceMax Go to the TrueContext app?

      • If yes, select Value. The system sends static text.

      • If no, select Field Name. The system sends the value stored in a ServiceMax field.

    • Enter a Parameter Value. It can be

      • static text, such as the TrueContext form name

      • a ServiceMax unique identifier, such as Record ID, or

      • a field label to reference values stored in ServiceMax fields.

      The system sends field values to the mapped TrueContext questions and prepopulates the responses.

      Info:The topic Supported question types for App‑to‑App requests lists the question types that can be prepopulated.

Add a Service Flow Manager Wizard step in ServiceMax

  1. Go to ServiceMax Setup, and then select Service Flow Manager.

    Result: The system displays the Service Flow Manager list.

    Shows how to go to the ServiceMax Setup, select Service Flow Manager, and then Select Wizards.

  2. Select Wizards.

    Result: The system displays the Service Flow Wizards page.

  3. From the Select Object dropdown list, select Work Order.

    Shows how to select work order in the Select Object dropdown list. Also shows how to select Active from the Wizard Status dropdown list.

  4. From the Wizard Status list, select Active.

    Result: The system displays a list of active wizards.

  5. Select an active wizard and then select Edit.

    Shows how to select an active wizard.

    Result: The system displays the Edit SFM Wizard page.

  6. On the Manage Wizard Steps tab, select New Step.

    Shows how to select new step from the Manage Wizard Steps tab.

    Result: The system expands the page for further configuration.

  7. From the Wizard Step Type list, select Others.

    Shows how to select the Others Wizard Step Type and how to add the preconfigured user-defined custom action as a step in the wizard.

  8. From the Step Name list, select the User-defined Custom Action you configured.

    Result: The system automatically populates the Step ID, Title, and Description.

  9. Select Save.

    Result: The system adds the User-defined Custom Action as an SFM Wizard step.

    Shows how the user-defined custom action is added as new step in the wizard successfully.

  10. Select Save & Close.

    Result: The system displays the edited wizard in the list of active wizards.

Test the configuration in ServiceMax Go

  1. Sign in to your ServiceMax Go app.

  2. Go to Sync, and then select Run Configuration Sync.

    Result: The system completes the sync and returns to the main app screen.

  3. Select Explore and open a work order.

  4. Open the list of Actions.

    A step in the Actions menu opens a prepopulated form in the ProntoForms app.

  5. Select the wizard step you configured.

    Result: A prepopulated form opens in the TrueContext Mobile App.

    An app-to-app action opens a prepopulated form in the ProntoForms app.

Tip: If you can’t successfully launch the TrueContext Mobile App, create a new User-defined Custom Action with only the truecontext://x-callback-url/open request configured. If the app launches successfully, then you can add more parameters.

Related topics