Working with Items

Em um Workspace conectado, cada entidade de projeto que pode ser armazenada, gerenciada e reutilizada é representada como um tipo específico de Item. Para atender à necessidade de poder atualizar um Item ao longo do tempo, o que realmente é armazenado no Workspace é uma série de Revisões de Item, que são revisões específicas desse Item cujo nome é baseado no Esquema de Nomeação de Revisão 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 Suportados

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, mais precisamente, suas revisões) será usado para conter, sua propriedade Content Type precisa ser especificada ao criar ou editar esse Item. Em outras palavras, você está, em essência, 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:

• Associated Folder Type – o tipo de pasta específico, quando disponível, no qual armazenar o conteúdo desse tipo. Isso não influencia o conteúdo da pasta. Ele apenas fornece uma “pista” visual sobre o que está armazenado em uma pasta e pode ser útil ao navegar em um Workspace em busca de 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, e o Esquema de Nomeação de Item 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, e o Esquema de Nomeação de Item da pasta pai usa a entrada $FOLDER_TYPE_CODE.

Revisões de Item

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/liberado em uma nova revisão, garantindo que nenhuma revisão existente jamais possa ser sobrescrita e, assim, assegurando a mais alta integridade. Portanto, os dados armazenados em cada revisão de um item são normalmente diferentes. Para identificar essas diferentes revisões de um Item, é usado 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.

Um ID completo de Item-Revisão, portanto, 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/liberados. Um ponto importante a destacar aqui é que você só pode liberar para um Item-Revisão específico uma única vez. Se houver uma alteração, então um novo Item-Revisão deverá ser criado. Isso garante a mais alta integridade, pois os dados contidos em uma determinada revisão nunca podem ser sobrescritos ao se liberar novamente para a mesma revisão. Para liberar outra vez, um novo Item-Revisão deve ser usado.

A maneira mais simples de compreender o conceito de um Item e suas revisões é pensar em uma “caixa”, na qual todos os dados daquela revisão específica daquele Item são armazenados. Quando o Item é liberado, os dados são colocados na caixa e a caixa é fechada. O ID do Item e o ID da Revisão tornam-se rótulos na lateral dessa caixa – eles permitem reconhecer instantaneamente para que serve o conteúdo da caixa. Se os dados precisarem ser atualizados e liberados novamente, o ID da Revisão é incrementado, criando uma nova caixa.

A “caixa” Item-Revisão – rotulada com o ID do Item e o ID da Revisão. O conteúdo são os dados necessários para construir, ou representar, aquela 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 do 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

Aprimorando a trilha de auditoria do conteúdo em um Workspace, o Altium Designer oferece a possibilidade de 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 subsequente 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 subsequente para inserir uma nota relevante para essa liberação. Esse recurso está disponível ao liberar novamente qualquer tipo de Item que suporte o paradigma de Direct Editing.

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 para 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 das alterações de estado da revisão na coluna Note, dentro da região Timeline. Para cada estado na 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 guia de visualização de aspecto Lifecycle para um Item-Revisão selecionado. Para cada estado na 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 Item

Juntamente com as 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 atualmente selecionado.

Esse comando invoca a criação de um novo item do Workspace do tipo selecionado. Quando um tipo de pasta de componente é selecionado no painel, por exemplo, é oferecido um botão . Isso abrirá um componente recém-criado desse tipo no Component Editor. Da mesma forma, um botão é exibido quando uma pasta do tipo Output Job foi selecionada, e assim por diante. O botão será exibido após uma busca de componente, conforme inserida no campo de caminho do componente na parte superior do painel, o que cria uma atividade Part Request que se aplica ao componente selecionado nos resultados da busca.

Posicionamento por arrastar e soltar

O posicionamento de determinados Itens do Workspace em um projeto de PCB no Altium Designer é simplificado com a capacidade de arrastar e soltar revisões desses tipos de Item no documento ativo (e aplicável), diretamente do painel Explorer. Há suporte para arrastar:

• Uma revisão de um Item de componente para o documento esquemático ativo (ou documento PCB). O modelo aplicável para o domínio escolhido aparecerá flutuando no cursor de acordo.
• Uma revisão de um Item de folha esquemática gerenciada para o documento esquemático ativo. Um símbolo de folha que referencia a folha ficará flutuando preso ao cursor.
• Uma revisão de um Item de modelo 3D para um documento PCB ou Biblioteca PCB, criando um objeto 3D Body que referencia aquela Revisão do Item.

Navegue no seu Workspace até encontrar o Item necessário para ser posicionado. O posicionamento envolve uma revisão específica desse Item, portanto, certifique-se de expandir a entrada principal do Item para listar todas as revisões disponíveis (clique no botão no canto superior direito do painel e desabilite 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 oferece suporte ao acesso e ao posicionamento de componentes a partir do painel Components.

Baixando dados de conteúdo

Baixe os dados armazenados em uma revisão de um Item clicando com o botão direito nessa revisão e escolhendo o comando Operations » Download no menu de contexto. Os dados associados serão baixados para uma subpasta dentro do diretório escolhido, nomeada usando o ID da Revisão do Item. Os arquivos podem ser encontrados na pasta Released dentro dela.

Tipo de conteúdo de arquivo binário

O Altium Designer, em conjunto com o seu Workspace conectado, oferece a capacidade de armazenar arquivos livres em um tipo especial de conteúdo – o Item Binary File. Esses Itens podem ser criados para acomodar um ou mais arquivos de qualquer formato. Isso permite que você aproveite efetivamente a natureza segura do Workspace e reforça o Workspace como o local perfeito para armazenar qualquer coisa, incluindo seus arquivos binários de origem juntos em uma única entidade. E, facilitando o fluxo simplificado de arquivos de dados, é fornecida uma funcionalidade bidirecional de arrastar e soltar, permitindo que você mova rapidamente arquivos entre pastas no seu Workspace e pastas no seu Windows Explorer.

• Crie um Item do tipo de conteúdo Binary File no Workspace. Uma nova revisão de um Item Binary File pode ser criada carregando o(s) arquivo(s) aplicável(is). Isso pode ser feito de algumas maneiras — veja  Carregando dados em uma nova revisão de um Item para mais informações.
• Se você precisar alterar o(s) arquivo(s) armazenado(s) em um Item Binary File, carregue o(s) novo(s) arquivo(s) necessário(s) para esse Item – o(s) novo(s) arquivo(s) será(ão) armazenado(s) na próxima revisão desse Item.
• Para abrir um arquivo armazenado em uma revisão de um Item Binary File, selecione esse arquivo – na guia de visualização de aspecto Details da revisão – depois clique com o botão direito e escolha o comando Open no menu de contexto. O aplicativo relevante (ou o próprio Altium Designer) será usado para apresentar o arquivo, quando aplicável.

Usando um arquivo binário com preferências de template

Como parte das suas Preferências do Altium Designer, você pode definir documentos template padrão usados ao criar um novo documento de um determinado tipo. Isso é feito na guia Defaults da página Data Management – Templates da caixa de diálogo Preferences. Um documento template padrão pode ser baseado em arquivo ou vir de um Workspace conectado.

Para alguns tipos de documento (ActiveBOM Document, Out Job File, Multi-board Schematic e Multi-board Assembly), um documento de modelo padrão baseado no Workspace pode ser obtido somente a partir de um arquivo binário. Portanto, você precisa carregar o documento de modelo necessário na revisão de um arquivo binário e, em seguida, usá-lo como padrão para o novo documento.

Carregue o documento necessário (por exemplo, um arquivo OutputJob) na revisão inicial de um novo arquivo binário.

Agora, quando você tentar definir um novo padrão de documento a partir do Workspace conectado, poderá procurar o arquivo binário, e a entrada de preferências será preenchida adequadamente.

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