Difference between revisions of "Update Action Item"

From Hornbill
Jump to navigation Jump to search
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{bluebanner|[[Main Page|Home]] > Service Manager|[[:Category:Service Manager|Index]]}}
+
This document can now be found at its new location in the [https://docs.hornbill.com/servicemanager-user-guide/service-portfolio/requests/update-action/ Hornbill Document Library].
{|style="width: 100%"
+
 
|- valign="top"
+
[[file:hornbill-document-library.png|Update Action|link=https://docs.hornbill.com/servicemanager-user-guide/service-portfolio/requests/update-action/]]
|style="width:73%"|
+
<!--
 +
 
 +
{{Breadcrumb|[[Main Page|Home]] > [[Service Manager]] > Update Action|Service Manager}}
 +
{{Section|
 
==Introduction==
 
==Introduction==
The Update Action within a request enables the manual updating on a  particular request. Updates are recorded in the Timeline of the request, alongside the other update types to provide an audit trail of all actions for each request.  
+
The Update Action item in a request allows a user to submit a post to the timeline of a request (also known as an Activity Stream) to communicate, discuss, or collaborate on the request with colleagues or the customer. As every action item in a request results in a timeline post, the timeline forms an audit trail of all actions performed on a request. You can control who can see each update by selecting the visibility level.|
|style="width:5%"|
+
{{RightBox|Related Articles|
|
 
|style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
 
 
 
== Related Articles ==
 
 
:* [[Collaboration]]
 
:* [[Collaboration]]
 
:* [[Wiki_Markup|Wiki Mark Up]]
 
:* [[Wiki_Markup|Wiki Mark Up]]
Line 15: Line 14:
 
:* [[What_are_mentions%3F|What are Mentions]]
 
:* [[What_are_mentions%3F|What are Mentions]]
 
:* [[Service_Manager_Business_Process_Workflow#Access_Control|Access Control]]
 
:* [[Service_Manager_Business_Process_Workflow#Access_Control|Access Control]]
|}
+
}}
===Update Content===
+
}}
[[File:YouTubeActionUpdate.png|right|300px]]
+
== Supported Content ==
 +
=== Links and Embedded Content ===
 +
[[File:YouTubeActionUpdate.png|right|400px|thumb|link=https://wiki.hornbill.com/images/e/e3/YouTubeActionUpdate.png|<div align="center">'''Media can be embedded in the request timeline'''</div>]]
  
The content of an update can be a combination of text, image and or embedded multimedia / hyperlinks. Examples include:
+
The timeline of a request supports text, image, and embedded multimedia / hyperlinks. Simply cut and paste the content, or link you wish to share in the content box. Examples include:
 
* Sharing a link to a youtube video, which can be viewed in the update from the timeline of the request
 
* Sharing a link to a youtube video, which can be viewed in the update from the timeline of the request
 
* links (URL) to another request, workspace post, or document in Hornbill).
 
* links (URL) to another request, workspace post, or document in Hornbill).
  
Simply cut and paste the content, or link you wish to share in the content box, view the related article on embedding rich media for more information.
+
Click here for more information on [https://wiki.hornbill.com/index.php?title=Activity_Stream_Integrations '''Hornbill Activity Streams'''].
  
 
===Wiki Mark-Up===
 
===Wiki Mark-Up===
  
For easy formatting of update content, a sub-set of wiki markup can be used for decorating text, with italics and bold,  creating bulleted or numbered lists etc.
+
For easy formatting of update content, a sub-set of [https://wiki.hornbill.com/index.php?title=Wiki_Markup '''Wiki Markup'''] can be used for decorating text, with italics and bold,  creating bulleted or numbered lists etc. Use Ctrl+I or Ctrl+B keyboard short cuts to enable/disable italic and bold text as you type.
  
 
===Mentions===
 
===Mentions===
Line 34: Line 35:
 
* Simply type @ followed by the co-workers name to mention them in the update content box
 
* Simply type @ followed by the co-workers name to mention them in the update content box
 
* Co-workers will only be able to follow the link in a notification and view the request they are mentioned in, if they are part of a team which supports the service against which the request has been raised, and if they have the rights to view the particular request type.  In addition if they have had their rights elevated by being added as a member to the request, they will also be able to view the individual request they have been mentioned in.
 
* Co-workers will only be able to follow the link in a notification and view the request they are mentioned in, if they are part of a team which supports the service against which the request has been raised, and if they have the rights to view the particular request type.  In addition if they have had their rights elevated by being added as a member to the request, they will also be able to view the individual request they have been mentioned in.
 +
 +
Click for more on [https://wiki.hornbill.com/index.php?title=What_are_mentions%3F '''mentions'''].
  
 
== Visibility ==
 
== Visibility ==
Line 40: Line 43:
 
<br>
 
<br>
 
<br>
 
<br>
===Customer Update Notification===
+
===Customer Email Notifications===
Decide if the customer of the request should receive an email notification that an update has been added to their request.  This can be configured per Service and Request Type under the '''Config''' and Action Items view on each Service.
+
Email notifications can be sent to the customer of the request each time an Update is added with the visibility level of ''Customer''.  These emails can contain links back to originating request to allow the customer to read and respond to the updates. Subsequent comments that are made below a customer visible update will also provide an email notification to the customer  This is a great way to keep the customer up to date.
 +
{{Infobox|'''Setup''' <br>It is important that the following has been set up in order for the customer to receive the updates by email.
 +
 
 +
::* '''Service Mailbox'''
 +
::: Set [[Service Details#Default Mailbox|a default mailbox on the service]] and/or on the Request Types for the service
 +
::* '''Shared Mailbox Access'''
 +
::: Make sure that all the analysts that will be updating the request have access to the [[Shared Mailboxes|mailbox]] set on the service.
 +
::* '''Default Email Template'''
 +
::: A default Email Template called '''CustomerTimelineUpdateNotification''' has been provide for you.  Emails sent to customers will be based on this template. You can modify this [[Email Templates|email template]] to suite your needs.
 +
::* '''Email Template Setting'''
 +
::: If you want to create a new email template for this purpose, update the [[System Settings|system setting]] '''guest.app.requests.notification.emailTemplate.customerTimelineUpdate''' with the name of the new email template.
 +
::* '''Email Notification Setting'''.
 +
::: This setting '''guest.app.requests.notification.emailMailbox''' defaults to ''helpdesk'' on installation.  This needs to be changed to the name of the mailbox that you wish to use for notifications from Service Manager.
 +
::* '''Notify Customer'''
 +
::: Enable the '''''Notify Customer''''' option on the [[Services_Request_Configuration#Incident_Configuration|Request Action configuration]]
 +
}}
  
If enabled, the customer of the request will receive an email notification when an update is posted to the timeline with the "customer" visibility. The email content can be configured in the default email template called '''CustomerTimelineUpdateNotification''', this includes a link back to the employee portal or customer portal, depending on the type of customer of the request. The template can be edited as needed from ''Hornbill Administration > System > Email > Email Templates'' or a new email template can be created. If creating a new template, the system setting "'''guest.app.requests.notification.emailTemplate.customerTimelineUpdate'''" must be updated with your chosen template. The setting is found in ''Hornbill Administration > Applications > Service Manager > Application Settings''.
 
<br>
 
<br>
 
 
== Update Linked Requests ==
 
== Update Linked Requests ==
 
If there are linked requests associated to the request that you are working on, you are able to send an update to the Timeline of these linked requests
 
If there are linked requests associated to the request that you are working on, you are able to send an update to the Timeline of these linked requests
  
 
=== Setting ===
 
=== Setting ===
 +
[[File:SmUpdateLinkedRequests.png|right|400px|link=https://wiki.hornbill.com/images/9/9f/SmUpdateLinkedRequests.png|thumb|<div align="center">'''An Update can be applied to selected linked requests at the time of posting'''</div>]]
 
This feature is turned off by default and can be enabled in ''Hornbill Administration > Applications > Hornbill Service Manager > Application Settings''.
 
This feature is turned off by default and can be enabled in ''Hornbill Administration > Applications > Hornbill Service Manager > Application Settings''.
 
{{bullet1|app.request.update.enableLinkedRequestAction|Enable the option to update linked requests against a request through the Update tab}}
 
{{bullet1|app.request.update.enableLinkedRequestAction|Enable the option to update linked requests against a request through the Update tab}}
  
 
=== Using ===
 
=== Using ===
[[File:SmUpdateLinkedRequests.png|right|350px|link=https://wiki.hornbill.com/images/9/9f/SmUpdateLinkedRequests.png]]
 
 
If there are requests linked to the request you are working on, the Update button within the Update Action will include an arrow that exposes the option to update the linked requests.  Selecting the option to ''Update this and linked requests...'' will display a dialog box that lists the linked requests.  
 
If there are requests linked to the request you are working on, the Update button within the Update Action will include an arrow that exposes the option to update the linked requests.  Selecting the option to ''Update this and linked requests...'' will display a dialog box that lists the linked requests.  
  
Line 63: Line 78:
  
 
{{infobox|Updating linked requests is a one way update. If updates are made on the updates in the linked requests, the originating request will not have visibility of these comments.}}
 
{{infobox|Updating linked requests is a one way update. If updates are made on the updates in the linked requests, the originating request will not have visibility of these comments.}}
 +
-->
  
 
+
[[Category:HDOC]]
[[Category:Service Manager]]
 

Latest revision as of 22:41, 1 February 2024

This document can now be found at its new location in the Hornbill Document Library.

Update Action