Installing and configuring WorkCycle for TruETA

First available in: TMW Operations 2019.4

Requirements:

You must have system administrator permissions to install and configure WorkCycle.

You use a WorkCycle workflow to determine how often SystemsLink communicates with the TruETA service and how often it updates your database.

To perform this part of the setup, you must have already downloaded the required files and installed SystemsLink. If you have not already done this, you must do it before you install WorkCycle. Follow the steps in these topics:

Installing WorkCycle

  1. Open File Explorer and locate the Trimble Web Products ZIP folder.

  2. Install WorkCycle.

    For details, see the WorkCycle installation topic in the WorkCycle online help.

    Note: After you download and install WorkCycle, you must:

    • Update the TMWWorkflow.exe.config file.

    • Create the TruETA WorkCycle workflow.

    • Specify the workflow frequency.

Updating the TMWWorkflow.exe.config file

  1. Use File Explorer to open the location where you installed WorkCycle.

    image1

  2. Double-click on the Tools folder.

  3. Open the TMWWorkflow.exe.config file in a text editor, such as Notepad++.

  4. Search for the <appSettings> section.

  5. For the TMWLicenseService setting, enter the URL to your company’s licensing service endpoint.

    For example: http://YourURL.com/QALicensingService20192/LicensingService.svc

  6. Save your changes.

  7. Back up this file so you do not have to make these changes after future upgrades.

Setting up the TruETA workflow

  1. In File Explorer, go to the location where you installed WorkCycle.

  2. Double-click on Work Cycle Management.

    image2

    The Workflow Designer application opens.

    image3

  3. Go to File > New.
    A Save Confirmation message opens. It asks, "Would you like to save your workflow?"

  4. Click No.

  5. In the Activities section, expand SystemsLink.
    A list of SystemsLink activities are displayed.

  6. Click on the TruETA Process Trip Legs option.

    Note: If you do not see this SystemsLink option, contact your Support representative.

  7. Drag this option to the Workflow area.
    A predefined workflow is displayed.

    image4

  8. Click on the TruETA Process Trip Legs action.
    Task options are displayed in the Options section.

    image5

  9. Make entries in these fields:

    Required field: *

    Field

    Definition

    Hours Out *

    Number of hours into the future to look for scheduled trips

    Note: Trimble Transportation recommends entering 30.

    IncludeCmpCanOnly

    Determines which trip statuses are used in the TruETA calculations

    Leave this field blank.

    Legs To Process Per Call

    Determines the number of trips processed each time the TruETA service runs

    Default value is 50.

    LghNumber

    Specific trip number

    Default is blank.

    This field is used for diagnostic purposes. It allows the TruETA service to process the same trip number until the diagnostic is complete.

    Service URL *

    URL to the TruEtaServiceInternal.svc

    For example: http://localhost/SystemsLinkTruETA.TMW/Wrapper/TruEtaServiceInternal.svc

    Use First Driver Trip

    Determines if the TruETA service looks at inactive trips (trips with a Started status)

    Options:

    • N (default)

    • Y

  10. Go to File > Save As.
    The Enter A Name window opens.

  11. Enter a name for this workflow and click Save.

Setting the workflow’s frequency

Before you can set the workflow’s frequency, you must set up the workflow.

  1. If needed, open the Workflow Designer application and then open your saved workflow.

    1. Go to File > Open.
      The OpenWorkflow window opens.

    2. Select the needed workflow and click Load.
      The workflow is displayed in the Workflow Area section.

  2. Go to Options > Manage Workflow Launching.
    The WorkflowLaunching window opens.

    image6

  3. If needed, select the Enabled checkbox in the Workflow Timer section.

  4. Use the other fields in this section to specify the workflow’s frequency.

  5. Click Update.
    A message is displayed. It states, "File mask and directory must be complete to save File Watcher. Schedule saved."

  6. Click OK.

  7. Close the WorkflowLaunching window.

  8. Follow the steps listed in Setting up TMW Operations for TruETA.