Комментирование документов

Altium Training

Altium Essentials: Design Review and Commenting

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Краткий обзор

Узнайте, как комментарии к документам в Altium Designer помогают командам проводить проверку общих проектов рабочего пространства, не изменяя исходные проектные документы. В этом руководстве рассматриваются поддерживаемые типы документов, добавление комментариев и ответов на них, назначение задач там, где эта функция доступна, а также работа с обратной связью на панели Comments and Tasks. Читайте дальше, чтобы эффективнее использовать комментарии при командной проверке проектов.

- Узнайте, где поддерживаются комментарии и как открыть панель Comments and Tasks.
- Научитесь привязывать комментарии к объектам, точкам или областям в зависимости от типа документа.
- Изучите фильтры, настройки уведомлений и экспорт в PDF, чтобы упорядочивать замечания по результатам проверки и делиться ими.
Узнайте больше с ИИ:

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

Панель Comments and Tasks
Панель Comments and Tasks

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

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

Если у вас нет доступа к функциям создания задач и управления ими, эти функции будут недоступны, а панель будет называться Comments.

Информацию о проектах с точки зрения рабочего пространства см. в разделе Workspace Projects (рабочее пространство Altium 365, рабочее пространство Enterprise Server).

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

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

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

Принципиальная схема

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

Печатная плата

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

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

Javascript ID: PCB_Support1

Настройки вида до перехода к комментарию: включены все сигнальные слои, активен слой Bottom, плата показана снизу.

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

Draftsman

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

Схема многоплатного устройства

Комментарии в документах схем многоплатных устройств доступны, если параметр MBS.Comments включен в диалоговом окне Advanced Settings.

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

Сборка многоплатного устройства

Комментарии в документах сборок многоплатных устройств доступны, если параметр MBA.Comments включен в диалоговом окне Advanced Settings.

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

Схема соединений и компоновочный чертеж жгута

Комментарии в документах схем соединений и компоновочных чертежей жгутов доступны, если параметр Harness.Comments включен в диалоговом окне Advanced Settings.

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

ActiveBOM

Комментарии в документах ActiveBOM доступны, если параметр BOM.Comments включен в диалоговом окне Advanced Settings.

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

Доступ к панели комментариев и задач

Из проекта рабочего пространства панель можно открыть следующими способами:

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

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

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

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

Для доступа к панели Comments and Tasks активным должен быть документ принципиальной схемы, печатной платы, ActiveBOM, схемы многоплатного устройства или Draftsman, входящий в открытый проект рабочего пространства. Для выбора будут доступны только те проекты, к которым вам предоставлен общий доступ.

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

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

Если вы пользуетесь преимуществами подписки, но еще не создали рабочее пространство Altium 365 для своей компании, вы можете опробовать функции комментирования в демонстрационном режиме. Войдя в свою учетную запись Altium из Altium Designer и работая с локальным проектом, вы можете разместить до трех комментариев. Для использования всех возможностей комментирования и сохранения размещенных комментариев проект необходимо разместить в рабочем пространстве. Соответствующий элемент управления появится в сообщении под всплывающим диалоговым окном комментария в области проектирования.

Опробуйте функцию комментирования в демонстрационном режиме, если у вас еще нет активированного рабочего пространства Altium 365.
Опробуйте функцию комментирования в демонстрационном режиме, если у вас еще нет активированного рабочего пространства Altium 365.

Параметры панели «Комментарии и задачи»

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

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

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

  • TYPE — включите типы, которые требуется отображать. По умолчанию включены все типы.

  • SCOPE — включите Current document, чтобы отображать комментарии только для текущего документа.

  • ASSIGNEE — по умолчанию все параметры отключены. Поэтому отображаются все задачи и комментарии, отсортированные по имени (первым в списке указан текущий пользователь). Если установить флажки для одного или нескольких пользователей, будут отображаться записи только выбранных пользователей. 

  • Clear Filters — используйте для быстрого возврата к настройкам фильтрации по умолчанию.

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

  • Unresolved Only — закрытые комментарии не отображаются в списке.

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

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

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

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

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

Размещение

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

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

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

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

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

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

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

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

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

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

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

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

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

Размещенный комментарий сразу становится доступен всем пользователям, имеющим доступ к проекту, а также отображается при просмотре проекта в браузере в подключенном рабочем пространстве.

Количество символов, которые можно ввести в обычный комментарий и задачу, ограничено 2000.

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

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

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

► Подробнее о предоставлении доступа к проекту.

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

При сохранении проекта в подключенное рабочее пространство задачу можно связать с коммитом проекта. Как указано в подсказке в диалоговом окне Save to Server, добавьте идентификатор задачи в поле Comment (в том виде, в котором он отображается на панели Comments and Tasks); задача будет связана с коммитом проекта, который будет создан после нажатия OK в диалоговом окне.

Ссылка на коммит будет отображаться в области сведений о задаче при выборе карточки задачи на странице Tasks браузерного интерфейса рабочего пространства (рабочее пространство Altium 365, рабочее пространство Enterprise Server) или в представлении Tasks на странице подробного управления проектом (рабочее пространство Altium 365, рабочее пространство Enterprise Server). Нажмите ссылку, чтобы открыть представление History проекта, в котором соответствующий коммит будет выделен на временной шкале.

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

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

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

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

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

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

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

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

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

Рисование

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

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

Общие задачи

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

Общие задачи отображаются на панели Comments and Tasks.
Общие задачи отображаются на панели Comments and Tasks.

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

Общую задачу для проекта можно создать на странице Tasks браузерного интерфейса рабочего пространства, открыв страницу подробного управления проектом. Подробнее см. Management of a Specific Project ( Рабочее пространство Altium 365, Рабочее пространство Enterprise Server).

Отсоединенные комментарии

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

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

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

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

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

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

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

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

Предварительный просмотр

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

Ответ

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

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

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

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

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

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

Закрытие комментария

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

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

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

Тег коммита, идентификатор ревизии выпуска и сведения о проверке проекта 

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

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

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

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

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

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

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

  • Обзор возможностей приведен на странице Интеграция с Jira.

  • Подробные сведения о настройке интеграции с Jira для вашего рабочего пространства Altium 365 приведены на странице Знакомство с браузерным интерфейсом.

  • Подробные сведения о работе с задачами Jira в Web Viewer браузерного интерфейса рабочего пространства Altium 365 приведены на странице Web Viewer.

Создание задачи Jira

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

Чтобы разместить задачу Jira в текущем документе проекта, сначала разместите комментарий. Альтернативный режим Jira доступен в раскрывающемся меню Comment.

Для размещения задачи Jira выберите пункт Jira Issue в меню Comment диалогового окна.

Нажмите Create Issue, если этот пункт еще не выбран.

Выберите тип создаваемой задачи в раскрывающемся списке Issue Type, который содержит типы, доступные в вашем сервисе Jira.

Введите Summary задачи и при необходимости укажите описание и исполнителя. Раскрывающийся список Assignee содержит только пользователей, зарегистрированных в вашей учетной записи Jira. Для подтверждения выберите Post.

Задача Jira размещается в исходной позиции комментария в документе и отображается на панели Comments and Tasks. Она содержит ссылку на задачу в пространстве Jira и позволяет интерактивно изменять ее приоритет (Medium, High и т. д.) и статус (To Do, In Progress и т. д.).

 
 
 
 
 
 
  • При публикации комментария, связанного с Jira, или ответа на него можно ввести не более 20 000 символов.

  • При создании задачи Jira через Altium Designer поддерживаются следующие поля:

    • Текст

    • Число

    • Поле URL

    • Раскрывающийся список

    • Раскрывающийся список с поиском (для выбора пользователя — исполнителя, поиска задачи Jira и поиска родительской задачи при создании подзадачи)

    • Поле множественного выбора (отображаются флажки с предупреждением о необходимости выбрать хотя бы один вариант для продолжения — ).

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

При размещении задачи Jira в рабочем пространстве в пространстве Jira создается синхронизированная задача. Они связываются путем сопоставления Task ID рабочего пространства с Issue Key Jira.
При размещении задачи Jira в рабочем пространстве в пространстве Jira создается синхронизированная задача. Они связываются путем сопоставления Task ID рабочего пространства с Issue Key Jira.

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

Связывание с задачей Jira

Интеграция Altium 365 с Jira также позволяет связать задачу рабочего пространства с существующей задачей Jira в вашем сервисе Atlassian Jira с помощью режима Jira Issue диалогового окна комментария. Вы можете установить связь с любой задачей в указанном проекте Jira, после чего она будет синхронизироваться с задачей 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, чтобы установить связь между задачей Jira рабочего пространства и выбранной задачей Jira.

Новая задача Jira отображается на панели Comments and Tasks и в диалоговом окне комментария, которое будет содержать все существующие (или добавленные) комментарии. Чтобы просмотреть полный список, выберите пункт Show all Replies в диалоговом окне.

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

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

Панель задач

Панель To-Do доступна, если параметр UI.PanelToDoList включен в диалоговом окне расширенных настроек.

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

Панель To-Do
Панель To-Do

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

Если вы не видите описанную функцию в используемом вами программном обеспечении, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.

Contents