Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The ability to share the issue resolution status, progress updates, troubleshooting notes, and discovered problems and deficiencies are essential to effective collaboration among the project team members and to discovering and addressing systemic problems. IMMS InfraLink provides a universal way of capturing issue progress updates any time meaningful and applicable information is gathered or the issue resolution status changes. 

The purpose of this document is to This article discusses the following topics, which will help you become familiar with the kinds of issue updates supported by IMMS InfraLink and the information that may or has to be included when performing them.

...

Issue resolution follows a defined process, which goes through a sequence of milestones referred to as statuses. This sequence is reflected in the workflow configured for the contract by the IMMS InfraLink administrator.  IMMS InfraLink allows the project team to keep a complete and accurate history of the steps taken to resolve the issue by entering issue updates.

Since some of the project team actions may change the status of the issue in accordance with the configured workflow, while other activities do not result in the immediate status change, IMMS InfraLink supports two kinds of updates:

  • Basic Updates, i.e. the updates that do not change the resolution status of the issue, are initiated using the aptly named "Update" button placed on the right hand side of the issue details panel;
  • Status Changes, or the workflow actions, are initiated using the available workflow buttons named after corresponding workflow activities (e.g. "Acknowledge", "Suspend", "Complete", etc) placed on the left hand side of the issue details panel.

Entering an Update

IMMS InfraLink provides a universal, consolidated interface to enter issue updates, and you can enter or modify a variety of issue attributes using the update form, as shown below:


Image RemovedImage Added


A general rule of thumb is to enter updates as the issue resolution progresses and to keep the related updates together. For example, if you performed a particular action and determined the cause of the issue, enter the description of the action and update the cause on the same update. Likewise, if you performed two different actions at different times, even if they were performed in sequence, enter them as separate updates. Keeping the information organized will help you and the rest of the team if you have to review the issue history.

...

In some cases it may be necessary to back-date the issue being entered. If you have sufficient privileges, IMMS InfraLink will allow you to back-date the issue by editing the Time Reported field, which is set to the current date/time by default. The reported time will be used as the creation date for this case when calculating handling metrics.

For example, if you were in the field where you cannot access IMMSInfraLink, and you started addressing the issue before you had a chance to get online. Note the time the issue occurred. When you get a chance to enter the issue in IMMSInfraLink, you would need to indicate the date/time when the issue was actually reported to you (and to also back-date the updates).

Note:  in order to protect integrity of the data and ensure accurate reporting, the IMMS InfraLink instance administrator may restrict who is allowed to back-date issues. If you are not granted the corresponding permissions, you will see the Time Reported field on the New Case form as read-only. If you need to back-date the issue, you will need to contact your project leader, so they can edit the case and modify the reporting date/time.

...

In case your account has the privileges to assign work, IMMS InfraLink will allow you to save time by assigning the issue you're creating directly from the New Case form using the Assigned To control. The control is self-explanatory and will allow you to select one or multiple users to assign the issue to. Note that the user selection will be constrained to only those users who have the necessary role(s) to be responsible for work under the contract you selected on the New Case form. In other words, IMMS InfraLink will not allow you to select a user who cannot access or work on the issue.

Sometimes an account will be assigned an issue, however this may need to be changed. To remove or add an assignment to someone, you have to update an assignment. Use the update window and select on a particular user as seen below.

Image RemovedImage Added

Updating the System Element Information and Diagnostic Details

You may need to add or remove system element from a particular issue, so you do this through the update window as well.

Image RemovedImage Added

Handling Asset Replacement

Sometimes an asset or device may not work. In this case, you must replace it. Sometimes you need to install another asset. To do any of these tasks, you must use the Update Window. From the Update window, go to the "Update System Elements and Diagnostics" section and to the right should be the "Replace" button. Select it and fill out the Replacement Information as seen below. Usually, Uninstallation Information will come before Installation Information since you must uninstall something before installing its replacement. See the example below:

Image RemovedImage Added

The nomenclature for the transition can be configured differently depending on the admin. “Replace,” “Uninstall” and “Abandon” could be totally different words such as, "Decommission" or "Deploy", but have the same meaning of "Install".

...

On the Issue Monitor page, double click on the issue you want to add a comment for. A right side-bar should pop up, where at the top is an Image RemovedImage Addedbutton. Select it and fill in the "Comment" section in the Update Window.

Image AddedImage Removed

Providing Additional Information

The IMMS InfraLink instance you're using may be configured to capture additional information for each new issue. The information to be captured is defined by the IMMS InfraLink administrator for each contract and case category (i.e. different categories of cases may require different fields to be populated). Some of the additional data elements may be defined as required, while the other ones may be defined as optional.

Required fields, if any, are denoted with an asterisk (*).  If configured by the IMMS InfraLink instance administrator, a tool tip will be provided to describe the purpose of each field.

...

Note: These additional information fields have specific behaviors defined by the IMMS InfraLink instance administrator. Based on these defined behaviors, the fields may be required, optional, read-only, or even hidden on the subsequent issue details and update screens.

...

In some cases, you may want other users to receive email notifications pertaining to the resolution progress on the issue you are creating. For example, when entering an issue on behalf of the end-user/customer, you may want the end-user/customer to be notified. Likewise, when dealing with a complex technical issue, you may want to keep the engineering team members informed of the issue and the progress on it.

IMMS InfraLink will allow you to select one or multiple users to be notified of the issue and its updates via the Notify via Email control. The control is self-explanatory and will allow you select one or multiple parties and add them to the notification list. The following restrictions apply:

To prevent disclosure of sensitive information to unauthorized parties, IMMS InfraLink will generate notifications only to users with active IMMS InfraLink accounts. You cannot add external email addresses not associated with an IMMS InfraLink accounts to the notification list.

Furthermore, IMMS InfraLink will send notifications only to those users who have sufficient privileges to see cases under the contract you selected on the New Case form. The list of users presented on the Notify via E-Mail user lookup will be restricted accordingly, and IMMS InfraLink will not allow you to select a user who doesn't have sufficient privileges to see the information.