Work Order Management

Work Order Management

Asset Version: 1.0.0
  • Version 1.0.0
Last Published: Sep 12, 2017 By: Kony Team
415 5 0 86
This MVC application showcases the abilities of Kony Fabric Engagement Server in a real world scenario with cloud storage as back-end. The work order application highlights developing omni-channel apps that use both the desktop web and mobile channels to create, approve, reject, notify, assign & request the work orders and also to view the reports of completed work-orders.
 

Requirements

  • Visualizer Enterprise
  • Kony Fabric
 

Devices

 

Platforms

The use-case that is discussed in this application is work order management that has both desktopweb and mobile channels with following flow

  1. Display of the all the existing work orders on desktopweb.
  2. Creating a new work order and making sure that it can be seen in the list.
  3. Assigning a work order to a technician and making sure that the technician receives a notification.
  4. The technician accepts the workorder and making sure that the status of the work order is updated in dekstopweb and mobile.
  5. Sending out a work sheet reminder to all the technicians from desktopweb and displaying the same on the technician’s device.
  6. Turning off the subscription of a device when the technician explicitly turns it off on the device for example when leaving on a vacation.
  7. Creating and starting a campaign when the requesting a technician to accept a work order. Also making sure that the technicians in the geoboundary receives that notification.
  8. Ensuring that the status of the work order is updated after it is accepted by the technician, once the notification from the campaign is received.

 
Features used:

  1. MF Object services with cloud storage as backend.
  2. MF Engagement services(Push Notifications,Adding subscribers, Campaign, Location & Segment creations etc).
  3. Reports module using highcharts.
  4. Kony Reference Architecture

The work order application highlights developing Omni-channel apps that use both the Desktop Web and Mobile channels to create, approve, reject, notify, assign, and request the work orders and view the reports of completed work-orders. It showcases the abilities of Kony Fabric Engagement Server in a real-world scenario with cloud storage as back-end.

Work Order Management App Functionality

This section explains the functionality of the Work Order Management app.

The Work Order Management application requires the following user roles:

  • Supervisor: The supervisor uses the Desktop Web application to perform tasks.
  • Technician: The technician uses the Mobile application to perform tasks.

 

Mobile Application:

The following is the login screen of the app:

workorder_mobilelogin.png

Once a user logs on to the app successfully, the Work Orders screen appears as shown in the following figure:
The Work Orders screen displays the list of work orders that were accepted by the technician who logged in.

workorder_m_woscreen.png

The Work Order screen displays the following UI elements:

  • Notifications: Clicking the notification icon navigates a user to the Notifications screen. The Notification screen displays the list of work orders that are notified.

    workorder_m_notif.png

  • Work Order Details: Clicking on a work order in the Notifications screen navigates a user to the Work Order Details screen. The screen displays Accept (to accept the work order) and Reject (to reject the work order) options.

    workorder_m_details.png

  • Clicking on a work order in the Work Orders screen navigates a user to the Work Order Details screen. The screen displays the Mark Complete and Mark Incomplete options.
    Mark Complete option is used complete a work order.
    Mark Incomplete option is used to mark the work order as incomplete.

    workorder_m_markcomplete.png

  • Subscriptions: Clicking the subscription icon navigates a user to the Subscriptions screen. The screen displays the status of the device subscription and location.

    workorder_m_subscription.png

Desktop Web Application:

The following is the login screen of the app:

workorder_dwlogin.png

Once a user logs on to the app successfully, the Work Order screen appears as shown in the following figure:
The Work Orders screen displays the list of work orders irrespective of the user (technician) inputs.

workorder_dw_woscreen.png

The Work Order screen displays the following UI elements:

  • Add New: Clicking the Add New button navigates a user to the Add New Work Order screen. Here, the user (Supervisor) can create a work order.

    workorder_dw_addnewwo.png

  • Reports: Clicking the Reports button displayed on the Work Order screen navigates a user to the Reports screen. The screen displays the reports of each technician. The user can also apply filters based on the technician and duration.

    workorder_dw_reports.png

  • Send Reminder: Clicking the Send Reminder button displays a prompt with Cancel and Send options. Clicking Send sends a time-sheet reminder to the respective technician.

    workorder_dw_sendreminder.png

  • Assign: Clicking the Assign button navigates a user to the Assign Work Order screen. The screen displays a list of technicians. The user (supervisor) assigns the work to a technician by clicking the Assign button.

    workorder_dw_assign.png

  • Request: Clicking the Request button navigates a user to the Request Work Order screen. The screen enables the user (Supervisor) to notify the technicians who come under the respective Geo boundaries.

    workorder_dw_request.png

  • Logout: Clicking Logout navigates a user to the Login screen.
  • Refresh: Clicking Refresh updates the existing work orders.

 

The following sections help you use the Work Order Management app.

Prerequisites

Before you start using the Work Order Management App, ensure you have the following:

  1. Kony account
  2. Kony Visualizer 7.3
  3. Kony MobileFabric 7.3
  4. For Android apps, select the GCM option under Push Notification of app project. You can add the permission using the following procedure:
    1. Open the application, and click Project Settings icon. The Project Settings dialog appears.
    2. Click the Native tab, and then click the Android sub-tab.

      workorder_kv.png

    3. Check GCM checkbox.

Importing the Work Order Management App

Before you start importing the component to Kony Visualizer, you must download the component from the Kony Marketplace website.

  1. Open Kony Visualizer.
  2. On the File menu, point to Import, and click Local Project. The Import Kony Project dialog appears.
  3. Click Select archive file.
  4. Select Import MobileFabric Services.
  5. Click Browse. The Open dialog appears.
  6. Navigate to the location where you downloaded the component (zip file) on your computer, select the component, and click Open. The Work Order Management app opens in Visualizer.

Once you import the app, you will also see a new set of elements under the Components section on the Templates tab.

After importing the app, you can configure the component the way you want it using the Look, Skin, and Action tabs on the Properties pane. Configuring the properties on the Properties pane is similar to configuring the properties of any widget in Kony Visualizer. For example, refer to Button Widget.

Configuring the UI of the Work Order Management App

The following changes must be done for the Work Order Management app:

  • Replace the value of applicationID variable in the WOM_GlobalData.js module with the appid published in your engagement server.

    workorder_dw_appid.png

    workorder_%20appidchange.png

  • Change the value of ChartServerUrl variable in the WOM_GlobalData.js module to the Desktop Web URL (You will receive the respective details after publishing the Desktop Web application to Cloud).

    workorder_%20chartserverurl.png

    Click App Service Document option, the App Service Document pane appears.

    workorder_appservicedoc.png

    Copy and paste the Desktop Web URL in WOM_GlobalData.js module

    workorder_%20chartserverurlchange.png

Configuring the WorkOrderManagement MobileFabric App

When you import the Work Order Management app into Kony Visualizer, a MobileFabric app, WorkOrderManagement, is uploaded to your Kony account.

Note:

If the auto upload fails, you must upload the WOMVCDemo.zip file located in your Visualizer workspace (at \<workspace>\<projectname>\resources\mobile\common\raw\WOMVCDemo.zip) to MobileFabric.

The WorkOrderManagement app contains a set of services by default. Using the MobileFabric console, you can configure the services as you require and then publish the app.

The following sections help you configure the WorkOrderManagement MobileFabric app.

Adding Users to Kony User Repository

To add users to Kony user repository, follow these steps:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the Apps menu. The Custom Apps page appears.
  3. Find and click WorkOrderManagement app.
  4. Click the Configure Services tab. The Configure Services tab opens.
  5. Click Kony User Repository.
  6. Click Import User. The Import Users dialog appears.
  7. Click the Choose file button.
  8. Select the UserRepository.zip file located at <workspace>\<projectname>\resources\mobile\common\raw\UserRepository.zip and click Open.
  9. Click Import.

Adding Subscribers in Engagement

To add users in Engagement services, follow these steps:

  1. Go to Subscribers page in the Engagement console.
  2. Click the Users tab. The Users tab opens.

    workorder_%20addusers.png

  3. Using the Imported Users option, upload the CSV file located at <workspace>\<projectname>\resources\mobile\common\raw\Subscribers.zip

Importing Work Orders Data bundled with Object Service

Sample work orders data is bundled with the WOMVCDemo.zip file. The data is available as the WOMVCDemo.zip file in the app zip file. You can find the data zip file in Visualizer workplace at \<works pace>\<project name>\resources\mobile\common\raw\WOMVCDemo.zip

To import the sample data, do the following:

  1. Log on to your Kony account. The Dashboard page appears by default.
  2. In the left pane, click the Apps menu. The Custom Apps page appears.
  3. Find and click WorkOrderManagement app.
  4. Click the Publish tab. The Publish tab opens. You must publish the app at least once before importing the sample data.
  5. In the Publish tab, In your environment box, in the RUNTIME CONSOLES section, click object services icon (highlighted in the following figure). The Object Services page appears.
    workorder_objectservice.png
  6. Find the WOMObjects object service by typing app's name search box. Click import icon (highlighted in the following figure). The Open dialog appears.
    workorder_objectserviceimport.png
  7. Select the WOM_Schema.zip file available in your Visualizer workspace at \<works pace>\<project name>\resources\mobile\common\raw\WOM_Schema.zip.

Configuring Messaging APIs in Engagement

  1. Uncheck the Authentication for Message API option in Engagement services under Configuration tab and save the settings. The step must be performed to invoke the messaging APIs without authorization token.

    workorder_authmessageapi.png

Replacing the Base URL in Integration Service

  1. Replace the Base URL of the WorkOrderEngagementServices Integration service in the WorkOrderManagement app, with your Engagement services URL (Ex: https://mftrial1.messaging.konycloud.com) and save the changes.

    workorder_%20intbaseurl.png

Publishing the App

After configuring the necessary configurations, you must publish the app to MobileFabric. For more information, refer to Publish a Project to MobileFabric.

workorder_publish.png

workorder_publishlast.png