Creating & Editing Content

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

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

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

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

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

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

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

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

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

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

Доступно несколько стандартных примерных схем, использующих краткий код либо для типа папки, либо для типа содержимого (список кодов см. в таблице ранее в этом документе). При использовании стандартной схемы именования программное обеспечение автоматически назначит следующий доступный уникальный идентификатор на основе этой схемы, просканировав весь 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, в зависимости от выбранной Revision Naming Scheme.

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

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

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

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

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

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

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

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

• Компонент

• Шаблон компонента

• Шаблон документа Draftsman

• Шаблон листа Draftsman

• Посадочное место

• Harness Wiring

• Стек слоев

• Управляемый лист схемы

• Outputjob

• Фрагмент PCB

• Шаблон проекта

• Блок повторного использования

• Фрагмент схемы

• Шаблон схемы

• Модель симуляции

• Символ

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

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

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

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

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

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

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

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

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

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

  • создание новой ревизии модели домена (символы, посадочные места, модели симуляции, модели проводки жгутов), на которую ссылаются ревизии элементов компонентов.

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

  • создание новой ревизии 3D-модели, на которую ссылаются ревизии элементов моделей посадочных мест.

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

  При сохранении отредактированного компонента или модели домена (символа, посадочного места, модели симуляции, модели проводки жгутов) в 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 поддерживаемого типа содержимого в Workspace (через панель Explorer panel) и отредактировать ее напрямую. Щелкните правой кнопкой мыши по ревизии и выберите команду Edit в контекстном меню. Снова откроется временный редактор, в котором документ, содержащийся в ревизии, будет открыт для редактирования. Внесите необходимые изменения, затем зафиксируйте выпуск документа в следующую ревизию элемента.

Пример доступа к команде запуска прямого редактирования существующего шаблона 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.

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

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

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

Меню Upload

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

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

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

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

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

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

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

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

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

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

Клонирование содержимого Workspace

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

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

• Компонент
• Посадочное место
• Символ
• Модель симуляции
• Шаблон компонента
• Управляемый лист схемы
• Шаблон схемы
• Шаблон проекта
• Шаблон документа Draftsman
• Шаблон листа Draftsman
• Стек слоев
• OutputJob

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

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

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

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