Skip to content
TeamSync

Working with Issues in the pane

Find, read, discuss and change Issues without leaving the model: the list, the Issue page, comments, files, activity, changing several Issues at once, and notifications.

#The Issue list

The pane lists the Issues of the Project and Zone you chose in the header. Each card shows the Issue’s number, title, Zone, status, source (Revit or Navisworks), Discipline, labels, due date, number of viewpoints and who it is assigned to, or Unassigned. A footer shows how many are loaded ("Showing X of Y"); choose Load N more to get the rest.

The Issue list: search box, filter, select and sort buttons, then a card for each Issue with status, labels, due date and assignees.
The Issue list.

#Search, filter and sort

  • Press / or click Search issues… to search by words.
  • Choose the filter button to open the Filters sheet. It has Assigned to me, Raised by me, Open only and Overdue, and groups for Status, Priority, Type, Discipline and Label. Choose Show issues to apply, or Clear all to start over. Active filters show as chips above the list.
  • Choose the sort button for Sort by: Newest first, Priority, Due date, Status or Title.
The Filters sheet with switches such as Assigned to me and Open only, and groups for status, priority, type and discipline.
The Filters sheet.

#The Issue page

Choose a card to open the Issue. ← Issues goes back to the list.

An open Issue: its title, status and priority, source and file name, who raised it and who it is assigned to, a following line, the description and the workflow bar.
An Issue open in the pane.
  • The facts: status, priority, type, Discipline and due date, then Source (Revit or Navisworks) and File name of the model it was raised in.
  • Who raised it and when, who it is assigned to, and Also notified for the people kept informed.
  • A line saying why you get updates, for example "You get updates because you raised it". Choose Subscribe if you do not follow it. If you do, Following or Muted opens a menu: Mute - keep the updates, lose the toast and sound, Unmute or Unsubscribe. Mentions and assignments are never muted.

#The workflow bar

Under the description, a bar shows the next steps for the Issue: the next status, Reopen when it is closed, the status that closes it, and Other status…, which opens Move to with every status. A line tells you your part, for example "This is assigned to you. Move it to Resolved and its author will verify."

The sheet explaining how an Issue moves: who raises it, who does the work, who closes it and who comments.
How the workflow works.

Open How the workflow works in the header’s ⋯ menu for the short version:

This is the default workflow. On TeamSync cloud your Organization’s Roles decide who may do what; see [Roles](/docs/roles).
WhoDoes what
Whoever spots itRaises the Issue.
The assigneeDoes the work and moves the status.
The authorVerifies and closes it. Resolved is not closed.
Everyone elseComments.

#The ⋯ menu, Edit and archive

  • The Issue’s ⋯ has Edit details…, Change status…, Copy a summary, Refresh and Archive this issue. Archiving asks "Archive this issue?" and says that it disappears from the list while its record is kept.
  • Edit opens the form for the Issue. You can change the title, description, status, type, priority, Discipline, Zone, phase, due date, labels, Assigned to and Also notify, and Archive it. Choose Save.
  • Moving an Issue to another Zone renumbers it. The pane says "Saved. It is" followed by the new reference.
  • If somebody else changed the Issue first, the pane says so and reloads their version. Make your change again.

Note

The pane can archive Issues but not delete them. Archived Issues stay readable; see Working on an Issue.

#Comments

Choose the Comments tab. Type in the box ("Add a comment…") and choose Comment, or press Ctrl+Enter.

The Comments tab of an Issue with a conversation and a box to add a comment.
Comments on an Issue.
  • Type @ to mention a person. They are notified, and the pane never mutes mentions.
  • Type # to link another Issue of the Project, or a model element.

#Pick an element in the model

  1. Type # in the comment

    The list that opens offers Issues and Pick element in the model.

  2. Choose Pick element in the model

    In Revit the status bar says "TeamSync: click an element to reference it in the comment. Esc cancels."

  3. Click the element

    The reference is added to your comment.

You can also type # followed by an element id such as #123, a GUID or a Revit UniqueId. Later, choosing the reference in the comment finds that element in the model. For comments on the web, see Comments and mentions.

#Files

The Files tab shows how much of the Issue’s 50 MB you have used (for example "X of 50 MB used"). Snapshots of viewpoints do not count. Choose + Attach files… to add files. Each file has Open and a delete button. Only the author and assignees can attach files.

The Files tab of an Issue: a storage meter, an Attach files button and a list of files.
Files attached to an Issue.

#Activity

The Activity tab is the Issue’s history of changes.

The Activity tab listing each change to an Issue.
The Activity tab.

#Changing several Issues at once

  1. Choose Select issues

    Choose the select button next to the search box. The pane asks you to pick Issues to change together and shows how many are selected. All and None select or clear every Issue in the list.

  2. Tick the Issues

    Tick the cards you want to change.

  3. Choose Edit

    Choose Edit N, where N is how many you ticked. The Change N issues sheet opens.

  4. Set what should change

    Every field starts at "— leave alone —". Change only the fields you want. You can move the Issues to another Zone with Move to zone, empty a field with clear it, and replace who they are assigned to.

  5. Choose Apply

    The pane says how many changed and how many were left alone. Choose Done to leave selection.

The sheet for changing several Issues, with fields set to leave alone and an Apply button.
Changing several Issues together.

#Notifications in the add-in

The bell in the header opens Notifications. The filters are All, Mentions, Assigned, Status and Due. New ones are listed under New, older ones under Earlier. Choose Mark all read to clear the badge, or See all notifications for the full history, where you can choose Load older.

The Notifications sheet with filter tabs and a list of new and earlier notifications.
The Notifications sheet.

You are told when an Issue is assigned to you, when you are mentioned, when a new comment arrives on an Issue you follow, when a status changes, when you are kept informed on an Issue, and when an Issue is due today or tomorrow or is overdue.

A Windows toast has an Open issue button that opens the Issue in the pane. The Team Sync button on the ribbon shows a red badge while you have unread notifications. The pane has no setting to silence its sounds: to quiet an Issue, mute it from its following line. The web app has more notification settings; see Notifications and reminders.

Can’t find what you need? Write to info@top-matrix.com and we’ll help.