Spring 2012 Release - CorrigoNet Version 7.6a
Spring 2012 Release - CorrigoNet Version 7.6a
SPRING, 2012
UPGRADE AVAILABILITY
VERSION 7.6A IS AVAILABLE IN PRODUCTION NOW. ALL 7.6 INSTANCES WILL BE MOVED TO 7.6A. CorrigoNet Version 7.6a is a minor update to 7.6 onto which ALL 7.6 clients must move. All 7.5 clients will be move to 7.6a as soon as schedulable. A GLOSSARY SECTION has been included at the end of these notes designed for readers who are new to The Work Order Network or Corrigo. Some terms in this document may not be what you might expect. For example, THROUGHOUT THESE NOTES, THE WORD CUSTOMER SHOULD BE UNDERSTOOD BY MANY CORRIGO CLIENTS TO MEAN STORE. For anyone who feels confused, the glossary should help.
CONTENTS
Upgrade Availability.......................................................................................................................................................1 Highlights .......................................................................................................................................................................4 Enhancements to Customer/Store Portal .....................................................................................................................5 Access to Documents .................................................................................................................................................5 Show Customer Documents ..................................................................................................................................5 Request Approval Extensions ....................................................................................................................................8 Example Scenario...................................................................................................................................................8 Contact Request Limit Setting .............................................................................................................................10 Theme Settings for Workflow ..............................................................................................................................11 Approving a Request............................................................................................................................................12 Enhacements to the customer portal assignment ...................................................................................................14 Assignment Settings & Configuration ..................................................................................................................14 On Upgrade..........................................................................................................................................................15 New Work Order Table Fields ..................................................................................................................................16 Improvement To the Last Step of the Wizard ......................................................................................................16 Enhancements to Back-Office/Corp App .....................................................................................................................17 Email Based Quote Approval ...................................................................................................................................17 Configuration .......................................................................................................................................................17 Use Scenario ........................................................................................................................................................18 Possible Scenarios................................................................................................................................................20 Specialty Groups & Dispatch Board Specialty Group Filter .....................................................................................20 Configuration .......................................................................................................................................................21 Financial Reporting Periods .....................................................................................................................................23 Disallow Vendor Invoice Authorization when WO is Active ....................................................................................24 Tenant COI Extensions .............................................................................................................................................24 Change to Customer Theme Settings Layout ..........................................................................................................24
Corrigo Incorporated Proprietary & Confidential Page 2
Logged In User Access to Stock Locations ...............................................................................................................24 New Materials Management Setting ...................................................................................................................24 Log in to Portal from Contact Details page ..............................................................................................................25 Tablet Extensions .........................................................................................................................................................27 Support for Providers ..........................................................................................................................................27 Display Flags ........................................................................................................................................................28 Quote Approval ...................................................................................................................................................29 Email Work Orders...............................................................................................................................................30 WO list on Customer Page ...................................................................................................................................30 Limit creation of Grandchildren ...........................................................................................................................31 Select List of Other Enhancements/Defect Fixes .........................................................................................................34 WSDK Changes .............................................................................................................................................................35 Import/Export Changes/Enhancements ......................................................................................................................36 Glossary: Terms Used in this Document ......................................................................................................................37
Corrigo Incorporated
Page 3
HIGHLIGHTS
This release contains a number of tweaks and not many significant items. Some of the more important tweaks include: Several enhancements to the workflow associated with the Customer/Store Portal, including: o Access to Customer & Customer Group Documents o Helpful new work order table fields o Extensions to assignment & request approvals Extensions to the tablet interface, including: o The Work Order Network with Vendor/Provider assignment o Visibility to flags o Quote visibility and approval Email Based Quote approvals the ability for a user to receive quotes from providers via email alerts and approve or reject the quotes by replying to the email The ability for a back-office administrative user to log in to the customer portal from the Custoemr Contact details page A Specialty Group Filter for the Dispatch board to better support functionally segregated back-office teams
Corrigo Incorporated
Page 4
ACCESS TO DOCUMENTS
Clients have often requested the ability to make documents like site maps, maintenance procedures, pictures, etc. available to customers via the portal.
Figure 1: Detail from Customer > Customer Portal Admin > Themes
When this is enabled, a new documents option appears in the View dropdown of the Home Page, as shown in Figure 2.
Corrigo Incorporated
Page 5
Corrigo Incorporated
Page 6
Scope is whatever was chosen on home page before coming to this page. Show All, will show all documents across all customers and customer groups. If a Customer Group was selected, ONLY documents associated with the customer group will be shown. Customer will ONLY see documents related to the customer, not docs associated with the Customer Group.
Figure 3: Documents page: showing 3 documents associated with this particular customer
The documents displayed are those associated with the Customer or Customer group. The example above shows the documents associated with that customer, configured in the Customer Details page of the Corp. as shown below.
Corrigo Incorporated
Page 7
NOTE: CUSTOMER WILL ONLY SEE DOCUMENTS RELATED TO THE CUSTOMER, NOT DOCS ASSOCIATED WITH THE CUSTOMER GROUP.
EXAMPLE SCENARIO
The system must be setup appropriately which includes: Theme settings include o Enable request approvals - On o Automatically send any work orders in the new status - On Notifications are turned on. Specifically the Request Needs Authorizing o Type is enabled o According to the theme, the Regional Manager shall be sent the notification (e.g.: send to Customer or Customer Group Primary) Contacts are set-up
Proprietary & Confidential Page 8
Corrigo Incorporated
Store Manager the work flow will only be enabled when a request is placed on a WO that exceeds the managers limit o Regional Manager has sufficient authority to approve AND their notification threshold is below the NTE NTEs are set up
Scenario: 1. 2. 3. Store manager places a request via the portal Contact selects to get the work done On the confirmation page, the manager see a note that the work has been created by not yet sent as seen in Figure 5.
4. 5.
The Regional Manager will now receive a notification: New Work Order Requires Sending Regional Manager logs in and sees the work order needs her attention (Figure 6)
6.
Corrigo Incorporated
Page 9
7. 8. 9.
RM approves the request The WO becomes New The WO is automatically sent to the assignee
Note: Send limit restricts the work a contact may request from a vendor based on NTE
Corrigo Incorporated Proprietary & Confidential Page 10
Authorization limit restricts the value of invoices the contact may authorize.
as shown below.
Figure 9: Customer > Customer Portal Admin > Themes > [Theme] > Settings
Corrigo Incorporated
Page 11
On
No
APPROVING A REQUEST
When a work order is put on hold due to request approvals being on, the reason is Request needs customer approval and the customer notification Request Needs Authorizing is triggered. The notification is a tweaking of a prior notification and can be seen in the configuration pages shown in Figure 9 and Figure 10. Work orders in this state will appear with a Review Request action button in the Customer Portal as seen in Figure 6.
Corrigo Incorporated
Page 12
Figure 11: Customer > Customer Portal Admin > Themes > [Theme] > Send Notifications
APPROVAL LIMIT
If the user does not have a sufficient request limit to review a request they will see a warning dialog showing the default string The NTE in this work order is greater than the maximum dollar amount you are allowed to approve. Someone with a higher request limit will need to login to approve it.
ON APPROVAL
The work order is re-opened and: The note entered is added as the re-open comments The work order is sent, If: o The work order is assigned to a connected Provider, AND o Customer portal theme setting Automatically send approved work orders = yes
REJECT
The work order is cancelled with the reason Customer Cancelled Request and the contents of the text area used to populate the reason for the cancellation.
Corrigo Incorporated
Page 13
ASSIGNMENT SETTINGS
None - The assignment selection page is not shown in the wizard and auto-assignment is switched off when the work order is created. The resulting work orders will always be unassigned. Automatic - The assignment selection page is not shown in the wizard and the work order is autoassigned when created. The resulting work orders may or may not be assigned. Assisted (to preferred providers) - The assignment selection is displayed, showing only preferred Providers Assisted (to any provider) - The assignment selection page is displayed showing all Providers
RE-ASSIGNMENT SETTINGS
None - There is no re-assign option in the available actions dropdown on the work order details page. Work order rejected notifications are not sent. Assisted (to preferred providers only) - There is a re-assignment option and work order rejected notifications are sent.
Corrigo Incorporated
Page 14
Assisted (to any provider) - There is a re-assignment option and work order rejected notifications are sent.
None/Automatic
None
NOTE THE AUTOMATIC/ASSISTED CONFIGURATION (2ND ROW ABOVE) DOES NOT EXPLICITLY PROHIBIT STORES FROM ASSIGNING WORK FOR REASONS OTHER THAN EXCEPTION BUT IT IS EXPECTED THAT THIS WILL BE ENFORCED THROUGH COMMUNICATION OF COMPANY POLICIES, OUTSIDE THE CONTEXT OF THE SYSTEM.
DEPENDENCIES
The Notification: Work Order Rejected is now dependent on Re-assignment setting NOT being None The release action will only be visible when the re-assignment option is not None.
ON UPGRADE
The old settings are migrated as follows Old Settings Allow Assignment/Reassignment No No To preferred To any Allow AutoAssignment No Yes Dont care Dont care Assignment None Automatic To preferred To any New Settings Re-assignment None None To preferred To any
Corrigo Incorporated
Page 15
Figure 13: Customer > Customer Portal Admin > Themes > [Theme] > Work Order Table Configuration
Age this is X day(s); e.g. days only: 1 day or 2 days Needs Attention this is the age of the highest priority work order action that the user has visibility to, i.e. it is how long the work order has been waiting in the contacts needs attention list. Detailed Status - When the status is either Needs Attention or On-Hold, this field shows the reason, otherwise it shows the status. This is expected to be used in place of the status, not in addition to the current status. Detailed status
Age of WO
Corrigo Incorporated
Page 16
CONFIGURATION
Requirements Notes To ensure integrity or responses, users replying to approve the work order must have an email address that is unique to that user. Quote Submitted/NTE Increase Request Alert is enabled (Figure 15) User (not customer contact) has access to the locations for which a quote is being requested User must be subscribed to alert (Figure 16) and have properly configured alert address User role has sufficient authority to approve the quote amount (Figure 17)
Figure 15: Detail of: Work Orders > Settings > Alert Settings showing the Quote submitted/NTE increase request alert
Figure 16: Detail of User > Manager Users > [Name] > User Details showing Alert subscriptions.
Corrigo Incorporated
Page 17
Figure 17: User > Role List > [Role] > Role Name edit page
USE SCENARIO
The very simple usage scenario is as follows: 1. 2. 3. 4. 5. 6. 7. A service request is created, assigned to provide A quote is requested and the WO is sent to a provider Provider fill out the quote and submits it User receives an email alert Quote of NTE increase request on WO#... as shown in Figure 18 User replies to the email with the word approve or reject (Figure 19) System receives the reply and processes it as an approved Quote (Figure 20) User will receive an email confirmation (Figure 21)
If there is a problem processing the approval/rejection, an email will be provided informing the user, the different scenario s that may occur are described following the screen captures below.
Corrigo Incorporated
Page 18
Corrigo Incorporated
Page 19
POSSIBLE SCENARIOS
When a user replies to quote approval request, the following scenarios are possible: Success - replying user had sufficient authority found and the Approved or Rejected action was successfully executed In sufficient authority email reply was successfully processed but the user had insufficient authority Action Error - an error occurred when taking the approve / reject action User not valid reply email was successfully processed, but the sending email address could not be associated with a valid user (this will also occur if there are 2 users in the system with the same email address) Already performed when the approve/reject had already been taken
Figure 22: When Use Specialty Group setting is enabled, filter appears as seen above. Clicking on it opens the dialog seen in Figure 23
Corrigo Incorporated
Page 20
NOTE: SPECIALTY GROUPS ARE NOT INTENDED TO CONTROL DATA, THEIR OBJECTIVE IS TO HELP THE USER HIDE USELESS INFORMATION, NOT RESTRICT ACCESS TO A SUB SET OF WORK ORDERS. This enhancement creates the ability to create groups of specialties and provides a short-cut for users to filter out work that is not within their domain. For a client who has a large number of specialties, users will much more easily be able to filter the dispatch board by deselecting all other specialty groups and choosing a single group when compared to the current model where they have to deselect all specialties and select the 40 specialties that they care about. When enabled, the specialty group filter allows users to select from the list of specialty groups as opposed to the individual specialties.
CONFIGURATION
Specialty groups are configured as part of the knowledgebase (Figure 24) N specialty groups can be defined for any set of specialties in the system Unknown Specialty is treated as its own specialty and may be included or excluded from any group Access to Specialty group page is controlled by the existing privilege: Company KnowledgeBase A Dispatch Board setting: Use Specialty Groups must be enabled (Figure 26)
Corrigo Incorporated
Page 21
Corrigo Incorporated
Page 22
Figure 26: Setting to use specialty groups: Work Orders > Settings > Dispatch Board: Use Specialty Groups
These options appear in report parameter time frame as shown in the example below.
Figure 27: Detail from report view page showing a couple of the new time frame options.
These are intended to help clients provide more appropriate reports, especially with subscriptions.
Corrigo Incorporated
Page 23
This allows legacy behavior of the system which was relaxed in 7.5 in order to support Vendor pre-bills. The relaxation of the constraint became problematic for some upgrading clients who require work orders to be completed before the invoice may be authorized (or set to another appropriate Read-Only status) ON upgrade, default the setting to Yes.
2.
Corrigo Incorporated
Page 24
The default setting shall be Assigned to User, which is the way the system functioned previously. When the setting is set to logged in user, a user (on the Corp UI ONLY) will see in stock (and out of stock) locations within their own scope, not the assigned to user.
2.
Corrigo Incorporated
Page 25
Clicking here opens a new window with the customer portal, shown below.
Figure 30: Detail of Contact Details page showing Portal log in button
Figure 31: Customer Portal home page Corrigo Incorporated Proprietary & Confidential Page 26
TABLET EXTENSIONS
The tablet interface received several important enhancements that round out its capabilities for field mangers. These enhancements are listed below. Each of them, like the tablet UI itself, are straight-forward and easy to use.
Corrigo Incorporated
Page 27
NOTE: THERE IS NOT A SINGLE ASSIGN AND SEND OPTION AVAILABLE SO THE USER MUST ASSIGN AND THEN USE THE SEND COMMAND TO SEND THE WORK. Clicking on send (Figure 32) brings up an editable send note dialog (Figure 34) which also allows a request quote option. Pressing Send sends the work order to the vendor.
DISPLAY FLAGS
There is a Home navigation button that provides a quick way for users to see all flagged work orders as shown below.
Work Order flags are visible in the list of work orders, along with the reasons (Figure 36), allowing users to quickly see the work orders that may need attention.
Corrigo Incorporated
Page 28
Figure 36: Flagged Work Order(s) - In this example, Quote submitted from provider
QUOTE APPROVAL
A quote submitted by a vendor will be visible due to the flag as seen in the example image above. Clicking on the Vendor Quote button brings up details of the quote (Figure 37) and the action button allows the user to approve or reject the quote.
CONFIGURATION NOTE: THE VENDOR QUOTE NAVIGATION BUTTON MUST BE ENABLED. FOR AN ADMIN USER WITH APPROPRIATE PRIVILEGE, THIS IS AVAILABLE ON THE CORP UI AT: OUR COMPANY > MOBILE CLIENTS > DISPLAY CONFIG > CONFIGURATION OF NAVIGATION BUTTONS FOR MOBILE TABLETS.
Corrigo Incorporated
Page 29
users may now email work orders directly from the tablet. After pressing the icon, a dialog like the one shown below will appear. The work order will be sent as a cover email with a .htm attachment.
Note: There is a new setting that defines the print template attached to emailed work orders from the tablet. It can be found at the bottom of: Work Orders > Settings > Details
Figure 38: Detail of Work Orders > Settings > Details page
Corrigo Incorporated
Page 30
Corrigo Incorporated
Page 31
Figure 40: Child Work Order showing Create Work Order options
In the example above, WO#TL0020.01 is already a child. Creating a child from parent will create the next serialized child WO. In this case, TL0020.02, as shown below.
Corrigo Incorporated
Page 32
Figure 41: Child Work Order created from context of another child
Corrigo Incorporated
Page 33
SELECT LIST OF OTHER ENHANCEMENTS/DEFECT FIXES JIRA Issue# Issue Type Change Request Summary Prior to 7.6a we only supported custom permissions for report folders. Now, custom permission are available on Reports reports as well. To better support subscription reports for large customers, Customer Group has been added as an initial scope selection parameter to work order and financial report templates. Allows creation of reports for specific customers Subscription corresponding to a customer group. Very useful for Reports Facility Service Provider clients. Minor Corp Theme/Color Issues: 1. Separate color controls for: a. Table Header Background, and b. Alt Text/Control Box (see attached) Administration 2. Allow .png files to be used as logos Changes made to customer portal logo configuration pages. Simplifies the page and contains upload to an Administration image size that will fit. Modify WON translation so that the Work Done Description in WorkTrack is copied to both the Work Completion comments AND the Invoice Comments in WON CorrigoNet Corporate Web Corporate Web Corporate Web Corporate Web Corporate Web Corporate Web Visits, Notifications Corporate Web Corporate Web Extend Customer Group import/export to include: Portal Theme setting Remove WYSIWYG HTML editor option from Customer Portal Label Updates as the new portal will not support more complex custom layout changes. On Customer Group Search Page, default selector to "Group Name" starts with as there is no other option, there is no reason to have to select it every time. Increase the length of customer special instructions to 1024 Remove the customer portal setting "Backup Phone" Replace the organization dropdown on the Provider details page with a type ahead dropdown, this better supports clients with thousands of organizations. Verification notifications shall not apply to visit work orders Expose Vendor Price List Import/Export in WON mode (previously it was dependent on pre-WON module) Apply auto-routing routine when WO is assigned On Hold status upon creation
Proprietary & Confidential Page 34
Component/s
CN-2137
Change Request
CN-2247
CN-2254
CN-2283 CN-2397
Change Request Change Request Change Request Change Request Change Request Change Request Change Request Change Request Change Request Change Request
CN-2407
Corrigo Incorporated
CN-2424 CN-2434 CN-2470 CN-2475 CN-2476 CN-2482 CN-2307 CN-2361 CN-2318 CN-2410 CN-2412
Change Request Change Request Change Request Change Request Change Request Change Request Change Request Change Request Defect Defect Defect
Customer Portal Customer Portal Customer Portal Auto-login Customer Portal Customer Portal Reports Reports Corporate Web Corporate Web Corporate Web
On the Service Request Wizard Last Step, if the request is an emergency, disable all radio selection except I just want the work done and present an explanation. A new customer portal theme setting show/hides the "contact us' link on the home page. "Customer" and "Customer Group" grouping labels in the CP scope selector have been added as theme labels Support for passing login credentials as part of form + POST request as opposed to only via URL parameters Display OnHold/Needs Attention reasons on the customer portal work order details page Hide Passwords on the customer portal preferences page when they are read-only When computing total width of tabular report, include grouping columns Add "Issue to" to the Parts and Materials Inventory > Transactions report wizard Fixed: PM generated work orders don't include Description text in "Work Description" Fixed: When a user is assigned to several teams, a wrong team is used during auto-assignment Fixed: Work Order Import with FireAlert field set to No still sends out alerts to assigned users Fixed: When a user changes Weekly PMRM schedule occurrence to Monthly via excel import, the system should automatically change RecurranceFrequency field value to "1" Fixed: Problem with uploading Customer Portal Logos of TIF format Fixed: "You cannot APPROVE .... " message is shown if user without sufficient permissions tries to REJECT quote. Fixed: A print out is not attached as a separate file in emails sent from Tablet
CN-2430 CN-2437
Defect Defect
CN-2440 CN-2527
Defect Defect
WSDK CHANGES
Corrigo Incorporated
Page 35
CN-2472 Add EstimatedCost, EstimateDetails to CustomerInvoice Object (read-only) CN-2489 For Provider Imports, when Action="delete", suspend the Provider CN-2567 Add IsRelatedTo field to Specialty imports (both Excel and WSDK)
CN-2362 CN-2531
Fixed: WorkZone import containing xml name space does not associate portfolios to the imported workzone Support for 4-digit rates submitted from WorkTrack as part of provider Invoice
IMPORT/EXPORT CHANGES/ENHANCEMENTS
Customer Notes - import/export for customer notes: There is one row per note. It has the following columns: ID, CustomerNumber, DateTime, Note, ByUserID, NoteType Announcements Import/Export - import/export for announcements. On export, export ALL Announcements.
Corrigo Incorporated
Page 36
Term
Company Contact
Equivalents
Requestor, Client, Corporate User, Back Office User User, Internal Customer Contact, Tenant Contact, Service Requestor, Customer Contact WON, Work Track Facility Management, FM Tenant, Store, Location, Restaurant, Building Customer, Tenant Group, Lease Group Portal, Tenant Portal, Store Portal Site, Space, Unit, Lease, Store
Meaning
Corrigos customer using CorrigoNet, who is usually a Service Requestor on the WON. A Customer end user who may request service. (often by logging in to the Customer Portal) The application used by Service Requestors to access the Won and manage their facilities. A flexible organization object that typically refers to the entity for whom work is being done. A Customer only exists within a single work zone. A collection of Customers. Interface that Customer Contacts log in to to request and view work. A conceptual object that can be thought of as a contract that links Customers to the buildings, assets, equipment or services that they use and may request service on. A collection of Work Zones- used a means to rollup/view data across multiple workzones A specific type of Work Order initiated by a customer contact, typically generated via the customer/tenant/store portal Someone with login credentials to the system. (not the Portal) An outside resource who is assigned work via the Work Order Network. Vendors can be either connected or non-connected. During the transition to the WON, they were referred to as Service Providers. The system that connects Service Requestors (entities with a need to get work done) and service providers (entities that perform work.) A description of work at a specific location that is assigned to a resource. A core organizational object in the system that typically refers to a specific address, logical grouping of customers/locations, or a general geographic area.
Region, Division, All, Management Area, Management Team, Group Work Order, Request, Service Order, Ticket Employee User, Tech, Dispatcher, Admin, Manager Provider, Service Provider, Subcontractor
Work Order Network Work Ticket, Service Request, WO Property, Project, Store, Region/State, Dispatching office, SubDivision
Corrigo Incorporated
Page 37