Working with Items
Num relance
- Entenda os tipos de Itens, os identificadores de revisão e por que as revisões liberadas não podem ser sobrescritas.
- Aprenda a registrar e consultar notas de liberação e de alteração do estado do ciclo de vida.
- Descubra como criar Itens e inserir revisões de Itens compatíveis em documentos de projeto a partir do painel Explorer.
Em um Workspace conectado, cada entidade de projeto que pode ser armazenada, gerenciada e reutilizada é representada como um tipo específico de Item. Para permitir a atualização de um Item ao longo do tempo, o que realmente é armazenado no Workspace é uma série de Revisões do Item, que são revisões específicas desse Item cujo nome se baseia no Esquema de Nomenclatura de Revisões escolhido. Cada novo Item é criado em uma pasta e, depois de definir as pastas necessárias em um Workspace, você pode criar novos Itens na pasta selecionada, na região de Itens do painel Explorer.
Tipos de conteúdo compatíveis
Diferentes Itens são usados para armazenar e representar diferentes tipos de dados. Um Item pode representar um símbolo esquemático, outro, um modelo de componente de PCB, enquanto outro pode conter os dados de fabricação gerados a partir de um projeto de placa liberado. Para declarar o tipo de conteúdo que um Item (ou melhor, suas revisões) conterá, sua propriedade Content Type precisa ser especificada ao criar ou editar esse Item. Em outras palavras, você está, essencialmente, especificando o Item Type.
A tabela a seguir lista os vários tipos de conteúdo (tipos de Item) que podem ser criados manualmente por um usuário em um Workspace conectado, juntamente com seus respectivos:
-
Associated Folder Type – o tipo de pasta específico, quando disponível, no qual armazenar o conteúdo desse tipo. Isso não interfere no conteúdo da pasta. Apenas fornece uma indicação visual do que está armazenado em uma pasta e pode ser útil ao navegar em um Workspace em busca de um conteúdo específico. O conteúdo pode ser armazenado em qualquer tipo de pasta, incluindo a
Generic Folder. -
Content Type Code – o código usado ao atribuir o ID exclusivo a um Item criado desse tipo de conteúdo, quando o Esquema de Nomenclatura de Itens da pasta pai usa a entrada
$CONTENT_TYPE_CODE. -
Folder Type Code – o código usado ao atribuir o ID exclusivo a um Item criado desse tipo de conteúdo, quando o Esquema de Nomenclatura de Itens da pasta pai usa a entrada
$FOLDER_TYPE_CODE.
| Tipo de conteúdo | Tipo de pasta associado | Código do tipo de conteúdo | Código do tipo de pasta | Mais informações... |
|---|---|---|---|---|
| Modelo 3D | Modelos 3D | A3D |
A3DL |
Ferramentas adicionais para trabalhar com corpos 3D |
| Preferências do Altium Designer | Preferências do Altium Designer | PREF |
ADPC |
Acessar, definir e gerenciar preferências do sistema |
| Dados de montagem | Catálogo de projetos | PAS |
PRJ |
Liberação de projeto |
| Arquivo binário | Arquivos binários | ABF |
ABC |
Tipo de conteúdo de arquivo binário |
| Modelo de BOM | Modelos de BOM | XLT |
XLT |
Preparar uma BOM no Gerenciador de Relatórios |
| Componente | Componentes | CMP |
CMPL |
Criar um novo componente de biblioteca do Workspace |
| Modelo de componente | Modelos de componentes | CMPT |
CTC |
Modelos de componentes |
| Modelo de documento do Draftsman | Modelos do Draftsman | DFD |
DRT |
Criação de modelos do Draftsman |
| Modelo de folha do Draftsman | Modelos do Draftsman | DFS |
DRT |
Criação de modelos do Draftsman |
| Arquivo de fabricação | – | – | – | Projetos do Workspace (Workspace do Altium 365) Projetos do Workspace (Workspace do Enterprise Server) |
| Footprint | Footprints | PCC |
PCBCL |
Criar um footprint de PCB |
| Modelo de layout de chicote | Modelos de layout de chicote | HARLT |
HLTC |
Criar documentos de modelo de chicote |
| Fiação de chicote | – | HARW |
– | Criar um componente de fiação de chicote |
| Modelo de fiação de chicote | Modelos de fiação de chicote | HARWT |
HWTC |
Criar documentos de modelo de chicote |
| Empilhamento de camadas | Empilhamentos de camadas | ALS |
ALS |
Definir o empilhamento de camadas |
| Folha esquemática gerenciada | Folhas esquemáticas gerenciadas | SCH |
SSC |
Trabalhar com folhas esquemáticas gerenciadas |
| Tarefa de saída | Tarefas de saída | OUT |
OUTC |
Preparar dados de fabricação com tarefas de saída |
| Dados de fabricação de PCB | Catálogo de projetos | PBL |
PRJ |
Liberação de projeto |
| Trecho de PCB | Trechos de PCB | PCBS |
PSNC |
|
| Projeto | Catálogo de projetos | PDE |
PRJ |
Liberação de projeto |
| Pacote de revisão de projeto | Catálogo de projetos | PRP |
PRJ |
Liberação de projeto |
| Modelo de projeto | Modelos de projeto | PRJT |
PRJT |
Criar um modelo de projeto |
| Bloco de reutilização | Blocos de reutilização de projeto | RBL |
RBLC |
|
| Trecho de esquema | Trechos de esquema | SCHS |
SSNC |
|
| Modelo de esquema | Modelos de esquema | SCHDOT |
STC |
Criação de modelos de esquema |
| Script | Scripts | ASF |
ASC |
Criar e armazenar scripts |
| Modelo de simulação | Modelos de simulação | SIM |
SML |
Criar um modelo de simulação |
| Símbolo | Símbolos | SYM |
SSL |
Criar um símbolo esquemático |
Revisões de itens
Um item pode ter qualquer número de revisões, que são essencialmente uma evolução desse item ao longo do tempo. Uma alteração é feita e o novo conteúdo de dados é salvo, carregado ou liberado em uma nova revisão, garantindo que nenhuma revisão existente possa ser sobrescrita e, assim, assegurando o mais alto nível de integridade. Portanto, os dados armazenados em cada revisão de um item geralmente são diferentes. Para distinguir essas diferentes revisões de um item, utiliza-se um identificador de revisão (ID) que, em combinação com o ID do item, cria um identificador exclusivo para cada liberação de um item. Isso nos dá o Item-Revision.
Portanto, um ID completo de item-revisão simplesmente identifica uma revisão específica de um item pai. Sempre haverá pelo menos uma revisão de um item (a primeira liberação), mas pode haver muitas, dependendo de quantas vezes os dados desse item foram salvos, carregados ou liberados. Um ponto importante aqui é que você só pode fazer uma liberação para um determinado item-revisão uma única vez. Se houver uma alteração, um novo item-revisão deverá ser criado. Isso garante o mais alto nível de integridade, pois os dados contidos em uma determinada revisão nunca poderão ser sobrescritos por uma nova liberação para a mesma revisão. Para liberar novamente, um novo item-revisão deverá ser usado.
A maneira mais simples de compreender o conceito de um item e suas revisões é pensar em uma “caixa”, na qual são armazenados todos os dados daquela revisão específica daquele item específico. Quando o item é liberado, os dados são colocados na caixa e ela é fechada. O ID do item e o ID da revisão tornam-se etiquetas na lateral dessa caixa — eles permitem reconhecer instantaneamente para que o conteúdo da caixa é usado. Se os dados precisarem ser atualizados e liberados novamente, o ID da revisão será incrementado, criando uma nova caixa.

A “caixa” do item-revisão — identificada com o ID do item e o ID da revisão. O conteúdo consiste nos dados necessários para construir ou representar essa revisão desse item. O ato de liberar fecha a caixa, impedindo que quaisquer outros dados sejam liberados para essa revisão no futuro. O ID completo de item-revisão, neste caso, seria: D-820-1001-01.A.1.
O formato do ID de uma revisão é determinado pelo Revision Naming Scheme empregado para o item pai. O formato específico usado em um esquema é configurável e dependerá das necessidades de cada organização.
Notas de alteração de estado e de liberação
Para aprimorar a trilha de auditoria do conteúdo em um Workspace, o Altium Designer permite inserir notas ao alterar o estado do ciclo de vida de um item-revisão e, para muitos tipos de conteúdo, ao liberar os dados de origem em revisões planejadas no Workspace.
Notas de alteração de estado
Ao alterar o estado do ciclo de vida de um item-revisão em um Workspace, use a região State change note da caixa de diálogo de alteração de estado exibida em seguida para inserir uma nota relevante para essa alteração.

Adicionando uma nota para explicar a alteração no estado do ciclo de vida de um item-revisão.
Notas de liberação
Ao liberar dados de origem em uma nova revisão planejada de um item em um Workspace, use a região Release notes da caixa de diálogo Create Revision exibida em seguida para inserir uma nota relevante para essa liberação. Esse recurso está disponível ao liberar novamente qualquer tipo de item que ofereça suporte ao paradigma de Edição direta.

Um exemplo de adição de uma nota de liberação durante a nova liberação de um empilhamento de camadas para um Workspace de destino.
Visualizando as notas associadas às revisões de um item
As notas adicionadas a qualquer revisão de um item podem ser visualizadas nos seguintes locais:
- Detailed Item view – visualize a nota de liberação associada e as notas de alterações de estado da revisão na coluna Note, dentro da região Timeline. Para cada estado ao longo da vida de uma revisão, a nota aplicável (se adicionada) também pode ser vista na visualização gráfica do ciclo de vida da revisão.
- Explorer panel – alterne para a aba de visualização Lifecycle de um item-revisão selecionado. Para cada estado ao longo da vida de uma revisão, a nota aplicável (se adicionada) pode ser vista na representação gráfica do ciclo de vida da revisão. Além disso, visualize a nota de liberação associada e a nota da alteração de estado mais recente da revisão na coluna Note, dentro da região principal Item do painel (talvez seja necessário habilitar a exibição dessa coluna).

Visualizando as notas associadas às revisões de um componente.
Comandos gerais de itens
Além das opções de visualização, a área de opções do painel Explorer também inclui o botão de comando Add <item>, que se aplica ao tipo de pasta selecionado no momento.
Este comando inicia a criação de um novo item do Workspace do tipo selecionado. Quando um tipo de pasta de componentes é selecionado no painel, por exemplo, um botão
é disponibilizado. Isso abrirá um componente recém-criado desse tipo no Editor de Componentes. Da mesma forma, um botão
é exibido quando uma pasta do tipo Output Job é selecionada, e assim por diante. O botão
será exibido após uma pesquisa de componentes, conforme inserida no campo de caminho do componente na parte superior do painel, e criará uma atividade de Solicitação de Peça referente ao componente selecionado nos resultados da pesquisa.
Posicionamento por arrastar e soltar
O posicionamento de determinados itens do Workspace em um projeto de PCB no Altium Designer é simplificado pela possibilidade de arrastar e soltar revisões desses tipos de itens no documento ativo (e compatível), diretamente do painel Explorer. É possível arrastar:
- Uma revisão de um Item de Componente para o documento de esquemático ativo (ou documento de PCB). O modelo aplicável ao domínio escolhido aparecerá flutuando junto ao cursor.
- Uma revisão de um Item de Folha de Esquemático Gerenciada para o documento de esquemático ativo. Um símbolo de folha que faz referência à folha ficará flutuando junto ao cursor.
- Uma revisão de um Item de Modelo 3D para um documento de PCB ou de biblioteca de PCB, criando um objeto de Corpo 3D que faz referência à revisão desse item.
Procure no Workspace o item que deseja posicionar. O posicionamento envolve uma revisão específica desse item; portanto, expanda a entrada principal do item para listar todas as revisões disponíveis (clique no botão
no canto superior direito do painel e desative a opção Show only latest para ver todas as revisões anteriores). Em seguida, clique na revisão desejada e arraste uma instância dela para o documento de projeto.
Além disso, o Altium Designer permite acessar e posicionar componentes do painel Componentes.
Download de dados de conteúdo
Baixe os dados armazenados em uma revisão de um item clicando com o botão direito do mouse nessa revisão e escolhendo o comando Operations » Download no menu de contexto. Os dados associados serão baixados para uma subpasta no diretório escolhido, nomeada com o ID da revisão do item. Os arquivos podem ser encontrados na pasta Released dentro dela.
Tipo de conteúdo Arquivo Binário
O Altium Designer, em conjunto com o Workspace conectado, permite armazenar arquivos avulsos em um tipo de conteúdo especial: o item Binary File . Esses itens podem ser criados para armazenar um ou mais arquivos de qualquer formato. Isso permite aproveitar de forma eficaz a segurança do Workspace e reforça seu papel como o local ideal para armazenar qualquer conteúdo, incluindo seus arquivos binários de origem reunidos em uma única entidade. Para facilitar o fluxo de arquivos de dados, é disponibilizada a funcionalidade bidirecional de arrastar e soltar, permitindo mover arquivos rapidamente entre pastas do Workspace e pastas do Windows Explorer.
- Crie um item do tipo de conteúdo Arquivo Binário no Workspace. Uma nova revisão de um item de Arquivo Binário pode ser criada carregando os arquivos correspondentes. Isso pode ser feito de algumas maneiras; consulte Carregamento de dados em uma nova revisão de um item para obter mais informações.
- Se precisar alterar os arquivos armazenados em um item de Arquivo Binário, carregue os novos arquivos desejados nesse item. Os novos arquivos serão armazenados na próxima revisão desse item.
- Para abrir um arquivo armazenado em uma revisão de um item de Arquivo Binário, selecione esse arquivo na guia de visualização de aspecto Details da revisão, clique com o botão direito do mouse e escolha o comando Open no menu de contexto. O aplicativo correspondente (ou o próprio Altium Designer) será usado para exibir o arquivo, quando aplicável.
Uso de um arquivo binário nas preferências de modelos
Nas Preferências do Altium Designer, você pode definir os documentos de modelo padrão usados ao criar um novo documento de determinado tipo. Isso é feito na guia Defaults da página Gerenciamento de Dados – Modelos da caixa de diálogo Preferences. Um documento de modelo padrão pode ser baseado em arquivo ou proveniente de um Workspace conectado.
Para alguns tipos de documentos (ActiveBOM Document, Out Job File, Multi-board Schematic e Multi-board Assembly), um documento de modelo padrão baseado no Workspace só pode ser obtido de um arquivo binário. Portanto, você precisa carregar o documento de modelo desejado na revisão de um arquivo binário e usá-lo como padrão para novos documentos.

Carregue um documento necessário (por exemplo, um arquivo OutputJob) na revisão inicial de um novo arquivo binário.
Agora, ao tentar definir um padrão para novos documentos a partir do Workspace conectado, você poderá procurar o arquivo binário, e a entrada nas preferências será preenchida adequadamente.

Uso bem-sucedido de um OutputJob como padrão para novos documentos, por meio do arquivo binário que o contém.