Document Commenting

При интеграции с подключенным Workspace проекты Altium Designer позволяют распределённой команде разработчиков совместно работать над проектами, которые централизованно хранятся и управляются. Интерфейс проектирования поддерживает комментирование различных проектных документов, улучшая процесс совместной работы. Комментарии, то есть добавляемые пользователями заметки, можно размещать в документах, а другие пользователи могут отвечать на них.

Панель Comments and Tasks 

Размещённые комментарии доступны сотрудничающим пользователям (тем, у кого есть общий доступ к документу) в режиме реального времени и сохраняются на сервере независимо от проекта, никак не изменяя входящие в него документы. Функция комментирования управляется через панель Comments and Tasks. При выборе записи комментария на панели Comments and Tasks система откроет (и при необходимости загрузит) связанный проектный документ.

Панель Comments and Tasks позволяет добавлять комментарии к заданной области или точке в активном документе проекта Workspace и назначать эти комментарии участникам Workspace, фактически создавая для них задачи. Панель позволяет всем пользователям, работающим с документом, добавлять комментарии и просматривать все комментарии, не изменяя сам документ. Эта функция способствует выстраиванию эффективных процессов совместной работы и незаменима, когда нужно указать на проблемы в документе без фактического слияния изменений и возникновения конфликтов. Панель Comments and Tasks по сути можно использовать для создания списка «to-do», и по мере развития проекта комментарии можно разрешать и закрывать. Размещённые комментарии доступны сотрудничающим пользователям в реальном времени — тем, у кого есть общий доступ к документу, — и сохраняются в Workspace независимо от проекта, никак не изменяя входящие в него документы.

Обратите внимание: комментарии и задачи можно добавлять и управлять ими как в Altium Designer, так и в соответствующем Workspace через его браузерный интерфейс (режим просмотра проекта). Функциональность двух систем комментирования по сути одинакова, и поскольку и проект, и данные комментариев хранятся в Workspace, системы работают совместно в реальном времени.

Подробные сведения о системе комментирования в браузерном интерфейсе Workspace см. в Commenting in the Web Viewer (Altium 365 Workspace, Enterprise Server Workspace).

Где поддерживается комментирование

Схема

Комментарий можно применить к объекту, конкретной точке или области в документе схемы.

PCB

Комментарий можно применить к объекту, конкретной точке или области в документе PCB (в режиме 2D-редактирования платы) — .

Draftsman

Комментарий можно применить к конкретной точке или области в документе Draftsman проекта PCB, Multi-board или Harness Design — .

Multi-board Schematic

Комментарий можно применить к объекту или конкретной точке в документе Multi-board Schematic — .

Multi-board Assembly

Комментарий можно применить к конкретной точке в документе Multi-board Assembly — .

Harness Wiring Diagram and Layout Drawing

Комментарий можно применить к объекту, конкретной точке или области в документе Wiring Diagram или Layout Drawing проекта разработки жгута.

ActiveBOM

Комментарий можно применить к строке в документе ActiveBOM — .

Доступ к панели Comments and Tasks

К панели можно получить доступ из проекта Workspace следующими способами:

• Нажмите кнопку Panels в правом нижнем углу рабочей области, затем выберите Comments and Tasks.

  Значок Workspace рядом с названием панели в меню в правом нижнем углу рабочей области указывает, что для просмотра данных соответствующей панели требуется подключение к Workspace. Синий значок () означает, что в данный момент есть подключение к Workspace. Серый значок () означает, что подключения к Workspace сейчас нет, и перед доступом к данным панели вам будет предложено подключиться к Workspace.

• Выберите команду View » Panels » Comments and Tasks в главном меню.

• Дважды щёлкните по маркеру (pin) комментария, размещённого в рабочей области.

Добавление комментария при отсутствии подключения к Workspace

Перед использованием функции комментирования убедитесь, что вы подключены к своему Workspace, открыли проект и один из типов документов, поддерживающих комментарии (включая схему, 2D PCB, Draftsman и ActiveBOM). Используйте команду File » Open Project, чтобы выбрать проект Workspace из тех, к которым вам предоставлен общий доступ. Панель Comments and Tasks подскажет эти предварительные условия.

Параметры панели Comments and Tasks

Используйте кнопки в верхней части панели Comments and Tasks, чтобы настроить доступность комментариев в панели и в области редактора, а также указать, будут ли упомянутые пользователи получать уведомления.

Кнопка панели  переключает видимость маркеров комментариев в документе. При этом записи комментариев в списке панели Comments and Tasks по-прежнему можно выбирать как обычно.

Используйте раскрывающееся меню фильтра на панели Comments and Tasks (), чтобы настроить фильтрацию комментариев, и связанную с ним кнопку  для переключения между отфильтрованным и неотфильтрованным представлением.

• Tasks only — включите эту опцию, чтобы показывать только комментарии, назначенные пользователю.
• ASSIGNED TO — по умолчанию все опции отключены. Соответственно, все задачи/комментарии отображаются и сортируются по имени (первая запись в списке — текущий пользователь). Когда флажки включены для пользователя(ей), будут отображаться записи только для отмеченных.

Используйте параметры меню кнопки  для настройки видимости комментариев и уведомлений:

• Unresolved Only — разрешённые комментарии не включаются в список.

• Current document only — показывать только комментарии, размещённые в текущем активном документе.

• Notification settings – щелкните, чтобы открыть диалог Notification Settings и настроить получение email-уведомлений обо всей активности комментариев в этом проекте (All), только по тем комментариям, где вас упомянули или назначили ответственным (My), либо полностью отключить email-уведомления (None). ► Пример содержимого письма.

• Export Comments – щелкните, чтобы открыть диалог Comment Export Configuration и настроить экспорт комментариев в PDF-файл.

  

  Итоговый PDF будет содержать информацию о комментариях в проекте: ID комментария, автора, дату и время создания, текст комментария, назначенного исполнителя (для задач) и статус (для комментария — если он Resolved; для задачи — её статус To Do / In Progress / Resolved). Вы можете выбрать экспорт всех комментариев, связанных с проектом, независимо от того, когда они были сделаны, либо только комментариев, сделанных между конкретными релизами проекта. Также есть несколько параметров, определяющих, какие скриншоты включать в сформированный PDF-документ. Вместе они дают информацию о том, где находится комментарий и к чему он относится (точка, компонент, область). Если оставить оба параметра выключенными, вы получите только сами комментарии. После настройки нажмите Export , чтобы сформировать PDF, а в последующем диалоге укажите, где сохранить файл и под каким именем (по умолчанию — имя проекта).

  • Entire designs snapshots - включить снимок каждого исходного документа с комментарием в пределах указанного Period. Это обеспечивает визуальное подтверждение того, где на документе расположен комментарий, по пронумерованному маркеру комментария.
  • Original design screenshots - включить Original Snapshot, сделанный при создании комментария (и это снимок, доступный в окне Contextual Commenting, когда в основной области проекта щелкают по маркеру комментария). Он показывает точку, область или компонент, к которым относится комментарий.

  Экспорт комментариев в PDF также можно настроить и сформировать через файл Output Job в рамках выпуска (release) проекта. Добавьте выходной модуль Export Comments в категорию Report Outputs.

  Обратите внимание: функция экспорта комментариев доступна только участникам Workspace, в котором находится проект. Она недоступна пользователям, которым проект был расшарен за пределами Workspace.

Размещение

Чтобы разместить комментарий в рабочем пространстве объектно-ориентированного графического редактора, такого как схема, 2D PCB или Draftsman, сначала запустите соответствующую команду. Это можно сделать одним из следующих способов:

• Нажмите кнопку , доступную на панели Comments and Tasks.

• Нажмите  в правом верхнем углу рабочей области.

• Выберите Place » Comment в главном меню.

• Используйте сочетание клавиш Ctrl+Alt+C.

• Щелкните правой кнопкой мыши и выберите Comment в рабочей области.

В зависимости от типа документа (см. выше), комментарии можно привязывать к объекту, конкретной точке или области на активном документе. Команда включает режим размещения комментария, а курсор меняется на перекрестие с синим кругом, который обнаруживает и подсвечивает объекты для выбора:

• Щелкните по подсвеченному объекту, чтобы прикрепить (закрепить) комментарий к этому объекту.

• Щелкните в неподсвеченной области, чтобы прикрепить комментарий к конкретной точке на документе.

• Щелкните в стороне от объекта и перетащите курсор, чтобы создать прямоугольную подсвеченную область и прикрепить комментарий к указанной области ().

В документе ActiveBOM щелкните по ячейке, чтобы добавить комментарий к соответствующей строке BOM. Либо щелкните правой кнопкой по строке и выберите команду Comment, чтобы добавить комментарий к этой строке.

После действия размещения открывается диалог ввода комментария с полем для текста комментария и, для графических документов, также с дополнительной опцией добавления к комментарию рисунка от руки, где это применимо (). Выберите опцию Assign a task to, чтобы назначить задачу себе или одному из пользователей, упомянутых в комментарии (подробности ниже). Нажмите , чтобы подтвердить создание комментария — он будет связан с пронумерованным маркером на документе, а также будет добавлена сводная запись о комментарии на панель Comments and Tasks.

Размещение комментария на объекте, упоминание другого зарегистрированного пользователя в комментарии, перемещение индикатора (пина) комментария и добавление к комментарию рисунка от руки.

Упоминания и назначение задач

Помимо текста в диалоге ввода комментария, можно добавить ссылку-«упоминание» любого другого пользователя или роли, зарегистрированных в подключенном Workspace, введя символ @. Выберите имя/email из выпадающего списка, чтобы добавить ссылку на пользователя (участника Workspace) в комментарий, а также как запись Assign a task to — по сути, пользователю будет назначен task. Снимите отметку с этой опции, если не хотите, чтобы комментарий считался назначенным именно этому пользователю. Также можно добавить в упоминание группу ролей (например, «Engineers»), а значит и входящих в неё пользователей.

Если упомянутый пользователь не имеет доступа к текущему проекту, вам будет предложено поделиться проектом с этим пользователем. Эта опция доступна, если вы владелец проекта или администратор Workspace. Права доступа пользователя задаются через диалог Share dialog; пользователь получит email-уведомление о предоставленном доступе. Если вы отмените диалог Share, проект не будет расшарен, но комментарий будет размещен как обычно.

► Подробнее о том, как поделиться проектом.

Когда задача назначена пользователю, изображение/фото этого пользователя будет показано в левом верхнем углу диалога комментария и на плитке комментария на панели Comments and Tasks. Кроме того, задача будет именоваться названием проекта и порядковым номером (например, Kame_FMU-1) вместо простого номера, как у обычных комментариев. Это имя также отображается в диалоге комментария и на плитке комментария. Щелкните по нему, чтобы открыть страницу Tasks проекта в браузерном интерфейсе Workspace, при этом выбранная задача будет выделена в списке задач.

Позиционирование

Расположение комментария в области редактора изменяется перетаскиванием связанного с ним «пина» в новое положение — во время размещения или после него. При выборе пина комментария отображается соединительная линия к связанному объекту или области.

Обратите внимание: комментарий также можно позиционировать во время первоначального размещения, щелкнув и перетащив в режиме размещения ().

Вставка изображений

Вы можете добавить изображение в комментарий, предварительно скопировав его из окна Explorer  или страницы браузера: щелкните правой кнопкой по изображению, чтобы скопировать его в буфер обмена. Чтобы прикрепить изображение, используйте команду правой кнопки Paste (или сочетание клавиш Ctrl+V ) непосредственно в комментарии (в поле, где указано Add others with @ or paste images). 

Максимальный размер каждого изображения — 2 МБ. После вставки в комментарий щелкните по изображению, чтобы открыть его в полном размере, как показано на изображении справа.

Также можно опубликовать комментарий, который содержит только вставленное изображение без текста, как показано ниже.

Рисование

При размещении или редактировании комментария выберите кнопку опции , чтобы добавить рисунок от руки — курсор при этом станет «пером». Щелкните и перетащите, чтобы рисовать линии, затем щелкните правой кнопкой, чтобы завершить и привязать рисунок к текущему выбранному комментарию.

Чтобы получить доступ к режиму Freehand Drawing панели Properties, нажмите клавишу Tab , когда активен режим рисования от руки (это обозначается значком  в рабочей области). Эти параметры позволяют отменять и повторять действия с комментариями в выпадающем списке Commands, а также менять толщину, размер и цвет в выпадающем списке Properties .

Общие задачи

Общие задачи (задачи, применяемые к текущему проекту, но не связанные с комментарием проекта или документом) перечислены на панели в отдельной группе под записью проекта. Для общих задач на панели отображаются те же сведения и атрибуты (исполнитель, приоритет и т. д.).

Общие задачи перечислены на панели Comments and Tasks.

Щелкните запись «Общая задача» на панели, чтобы открыть диалоги комментирования. Используйте диалог, чтобы публиковать комментарии (включая комментарии с вставленными изображениями) для выбранной общей задачи.

Открепленные комментарии

Если документ проекта удален или изменился его UniqueID, комментарии к документу могут стать «открепленными». Эти комментарии по‑прежнему доступны из Detached Comments сворачиваемой области панели. Щелкните плитку открепленного комментария на панели Comments and Tasks, чтобы показать его диалог в рабочей области дизайна текущего открытого документа.

Работа с комментариями

Комментарии, размещенные в документе проекта, регистрируются и на панели Comments and Tasks (как последовательность пронумерованных записей), и в соответствующем редакторе документа (как пронумерованные графические «пины»). Каждая запись на панели представляет ветку комментариев и предоставляет сводную информацию, включая кто и когда разместил комментарий, исходный текст комментария, примененные упоминания/назначения и количество ответов в ветке.

Ветка комментариев открывается выбором ее записи на панели Comments and Tasks или щелчком по связанному с ней пину в рабочей области. При этом комментарий подсвечивается в редакторе документа и открывается диалог записи комментария, включающий исходный комментарий и ответы пользователей. Если выбранный комментарий связан с другим проектным документом, система откроет (и при необходимости загрузит) этот документ.

Навигация по комментариям путем выбора маркеров‑пинов в рабочей области и выбора записей на панели Comments and Tasks.

Диалог комментариев

Взаимодействие с размещенным комментарием выполняется через всплывающий диалог комментария, который показывает все записи выбранной ветки и содержит параметры для предпросмотра, ответа, редактирования, закрытия (resolve) и удаления записи. Диалог открывается при первоначальном размещении комментария или при выборе размещенного комментария на панели Comments and Tasks либо в рабочей области. Нажмите Esc или щелкните в рабочей области, чтобы закрыть диалог комментария.

Предпросмотр

Выберите параметр Original Snapshot в исходном комментарии, чтобы увидеть графический снимок области редактора в момент размещения комментария. Щелкните значок в правом верхнем углу снимка экрана или сам снимок, чтобы открыть полноразмерный предпросмотр (щелкните значок  в правом верхнем углу этого предпросмотра или само изображение, чтобы закрыть его).

Ответ

Введите текст и при необходимости упоминание пользователя («@») в поле Reply, чтобы добавить новую запись в ветку комментариев. Выберите параметр Assign a task to, чтобы создать задачу, назначенную пользователю, указанному в раскрывающемся списке. Нажмите  для подтверждения записи.

Редактирование и удаление

Существующий комментарий может быть отредактирован автором этого комментария с помощью параметра Edit, доступного из меню комментария . Нажмите кнопку , чтобы подтвердить редактирование комментария.

Используйте параметр Delete, чтобы удалить текущий выбранный комментарий. Обратите внимание: если удалить исходный комментарий (а не ответ), будет удалена вся ветка.

Используйте параметр Convert to Task, чтобы преобразовать комментарий в задачу, назначенную вам.

Используйте параметр Copy Link, чтобы скопировать URL ветки комментариев. Эту ссылку можно использовать, чтобы открыть данный проект в Web Viewer браузерного интерфейса Workspace, при этом объект, точка или область комментария будут увеличены и центрированы.

Закрытие (Resolve)

Нажмите кнопку / , чтобы переключить состояние комментария между Resolved и Unresolved (по умолчанию). Закрытый комментарий (отмеченный как выполненный) неактивен и недоступен для редактирования; и его запись на панели Comments and Tasks, и маркер‑пин в документе отображаются серым цветом.

Настройка приоритетов и статусов задач

Если комментарий‑задача назначен пользователю, можно задать его приоритет и статус. Изначально задача сразу устанавливается с приоритетом Medium и статусом To Do, но их можно изменить, щелкнув соответствующий элемент управления в верхней части диалога комментария.

Тег коммита, ID ревизии релиза и сведения Design Review 

Теги коммитов и ID ревизий релизов отображаются при просмотре соответствующих комментариев/задач как на панели Comments and Tasks, так и в диалоге комментирования в Altium Designer.

• Комментарии, созданные в Web Viewer при просмотре снимка дизайна для помеченного тегом коммита, будут включать связанное имя тега. Щелкните ссылку с именем тега, чтобы открыть соответствующий снимок коммита в Web Viewer.

• Комментарии, созданные в Web Viewer при просмотре конкретного релиза, будут включать ID ревизии релиза. Щелкните ссылку с ID ревизии релиза, чтобы открыть Manufacturing Portal для этого релиза.

• Комментарии, созданные в Web Viewer при просмотре снимка Design Review, будут включать запись Design Review. Щелкните ссылку Design Review, чтобы открыть страницу обзора.

Работа с задачами Jira

Если интеграция Jira включена и настроена для вашего Altium 365 Workspace, то размещенный комментарий будет содержать дополнительную возможность — создать и связать задачу Jira (issue) в вашем сервисе Atlassian Jira®. Как и обычные комментарии и связанные с ними задачи, размещенные задачи Jira можно просматривать, редактировать и комментировать прямо в проектных документах, а также просматривать/выбирать через панель Comments and Tasks.

Размещенный экземпляр задачи Jira синхронизируется с соответствующей задачей (issue) в пространстве Jira. Двунаправленная синхронизация данных между задачами Jira и задачами Workspace позволяет вести управление проектом разработки через пространство Jira совместно с Altium 365.

Создание задачи Jira (Issue)

Чтобы разместить задачу Jira Issue для проекта, сначала создайте экземпляр комментария обычным способом, затем выберите параметр Jira Issue в диалоге комментария. Далее выберите тип Issue и добавьте краткое описание (summary), чтобы создать синхронизированную задачу Jira.

❯ ❮ Javascript ID: CreateJiraIssue

Разместите задачу Jira в текущем документе проекта, сначала разместив экземпляр комментария. Альтернативный режим Jira доступен в раскрывающемся меню Comment. Запустите размещение задачи Jira, выбрав параметр Jira Issue в меню Comment диалога. Щелкните параметр Create Issue, если он еще не выбран. Выберите тип создаваемой задачи (issue) из раскрывающегося списка Issue Type, который включает типы, доступные в вашем сервисе Jira. Введите Summary задачи и необязательные описание/исполнителя. Раскрывающийся список Assignee будет включать только тех пользователей, которые зарегистрированы как участники вашей учетной записи Jira. Выберите Post для подтверждения. Задача Jira размещается в позиции исходного комментария в документе, добавляется на панель Comments and Tasks, предоставляет ссылку на задачу в пространстве Jira и включает интерактивный доступ к настройкам приоритета задачи (Medium, High и т. д.) и статуса (To Do, In Progress и т. д.).

Выберите Task ID задачи Jira Workspace в диалоге комментария или на панели Comments and Tasks, чтобы напрямую открыть эту задачу в пространстве Jira в новой вкладке браузера по умолчанию. Task ID Workspace сопоставляется с Issue Key в пространстве Jira, а основные параметры Jira, такие как Summary, Description, Assignee и Comments, сопоставляются между двумя экземплярами. Пользователь Workspace, создавший Jira Issue, является Issue Reporter на стороне Jira. Обратите внимание: снимок изображения текущего документа Workspace добавляется как вложение Jira, если при создании Jira Issue в Workspace был выбран параметр Attach original snapshot (см. выше).

Размещённая задача Workspace Jira создаст синхронизированную задачу Jira в пространстве Jira. Эти две сущности связаны сопоставлением Workspace Task ID с Jira Issue Key.

Наряду с параметрами, сопоставленными между задачами Workspace и Jira, также синхронизируются настройки статусов, связанные с задачей: Priority и Progress. Например, перевод задачи Workspace issue из состояния приоритета Medium в High немедленно отразится в задаче на стороне Jira, а изменение состояния прогресса с To Do на In Progress на стороне Jira аналогичным образом изменит состояние задачи Workspace Jira issue. Для просмотра обновлённых данных может потребоваться обновление данных (выполняется нажатием кнопки  в верхней части панели Comments and Tasks).

Связь с задачей Jira

Интеграция Altium 365 Jira Integration также позволяет связать задачу Workspace Task с уже существующей задачей Jira в вашем сервисе Atlassian Jira через режим Jira Issue в диалоге комментария. Вы можете связаться с любой задачей в указанном проекте Jira, после чего она будет синхронизироваться с задачей Workspace Jira.

❯ ❮ Javascript ID: LinkJiraIssue

Разместите экземпляр комментария в области документа или на объекте, который вы хотите связать с существующей задачей Jira, затем выберите режим Jira Issue и опцию Link Issue в диалоге комментария. Используйте раскрывающийся список Select or search issues, чтобы выбрать задачу Jira (отображается как текст Summary), которая будет связана с только что размещённым экземпляром задачи Jira. Начните вводить текст в поле, чтобы выполнить поиск нужной задачи Jira. В раскрывающемся списке Jira Issue диалога будет показана выбранная задача из пространства Jira. При необходимости установите опцию Attach original snapshot, чтобы передать изображение текущего вида документа в Jira. Нажмите кнопку Post, чтобы установить связь между задачей Workspace Jira и выбранной задачей Jira. Новая задача Jira issue отображается на панели Comments and Tasks и в диалоге комментария, который будет включать любые существующие (или добавленные) комментарии — выберите опцию Show all Replies в диалоге, чтобы увидеть полный список.

Связанная задача Jira теперь синхронизируется с задачей Workspace Jira, включая Comments задачи, и устанавливается в состояния Progress и Priority, определённые задачей Jira — In Progress и High в этом примере. Обратите внимание: записи Jira issue Web links теперь будут указывать, что к этой задаче была привязана (или повторно привязана) задача Altium 365 Workspace Jira.

Существующая задача Jira связывается с задачей Workspace путём указания её записи Jira Issue в режиме Link Issue диалога комментария Workspace.

Панель To-Do

Хотя ваш подключённый Workspace предоставляет полный набор функций для комментирования и назначения задач, описанных выше, вы также можете использовать панель To-Do для отслеживания своих задач. Панель To-Do перечисляет все элементы To-Do, которые в данный момент определены для активного проекта. Элемент To-Do используется как напоминание о задаче, которую нужно выполнить позже в связи с документом.

Панель To-Do

To-Do Panel Content and Use

Панель To-Do может отображать два типа элементов «to-do» для активного проекта:

• Элемент To-Do уровня проекта.
• Элемент To-Do уровня документа — добавляется в текстовый документ внутри проекта.

Для каждого элемента To-Do отображается следующая информация:

• Done - этот флажок позволяет отметить элемент, когда соответствующая задача выполнена.
• Action Item - собственно задача, которую необходимо выполнить.
• Priority - важность выполняемой задачи (Lowest, Low, Normal (по умолчанию), High, Highest).
• Document - ссылка на исходный документ, к которому был добавлен элемент To-Do уровня документа.
• Owner - это может быть имя человека, который ввёл задачу, или того, кто фактически должен её выполнить.
• Category - это может быть конкретная область проекта, к которой относится выполняемая задача (например, схемы, правила проектирования, трассировка, ограничения и т. п.).

Добавление элементов To-Do уровня проекта

Элементы To-Do уровня проекта добавляются непосредственно из самой панели. Перед добавлением элементов убедитесь, что активный документ в окне редактора проектирования — один из проектных документов того проекта, для которого вы хотите определить элементы To-Do.

Чтобы добавить новый элемент To-Do, щёлкните правой кнопкой мыши внутри панели и выберите пункт Add Project To-Do Item в появившемся контекстном меню. Откроется диалог Edit To-Do Item.

Используйте этот диалог, чтобы ввести подходящий текст для задачи, которую необходимо выполнить в проекте. Используйте доступные поля диалога, чтобы определить task's Priority, Owner, and Category. После задания параметров элемента нажмите OK, чтобы добавить новый элемент на панель.

Добавление элементов To-Do уровня документа

Элементы To-Do уровня документа добавляются в текстовый исходный документ (например, файл VHDL, файл ограничений, документ Embedded Source code и т. п.). Перед добавлением элементов убедитесь, что нужный документ активен в окне редактора проектирования и что этот документ относится к проекту, для которого вы сейчас определяете общий список To-Do.

Чтобы добавить новый элемент To-Do, установите текстовый курсор в нужное место документа, где вы хотите разместить элемент To-Do, щёлкните правой кнопкой мыши и выберите пункт Add To-Do Item в появившемся всплывающем меню. Появится диалог Edit To-Do Item. Используйте этот диалог, чтобы ввести подходящий текст, относящийся к задаче, которую необходимо выполнить в документе. Используйте доступные поля диалога, чтобы определить для задачи Priority, Owner и Category (например, проход форматирования, проход Code Review и т. п.). После задания элемента To-Do нажмите OK, чтобы закрыть диалог и вернуть фокус на текущий документ. Запись элемента To-Do появится на панели To-Do, а также в месте, отмеченном текущей позицией текстового курсора. Запись будет отображаться как комментарий (между разделителями комментариев, определёнными для данного типа документа), включая фактический текст элемента и уникальный идентификатор, как показано на изображении ниже.

Меню правой кнопки мыши

Меню правой кнопки мыши содержит следующие команды:

• Goto Source - эта команда становится доступной, когда выбранный элемент на панели — это элемент To-Do уровня документа. Используйте эту команду, чтобы открыть (если ещё не открыт) связанный исходный документ, указанный в поле Document элемента, и сделать его активным документом в окне редактора проектирования. Текстовый курсор будет установлен в начало текста элемента To-Do.
• Add Project To-Do Item - добавить на панель элемент To-Do уровня проекта для активного проекта.
• Edit - редактировать выбранный элемент To-Do. Появится диалог Edit To-Do Item, позволяющий внести необходимые изменения.
• Delete - удалить выбранный элемент To-Do с панели.
• Show Completed Items - при включении этой опции на панели будут отображаться только элементы To-Do, отмеченные как выполненные (включена опция Done ).
• Report - сформировать отчёт, содержащий все элементы To-Do, которые в данный момент отображаются на панели. После запуска команды откроется диалог Report Preview, в котором можно настроить, распечатать и экспортировать отчёт в различных форматах файлов.

Примечания

• Если элемент To-Do уровня документа определён на панели и соответствующий исходный документ является активным документом в окне редактора проектирования, весь текст записи To-Do на панели будет выделен полужирным.
• Двойной щелчок по записи элемента To-Do на панели откроет диалог Edit To-Do Item, позволяя изменить определение задачи.
• Записи на панели можно сортировать по любому столбцу, щёлкнув по заголовку этого столбца. Один щелчок — сортировка по возрастанию; повторный щелчок — по убыванию.
• Прямая фильтрация позволяет быстро перейти к записи элемента To-Do, просто набирая текст прямо в панели. Фильтрацию можно выполнять по любому столбцу данных на панели. Используйте клавиши Right Arrow и Left Arrow, чтобы переключаться между столбцами для фильтрации, или щёлкните непосредственно по полю в нужном столбце. Чтобы воспользоваться этой функцией фильтра, щёлкните внутри столбца данных и введите первую букву записи, к которой хотите перейти. Будет выбрана первая запись в этом столбце, начинающаяся с введённой буквы, а буква будет подсвечена, показывая, что фильтрация содержимого столбца выполняется по введённой букве.