Управляйте совместными задачами по рабочим действиям и работайте с ними через панель Tasks dashboard
в Altium 365 Workspace.Управляйте совместными задачами по рабочим действиям и работайте с ними через панель Tasks dashboard
в Altium 365 Workspace.
Несмотря на относительно простой интерфейс, панель Workspace Tasks dashboard предлагает гибкий и эффективный способ как управления, так и отслеживания рабочих процессов непосредственно в реальной среде проектирования, а не через внешнюю систему. Эта страница представляет собой глобальное представление всех задач, которые в данный момент активны в Workspace, тогда как представление задач конкретного проекта, доступное из дерева навигации при просмотре проекта, отображает только те задачи, которые связаны с этим проектом.
MCAD CoDesigner
Related page: ECAD-MCAD CoDesign
Эта страница относится к функциональности ECAD-MCAD CoDesign. MCAD CoDesigner синхронизирует PCB-проект между инженерами-электронщиками и инженерами-механиками. Он работает напрямую с данными ECAD и MCAD через панель MCAD CoDesigner panel на стороне Altium Designer и соответствующую панель, подключаемую к вашему программному обеспечению MCAD. Последняя предоставляется через установку (и регистрацию в MCAD-программе) Altium CoDesigner plugin.
При использовании последних плагинов Altium CoDesigner поддерживаются следующие платформы MCAD:
Версии инструментов MCAD, официально поддерживаемые системой, зависят от используемой версии плагина Altium CoDesigner. Эту информацию можно найти на странице New in CoDesigner page.
Страница MCAD CoDesigner содержит обзор этого раздела, а также ссылки на плагины MCAD CoDesigner и дополнительные обучающие материалы.
Страница предлагает следующее:
Team
Related page: Managing Workspace Membership
Эта страница используется для создания списка пользователей Workspace и управления им — людей, которые являются участниками Workspace и имеют доступ к Workspace и/или связанным с ним технологиям.
Участниками команды могут быть владельцы Altium Accounts внутри вашей организации или пользователи из другой организации (во втором случае приглашение их в качестве участников Workspace не означает, что они становятся частью вашей организации). Вы также можете приглашать пользователей, у которых нет Altium Account (в этом случае им потребуется зарегистрировать его). Пользователи могут отправлять запрос на присоединение к вашему Workspace, а существующие пользователи — отправлять запрос на приглашение другого пользователя в Workspace.
Определите, какие пользователи должны иметь доступ к Workspace, на странице Team интерфейса.
Параметры вкладок в верхней части страницы позволяют администраторам просматривать всех пользователей, имеющих доступ к Workspace, и управлять запросами пользователей на доступ к Workspace:
-
Team Members — все пользователи с доступом участника к Workspace на основе примененного членства в группах и назначенных прав доступа. Вкладка Team Members — единственное представление, доступное участникам Workspace, не входящим в группу Administrator. Администраторы (и только они) могут использовать параметры записи (
), чтобы Edit (управлять назначениями Group), Review Accesses (просматривать доступные им проекты) и Remove пользователя из Workspace.
-
External Share — пользователи, внешние по отношению к Workspace организации (не участники), которым был предоставлен гостевой общий доступ к проекту Workspace — см. Sharing with External Users.
-
Join Requests — отправленные запросы от пользователей вашей организации, которым требуется доступ к корпоративному Workspace.
-
Invitation Requests — запросы, отправленные участниками Team на предоставление доступа к Workspace другому пользователю или пользователям.
Используйте поле Search , чтобы быстро найти участника в списке.
Trash
Эта страница показывает все элементы, которые были «мягко удалены» — то есть удалены, но еще не окончательно. Trash по сути представляет собой корзину, в которую можно переместить любой элемент в вашем Workspace (посредством мягкого удаления). Она изолирована от остальной части Workspace, поэтому любой элемент в Trash недоступен для использования и не может быть найден через поиск, страницы браузерного интерфейса или из Altium Designer.
Вы поймете, что команда на основе Delete в интерфейсе Workspace или Altium Designer относится к типу мягкого удаления, поскольку последующее окно подтверждения сообщит, что удаляемый(е) элемент(ы) будут перемещены в Trash.
Когда вы удаляете элемент в Workspace с помощью мягкого удаления, он перемещается в Trash. Страница Trash предоставляет интерфейс к этой изолированной области Workspace.
Вы будете видеть только те элементы, которые были мягко удалены вами. Администратор будет видеть все мягко удаленные элементы в Trash. Список включает данные в столбцах, соответствующие идентификационной информации, а также сведения о том, когда и кем элемент был удален. Вы можете сортировать по любому из столбцов — щелкните заголовок столбца один раз для сортировки по возрастанию и еще раз для сортировки по убыванию. Используйте поле Search над списком для поиска по всему содержимому.
Выберите элемент в Trash, затем используйте элементы управления в правом верхнем углу списка, чтобы соответственно удалить этот элемент окончательно или восстановить его. Соответствующие команды также доступны из меню, связанного с элементом управления
(в крайней правой части выбранного элемента).
-
Для Project только владелец или администратор может выполнить (мягкое) удаление или восстановление. Для любого другого элемента вы сможете выполнять эти действия при наличии у вас editing rights.
- Полное «жесткое» удаление элемента (Permanently Delete) доступно только администраторам Workspace.
Выберите элемент, затем решите, нужно ли полностью восстановить его для повторного использования или удалить безвозвратно (то есть выполнить «hard delete»).
Либо, чтобы очистить весь Trash одним пакетным действием, нажмите кнопку
в левом верхнем углу страницы. Появится окно подтверждения, уведомляющее о том, что это действие навсегда удалит все элементы и после этого их невозможно будет восстановить. Чтобы продолжить, нажмите кнопку
.
При попытке безвозвратно удалить элемент (hard delete) система не позволит сделать это, если данный элемент используется родительским элементом — например, компонент, который используется на управляемом листе схемы или в проекте.
Элементы интерфейса только для администраторов
В следующих разделах кратко описаны элементы интерфейса браузера Workspace, к которым only могут получать доступ административные пользователи Workspace — те, кто входит в группу Administrators. Доступ к этим элементам осуществляется через специальную область Admin в дереве навигации слева.
Admin – Settings
На этой странице представлена коллекция подстраниц для настройки параметров, относящихся к различным функциям и службам, предоставляемым Workspace и через него.
Область Admin – Settings, являющаяся частью страниц только для администраторов в интерфейсе браузера Altium Lifecycle Workspace.
При изменении любых настроек обязательно нажимайте кнопку
в правом верхнем углу страницы.
В левой части страницы находится дерево навигации, позволяющее быстро переходить к различным подстраницам настроек. Доступны следующие страницы:
General
Используйте эту страницу, чтобы при необходимости изменить имя, адрес сервера и описание Workspace. На странице также приводится информация о расположении Workspace только для чтения. Изменения может вносить только администратор, который одновременно является владельцем Workspace, но не любой другой администратор этого Workspace.
Projectѕ
Используйте эту страницу, чтобы указать путь по умолчанию (в структуре папок Workspace), а также при необходимости разрешения на общий доступ для вновь создаваемых проектов. Проекты будут создаваться в указанной записи папки Default path for new projects, если только уже не открыта папка (в этом случае проект будет создан в ней) или в поле Parent Folder окна Create Project в разделе Advanced не был указан другой путь — дополнительную информацию см. в разделе Creating a New Project.
Пользователям, которые создают или загружают проекты, потребуется доступ к этой папке проекта по умолчанию (изначально Projects), который определяется ее разрешениями общего доступа, заданными на странице Explorer Workspace — дополнительную информацию см. в разделе Sharing Folders and Items. Обратите внимание, что если пользователь не имеет доступа к папке проекта по умолчанию (и не открыта другая папка), система создаст структуру Personal Folder, включающую папку My Projects для хранения проекта — дополнительную информацию см. в разделе Project Creation Without Folder Write Access.
Разрешения для нового проекта всегда включают администраторов и пользователя, создавшего проект (его «владельца»). Также включается набор разрешений, унаследованный от родительской папки, если это не переопределено параметром Default permissions for new projects. Если этот параметр доступен и включен, его настройки будут применять к вновь создаваемым проектам указанный набор прав доступа, а не права, унаследованные от родительской папки — связанную информацию см. в разделе Default Project Creation Permissions.
Администратор может определить настройки по умолчанию для вновь создаваемых проектов. Изначально путь задан как Projects, а параметр Default permissions отключен.
Email Notifications
На этой странице находится переключатель для включения функции email-уведомлений Workspace. Эта возможность уведомляет ключевых заинтересованных лиц о различных событиях, связанных с элементами компонентов, проектами и запросами на детали.
Дополнительную информацию см. на странице Email Notifications page.
Altium 365 использует Amazon SES (Simple Email Service) в качестве сервера отправки email. Это тот же сервис, который Altium использует для отправки писем, связанных с учетной записью Altium Account (например, активации учетной записи).
Также доступен расширенный параметр Process Workflows и связанное с ним Send a notification when no updates have been made to a workflow task for <number> days уведомление. Если эта функция включена, пользователи с активной задачей, требующей завершения шага workflow, будут получать уведомление-напоминание, если в течение указанного количества дней не было предпринято никаких действий.
Access Control
Заголовок раздела Access Control объединяет настройки, используемые для управления потоком данных Workspace в целях безопасности. Этот параметр доступен администраторам с Altium 365 GovCloud или когда для вашей организации включено решение уровня Altium Entreprise .
-
Inbound Traffic – используйте эту страницу, чтобы указать IP-адреса, диапазоны IP-адресов или подсети, которым разрешен доступ к вашему Workspace. IP-фильтрация применяется с использованием метода записи Classless Inter-Domain Routing (CIDR) с одной записью для блокировки входящих подключений вне указанного IP-диапазона. Фильтрация входящего трафика обеспечивает более тонкий контроль над тем, кто может подключаться к Workspace вашей компании, и, например, может ограничивать входящий доступ диапазоном допустимых IP-адресов или IP-адресом официальной конфигурации VPN. Можно добавить несколько записей фильтра IP.
Пользователи, пытающиеся подключиться к Workspace с IP-адреса, который не проходит примененный фильтр, получат сообщение о блокировке доступа.
-
Outbound Traffic – доступно только в Workspace Altium 365 GovCloud, размещенном в США. Используйте эту страницу для включения/отключения определенного трафика к внешним пользователям или местоположениям, потенциально находящимся за пределами США, в соответствии с политиками компании и государственными нормативами. Каждый параметр, представленный на странице, применяется к данным, которые могут отправляться из Workspace при использовании соответствующей функции — связанную информацию см. в примечаниях.
-
Supply Chain Data Acquisition: Если флажок снят, этот параметр отключит запросы данных, такие как запросы данных Manufacturer Part Number (MPN), отправляемые к внешним источникам данных о деталях. Это отключит автоматические запросы деталей, отправляемые во внешние источники и сервисы данных о деталях.
-
External Project Share and Manufacturer Packages: Если флажок снят, этот параметр запретит совместный доступ к данным проекта для внешних пользователей — тех, кто не является зарегистрированным участником Workspace. Попытки сделать это будут проигнорированы или приведут к сообщению об ошибке.
-
PLM Integration: Если флажок снят, этот параметр запретит запросы данных, отправляемые во внешние PLM-системы. При выполнении таких действий, как синхронизация деталей, данные компонентов Workspace не будут передаваться в удаленный экземпляр PLM, что приведет к ошибке LibSync.
-
Silicon Expert Integration: Если флажок снят, этот параметр запретит отправку запросов данных компонентов в сервис данных о деталях производителя Silicon Expert. Попытка активировать сервис приведет к предупреждению/сообщению об ошибке.
-
Z2Data Integration: Если флажок снят, этот параметр запретит отправку запросов данных компонентов в сервис данных о деталях производителя Z2Data. Попытка активировать сервис приведет к предупреждению/сообщению об ошибке.
Vault
Заголовок раздела Vault объединяет настройки, относящиеся к определенной функциональности внутри самого Workspace.
-
Legacy Part Requests (если доступно в вашем Workspace) – включает настройки, связанные с доступом и конфигурацией функции Legacy Part Request, в отличие от основанной на процессах функции Part Requests. Установите флажок Legacy Parts Request Active, чтобы включить старую версию Parts Requests. Подразделы здесь относятся к этой версии:
-
Librarians Role – используйте эту страницу, чтобы указать, какая группа пользователей (или группы) должна использоваться для выполнения роли библиотекарей в вашей организации. По сути, вы просто настраиваете набор пользователей вашего Workspace, которым можно назначать legacy-запрос на деталь. Пример группы Librarians уже будет предварительно заполнен здесь.
-
Custom States – используйте эту страницу для настройки открытых и закрытых состояний функции Legacy Part Request.
-
Lifecycle Definitions – используйте эту страницу для определения и управления lifecycle-определениями вашего Workspace, дополняя возможность делать это через Altium Designer. Обеспечивая лучшую наглядность состояний и переходов, каждый lifecycle строится графически для отображения соответствующих потоков.
Эта страница также включает параметры для включения дополнительных функций, которые станут доступны при редактировании компонентов на базе Workspace в Altium Designer (нажмите
, чтобы подтвердить измененную настройку):
-
Data Cleanup – используйте эту страницу, чтобы быстро удалять элементы данных из вашего Workspace. Это особенно полезно после экспериментов с созданием и выпуском содержимого в Workspace, например при тестировании миграции неуправляемых библиотек, когда затем требуется «очистить» такие экспериментальные данные. Эта функция работает с любыми типами элементов в вашем Workspace.
Используйте доступные флажки, чтобы определить, удалять ли все элементы данных (All) или только элементы определенных типов. После настройки стратегии очистки нажмите кнопку
. Появится окно с запросом подтверждения и предупреждением о том, что это действие нельзя отменить. Чтобы подтвердить и продолжить, введите текст Delete my data permanently в поле, затем нажмите
.
Обратите внимание, что дочерние элементы нельзя удалить, если на них уже есть ссылки (они используются) со стороны родительских элементов. Сначала необходимо удалить родительские элементы. Например, если компонент используется на управляемом листе или в проекте, сначала нужно удалить управляемый лист и/или проект.
Помните, что очистка данных — это действие, которое нельзя отменить. Перед удалением данных автоматически будет создан снимок вашего Workspace. Также учтите, что операции очистки данных могут выполняться некоторое время в зависимости от объема данных.
MCАD CoDesigner
На этой странице представлены элементы управления для включения распознавания компонентов между доменами ECAD и MCAD при использовании функции ECAD-MCAD CoDesign. Это облегчает использование native components, когда проект передается между двумя доменами. Доступны следующие параметры.
-
Specify how transferred ECAD models are named – задает соглашение об именовании, используемое для моделей при первоначальной передаче в домен MCAD. По умолчанию установлено значение <FootprintName><ComponentID>, которое можно изменить на <ComponentID><FootprintName> или <CustomComponentProperty><FootprintName>.. В последнем случае используйте поле Custom Component Property (в противном случае установлено значение PARTNO), чтобы определить пользовательское свойство, которое вы хотите использовать в имени компонента MCAD. Этот параметр позволяет инженерам включать в идентификацию компонента значимую информацию, например подробные данные о номере детали.
-
Recognize models placed in MCAD and use true electrical components in ECAD instead – включите эту опцию, чтобы обеспечить поддержку использования native components, когда плата передается из MCAD и затем загружается в ECAD. 3D-модель MCAD связывается с эквивалентным компонентом Altium Designer, поэтому при загрузке платы в Altium Designer 3D-модель MCAD может быть заменена экземпляром полностью определенного посадочного места компонента Altium Designer, включая 3D-модель. Используйте два вложенных поля, чтобы определить свойство модели MCAD и параметр компонента ECAD, используемые для идентификации компонентов в двух доменах проектирования. По умолчанию эти поля заполнены значением PARTNO. Поле MCAD model property может содержать ваше собственное пользовательское свойство, либо можно выбрать MCAD model name из раскрывающегося списка. Поле ECAD component parameter также может содержать ваш собственный пользовательский параметр. Эти поля обязательны, если включена родительская опция. Если одно или оба поля оставить пустыми, кнопка
будет недоступна.
-
Use models from data management system on MCAD side when creating PCB assembly – включите эту опцию, чтобы обеспечить поддержку использования native components, когда плата передается из ECAD и затем загружается в MCAD. Программное обеспечение MCAD получает модель компонента из системы управления данными MCAD (по имени модели), а затем размещает этот компонент на сборке печатной платы в MCAD вместо модели, пришедшей из ECAD. Используйте вложенное поле, чтобы определить параметр компонента ECAD, который будет использоваться для хранения имени модели MCAD. По умолчанию это поле заполнено значением MCADModelName. Это поле обязательно, если включена родительская опция. Если оставить его пустым, кнопка
будет недоступна.
Связывание компонентов MCAD-to-ECAD доступно для всех поддерживаемых платформ MCAD (кроме Autodesk Fusion®). Связывание native components ECAD-to-MCAD в настоящее время поддерживается только в:
SOLIDWORKS – требуется, чтобы SOLIDWORKS был подключен к системе SOLIDWORKS PDM. Компонент MCAD должен быть определен в компоненте ECAD как параметр в формате "<vault>:folder\folder\component.sldprt", где <vault> — имя PDM-хранилища. Информацию о подключении к системе SOLIDWORKS PDM см. в документации SOLIDWORKS. Если компонент недоступен в системе SOLIDWORKS PDM, CoDesigner вместо этого размещает модель, переданную из редактора PCB и сохраненную в Workspace Altium 365.
PTC Creo Parametric – требуется, чтобы PTC Creo был подключен к серверу PTC Windchill®, а компоненты ECAD хранились в Windchill Workspace. Информацию о подключении к Windchill см. в документации Creo. Если компонент недоступен в Windchill Workspace, CoDesigner вместо этого размещает модель, переданную из редактора PCB и сохраненную в Workspace Altium 365.
Siemens NX – требуется, чтобы Siemens NX был подключен к Siemens Teamcenter PLM. Информацию о подключении к Teamcenter PLM см. в документации Siemens NX. Ссылка на компонент MCAD должна быть определена в компоненте ECAD как параметр, включающий путь Teamcenter, со значением параметра в формате :root_TC_folder:subfolder1:subfolder12:model_name.
CoDesigner проверяет эти настройки при запуске (из Altium Designer и из инструментов MCAD). Перезапустите ваше ПО для проектирования, если настройки были изменены в Workspace.
PLM Integration
Доступно, когда для вашего Workspace Altium 365 включена функция PLM Integration. На этой странице доступна опция Enable new PLM Configuration, которая при снятии флажка возвращает пользовательский интерфейс PLM Integration к previous system
, основанной на загрузке отредактированных конфигурационных файлов.
См. PLM Integration для получения дополнительной информации.
Dictionaries
Используйте эту страницу для создания пользовательских параметров с несколькими заданными значениями (Dictionaries), которые можно применять к шаблонам компонентов через Altium Designer. Можно добавить несколько словарей параметров, при этом каждая запись будет содержать список соответствующих значений параметра. При использовании этот подход обеспечивает более формализованный контроль применения данных параметров, когда стандартизованные параметры и варианты их значений централизованно управляются в одном доступном месте.
Создавайте предопределенные списки значений параметров с помощью опции Dictionary в разделе Admin - Settings.
Чтобы добавить запись Dictionary, нажмите кнопку
, затем в следующем окне Create Dictionary введите подходящее имя типа параметра. Добавляйте значения параметров с помощью опции
, связанной с именем записи Dictionary, — нажмите Enter, чтобы подтвердить введенное значение.
Можно создать несколько Dictionaries с несколькими значениями параметров.
-
Дважды щелкните запись или используйте связанную опцию
, чтобы изменить имя или значение Dictionary.
-
Используйте связанную опцию
, чтобы добавить новое значение в Dictionary.
-
Используйте связанную опцию
, чтобы удалить запись значения или саму запись Dictionary.
В Altium Designer Dictionaries, созданные в Workspace Altium 365, становятся доступными как Parameter data Types при создании или редактировании Component Template. Если этот Template используется для creating a new component — или при редактировании компонента, основанного на этом Template, — записи параметров, определенные в Dictionary, будут предлагать только те значения, которые заданы в Dictionary Workspace. Обратите внимание, что параметры на основе Dictionary обозначаются соответствующим значком.
Дополнительную информацию см. в разделе Support for Dictionary-defined Component Parameter Data Types в Component Editor Altium Designer.
Checklists
На этой странице представлен список доступных контрольных перечней соответствия, применяемых к проекту Design Reviews. Каждый именованный Checklist состоит из нескольких описательных пунктов, которые можно отметить как «проверено» в ходе процесса Design Review. В список входят два примера Checklist (проверка PCB и Schematic), которые можно использовать как есть или взять за основу для создания пользовательских Checklist.
Существующие Checklist можно редактировать или удалять, а также создавать дополнительные Checklist с помощью кнопки
. Набор пунктов проверки в списке состоит из простых текстовых утверждений, расположенных в нескольких строках — нажмите Enter, чтобы добавить новую строку.
Новые Checklist также можно создавать, редактировать и сохранять на странице Overview экземпляра Design Review.
См. Design Reviews для получения дополнительной информации о работе с Checklist в экземплярах Design Review.
Audit Export
На этой странице представлены параметры конфигурации для предоставления данных Events Log рабочего пространства Altium 365 в подходящую SIEM-систему (Security Information and Event Management) в целях соответствия требованиям и аудита. API Workspace позволяет специалисту по безопасности вашей организации настроить SIEM-систему для получения данных аудита из Altium 365 с использованием параметров Client ID и Secret Key, указанных на этой странице администратором Workspace.
Откройте раскрывающийся раздел ниже, чтобы увидеть связанную техническую информацию по настройке для специалистов по безопасности.
Audit Logs Exposure Usage
Представленная здесь информация об API Altium 365 предназначена для специалиста по безопасности организации, которому при настройке импорта данных из Altium 365 следует использовать поддержку, доступную в его SIEM-решении.
Этот веб-сервис предназначен для аудита и отслеживания событий в Workspace. API поддерживает постраничный вывод с ограничением (Limit Pagination), аутентификацию через Client ID и динамически генерируемый Secret Key. В ответе на запрос подробная информация о событиях доступна в формате JSON, при этом имена полей соответствуют Common Event Format (CEF).
Обратите внимание, что этот сервис доступен только при наличии действующей лицензии. Доступ и использование ограничены лицензированными Workspace.
Как использовать сервис
-
How to get endpoint and parameters
Чтобы получить доступ к конечной точке сервиса и параметрам, пользователи с административными правами должны перейти на страницу Admin – Settings в Workspace.
Если Workspace имеет необходимую лицензию, будет доступна опция Audit Export.
При выборе этой опции откроется страница с URL для получения данных, а также с Client Id и Secret Key. Если вы открываете эту страницу впервые, поле Secret Key не будет заполнено. Чтобы получить значение, нажмите кнопку
. Если ключ уже был создан, он будет доступен сразу же.
Если по какой-либо причине необходимо аннулировать текущий ключ, после его генерации станет доступно действие кнопки
. Это действие предотвращает получение данных с использованием предыдущего, теперь уже отозванного, ключа.
Используйте кнопку
, связанную с каждым полем, чтобы при необходимости скопировать его содержимое.
-
How to use Endpoint
Обзор
Эта конечная точка API предназначена для получения событий аудита. Для получения данных используется постраничный вывод с ограничением. Это означает, что мы возвращаем общее количество событий и текущий набор событий, определяемый параметрами Limit и Offset. Например, при первом запросе данных событий пользователь может вообще не передавать никаких параметров — в этом случае мы вернем набор событий с параметрами по умолчанию.
В качестве альтернативы пользователь может указать параметры в своем запросе, такие как Offset = 0 и Limit = 500. В этом случае мы вернем события, начиная с самого первого и до указанного лимита. Если событий меньше указанного лимита, будут возвращены все доступные события.
Важно отметить, что пользователи этого API должны на своей стороне отслеживать текущую позицию в журналах, чтобы последовательно запрашивать события. Например, если всего имеется 1000 событий и пользователь первоначально передает Offset = 0 и Limit = 500, то следующий запрос должен содержать Offset = 500, чтобы получить оставшиеся события.
Аутентификация
Доступ к этой конечной точке требует передачи идентификатора клиента (ClientId) и клиентского секрета (ClientSecret) в заголовках запроса. Если один из них отсутствует или неверен, возвращается ответ Unauthorized.
Параметры запроса
Offset (optional): Смещение от начала результата. Позволяет управлять тем, с какой записи начинать возврат данных.
Limit (optional): Максимальное количество записей для возврата. Существует ограничение на максимально допустимое значение, которое не должно превышать установленный максимум для этого API.
Ответы
200 OK: Успешный ответ содержит события аудита, соответствующие указанным критериям.
400 Bad Request: Возвращается , если количество записей, указанное в запросе, превышает максимально допустимый предел.
401 Unauthorized: Возвращается, если аутентификация клиента не удалась из-за отсутствующих или неверных заголовков ClientId или ClientSecret, либо из-за отсутствия лицензии.
Пример запроса
GET your-endpoint-url?Offset=0&Limit=500
Заголовки:
ClientId: your-client-id
ClientSecret: your-client-secret
Response
Стандартный ответ для API-запросов, возвращающих события аудита в формате JSON с полями, именованными в соответствии с Common Event Format (CEF).
Определение объекта
Стандартная структура объекта ответа:
TotalCount (int): Общее количество записей, доступных для получения. Это значение представляет количество всех событий, соответствующих критериям запроса.
Events (List of Events): Список событий в формате JSON CEF. Каждый элемент этого списка представляет отдельное событие.
Структура события:
CefVersion (string): Версия формата CEF. (Current version = 1)
DeviceVendor (string): Идентификатор производителя устройства. В сочетании с DeviceProduct и DeviceVersion он однозначно определяет тип отправляющего устройства. (Predefined: Altium)
DeviceProduct (string): Идентификатор продукта устройства. В сочетании с DeviceVendor и DeviceVersion он однозначно определяет тип отправляющего устройства. (Predefined: 365 Platform)
DeviceVersion (string): Идентификатор версии устройства. В сочетании с DeviceProduct и DeviceVendor он однозначно определяет тип отправляющего устройства. (Predefined: Cloud)
DeviceEventClassID (string): Уникальный идентификатор для каждого типа события.
Name (string): Понятный человеку заголовок или описание события.
Extension (Object): Объект, содержащий сведения о событии.
Структура расширения:
Dvchost (string): Полное доменное имя (FQDN) устройства, если доступно.
Msg (string): Сообщение, дополнительно описывающее событие.
Rt (DateTime): Время получения события.
Dtz (TimeSpan): Часовой пояс устройства, сгенерировавшего событие.
Suser (string): Имя исходного пользователя, связанного с событием.
Act (string): Действие, указанное в событии.
ExternalId (string): Идентификатор, используемый исходным устройством. Обычно эти значения идут последовательно и связаны с каждым событием.
Cat (string): Категория, назначенная исходным устройством. Устройства часто используют собственные схемы категоризации для классификации событий.
Пример ответа
{
"TotalCount": 2,
"Events": [
{
"CefVersion": "1",
"DeviceVendor": "Altium",
"DeviceProduct": "365 Platform",
"DeviceVersion": "Cloud",
"DeviceEventClassId": "",
"Name": "User Login",
"Extension": {
"dvchost": "host.domain.com",
"msg": "User successful login",
"rt": "2024-01-10T14:30:00Z",
"dtz": "UTC+00:00",
"suser": "sampleuser",
"act": "login",
"externalId": "45678",
"cat": "authentication"
}
},
{
// Additional Events
}
]
}
BOM Portal
Приложение Altium 365 BOM Portal позволяет создавать насыщенные данными документы закупки BOM из проектных данных Workspace или из загруженных файлов ECAD BOM (CSV/XLS). Используя комплексные сервисы данных Altium, документы Managed BOM в Portal включают актуальную информацию о производителях компонентов и данные Supply Chain в реальном времени из нескольких источников. Эта веб-система автоматизирована, обладает высокой гибкостью настройки и предлагает расширенные возможности поиска для определения оптимальных компонентов для ваших проектных разработок.
См. страницу BOM Portal page для получения дополнительной информации.
Используйте эту страницу настройки, чтобы указать параметры по умолчанию для вновь создаваемых/загружаемых документов Managed BOM. Эти настройки можно изменить относительно значений по умолчанию в отдельных документах Managed BOM через окно BOM Settings window.
-
General Settings: Укажите значения по умолчанию для параметров закупки Currency и Country. Они независимы друг от друга, поэтому предпочтительная валюта закупки не привязана к местоположению.
-
Releases
-
Default Release Name: Задайте имя по умолчанию для Releases, генерируемых в BOM Portal. Оно может состоять из стандартных и пользовательских параметров проекта, а также обычного текста, чтобы при необходимости создать составную схему именования релизов. Обязательно сохраняйте все обновленные настройки (
). См. BOM Portal Release Naming для получения дополнительной информации.
-
Prevent Release with Error and Fatal Error Issues: Укажите, должны ли ошибки, обнаруженные для компонентов BOM, препятствовать их выпуску. Когда эта опция включена, Release process в BOM Portal блокируется, если обнаруживается часть BOM Check с Error или Fatal Error, как определено в Checks Manager
Report Levels приложения.
Также обратите внимание, что процесс Release временно блокируется, пока выполняются активные BOM Checks.
-
Favorite Suppliers:Укажите поставщиков компонентов по умолчанию, включенных для документов Managed BOM. Дополнительную информацию см. в разделе BOM Portal Order List section. Обратите внимание, что доступные поставщики, включенные в Favorite Suppliers list, в свою очередь определяются параметрами Altium Parts Provider settings на странице Workspace Part Providers page.
-
Checks Manager: Укажите, как в документах BOM должны отображаться проблемы строк BOM. Для каждого типа проверки корректности BOM можно настроить вывод на любом из доступных Report Levels, включая возможность игнорировать проверку (No Report). Дополнительную информацию см. в разделе BOM Portal BOM Checks section.
-
BOM Templates – управление документами шаблонов BOM в формате Excel, которые можно применять при загрузке файлов WIP BOM files или Released BOM files.
Список файлов включает параметры для изменения Lifecycle State записи (с помощью стандартных уровней, таких как Draft, Prototype и Obsolete), Download или Delete записи (перемещение в Trash), а также для добавления обновленной ревизии к записи путем загрузки исправленного файла шаблона с помощью Create New Revision – разверните запись, чтобы увидеть ее предыдущие Revisions.
Используйте кнопку
, чтобы выбрать и добавить новый файл шаблона из локальных источников. См. также related Altium Designer information.
Прокрутите страницу, чтобы просмотреть все параметры конфигурации BOM Portal.
Requirements Portal
Requirements Portal — это продвинутое приложение системной инженерии, интегрированное с Altium 365 для определения и управления техническими требованиями к проектам. Экземпляры требований, созданные в портале, могут размещаться в проектных документах Altium 365 Workspace, а также назначаться как пользовательские Tasks. Соответствие определению Requirement затем можно проверить в пространстве проектирования, а его статус синхронно отражается в экземпляре Requirement в Requirements Portal.
Дополнительную информацию см. в разделе Working With Requirements.
Синхронная связь между вашим Altium 365 Workspace и Requirements Portal определяется сопоставлением проекта Workspace с блоком System Design Block портала, который имеет связанные определения Requirement. Эту связь можно установить в разных местах:
-
В веб-интерфейсе Requirements Portal, назначив Block типа Electronics проекту разработки Workspace — related information.
-
В окне Edit Project Workspace design, назначив Block портала проекту разработки Workspace — related information.
-
В представлении записи Requirements Portal на странице Workspace Admin - Settings pageLink Requirements, добавив новую связь Project-Block в список — см. ниже.
Используйте параметр Requirements Portal в меню с девятью точками (
), чтобы открыть интерфейс Requirements Portal в новой вкладке браузера.
Jira Integration
Altium 365 Jira Integration обеспечивает двунаправленную синхронизацию данных между Atlassian Jira® issues и Workspace Tasks в Altium 365. Интеграция позволяет удаленно создавать Jira issues непосредственно из вашего Altium Workspace как выделенные Jira Tasks, либо связывать существующие Jira Issues с проектом Workspace.
После установления связи Jira Issue с Workspace Task их Comments и параметры статуса (priority, progress, assignee) синхронизируются в реальном времени, что обеспечивает более глубокое и интерактивное управление проектами Altium в пространстве Jira. Интеграция Jira настраивается путем сопоставления проектов Workspace с указанным проектом Jira.
Дополнительную информацию см. в разделе Working With Jira Tasks.
Страница настройки Jira Integration включает следующие дополнительные параметры:
-
Кнопка
открывает представление по умолчанию для вашей учетной записи Jira в новой вкладке браузера.
-
Кнопка
отключает приложение Jira от вашей учетной записи Jira, указанной в Jira Connection. После этого страница Jira Integration возвращается в исходное состояние до настройки.
-
Когда включен параметр Enable Jira mapping for project editors (в разделе Access Settings), участники Workspace могут сопоставлять проект — при наличии прав на редактирование — с проектом Jira, указанным в этой конфигурации. Сопоставление проекта выполняется из окна проекта Edit window — см. mapping access example. Администраторы Workspace могут сопоставлять design Projects с Jira Projects через окно проекта Edit независимо от этого параметра доступа.
Admin – Groups
Related page: Управление участниками Workspace — Groups
Эта страница используется для создания и управления списком групп пользователей (участников Workspace). Группы позволяют дополнительно организовать участников Workspace, например по подразделению организации, в котором они работают, или по команде разработчиков, в которую они входят. Группы также упрощают совместный доступ к содержимому Workspace и настройку других предоставляемых технологий.
Используйте параметры записи Group для управления ее составом пользователей (Edit), просмотра проектов, предоставленных имени Group (Review Accesses), и удаления категории Group (Remove).
Получить доступ к группам, определенным для вашего Workspace, и управлять ими можно на странице интерфейса Admin – Groupspage. Для Workspace определено несколько примеров групп, включая группу Administrators. Эта группа предоставляет своим участникам административные привилегии. Любой участник этой группы имеет полный доступ к Workspace и всем связанным технологиям и сервисам через его браузерный интерфейс.
Admin – Configurations
Related page: Управление конфигурацией среды
Страница Configurations предоставляет средства для формализации рабочей среды участников Workspace на основе назначенной им Group. На практике экземпляры конфигурации используются для ограничения рабочей среды Altium Designer каждого разработчика так, чтобы использовались только утвержденные компанией элементы проектирования, включая шаблоны, файлы конфигурации output job, настройки workspace и другое. Можно создать любое количество Configurations и назначить их группам пользователей (Roles) по мере необходимости.
Определяйте и управляйте конфигурациями среды разработчиков на странице Workspace Configurationspage.
Admin – Part Providers
Related page: Настройка источников компонентов
Эта страница позволяет определить Part Source — тем самым обеспечивается централизованное управление цепочкой поставок, при котором разработчики по всей организации используют один и тот же утвержденный список Suppliers для получения данных supply chain intelligence по компонентам, используемым в их проектах.
Для Workspace доступны следующие источники компонентов:
-
Altium Parts Provider – агрегированный сервис данных о поставщиках, предоставляющий доступ к актуальной информации о компонентах от широкого круга поставщиков компонентов.
Параметры Altium Parts Provider, заданные в Workspace, будут иметь приоритет над настройками в Altium Designer, когда пользователь подключается к этому Workspace.
-
Custom Parts Provider – для случаев, когда данные поставщиков компонентов поступают (и должны поступать) из внутренней корпоративной системы предприятия, предоставляющей собственный набор данных о поставщиках компонентов, который может основываться на локальных складских запасах, строго утвержденном наборе поставщиков и/или специальных схемах ценообразования. Этот источник компонентов фактически настраивается для синхронизации через Altium Designer — с использованием документа Custom Parts Provider Synchronization Configuration (*.PrtSync) — что позволяет сопоставить данные поставщиков из указанного источника базы данных с данными цепочки поставок Workspace.
Фактические данные supply chain intelligence — включая Manufacturer (и part number), Supplier (и part number), Description, Pricing и Availability — поступают из локального Part Catalog Workspace и соответствующего Part Source.
Каждый экземпляр Workspace имеет собственный выделенный Part Catalog. Это база данных каталога компонентов, предназначенная для управления и отслеживания деталей производителя и связанных с ними деталей поставщика. Каталог устанавливается как сервис (Part Catalog Service), предоставляется через платформу Altium 365 и работает только с Workspace.
Каталог компонентов хранит элементы, представляющие реальные детали производителя, а также один или несколько элементов, представляющих детали поставщика — варианты этих деталей производителя, продаваемые поставщиками/вендорами. Каждая деталь поставщика является ссылкой на элемент в базе данных компонентов — либо в агрегированной базе данных компонентов Altium Parts Provider (которая, в свою очередь, взаимодействует с включенными поставщиками и собирает от них данные о компонентах), либо в подключенной локальной базе данных компонентов.
Включение необходимых поставщиков и определение диапазонов местоположения/валюты для Altium Parts Provider.
Администрирование – PLM Integration
Related page: PLM Integration
Эта страница предоставляет интерфейс для Workspace Altium 365 PLM Integration service. Именно здесь определяется взаимодействие с экземпляром PLM и включается/настраивается синхронизация компонентов вашей PLM с компонентами в Workspace.
Workspace поддерживает одно- или двунаправленную синхронизацию данных компонентов с корпоративными системами вашей компании. Взаимодействие между данными Workspace и корпоративной системой — обычно системой PLM — настраивается и управляется через страницу PLM Integration. Она предоставляет автоматизированный интерфейс для удобной настройки соединения, сопоставления данных параметров и указания направления синхронизации данных. Синхронизация данных компонентов между Workspace и целевой корпоративной системой использует встроенный процесс синхронизации, который можно запускать вручную или настроить как повторяющееся событие по расписанию.
Workspace поддерживает следующие PLM-системы:
Настройка интеграции PLM выполняется через автоматизированный интерфейс для удобной настройки соединения, сопоставления данных параметров и указания направления синхронизации данных.
Администрирование – Processes
Related pages: Создание и управление процессами, Определение workflow процесса
Эта страница предоставляет интерфейс для создания и управления Process Workflows, которые формально направляют разработчиков компании в рамках типовых повседневных процессов проектирования, таких как:
-
Запрос новых библиотечных компонентов.
-
Выполнение действий, связанных с проектом, таких как проверки или публикация в PLM.
-
Создание новых проектов.
Каждый Workflow, используемый для реализации определенного процесса проектирования, создается как часть Process Definition. Поэтому его можно назвать базовым Workflow этого процесса или просто Process Workflow. Процессы и их Workflow создаются и управляются через интерфейс страницы Processes, где можно включать для использования ряд предопределенных процессов либо клонировать и изменять их под свои потребности с помощью включенного Process Workflow Editor.
Администрирование – Explorer
Related page: Управление структурой содержимого и доступом
Эта страница предоставляет вам доступ к структуре Workspace и по представлению и компоновке похожа на панель Explorer в Altium Designer. Отсюда вы можете просматривать папки и элементы внутри Workspace. Вы также можете создавать и редактировать папки, формируя структуру Workspace, без необходимости подключаться к этому серверу через Altium Designer.
Из этого интерфейса также можно задавать общий доступ на уровне папок и элементов, определяя, кто может видеть тот или иной контент в Workspace и, на уровне папки, могут ли другие пользователи только просматривать папку и ее содержимое либо также редактировать их (фактически выпускать/фиксировать/загружать в нее данные проекта). Контент можно загружать из Workspace непосредственно из этого интерфейса.
Обратите внимание, что многие функции страницы Explorer, особенно в части управления папками и проектами, можно выполнять через страницу Projects Workspace и функции Library.
Просматривайте и задавайте структуру вашего Workspace, а также определяйте доступ к его содержимому и возможность его загрузки.
Из Admin – Explorer страницы можно выполнять мягкое удаление папок и элементов, отправляя их в изолированную Trash область Workspace.
Администрирование – Usage and Billing
Эта страница предоставляет информацию о подписке и распределении пользователей для решения Altium Develop .
На вкладке Usage and Billing этой страницы вы можете управлять своей подпиской Altium Develop. Если у вас нет подписки, нажмите кнопку
в правом верхнем углу страницы, чтобы открыть окно Subscribe, где можно указать данные подписки (необходимое количество авторских лицензий Altium Designer Develop, адрес для выставления счета, способ оплаты и т. д.).
Если у вас есть подписка, информация о ней будет показана на странице.
Вы можете просматривать сведения о подписке и управлять ими следующим образом:
-
Нажмите плитку Altium Designer Author Seats , чтобы открыть окно Author Seats, где можно управлять количеством авторских лицензий Altium Designer Develop (
).
-
Нажмите плитку Next Payment , чтобы открыть окно Next Payment, в котором отображаются сведения о следующем платеже (
).
-
Нажмите плитку Payment Method , чтобы открыть окно Payment Method, где можно изменить сведения о текущем способе оплаты (
).
В области Simultaneous Author Seats страницы вы также можете видеть списки пользователей, которые в данный момент подключены к Workspace из Altium Designer Develop. У этих пользователей в столбце Taken Online будет отображаться текст Status. Пользователя можно отключить, нажав значок
, тем самым освободив авторское место для другого пользователя.
Как администратор Workspace, вы можете зарезервировать авторское место за конкретным пользователем, фактически позволяя ему работать офлайн в режиме roaming в течение срока подписки. Для этого нажмите элемент управления Reserve Seat в области Simultaneous Author Seats. В открывшемся окне Reserve Seat используйте поле User для поиска и выбора участника команды Workspace, для которого нужно зарезервировать авторское место, затем нажмите кнопку
. Выбранный пользователь появится в списке с текстом Reserved Seat в столбце Status. Нажмите значок
, чтобы отменить резервирование места для этого пользователя.
Дополнительные сведения о roaming авторского места из Altium Designer Develop см. на странице Authoring Access in Altium Designer Develop.
Вкладка Quotes and Invoices этой страницы содержит историю ваших финансовых действий по подписке Altium Develop.
Администрирование – Events Log
Events Log — это последовательный список значимых событий данных и пользователей, произошедших в Workspace. Он предоставляет администраторам единую точку доступа для мониторинга и аудита ключевой активности Workspace в целях управления данными. Эта возможность доступна администраторам, когда для вашей организации включено решение уровня Altium Enterprise.
Журналируемые события включают добавление, удаление и назначение пользователей в группы (участников Workspace), добавление и удаление данных проектов/компонентов, а также предоставление общего доступа к этим данным пользователям. Для каждой записи события приводится подробная информация, например когда оно произошло, кто инициировал событие и какой объект или пользователь был затронут.
Журнал событий администратора фиксирует значимые события, связанные с проектными данными и доступом пользователей.
Используйте поле Search в этом представлении, чтобы отфильтровать список событий и оставить только интересующие вас на основе введенного поискового запроса.
Обновите представление браузера (F5), если недавние события еще не появились в журнале.
Events Log Export to SIEM Systems:
Workspace Altium 365 предоставляет API для передачи данных Events Log в подходящую систему SIEM (Security Information and Event Management) в целях соответствия требованиям и аудита. Обратите внимание, что API SIEM Altium 365 доступен, когда для вашей организации включено решение уровня Altium Enterprise. Дополнительные сведения см. в записи Audit Export выше.
Администрирование – Extensions
Эта страница предоставляет доступ к настройке дополнительных лицензируемых сервисов, доступных в вашем Workspace. Расширения Workspace представлены в виде выбираемых плиток, которые открывают доступ к дополнительной информации и параметрам конфигурации для соответствующего сервиса.
Щелкните плитку расширения, чтобы открыть представление настройки сервиса, где при необходимости можно указать учетные данные подключения и связанные параметры.
SiliconExpert
Интеграция Altium 365 SiliconExpert Integration предоставляет прямой доступ к дополнительному набору расширенных данных о деталях производителей, доступных в документах BOM Portal, документах BOM проекта и в анализе Library Health. Расширенные параметрические данные, получаемые из SiliconExpert, заполняют BOM Workspace в виде отдельных столбцов параметров (YTEOL, Inventory risk и т. д.). Расширенные параметрические данные о компонентах и ранжированные предложения по альтернативным компонентам от SiliconExpert также доступны при использовании функций Supply Chain Information в Altium Designer.
Этот сервис полностью доступен для использования при наличии приобретенной лицензии Altium SiliconExpert Integration. Чтобы включить этот сервис, откройте приложение SiliconExpert, выбрав его плитку, введите учетные данные, предоставленные вам Altium, а затем подтвердите настройки (
). Также обратите внимание, что вы можете ознакомиться с преимуществами интеграции Silicon Expert с вашим Workspace, активировав пробный период (
).
После установки соединения с сервисом SiliconExpert представление SiliconExpert Integration будет заполнено информацией, относящейся к вашей учетной записи. Сюда входят настраиваемый список уровней отчетности и данные параметров:
-
Информация в разделе Part Quota Details включает текущие ограничения квоты и использование данных по компонентам SiliconExpert.
-
Раздел Checks Manager включает настройки уровня отчетности по умолчанию для значений параметров SiliconExpert. Используйте раскрывающийся список, связанный с каждой записью, чтобы выбрать другой уровень отчетности (Fatal/Error/Warning) или вариант No Report, чтобы значение не попадало в отчет. Обратите внимание, что вы также можете редактировать значения Years to End of Life (в годах), которые будут запускать три уровня отчетности YTEOL.
-
Список Data Visibility Settings включает все параметры SiliconExpert, доступные вам. Используйте флажки параметров, чтобы включать или отключать их отображение в списках данных о компонентах (BOM проекта, Managed BOM и т. д.) как в Altium Designer, так и в вашем Workspace Altium 365 — наведите курсор на значки
, связанные с параметрами, чтобы увидеть соответствующую информацию. Обратите внимание, что базовые параметры SiliconExpert YTEOL и Lifecycle доступны всегда, и их состояние видимости нельзя переключать.
Прокрутите страницу, чтобы увидеть все параметры конфигурации SiliconExpert.
Z2Data
Интеграция Z2Data Integration в Altium 365 предоставляет расширенную информацию о деталях производителя и данные цепочки поставок непосредственно в ваш Workspace. Богатые проприетарные источники данных от Z2Data помогают принимать более обоснованные решения при выборе и закупке компонентов, используемых в ваших разработках. Интеграция Z2Data в Altium 365 реализована аналогично SiliconExpert Integration, как описано выше, и доступна в документах BOM Portal, Alternate Parts и Part Choices компонентов Workspace.
Плитка приложения Z2Data включена на странице Admin – Extensions, когда Z2Data Integration включена для вашего Workspace Altium 365. Выберите плитку, чтобы открыть приложение Z2Data, а затем нажмите кнопку
, чтобы получить базовый доступ к ресурсам Z2Data.
После активации доступа к Z2Data представление Z2Data Integration будет заполнено информацией и настройками, относящимися к вашему текущему уровню доступа:
-
Информация в разделе Part Quota Details включает текущие ограничения квоты и использование данных по компонентам Z2Data.
-
Раздел Checks Manager включает настройки уровня отчетности по умолчанию для значений параметров Z2Data. Используйте раскрывающийся список, связанный с каждой записью, чтобы выбрать другой уровень отчетности (Fatal/Error/Warning) или вариант No Report , чтобы значение не попадало в отчет. Обратите внимание, что вы также можете редактировать значения Years to End of Life (в годах), которые будут запускать три уровня отчетности YTEOL.
Обратите внимание, что вы также можете приобрести расширенный уровень доступа к Z2Data, который включает большую квоту данных по компонентам, а также значительно более широкий набор информации и сведений об оценке рисков. Нажмите кнопку
или сразу перейдите к форме доступа Z2Data.