Creating & Editing Content

Элементы (Items) создаются непосредственно в подключенном Workspace, и все данные, необходимые для изготовления/представления элемента, затем хранятся в этом Workspace и привязываются к номеру элемента. В зависимости от типа контента элемент может быть создан вручную или автоматически в рамках процесса сохранения/загрузки/выпуска (release). Все типы контента можно создавать в Altium Designer через панель Explorer panel. При работе с компонентами создание также возможно через панель Components panel.

Элементы создаются в подключенном Workspace. В Altium Designer панель Explorer предоставляет полный интерфейс к вашему Workspace.

Создание элемента

После того как вы определили необходимые папки, можно переходить к созданию контента в Workspace. Чтобы создать элемент, выберите соответствующую папку, затем щёлкните правой кнопкой мыши в области сетки Items (Items grid) панели и выберите одну из команд в подменю Create Item. Либо, если папка пустая, используйте элемент управления Add an item в центре области, чтобы открыть меню.

Щёлкните правой кнопкой мыши в области сетки Items панели Explorer, чтобы получить доступ к командам, связанным с созданием контента.

Появится диалог Create New Item, предоставляющий все элементы управления, необходимые для полного определения элемента.

Укажите сведения о новом элементе в диалоге Create New Item.

Для многих типов контента доступна возможность отредактировать и выпустить соответствующий проектный документ в начальную ревизию этого контента после создания. Для этого включите опцию Open for editing after creation внизу диалога Create New Item (по умолчанию включена). Элемент будет создан, и откроется соответствующий временный редактор, готовый к созданию данных для этого элемента. Подробнее о работе с конкретным типом контента см. на его отдельной странице — ссылка на неё приведена в table.

Несколько слов об Item ID...

Важным аспектом родительской папки, в которой создаётся контент, является Item Naming Scheme, применяемая для неё. Она определяет формат уникального ID для каждого элемента, создаваемого в этой конкретной папке. Задавая схему именования элементов (Item Naming Scheme) на уровне папки, можно быстро создавать контент в этой папке, соблюдая корректную схему именования ID. Это особенно актуально, когда элементы создаются автоматически «на лету», а не при выпуске в уже существующие элементы, которые были вручную созданы непосредственно в целевом Workspace.

Доступно несколько примеров схем по умолчанию, использующих короткий код либо типа папки, либо типа контента (список кодов см. в table выше в этом документе). При использовании схемы по умолчанию ПО автоматически назначит следующий доступный уникальный ID согласно этой схеме, предварительно просканировав весь Workspace и идентификаторы существующего контента.

В качестве альтернативы, если требуется полный ручной контроль над именованием элемента, выберите пункт [NO ITEM NAMING SCHEME]. Тогда в рамках создания элемента необходимо определить уникальный идентификатор. Обратите внимание: система не позволит создать элемент с дублирующимся идентификатором, поэтому при ручном назначении идентификатора нужно знать, какие идентификаторы уже использовались.

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

Независимо от настройки Item Naming Scheme на уровне папки, вы можете переопределить любой автоматически определенный ID на уровне элемента. Измените такой ID при необходимости через диалог Create New Item.

Выбор схемы для ID элементов

Существует бесконечное количество возможных схем именования/нумерации, которые можно использовать для элементов; показанные в изображениях в документации — лишь примеры. Есть множество обсуждений о том, какая схема нумерации лучше. В целом эксперты сходятся во мнении, что лучше всего подходит короткая, незначимая, только числовая схема нумерации. «Незначимая» означает, что в схему нумерации не закодирована никакая информация — например категория продукта, подкатегория, местоположение и т. п.; каждому новому элементу просто присваивается следующий номер в последовательности.

Длина важна, потому что чем длиннее идентификатор, тем выше вероятность, что человек допустит ошибку при записи или воспроизведении ID элемента. Опыт и академические исследования показали, что ошибки ввода данных растут по мере увеличения числа символов. Считается, что семь цифр — «магическое» число с точки зрения легкого и надежного запоминания человеком. После определенной длины ошибки растут с возрастающей скоростью — при 15 символах вероятность ошибки близка к 100%.

Если для вашей организации важно создавать «идентичность» в ID элемента, решением может быть составной идентификатор. В этом случае рекомендуется простой буквенно-цифровой префиксный код по типу номенклатуры. Например, рассмотрим ID D-820-0001. Здесь D в коде может означать Design, то есть это элемент, используемый для проектов. В следующих 3 цифрах первая цифра может обозначать категорию продукта, например Peripheral Boards, а вторая и третья цифры в этом блоке из трех могут использоваться для обозначения голых плат (1X) или сборок (2X и выше). Последние четыре цифры в ID элемента — это простой, незначимый номер «следующий в очереди».

Задание ID для начальной ревизии элемента Workspace

Переход от локальной парадигмы проектирования к парадигме Workspace требует миграции существующих данных в Workspace. Такие данные вполне могли пройти через несколько итераций и иметь нумерацию ревизий, признанную в организации. Например, rev.3 платы Magno-Synthetic Digitizer вполне могла уже быть отгружена, а улучшения должны быть поставлены в rev.4. При выпуске в Workspace наличие начальной ревизии, которая снова начинается с 1, будет, мягко говоря, сбивать с толку — не только внутри организации, но и, что важнее, для клиентов (которые ожидают версию новее, чем их текущая rev.3!).

Для этого Altium Designer предоставляет возможность вручную задать ID начальной ревизии для вновь созданного элемента в Workspace.

Задание ID начальной ревизии

Создайте требуемый новый элемент в Workspace обычным способом. После создания щелкните по элементу правой кнопкой мыши и выберите Properties — откроется диалог Edit Item. Разверните область Advanced в диалоге и нажмите кнопку справа от поля Revision ID. Появится диалог Set Initial revision Id values, в котором можно задать ID в соответствии с вашими требованиями. При необходимости будут доступны поля для изменения различных уровней ID в соответствии с выбранной схемой именования ревизий.

Чтобы получить доступ к элементам, связанным с проектом (PCB Fabrication Data, PCB Assembly Data, PCB Project Design) в панели Explorer, убедитесь, что вы просматриваете проект в его Classic View. Возможно, потребуется вручную переключиться с Project View — команды доступны в меню, связанном с кнопкой в правом верхнем углу панели.

Задайте различные уровни ID (в зависимости от используемой схемы именования ревизий).

Создание и редактирование контента напрямую через Workspace

Ваш подключенный Workspace предоставляет гибкий и безопасный способ централизовать хранение и управление всеми типами проектных данных, используемых в Altium Designer. От модели схемы до компонента, от управляемых листов схемы до завершенных проектов печатных плат — Workspace обеспечивает идеальный способ хранения и управления данными электронного проектирования.

Мощной особенностью Workspace является поддержка Direct Editing. Что это означает — «прямое редактирование»? Это означает, что вы можете щелкнуть правой кнопкой мыши по модели, компоненту или даже управляемому листу в Workspace и выбрать Edit. Да, файл откроется в Altium Designer и будет готов к редактированию — он откроется во временном редакторе — но когда вы закончите, вы просто сохраните его обратно в Workspace. А о файле, который вы только что редактировали, можно не беспокоиться: он больше не нужен, поскольку ваши правки надежно сохранены обратно в Workspace, поэтому он уничтожается, а экземпляр временного редактора закрывается.

Прямое редактирование освобождает вас от необходимости иметь отдельные исходные данные под управлением системы контроля версий. Вы можете просто редактировать поддерживаемый тип элемента, используя временный редактор, загруженный с самым свежим исходником прямо из Workspace. А после завершения редактирования сущность выпускается (или перевыпускается) в следующую запланированную ревизию своего родительского элемента, и временный редактор закрывается. На жестком диске не остается файлов, не возникает сомнений, работаете ли вы с правильным или самым актуальным исходником, и не нужно поддерживать отдельное ПО для контроля версий. Workspace берет это на себя с высокой целостностью и таким образом, который значительно ускоряет внесение изменений в ваши данные.

Типы контента, поддерживаемые для прямого редактирования

Следующие типы контента Workspace поддерживаются в отношении прямого редактирования:

Редактирование начальной ревизии элемента

На панели Explorer panel при создании Item одного из поддерживаемых типов контента у вас есть возможность после создания отредактировать и выпустить связанную сущность данных в начальную ревизию этого Item. То есть вместо того, чтобы создавать исходные данные вне Workspace и затем выпускать их, вы можете начать работу с исходником напрямую с момента создания пустого Item — благодаря прямому редактированию. Когда редактирование завершено, сущность выпускается в начальную запланированную ревизию своего родительского Item, а временный редактор закрывается.

Чтобы воспользоваться этой возможностью, включите параметр Open for editing after creation, расположенный внизу диалога Create Item dialog. Предвосхищая полезность этой функциональности, параметр включен по умолчанию. Item будет создан, и откроется соответствующий временный редактор, показывая нужный документ как активный документ в главном окне проектирования. Этот документ будет назван в соответствии с Item-Revision, в формате: <Item>-<Revision>.<DocumentExtension>.

На изображении ниже показан пример для создания нового Symbol Item (SYM-001-0031). Открывается временный редактор Schematic Symbol, предоставляющий документ для определения символа требуемым образом.

Пример редактирования начальной ревизии Symbol Item напрямую из Workspace — временный редактор Schematic Symbol предоставляет документ, с помощью которого вы определяете свой условный графический символ.

Элементы управления прямым редактированием

При прямом редактировании есть три соответствующих элемента управления, доступных на панели быстрого доступа (в левом верхнем углу главного окна приложения) или на панели инструментов Standard для активного временного редактора (если доступно):

• ​ – Save Active Document. Используйте эту кнопку, чтобы сохранить любые изменения, внесенные в документ. Это позволяет сохранить текущие изменения, если вы хотите вернуться позже и внести дополнительные правки перед окончательным выпуском в Workspace.

• / – Save to Server. Используйте эту кнопку, чтобы выпустить (фактически — сохранить и выпустить) документ в Workspace, сохранив его в начальной (запланированной) или следующей ревизии целевого Item. Появится диалог Create Revision dialog (или Edit Revision dialog), в котором можно изменить Name и Description, а также при необходимости добавить примечания к выпуску. После выпуска документ и редактор будут закрыты.

  Где применимо и при необходимости также могут быть обновлены ревизии родительских items, связанных с (ссылающихся на) текущую ревизию сохраняемого item. Это управляется параметром Update items related to <ItemRevision>, который включен по умолчанию. Обратите внимание: этот параметр появляется только когда:

  • создается новая ревизия доменной модели (symbols, footprints, simulation models, harness wiring models), на которую ссылаются ревизии component items.

  • создается новая ревизия шаблона компонента (component template), на который ссылаются ревизии component items.

  • создается новая ревизия 3D-модели, на которую ссылаются ревизии footprint model items.

  Если вы хотите, чтобы все связанные родительские Items продолжали использовать текущую ревизию Item, отключите этот параметр. Тогда будет сохранен только сам item.

  При сохранении отредактированного компонента или доменной модели (symbol, footprint, simulation model, harness wiring model) в Workspace вы можете сохранить его текущее состояние жизненного цикла. Управление выполняется с помощью параметра Preserve lifecycle state (not recommended), доступного в диалоге Edit Revision / Create Revision при повторном сохранении. Когда параметр включен, новая ревизия автоматически будет установлена в состояние жизненного цикла предыдущей ревизии. Эта возможность доступна тем, у кого назначено операционное разрешение Allow to skip lifecycle state change for new revisions (подробнее: Setting Global Operation Permissions for a Workspace).

  Чтобы сохранить редактируемый документ в Workspace, вы также можете использовать элемент управления Save to Server рядом с записью документа на панели Projects panel.

• / – Discard Local Changes. Используйте эту кнопку, если хотите отменить редактирование. Временный файл (используемый исключительно для обеспечения редактирования) будет удален, его запись будет удалена с панели Projects, и в целевой Item ничего не будет выпущено.

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

Эти элементы управления также доступны как команды из контекстного меню (правый клик) записи документа на панели Projects. Для многих редакторов эти элементы управления также доступны как команды — Save (сочетание: Ctrl+S), Save to Server (сочетание: Ctrl+Alt+S) и Discard Local Changes — из главного меню File.

Редактирование существующей ревизии Item

На любом этапе вы можете вернуться к любой ревизии Item поддерживаемого типа контента в Workspace (через панель Explorer panel) и отредактировать ее напрямую. Щелкните правой кнопкой по ревизии и выберите команду Edit в контекстном меню. Снова откроется временный редактор, а документ, содержащийся в ревизии, будет открыт для редактирования. Внесите необходимые изменения, затем зафиксируйте выпуск документа в следующую ревизию item.

Пример доступа к команде запуска прямого редактирования существующего шаблона документа Draftsman Document Template.

Поведение временных файлов

Чтобы иметь возможность редактировать данные Workspace, необходимо создать нечто, что можно редактировать в Altium Designer. Для этого создаются временные файлы. Например, когда вы щелкаете правой кнопкой по Symbol Item и выбираете Edit, создается временный файл SchLib и открывается в Altium Designer. Когда вы завершаете работу и выполняете Save to Server, этот файл уничтожается сразу после обновления данных Workspace.

Однако если вы не выпускаете его, а вместо этого выполняете Save и Close файла, он останется на панели Projects panel. Это сделано для того, чтобы вам не приходилось завершать процесс обновления за один сеанс редактирования — при желании вы можете сохранить работу и закрыть файл; Altium Designer понимает, что это специальный файл, поэтому сохраняет его под записью <WorkspaceName> на панели Projects (например, /), чтобы вы могли снова открыть его, когда будете готовы, и завершить процесс обновления и повторного выпуска.

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

Прямое редактирование компонентов с панели Components

В повседневном управлении компонентами прямое редактирование доступно с панели Components panel — которую вы, как правило, будете использовать чаще, чем панель Explorer, применительно к этому типу контента. Найдите нужный компонент, выделите его, затем щелкните правой кнопкой и выберите команду Edit в контекстном меню. Откроется временный экземпляр Component Editor — в режиме Single Component Editing — готовый к внесению необходимых изменений.

Пример прямого редактирования с панели Components.

Прямое редактирование моделей из Component Editor

При редактировании компонента с помощью Component Editor в режиме Single Component Editing вы можете редактировать связанные доменные модели, используя подход прямого редактирования. Чтобы изменить модель, которая в данный момент используется (на которую ссылается) компонент, нажмите элемент управления в правом верхнем углу ее предпросмотра. Откроется соответствующий временный редактор для этого типа модели, готовый к внесению изменений. Когда все готово, просто сохраните и закройте редактор — измененная модель появится связанной обратно в области Models. При выпуске компонента измененная модель также будет автоматически выпущена в Workspace — в следующую ревизию своего родительского Item.

Пример прямого редактирования существующей модели, на которую ссылается компонент, который сам редактируется напрямую, с использованием Component Editor в режиме Single Component Editing.

Загрузка данных в новую ревизию элемента

Большинство типов контента поддерживают создание новой ревизии путем загрузки соответствующего файла данных.

Загрузку данных в новую ревизию элемента можно выполнить несколькими способами.

Меню Upload

Файл можно загрузить, щелкнув правой кнопкой мыши по нужному элементу в панели Explorer panel и выбрав команду Upload в контекстном меню. Появится диалог Create New Revision, в котором при необходимости можно изменить Name, Description и добавить примечания к выпуску. Используйте область Sources диалога, чтобы загрузить нужный файл. Это можно сделать, перетащив файл из Windows Explorer в эту область. Либо нажмите кнопку — появится диалог Add Files (стандартный диалог Windows для открытия файла). Используйте его, чтобы перейти к нужному файлу и открыть его.

Пример загрузки. В данном случае вручную указывается файл 3D‑модели для загрузки в целевой элемент 3D Model Item.

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

Для типа контента, который поддерживает загрузку нескольких файлов в одну ревизию (например, Binary File), выбранные файлы будут добавлены и перечислены в области Sources диалога. Если нужно скорректировать список, добавьте дополнительные файлы или выберите и удалите файлы (нажмите кнопку  ) по мере необходимости. Область Sources поддерживает выбор нескольких файлов стандартными способами множественного выбора (Ctrl+Click, Shift+Click и выделение перетаскиванием).

Продолжите загрузку, нажав кнопку OK. В зависимости от типа контента сведения о загруженном(ых) файле(ах) будут представлены на вкладках представления аспектов Details и/или Preview для ревизии элемента в панели Explorer.

Откройте сохраненную ревизию элемента (показано для 3D Model Item) в панели Explorer. Переключитесь на вкладку представления аспектов Preview, чтобы увидеть графическое представление (если применимо).

Перетаскивание из Windows Explorer

Соответствующие файлы данных также можно загрузить, перетащив выбранные файлы из исходной папки в Windows Explorer и сбросив их на нужный целевой элемент в панели Explorer panel. Появится диалог Create New Revision, а перетащенный файл будет указан в области Sources. Добавьте Release Notes при необходимости, затем нажмите кнопку OK.

Для некоторых типов контента потребуется изменить Name (это будет имя файла, включая расширение; для нескольких файлов записи будут разделены точкой с запятой) и Description (в формате Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate>; для нескольких файлов записи будут разделены точкой с запятой). Для тех типов контента, которые поддерживают несколько файлов, при необходимости добавить дополнительные файлы это можно сделать, нажав кнопку и выбрав файл(ы), либо перетащив файл(ы) в область Sources. Если нужно удалить файлы, выделите их в списке и нажмите кнопку  .

Загрузка методом перетаскивания, показано на примере 3D‑модели.

Клонирование контента Workspace

Панель Explorer предоставляет возможность клонировать различные элементы Workspace. Поэтому вместо того чтобы создавать нужный компонент, доменную модель, лист схемы или шаблон с нуля, вы можете просто клонировать его. Direct Editing гарантирует, что любые необходимые изменения — в копии исходных данных из исходной ревизии элемента — выполняются максимально просто, а получившиеся изменения выпускаются в начальную ревизию нового элемента того же типа. Быстро и без лишних усилий вы сможете расширять контент Workspace, не начиная с «чистого листа».

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

• Component
• Footprint
• Symbol
• Simulation Model
• Component Template
• Managed Schematic Sheet
• Schematic Template
• Project Template
• Draftsman Document Template
• Draftsman Sheet Template
• Layerstack
• OutputJob

Команда клонирования одного из поддерживаемых типов контента доступна из панели Explorer следующими способами:

• Щелкните правой кнопкой мыши по записи исходной ревизии элемента и выберите команду Operations » Clone в контекстном меню.
• Выберите запись исходной ревизии элемента и используйте сочетание клавиш Ctrl+D.

Команда Clone доступна по всей панели Explorer везде, где отображается соответствующая ревизия элемента, включая:

• Основной список элементов в папке.
• Children вкладку представления аспектов (при просмотре элемента Managed Schematic Sheet Item).
• Where-used вкладку представления аспектов (при просмотре элемента Component Item, Symbol Item, Footprint Item, Simulation Model Item, Component Template Item или Schematic Template Item).
• Preview вкладку представления аспектов (при просмотре элемента Component Item, Managed Schematic Sheet Item или Schematic Template Item).