Skip to content

Commit 22610c3

Browse files
Added groups section
1 parent 5cf83c6 commit 22610c3

1 file changed

Lines changed: 84 additions & 43 deletions

File tree

  • content/en/docs/developerportal/app-insights

content/en/docs/developerportal/app-insights/feedback.md

Lines changed: 84 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ After a user reports feedback in the app using the feedback widget, they get an
4343
* Summary of the feedback that your team wrote
4444
* To which team member the feedback is assigned
4545
* Tags that are assigned to the feedback
46-
* Other feedback items that are associated with this feedback
46+
* Other feedback that are associated with this feedback
4747
* Attachments that you team uploaded for this feedback
4848
* Team comments on this feedback
4949

@@ -61,14 +61,15 @@ On the **Inbox** tab, everyone from your team can view all the unarchived feedba
6161

6262
{{< figure src="/attachments/developerportal/app-insights/feedback/feedback-items.png" alt="inbox tab" >}}
6363

64-
In the list on the **Inbox** tab, you can find the following information for each feedback item:
64+
In the list on the **Inbox** tab, you can find the following information for each feedback:
6565

6666
* **ID** – the unique number that is assigned to the feedback
6767
* **Subject** – the title of the feedback given by the reporter
6868
* **Submitter** – the email address of the reporter
6969
* **Tags** – tags that your team has assigned to the feedback
7070
* **Status** – the status that your team has set to the feedback
71-
* **Linked** – the number of the feedback items that are linked to this feedback
71+
* **Group** – the group that the feedback belongs to
72+
* **Stories** – the story that the feedback is linked to
7273
* **Priority** – the priority that the feedback has
7374
* **Date** – the date when the feedback was submitted
7475

@@ -82,7 +83,7 @@ Clicking the filter bar opens the **Filter by** side panel. In this side panel,
8283

8384
### Organizing Feedback in Inbox
8485

85-
If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can also organize feedback items.
86+
If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can also organize feedback.
8687

8788
You can add new feedback manually yourself.
8889

@@ -97,27 +98,41 @@ If you select feedback, you can see the following items:
9798

9899
{{< figure src="/attachments/developerportal/app-insights/feedback/bulk-actions-bar.png" alt="bulk-actions-bar" >}}
99100

100-
* **Link** – Clicking this links the feedback together into one feedback group.
101+
* **Group Items** – Clicking this button will show you two options:
102+
* **Create New Group** – You can create a new group for the selected feedback.
103+
* **Add to Group** – You can add the selected feedback to an existing group.
101104

102-
You need to choose which item is the primary item of the group. After the feedback items are linked, only the primary feedback item appears in the list. The feedback items that are linked to the primary item disappear from the list. You can only access these linked feedback items from their primary item. If you change the status of the primary feedback item, all the linked items get the same status automatically.
105+
* **Move** – Clicking this moves the selected feedback to any other app of which you are a member. This action will remove the link to the group if the feedback is part of a feedback group.
103106

104-
{{% alert color="info" %}}When you open a linked feedback, you can click **Make [the linked feedback] the Primary feedback** to make this feedback the primary feedback of the feedback group instead.{{% /alert %}}
107+
* **Create Stories** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the selected feedback to stories on the designated board in Epics or Jira.
105108

106-
* **Move** – Clicking this moves the selected feedback item to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
109+
* Status drop-down list – You can select a status from the drop-down list and then click **Apply** to change the status of the selected feedback.
107110

108-
* **Create Stories**If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the selected feedback item to stories on the designated board in Epics or Jira.
111+
* **Archive**Clicking this sets the selected feedback as archived.
109112

110-
* Status drop-down list – You can select a status from the drop-down list and then click **Apply** to change the status of the selected feedback item.
113+
* **Delete** – Clicking this deletes the selected feedback permanently. The result is irreversible.
111114

112-
* **Archive** – Clicking this sets the selected feedback item as archived.
115+
## Groups {#groups}
113116

114-
* **Delete** – Clicking this deletes the selected feedback item permanently. The result is irreversible.
117+
On the **Groups** tab, everyone in your team can view all the feedback groups in your app.
118+
119+
In the list on the **Groups** tab, you can find the following information for each group:
120+
121+
* **Group Name** – the name of the group
122+
* **Status** – the status of the group
123+
* **Priority** – the priority of the group
124+
* **Assignee** – the assignee of the group
125+
* **Number of Items** – the number of feedback that the group has
126+
127+
You can use the search bar in the list. You can search by group name, assignee, status and priority.
128+
129+
You can add a new group from this page by clicking **Add Group** button below the list
115130

116131
## Archive {#archive}
117132

118133
On the **Archive** tab, everyone in your team can view all the archived feedback.
119134

120-
In the list on the **Archive** tab, you can find the following information for each feedback item:
135+
In the list on the **Archive** tab, you can find the following information for each feedback:
121136

122137
* **ID** – the unique number that is assigned to the feedback
123138
* **Subject** – the title of the feedback given by the reporter
@@ -135,12 +150,10 @@ Clicking the filter bar opens the **Filter by** side panel. In this side panel,
135150

136151
## Feedback Details {#feedback-details}
137152

138-
On the [Inbox](#inbox) and the [Archive](#archive) tabs, you can open feedback details by clicking the feedback item in the list:
153+
On the [Inbox](#inbox) and the [Archive](#archive) tabs, you can open feedback details by clicking the feedback in the list:
139154

140-
* If you click the **ID** of the feedback item, the feedback details open in a new page.
141-
* If you click a place other than the **ID** of the feedback item, the feedback details open as a side panel.
142-
143-
{{% alert color="info" %}}If your [role](/developerportal/general/app-roles/) has the **Can edit ‘Stories, Documents and Feedback'** permission, you can edit the feedback details on the **Feedback** tab.{{% /alert %}}
155+
* If you click the **ID** of the feedback, the feedback details open in a new page.
156+
* If you click a place other than the **ID** of the feedback, the feedback details open as a side panel.
144157

145158
The following items are available:
146159

@@ -149,7 +162,7 @@ The following items are available:
149162
* {{% icon name="view" %}} – Click this button to stop receiving notifications for this feedback.
150163
* **Copy Link** ({{% icon name="hyperlink" %}}) – Click this button to copy the URL to the feedback. You can send the URL to other people.
151164
* **More Options** ({{% icon name="three-dots-menu-horizontal" %}}) – Click this button to open a menu with the following items:
152-
* **Move** – Click this button to move the feedback to any other app of which you are a member. Whenever you move feedback, you also move all linked feedback. If you only want to move one feedback item, you need to unlink the feedback from the group first.
165+
* **Move** – Click this button to move the feedback to any other app of which you are a member. This action will remove the link to the group if the feedback is part of a feedback group.
153166
* **Create Story** – If your app is connected to [Epics](/developerportal/project-management/epics/) or [Jira](/developerportal/project-management/jira-connector/), clicking this button converts the feedback to a story on the designated board in Epics or Jira. Once the story is created, clicking this button brings you to the story on the board right away.
154167
You can also create feedback-based stories using Maia. For details, refer to the [Creating Stories with Maia](#create-with-maia) section.
155168
* **Delete** – Click this button to remove the feedback permanently from **Feedback**. The result is irreversible.
@@ -159,7 +172,7 @@ The following items are available:
159172
* **Priority** – This shows the priority that the feedback has.
160173

161174
* **Status** – This is the status of the feedback. There are two default statuses: **New** and **Closed**. Whenever feedback arrives in the app, it is set to **New**. When you close feedback, it is set to **Closed** and moved to the **Archived** page.
162-
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}) and adding the new statuses in the dialog box. Custom statuses can only be used for feedback items that are not archived. You can filter your feedback based on the status.
175+
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}) and adding the new statuses in the dialog box. Custom statuses can only be used for feedback that are not archived. You can filter your feedback based on the status.
163176
You can edit the default status name by clicking **Manage Statuses** ({{% icon name="cog" %}}), then clicking the status name.
164177

165178
* **Tags** – These are the tags assigned to the feedback. You can select a tag from the drop-down list or create new tags by typing the tag name inside the text box and then clicking **create [the tag name]**. A tag should contain maximum 50 characters. You can assign multiple tags.
@@ -183,40 +196,28 @@ The following items are available:
183196
* **Submitter email** – This shows the email of the reporter
184197
* **Submission date** – This shows the date when the feedback was submitted
185198

186-
* **Linked Feedback** – This shows which feedback items are linked to this feedback.
187-
188-
You can link a feedback item by selecting it from the drop-down list.
189-
190-
{{< figure src="/attachments/developerportal/app-insights/feedback/linked-feedback.png" class="no-border" >}}
191-
192-
Once the feedback is linked, it disappears from the list on the **Inbox** or **Archive** tab. You can only access the linked feedback from its primary feedback to which it is linked. If you change the status of the primary feedback, all the linked feedback gets the same status automatically.
193-
194-
{{% alert color="info" %}}When you open a linked feedback item, you can click **Make [the linked feedback item] the Primary feedback** to make this feedback the primary feedback of the feedback group instead.{{% /alert %}}
195-
196-
You can unlink a feedback item by hovering over the feedback and clicking the **Remove** ({{% icon name="remove" %}}) button. Once the feedback is not linked anymore, it appears again in the list on the **Inbox** or **Archive** tab.
197-
198-
* **Story** – This displays any stories that are linked to that feedback item.
199-
To unlink a story from a feedback item, click its corresponding {{% icon name="unlink" %}} **unlink** button.
199+
* **Story** – This displays any stories that are linked to that feedback.
200+
To unlink a story from a feedback, click its corresponding {{% icon name="unlink" %}} **unlink** button.
200201
If there are no linked stories, you have the following options:
201202

202-
* **Add to Story** – Add the feedback item to an existing story.
203-
* **Create Story** – Create a new story based on the feedback item.
203+
* **Add to Story** – Add the feedback to an existing story.
204+
* **Create Story** – Create a new story based on the feedback.
204205

205206
* **Attachments** – This contains attachments to this feedback. To upload an attachment, click **Add** ({{% icon name="add" %}}) and select the file. The following formats are supported: .*peg*, *.png*, and *.gif*. Each attachment can be a maximum of 5 MB in size. Once an attachment is uploaded, only your team members can view, download, and delete the attachment.
206207

207208
* **Communication** – This section is made up of the following tabs:
208209

209210
* **Team Comments** — Displays all the comments left by your team for this feedback. You can leave comments here and add attachments to each comment.
210211
Comments submitted to this tab are only visible to your team members.
211-
* **Contact Submitter** — Allows you to read messages from the reporter and reply to them. Whenever the reporter sends a message, it is shown in this section. Once you reply to a message from the reporter, they receive an email. When multiple feedback items are linked, the system only sends an email to the reporter of this specific feedback item, not other associated feedback items in the same group.
212+
* **Contact Submitter** — Allows you to read messages from the reporter and reply to them. Whenever the reporter sends a message, it is shown in this section. Once you reply to a message from the reporter, they receive an email.
212213
For more information, see the [What Happens to a User After They Submit Feedback](#what-happens-to-user) section.
213214

214215
### Creating Stories with Maia {#create-with-maia}
215216

216-
You can use Maia to create a story based on one or more feedback items. To do that, follow these steps:
217+
You can use Maia to create a story based on one or more feedback. To do that, follow these steps:
217218

218219
1. Enable Maia in the app [Settings](/developerportal/general-settings/#maia-settings) page.
219-
2. Select a feedback item from the list.
220+
2. Select a feedback from the list.
220221
3. Click **Create Story**. The **Create Story** window is displayed.
221222
4. Click {{% icon name="sparkles" %}}**Create with Maia**.
222223
If Maia is enabled, the **Create Story with Maia** window is displayed.
@@ -229,7 +230,7 @@ You can use Maia to create a story based on one or more feedback items. To do th
229230

230231
A banner at the bottom of the window shows you that the story has been created. You can click **Open** to access the story on the **Planning** page.
231232

232-
You can select several feedback items to create a story based on all of them.
233+
You can select several feedback to create a story based on all of them.
233234

234235
### Managing Tags {#manage-tags}
235236

@@ -255,6 +256,46 @@ From the [feedback details](#feedback-details) page, you can manage tags by clic
255256
2. Click **Delete**. The **Confirmation** dialog box opens.
256257
3. Click **Delete Tag**.
257258

259+
## Group Details {#group-details}
260+
261+
On the [Groups](#groups) tab, you can open group details by clicking the group in the list:
262+
263+
The following items are available:
264+
265+
* Buttons
266+
* **Ungroup** Click this button to ungroup all feedback in the group. This action doesn't delete the group .
267+
* **Delete Group** Click this button to delete the group and all feedback in this group. This action is destructive and once you delete a group with feedback, you delete both of them.
268+
269+
* **Group Name** – This is the name of the group. You can edit the name by click on the name. It will show a input panel where you can edit the name
270+
271+
* **Description** – This is the description of the group.
272+
273+
* **Tags** – These are the tags assigned to the group. You can select a tag from the drop-down list or create new tags by typing the tag name inside the text box and then clicking **create [the tag name]**. A tag should contain maximum 50 characters. You can assign multiple tags.
274+
275+
{{< figure src="/attachments/developerportal/app-insights/feedback/tags.png" class="no-border" >}}
276+
277+
{{% alert color="info" %}}For more information about how to manage tags, refer to the [Managing Tags](#manage-tags) section.{{% /alert %}}
278+
279+
* **Status** – This is the status of the group. There are two default statuses: **New** and **Closed**. Whenever you create a new group in the app, it is set to **New**.
280+
You can add custom statuses by clicking **Manage Statuses** ({{% icon name="cog" %}}) and adding the new statuses in the dialog box. Custom statuses can only be used for feedback that are not archived or for groups. You can filter your feedback based on the status.
281+
You can edit the default status name by clicking **Manage Statuses** ({{% icon name="cog" %}}), then clicking the status name.
282+
283+
* **Assigned To** – This shows to whom the group is assigned. When you assign a group to someone, they get an email notification.
284+
285+
* **Priority** – This shows the priority that the group has.
286+
287+
* **Reply To All** – You can reply to the submitters of all the feedback in the group. The same message will be sent to all of the feedback.
288+
289+
* **Grouped Feedback** – This shows a list of the feedback that are linked to the group. If you click on an item in the list it will show you the feedback details in side panel.
290+
291+
* **ID** – the unique number that is assigned to the feedback. Clicking the ID will open another page with the feedback details
292+
* **Subject** – the title of the feedback given by the reporter
293+
* **Action** – This column contains actions just for the feedback in the row.
294+
* **Reply to Submitter** - You can reply to the submitter of the feedback.
295+
* **Ungroup feedback** - You can ungroup the feedback from the group
296+
* **Group Team Comments** — Displays all the comments left by your team for this group. You can leave comments here and add attachments to each comment.
297+
Comments submitted here are only visible to your team members.
298+
258299
## Receiving Notifications {#notifications}
259300

260301
You can receive a notification when new feedback lands in **Inbox** or when a reporter replies to their feedback. To receive notifications, follow these steps:
@@ -269,7 +310,7 @@ You can receive a notification when new feedback lands in **Inbox** or when a re
269310
* **Daily email update**
270311
* **Weekly email update**
271312

272-
### Receiving Notifications for an Individual Feedback Item {#notifications-individual-feedback}
313+
### Receiving Notifications for an Individual Feedback {#notifications-individual-feedback}
273314

274-
You can receive notifications for an individual feedback item. To set this up, click the {{% icon name="view-off" %}} icon in the upper-right corner of the **Feedback** tab after you open the feedback item.
275-
You also automatically start receiving notifications for an individual feedback item once you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section of the feedback details window.
315+
You can receive notifications for an individual feedback. To set this up, click the {{% icon name="view-off" %}} icon in the upper-right corner of the **Feedback** tab after you open the feedback.
316+
You also automatically start receiving notifications for an individual feedback once you respond to the reporter of the feedback or leave a comment for your team in the **Communications** section of the feedback details window.

0 commit comments

Comments
 (0)