Главная страница: Объекты сервера
Altium Designer в сочетании с сервером управляемых данных позволяет создавать объекты управляемых файлов Outputjob. Такие объекты могут быть созданы:
- С помощью прямого редактирования.
- Путем выгрузки файла конфигурации выходных данных (
*.OutJob) в ревизию целевого объекта.
После того, как объект Outputjob был создан (и в его ревизию были выпущены данные) и его состояние жизненного цикла задано на том уровне, при котором этот объект можно использовать при проектировании, объект можно повторно использовать на уровне проектирования плат.
Кроме того, объект Outputjob Item можно использовать как объект данных конфигурации в одной или нескольких заданных конфигурациях среды (Environment Configurations). Конфигурация среды используется, чтобы ограничить рабочую среду средства проектирования Altium NEXUS использованием только утвержденных компанией проектных элементов. Конфигурации среды определяются и хранятся в Team Configuration Center – службе, которая устанавливается вместе с NEXUS Server и которая отвечает за концепцию управления конфигурацией среды.
Тип папки
При создании папки, в которой будут храниться объекты Outputjob Item, вы можете указать тип этой папки. Это не имеет отношения к содержимому папки – выпуск файла конфигурации выходных данных всегда осуществляется в соответствующий объект Outputjob Item. Таким образом вы лишь обеспечиваете визуальную подсказку о том, что хранится в папке, что может быть полезными при поиске определенного содержимого на сервере. Чтобы указать, что папка используется в качестве контейнера для объектов Outputjob Item, задайте ее тип (Folder Type) как Output Jobs при определении свойств папки в диалоговом окне Edit Folder.
Определение типа папки, т.е. ее планируемого использования, предоставляет визуальную индикацию содержимого этой папки при просмотре данных на сервере.
Схема именования объектов
Другим важным аспектом родительской папки является используемая для нее схема именования объектов (Item Naming Scheme), которая определяет формат уникального идентификатора каждого объекта, создаваемого в этой папке. Доступны несколько примеров схем по умолчанию, использующих краткий код для папок каждого типа (OUTC для набора OutputJob) или для содержимого каждого типа (OUT для OutputJob):
$CONTENT_TYPE_CODE-001-{0000} – например, OUT-001-0001.$CONTENT_TYPE_CODE-001-{A00} – например, OUT-001-A01.$FOLDER_TYPE_CODE-001-{0000} – например, OUTC-001-0001.$FOLDER_TYPE_CODE-001-{A000} – например, OUTC-001-A001.
Используя схему именования по умолчанию, система автоматически назначит следующий уникальный идентификатор на основе этой схемы, просканировав весь сервер и идентификаторы существующих объектов. Это может значительно сэкономить время при создании объектов Outputjob вручную.
Используя схему именования по умолчанию, система автоматически назначит следующий уникальный идентификатор на основе этой схемы, просканировав весь сервер и идентификаторы существующих объектов. Это может значительно сэкономить время при создании объектов стеков слоев вручную.
Для папки также можно определить пользовательскую схему путем ее ввода в поле, с переменной частью в фигурных скобках (например, OUTJOB-001-{0000}).
Схема именования объектов родительской папки применяется к уникальным идентификаторам всех объектов, которые создаются в этой папке.
Схему Item Naming Scheme, примененную к родительской папке, можно в любой момент изменить. Измененная схема будет применяться ко всем создаваемым далее в этой папке объектам.
Тип объекта
При создании целевого объекта Outputjob Item, в котором будет храниться конфигурация выходных документов, убедитесь, что в диалоговом окне Create New Item тип содержимого этого объекта (Content Type) определен как Outputjob. Если вы создаете объект в папке с типом Output Jobs, то объект этого типа будет доступен в контекстном меню при создании объекта.
Создание объекта Outputjob Item в папке Output Jobs. Нужный тип содержимого (Content Type) доступен в контекстном меню.
Определение жизненного цикла и именование ревизий
При определении объекта Outputjob Item убедитесь, что указан тип управления жизненным циклом для его использования с этим объектом и схема именования ревизий этого объекта.
Управление тем, какие типы объектов могут использовать конкретное определение жизненных циклов или схему именования ревизий, осуществляется на глобальном уровне в диалоговом окне Content Types, при определении схемы. Схемами по умолчанию, которые назначаются объекту Outputjob Item, являются Generic Lifecycle и 1-Level Revision Scheme.
После того, как файл был выгружен в начальную ревизию объекта Outputjob Item, эти схемы не могут быть изменены для этого конкретного объекта.
Укажите нужные схемы в диалоговом окне Create New Item с помощью полей Lifecycle Definition и Revision Naming Scheme соответственно.
Если включен параметр для управления использованием определений жизненных циклов и схем именования ревизий по типу содержимого и для типа Outputjob Item не задано использование конкретного определения/схемы, то это определение/схема будет не доступно в соответствующем выпадающем списке.
Выбор определения жизненного цикла и схемы именования ревизий для создаваемого вручную объекта.
Придерживаясь стандартных схем именования ревизий и определений жизненных циклов для различных типов проектных объектов на сервере управляемых данных, вы обеспечите понятное и надежное управление этими объектами.
Хорошей идеей является добавление названия и описания в определение объекта. Эта информация используется при поиске на сервере и позволяет быстро идентифицировать, что предлагает тот или иной объект Outputjob Item.
Выпуск конфигурации выходных документов
До сих пор рассматривалась поддержка сервером объекта Outputjob Item с точки зрения соответствующих типов папки и объекта. Выпуск конфигурации выходных документов в ревизию такого объекта может быть выполнена удобным способом.
Конфигурация выходных документов может быть отредактирована и выпущена в начальную ревизию нового объекта Outputjob Item с помощью прямого редактирования, поддерживаемого сервером. Прямое редактирование избавляет от ограничений отдельных исходных данных под контролем версий. Вы можете просто изменить объект поддерживаемого типа с помощью временного редактора, в который загружена самая новая версия исходных данных непосредственно с сервера. По завершении редактирования, сущность выпускается (или выпускается повторно) в последующую запланированную ревизию родительского объекта, и временный редактор закрывается. Нет файлов на вашем жестком диске, не нужно задаваться вопросом о том, работаете ли вы с корректными и самыми новыми данными, нет необходимости в обслуживании отдельного программного обеспечения для контроля версий. Всем этим управляет сервер, с высокой степенью целостности, для значительного ускорения внесения изменений в данные.
После создания объекта Outputjob Item вы можете изменить и выпустить конфигурацию выходных документов в начальную ревизию этого объекта. Для этого включите параметр Open for editing after creation в нижней части диалогового окна Create New Item (параметр включен по умолчанию). Объект будет создан, и откроется временный редактор Outputjob Editor, с соответствующим документом .OutJob в качестве активного документа в главном окне приложения. Этот документ будет назван в соответствии с объектом-ревизией, в формате <Объект><Ревизия>.OutJob (например OUT-0006-1.OutJob).
Пример редактирования начальной ревизии объекта Outputjob Item непосредственно с сервера управляемых данных. Временный редактор Outputjob Editor предлагает документ для определения конфигурации.
Используйте этот документ для определения конфигурации выходных документов необходимым образом. Для получения более подробной информации перейдите на страницу Подготовка множества выходных документов в Output Job.
Повышение возможности повторного использования – Создание универсальной конфигурации выходных документов
Для создания максимально универсального файла Output Job, при настройке файла конфигурации выходных документов доступен ряд инновационных функций. Универсальность файла OutJob позволит вам повысить возможность его повторного использования в будущих проектах.
Универсальные имена источников данных
Многие генераторы выходных документов используют в качестве своего источника документы, названные определенным образом – например, файлы Gerber, формируемые из документа платы FluxTriangulator.PcbDoc. Однако такой подход ограничивает конфигурацию выходных документов их использованием только в родительском проекте этого документа. Чтобы избежать этого, для многих генераторов выходных документов доступна универсальная запись для источника данных. В таблице ниже приведено, какие генераторы выходных документов поддерживаются и какие универсальные записи доступны.
| Категория |
Тип выходных документов |
Универсальная запись источника данных |
| Netlist Outputs |
Все |
[Project] |
| Simulator Outputs |
Mixed Sim
SIMetrix
SIMPLIS |
[Project] |
| Documentation Outputs |
Composite
PCB 3D Print
PCB 3D Video
PCB Prints
PDF3D |
[PCB Document] |
| |
Schematic Prints |
[Project Physical Documents] |
| Assembly Outputs |
Все |
[PCB Document] |
| Fabrication Outputs |
Все |
[PCB Document] |
| Report Outputs |
Bill of Materials |
[Project]
[ActiveBOM Document] |
| |
Component Cross Reference
Report Project Hierarchy
Report Single Pin Nets |
[Project] |
| Validation Outputs |
BOM Checks |
[ActiveBOM Document] |
| |
Component states
Electrical Rules Check |
[Project] |
| |
Design Rules Check
Differences Report
Footprint Comparison Report |
[PCB Document] |
| Export Outputs |
Ansoft Neutral (AutoPCB)
AutoCAD dwg/dxf PCB
Export IDF
Export PARASOLID
Export STEP
Export VRML
Hyperlynx (AutoPCB)
P-CAD ASCII (AutoPCB)
Save As/Export PCB
SiSoft (AutoPCB)
Specctra Design PCB |
[PCB Document] |
| |
AutoCAD dwg/dxf Schematic
OrCAD v7 Capture Design (AutoSCH)
P-CAD V16 Schematic Design (AutoSCH)
Save As/Export Schematic |
[Project] |
| PostProcess Outputs |
Copy Files |
[Project] |
| Категория |
Тип выходных документов |
Универсальная запись источника данных |
| Netlist Outputs |
Все |
[Project] |
| Simulator Outputs |
Mixed Sim
SIMetrix
SIMPLIS |
[Project] |
| Documentation Outputs |
Composite
PCB 3D Print
PCB 3D Video
PCB Prints
PDF3D |
[PCB Document] |
| |
Schematic Prints |
[Project Physical Documents] |
| Assembly Outputs |
Все |
[PCB Document] |
| Fabrication Outputs |
Все |
[PCB Document] |
| Report Outputs |
Bill of Materials |
[Project]
[ActiveBOM Document] |
| |
Component Cross Reference
Report Project Hierarchy
Report Single Pin Nets |
[Project] |
| Validation Outputs |
BOM Checks |
[ActiveBOM Document] |
| |
Component states
Configuration compliance
Electrical Rules Check |
[Project] |
| |
Design Rules Check
Differences Report
Footprint Comparison Report |
[PCB Document] |
| Export Outputs |
Ansoft Neutral (AutoPCB)
AutoCAD dwg/dxf PCB
Export IDF
Export PARASOLID
Export STEP
Export VRML
Hyperlynx (AutoPCB)
P-CAD ASCII (AutoPCB)
Save As/Export PCB
SiSoft (AutoPCB)
Specctra Design PCB |
[PCB Document] |
| |
AutoCAD dwg/dxf Schematic
OrCAD v7 Capture Design (AutoSCH)
P-CAD V16 Schematic Design (AutoSCH)
Save As/Export Schematic
Web Review |
[Project] |
| PostProcess Outputs |
Copy Files |
[Project] |
Классы слоев
Вы можете добавлять именованные классы слоев при конфигурации следующих генераторов выходных документов:
- PCB Prints
- Assembly Drawings
- Drill Drawings
- Final
- Gerber Files
- Mask Set
- ODB++ Files
- Power-Plane Set
Это обеспечит возможность повторного использования этих генераторов выходных документов. Например, добавьте класс сигнальных слоев и сделайте на него ссылку в файле OutJob – платы, в которых будет этот класс слоев, смогут использовать этот генератор выходных документов без внесения изменений в него.
При прямом редактировании есть три элемента управления, доступных в панели быстрого доступа (Quick Access Bar, в верхней левой части окна приложения) или в панели инструментов Job Manager Toolbar:
-
– Save Active Document (Сохранить активный документ). Используйте эту кнопку, чтобы сохранить все изменения документа. Это позволит вам сохранить текущие изменения и позже вернуться к внесению дальнейших изменений перед выпуском на сервер управляемых данных.
-
– Release Document (Выпуск документа). Используйте эту кнопку, чтобы выпустить (по сути, сохранить и выпустить) заданную конфигурацию на сервер управляемых данных в начальную (запланированную) ревизию целевого объекта Outputjob Item. Будет открыто диалоговое окно Edit Revision, в котором вы можете изменить название и описание и добавить информацию о выпуске. После выпуска документ и редактор будут закрыты. Документ *.OutJob, содержащий в себе конфигурацию, будет сохранен в ревизию объекта.
-
– Cancel Editing (Отменить редактирование). Используйте эту кнопку, если вы хотите отменить редактирование. Документ и редактор будут закрыты, и в целевой объект Outputjob Item ничего не будет выпущено.
Эти элементы управления также доступны в качестве команд главного меню File: Save (сочетание клавиш Ctrl+S), Release to Server (сочетание клавиш Alt+Ctrl+S) и Cancel Edit.
Выпущенные данные, которые хранятся на сервере, состоят из определения конфигурации выходных документов, заданной в файле Output Job (<Объект><Ревизия>.OutJob). В панели Explorer переключитесь на вкладку аспектного вида Preview, чтобы увидеть конфигурацию выходных документов.
Просмотр выпущенной ревизии объекта Outputjob Item в панели Explorer. Переключитесь на вкладку аспектного вида Preview, чтобы увидеть конфигурацию выходных документов.
Выгрузка файла OutJob
Вы также можете выгрузить конфигурации выходных документов в ревизию объекта Outputjob Item. Это можно сделать несколькими способами.
Меню Upload
Файл конфигурации выходных документов может быть выгружен щелчком ПКМ по нужному объекту Outputjob Item в панели Explorer и выбором команды Upload из контекстного меню. Будет открыто диалоговое окно Create New Revision, в котором вы можете изменить название и описание и добавить необходимую информацию о выпуске. Используйте область Sources диалогового окна, чтобы загрузить нужный файл OutJob. Это можно выполнить путем перетаскивания файла мышью из Проводника Windows в эту область. Либо нажмите кнопку 
– будет открыто диалоговое окно Add Files (стандартное диалоговое окно Windows на открытие файла). Используйте его, чтобы найти и открыть нужный файл (*.OutJob).
Если у объекта нет запланированной ревизии, выгрузка будет осуществлена в следующую запланированную ревизию, созданную на лету в рамках процесса выгрузки.
Ручное определение файла OutJob для загрузки в целевой объект Outputjob Item.
После перетаскивания нужного файла или его выбора и нажатия кнопки Open запись этого файла будет отображена в области Sources. Начните загрузку, нажав кнопку OK. В панели Explorer переключитесь на вкладку аспектного вида Preview, чтобы увидеть конфигурацию выходных документов.
Содержимое выгруженного файла можно увидеть на вкладке аспектного вида Preview ревизии объекта Outputjob Item.
Перетаскивание из Проводника Windows
Файл конфигурации выходных документов также можно выгрузить, перетащив выбранный файл из исходной папки в Проводнике Windows в нужный целевой объект Outputjob Item в панели Explorer. Будет открыто диалоговое окно Create New Revision, где этот файл будет отображен в списке области Sources. Измените поля Name (которое будет именем файла с его расширением) и Description (которое будет в формате Uploaded from <ИмяИПутьФайла>, Size <РазмерФайла>, Created on <ДатаСозданияФайла>), добавьте нужную информацию о выпуске Release Notes и нажмите кнопку OK.
Если у существующего объекта Outputjob Item нет запланированной ревизии, выгрузка будет осуществлена в следующую запланированную ревизию, созданную на лету в рамках процесса выгрузки. Если вы перетащите файл не в существующий объект, будет создан новый объект Outputjob Item. Будет открыто диалоговое окно
Create New Item. Названием (
Name) объекта будет имя файла с его расширением. Описание (
Description) объекта будет в формате
Uploaded from <ИмяИПутьФайла>, Size <РазмерФайла>, Created on <ДатаСозданияФайла>. Измените эти поля нужным образом. Идентификатор
Item ID будет задан в соответствии со схемой именования ревизий, заданной на уровне папки. Если папке не задана схема именования ревизий, будет использоваться схема
$CONTENT_TYPE_CODE-001-{0000}.
Выгрузка файла OutJob с помощью перетаскивания мышью.
Повторное использование объекта Outputjob Item
Связанная страница: Управление доступом к данным на сервере
После того, как файл конфигурации выходных документов был выгружен на сервер управляемых данных и состояние его жизненного цикла было задано на том уровне, при котором его можно использовать на уровне проекта, этот файл можно повторно использовать при создании проектов плат.
Когда вы вошли на сервер управляемых данных, вы можете вручную выбрать ревизию любого объекта Outputjob, которая опубликована для вас.
Если вы не вошли на сервер управляемых данных, вы всё же можете работать в Altium Designer (под активной лицензией Altium Designer), но вы не сможете получить доступ к серверу управляемых данных организации и к его службам. Соответственно, вы не сможете повторно использовать объекты Outputjob Item. Вы сможете использовать только файловые конфигурации, определенные локально.
Выберите ревизию объекта Outputjob Item, которую вы хотите использовать, на вкладке Managed OutputJobs диалогового окна Project Options. Нажмите кнопку 
– будет открыто диалоговое окно Select configuration item (Output Jobs) со списком самых новых ревизий всех объектов Outputjob Item на сервер, которые доступны вам (т.е. которые опубликованы для вас). Выберите нужную ревизию объекта и нажмите OK.
Выбор ревизии объекта Outputjob Item вручную на вкладке Managed OutputJobs диалогового окна Project Options.
Добавьте ревизии других объектов OutputJob Item, если необходимо. Нажмите OK, чтобы закрыть диалоговое окно Project Options, сохраните проект и выполните его повторную компиляцию – выбранные ревизии объектов OutputJob Item появятся в панели Projects.
Управляемый OutputJob отличается в панели
Projects иконкой
.
Добавленные ревизии объектов OutputJob Item будут отражены в панели Projects после сохранения и повторной компиляции проекта.
Помимо ревизий управляемых объектов Outputjob Item, вы также можете создавать и использовать неуправляемые (локальные) файлы Output Job, если необходимо.
Повторное использование объекта как части конфигурации среды
Выпущенную конфигурацию выходных документов также можно использовать как объект данных конфигурации в одной или множестве конфигурациях среды (Environment Configurations). Конфигурация среды используется для ограничения рабочей среды средства проектирования Altium NEXUS использованием только тех проектных элементов, которые утверждены компанией. Определение конфигураций среды и их хранение осуществляется в Team Configuration Center – службе, которая устанавливается вместе с NEXUS Server.
После того, как вы вошли в NEXUS Server и выбрали доступную вам конфигурацию среды, в Altium NEXUS будет настроено соответствующее использование конфигураций Output Job. Если в выбранной конфигурации среды есть заданная ревизия объекта Outputjob Item, она сразу будет применена. В противном случае, настройки останутся доступными для их определения вручную, т.е. вы сможете повторно использовать управляемую конфигурацию выходных документов или использовать локальные файлы. Для получения более подробной информации перейдите на страницу Управление конфигурацией среды.
При использовании конфигурации среды, будут настроены следующие области Altium NEXUS для использования файлов Output Job.
Диалоговое окно Project Options
Ревизии объектов Outputjob Item указываются для их использования на вкладке Managed OutputJobs диалогового окна Project Options подобно тому, как они используются повторно вручную. Разница в их использовании под управлением конфигурации среды состоит в том, что вы можете добавлять только ревизии объектов Outputjob Item, заданные для этой конфигурации среды.
Нажмите кнопку – будет открыто диалоговое окно Select configuration item (Output Jobs). Используйте его, чтобы выбрать для использования в проекте файл OutJob из списка ревизий объектов Outputjob Item, заданных в примененной конфигурации среды. Добавьте дополнительные ревизии объектов Outputjob Item, если необходимо.
Выберите ревизии объектов Outputjob Item, заданные в конфигурации среды, при добавлении OutJob в проект. На изображении выше, для использования выбраны три из четырех определенных на сервере объектов Outputjob Item, доступных для активной конфигурации среды (PCB Design Engineers).
Когда все необходимые ревизии объектов Outputjob Item добавлены, нажмите OK, чтобы закрыть диалоговое окно Project Options, сохраните проект и выполните его повторную компиляцию – выбранные ревизии объектов OutputJob Item появятся в панели Projects.
Создание нового файла OutJob
Хотя вы можете повторно использовать только ревизии управляемых объектов Outputjob Item, указанные в активной конфигурации среды, вы всё же можете создавать новые файловые конфигурации выходных документов, если необходимо. Соответственно, остаются доступными для использования команды на создание нового OutJob: команда File » New » Output Job File главного меню и команда Add New to Project » Output Job File контекстного меню записи проекта в панели Projects.
Попытка использовать существующий файл OutJob
При использовании конфигурации среды, если для нее определен хотя бы один OutJob, использование существующих файлов OutJob будет невозможно. Если вы попытаетесь добавить в проект существующий файл OutJob, щелкнув ПКМ по записи проекта в панели Projects, выбрав Add Existing to Project и перейдя к этому файлу, будет открыто диалоговое окно, оповещающее о том, что файлы Output Job управляются примененной конфигурацией среды и что существующие файлы Output Job не могут быть добавлены в проект.
Редактор OutputJob Editor
В редакторе OutputJob Editor, вызванном при открытии управляемого OutJob, будет отражено, что документ является управляемым документом OutputJob (Managed OutputJob Document), с обозначением ревизии объекта и сервера управляемых данных, на котором этот объект находится.
Редактор Output Job Editor при просмотре управляемого Output Job.
Поскольку OutJob является управляемым, элементы управления, которые могут привести к его изменению, отключены. Соответственно, приведенные ниже функциональные возможности недоступны:
- Добавление новых генераторов выходных документов.
- Настройка существующих генераторов выходных документов.
- Вырезание, копирование, вставка, дублирование и удаление существующих генераторов выходных документов.
- Добавление новых контейнеров выходных документов и выводов на печать.
- Настройка существующих контейнеров выходных документов и выводов на печать.
- Вырезание, копирование, вставка, дублирование и удаление существующих контейнеров выходных документов и выводов на печать.
- Включение/отключение генератора выходных документов для его использования в валидном контейнере выходных документов или выводе на печать.
Тем не менее, вы всё ещё можете определять использование вариантов для OutJob.
Повторный выпуск объекта Outputjob Item
В любой момент вы можете вернуться к ревизии объекта Outputjob Item на сервере и напрямую отредактировать ее. Щелкните ПКМ по ревизии и выберите команду Edit из контекстного меню. Будет открыт временный редактор с файлом конфигурации из этой ревизии. Внесите необходимые изменения, затем выпустите документ в следующую ревизию объекта.
Щелкните ПКМ по записи верхнего уровня самого объекта, чтобы изменить самую новую ревизию этого объекта.
Доступ к команде для запуска прямого редактирования существующей ревизии объекта Outputjob Item.
Обновление объекта Outputjob Item
Если необходимо изменить конфигурацию выходных файлов, сохраненную в объекте Outputjob Item, и у вас есть обновленный файл OutJob, выгрузите новый файл шаблона в этот объект – новый шаблон будет сохранен в следующую ревизию этого объекта.
Загрузка выпущенных данных
Чтобы загрузить данные, которые хранятся в ревизии объекта Outputjob Item, щелкните ПКМ по ревизии этого объекта и выберите команду Operations » Download из контекстного меню. Файл конфигурации выходных документов будет загружен в подпапку выбранной директории, названную в соответствии с идентификатором ревизии объекта. Этот файл можно найти здесь в папке Released.
Запустите команду Download для записи верхнего уровня объекта Outputjob Item, чтобы загрузить файл конфигурации выходных документов, который хранится в самой новой ревизии этого объекта.
Нажмите кнопку Explore в диалоговом окне Download from Server, чтобы быстро открыть папку загрузки.
