Управляемые файлы Output Job

Вы просматриваете версию 3.0. Для самой новой информации, перейдите на страницу Управляемые файлы Output Job для версии 5

This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Главная страница: Объекты сервера

Altium NEXUS в сочетании с сервером управляемых данных позволяет создавать объекты управляемых файлов Outputjob. Такие объекты могут быть созданы:

  • С помощью прямого редактирования.
  • Путем выгрузки файла конфигурации выходных данных (*.OutJob) в ревизию целевого объекта.

После того, как объект Outputjob был создан (и в его ревизию были выпущены данные) и его состояние жизненного цикла задано на том уровне, при котором этот объект можно использовать при проектировании, объект можно повторно использовать на уровне проектирования плат.

Кроме того, объект Outputjob Item можно использовать как объект данных конфигурации в одной или нескольких заданных конфигурациях среды (Environment Configurations). Конфигурация среды используется, чтобы ограничить рабочую среду средства проектирования Altium NEXUS использованием только утвержденных компанией проектных элементов. Конфигурации среды определяются и хранятся в Team Configuration Center – службе, которая устанавливается вместе с NEXUS Server и которая отвечает за концепцию управления конфигурацией среды.

Для получения более подробной информации о работе с файлами конфигурации выходных данных перейдите на страницу Подготовка множества выходных документов в Output Job.

Тип папки

При создании папки, в которой будут храниться объекты Outputjob Item, вы можете указать тип этой папки. Это не имеет отношения к содержимому папки – выпуск файла конфигурации выходных данных всегда осуществляется в соответствующий объект Outputjob Item. Таким образом вы лишь обеспечиваете визуальную подсказку о том, что хранится в папке, что может быть полезными при поиске определенного содержимого на сервере. Чтобы указать, что папка используется в качестве контейнера для объектов Outputjob Item, задайте ее тип (Folder Type) как Output Jobs при определении свойств папки в диалоговом окне Edit Folder.

Определение типа папки, т.е. ее планируемого использования, предоставляет визуальную индикацию содержимого этой папки при просмотре данных на сервере.
Определение типа папки, т.е. ее планируемого использования, предоставляет визуальную индикацию содержимого этой папки при просмотре данных на сервере.

Тип объекта

При создании целевого объекта Outputjob Item, в котором будет храниться конфигурация выходных документов, убедитесь, что в диалоговом окне Create New Item тип содержимого этого объекта (Content Type) определен как Outputjob. Если вы создаете объект в папке с типом Output Jobs, то объект этого типа будет доступен в контекстном меню при создании объекта.

Создание объекта Outputjob Item в папке Output Jobs. Нужный тип содержимого (Content Type) доступен в контекстном меню.
Создание объекта Outputjob Item в папке Output Jobs. Нужный тип содержимого (Content Type) доступен в контекстном меню.

Выпуск конфигурации выходных документов

До сих пор рассматривалась поддержка сервером объекта 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 предлагает документ для определения конфигурации.
Пример редактирования начальной ревизии объекта Outputjob Item непосредственно с сервера управляемых данных. Временный редактор Outputjob Editor предлагает документ для определения конфигурации.

Используйте этот документ для определения конфигурации выходных документов необходимым образом. Для получения более подробной информации перейдите на страницу Подготовка множества выходных документов в Output Job.

При прямом редактировании есть три элемента управления, доступных в панели быстрого доступа (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, чтобы увидеть конфигурацию выходных документов.
Просмотр выпущенной ревизии объекта 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.Ручное определение файла OutJob для загрузки в целевой объект Outputjob Item.

После перетаскивания нужного файла или его выбора и нажатия кнопки Open запись этого файла будет отображена в области Sources. Начните загрузку, нажав кнопку OK. В панели Explorer переключитесь на вкладку аспектного вида Preview, чтобы увидеть конфигурацию выходных документов.

Содержимое выгруженного файла можно увидеть на вкладке аспектного вида Preview ревизии объекта Outputjob Item.Содержимое выгруженного файла можно увидеть на вкладке аспектного вида 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 с помощью перетаскивания мышью.Выгрузка файла OutJob с помощью перетаскивания мышью.

Повторное использование объекта Outputjob Item

Связанная страница: Управление доступом к данным на сервере

После того, как файл конфигурации выходных документов был выгружен на сервер управляемых данных и состояние его жизненного цикла было задано на том уровне, при котором его можно использовать на уровне проекта, этот файл можно повторно использовать при создании проектов плат.

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

Если вы не вошли на сервер управляемых данных, вы всё же можете работать в Altium NEXUS (под активной лицензией Altium NEXUS), но вы не сможете получить доступ к серверу управляемых данных организации и к его службам. Соответственно, вы не сможете повторно использовать объекты Outputjob Item. Вы сможете использовать только файловые конфигурации, определенные локально.

Выберите ревизию объекта Outputjob Item, которую вы хотите использовать, на вкладке Managed OutputJobs диалогового окна Project Options. Нажмите кнопку  – будет открыто диалоговое окно Select configuration item (Output Jobs) со списком самых новых ревизий всех объектов Outputjob Item на сервер, которые доступны вам (т.е. которые опубликованы для вас). Выберите нужную ревизию объекта и нажмите OK.

Выбор ревизии объекта Outputjob Item вручную на вкладке Managed OutputJobs диалогового окна Project Options.
Выбор ревизии объекта Outputjob Item вручную на вкладке Managed OutputJobs диалогового окна Project Options.

Добавьте ревизии других объектов OutputJob Item, если необходимо. Нажмите OK, чтобы закрыть диалоговое окно Project Options, сохраните проект и выполните его повторную компиляцию – выбранные ревизии объектов OutputJob Item появятся в панели Projects.

Управляемый OutputJob отличается в панели Projects иконкой .

Добавленные ревизии объектов OutputJob Item будут отражены в панели 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.

Редактор OutputJob Editor

В редакторе OutputJob Editor, вызванном при открытии управляемого OutJob, будет отражено, что документ является управляемым документом OutputJob (Managed OutputJob Document), с обозначением ревизии объекта и сервера управляемых данных, на котором этот объект находится.

Редактор Output Job Editor при просмотре управляемого Output Job.
Редактор Output Job Editor при просмотре управляемого Output Job.

Поскольку OutJob является управляемым, элементы управления, которые могут привести к его изменению, отключены. Соответственно, приведенные ниже функциональные возможности недоступны:

  • Добавление новых генераторов выходных документов.
  • Настройка существующих генераторов выходных документов.
  • Вырезание, копирование, вставка, дублирование и удаление существующих генераторов выходных документов.
  • Добавление новых контейнеров выходных документов и выводов на печать.
  • Настройка существующих контейнеров выходных документов и выводов на печать.
  • Вырезание, копирование, вставка, дублирование и удаление существующих контейнеров выходных документов и выводов на печать.
  • Включение/отключение генератора выходных документов для его использования в валидном контейнере выходных документов или выводе на печать.

Тем не менее, вы всё ещё можете определять использование вариантов для OutJob.

Повторный выпуск объекта Outputjob Item

В любой момент вы можете вернуться к ревизии объекта Outputjob Item на сервере и напрямую отредактировать ее. Щелкните ПКМ по ревизии и выберите команду Edit из контекстного меню. Будет открыт временный редактор с файлом конфигурации из этой ревизии. Внесите необходимые изменения, затем выпустите документ в следующую ревизию объекта.

Щелкните ПКМ по записи верхнего уровня самого объекта, чтобы изменить самую новую ревизию этого объекта.

Доступ к команде для запуска прямого редактирования существующей ревизии объекта Outputjob Item.
Доступ к команде для запуска прямого редактирования существующей ревизии объекта Outputjob Item.

Обновление объекта Outputjob Item

Если необходимо изменить конфигурацию выходных файлов, сохраненную в объекте Outputjob Item, и у вас есть обновленный файл OutJob, выгрузите новый файл шаблона в этот объект – новый шаблон будет сохранен в следующую ревизию этого объекта.

Загрузка выпущенных данных

Чтобы загрузить данные, которые хранятся в ревизии объекта Outputjob Item, щелкните ПКМ по ревизии этого объекта и выберите команду Operations » Download из контекстного меню. Файл конфигурации выходных документов будет загружен в подпапку выбранной директории, названную в соответствии с идентификатором ревизии объекта. Этот файл можно найти здесь в папке Released.

Запустите команду Download для записи верхнего уровня объекта Outputjob Item, чтобы загрузить файл конфигурации выходных документов, который хранится в самой новой ревизии этого объекта.
Нажмите кнопку Explore в диалоговом окне Download from Server, чтобы быстро открыть папку загрузки.
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content