Working with Items

Dentro de 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 é efetivamente 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 dentro de um Workspace, você pode criar novos Itens na pasta selecionada na região de Itens do painel Explorer.

Tipos de Conteúdo Suportados

Itens diferentes 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) 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. Simplesmente 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 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, e o Esquema de Nomeação de Itens 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 possa jamais ser sobrescrita e, assim, garantindo a mais alta integridade. Portanto, os dados armazenados em cada revisão de um item são tipicamente 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 determinado Item-Revisão uma única vez. Se houver uma alteração, então um novo Item-Revisão deve ser criado. Isso garante a mais alta integridade, pois os dados contidos em uma determinada revisão nunca podem ser sobrescritos por uma nova liberação para a mesma revisão. Para liberar novamente, um novo Item-Revisão deve ser usado.

A maneira mais simples de entender 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 específico 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' de 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 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 Mudança de Estado e de Liberação

Para aprimorar a trilha de auditoria do conteúdo em um Workspace, o Altium Designer oferece a capacidade 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 Mudança 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 subsequente de mudança de estado 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 subsequente Create Revision 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 Direct Editing.

Um exemplo de adição de uma nota de liberação durante a nova liberação de uma pilha 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 para mudanças 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 mudança 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 de 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 é mostrado quando um tipo de pasta Job de Saída foi selecionado, e assim por diante. O botão aparecerá após uma pesquisa de componente, conforme inserida no campo de caminho de componente na parte superior do painel, o que cria uma atividade Part Request que se aplica ao componente selecionado nos resultados da pesquisa.

Posicionamento por Arrastar e Soltar

A inserção de determinados Itens do Workspace em um projeto de design de PCB no Altium Designer é simplificada 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 Component Item para o documento esquemático ativo (ou documento PCB). O modelo aplicável para o domínio escolhido aparecerá flutuando no cursor conforme apropriado.
• Uma revisão de um Managed Schematic Sheet Item para o documento esquemático ativo. Um símbolo de folha que referencia a folha ficará flutuando anexado ao cursor.
• Uma revisão de um 3D Model Item para um documento PCB ou Biblioteca PCB, criando um objeto 3D Body que referencia essa Revisão de Item.

Navegue pelo seu Workspace até 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 posicionamento de componentes a partir do painel Components panel.

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 Arquivo Binário

O Altium Designer, em conjunto com seu Workspace conectado, oferece a capacidade de armazenar arquivos livres em um tipo de conteúdo especial – 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, para facilitar o fluxo simplificado de arquivos de dados, é fornecida funcionalidade bidirecional de arrastar e soltar, permitindo mover rapidamente arquivos entre pastas no seu Workspace e pastas no Windows Explorer.

• Crie um Item do tipo de conteúdo Arquivo Binário no Workspace. Uma nova revisão de um Item Arquivo Binário pode ser criada carregando o(s) arquivo(s) aplicável(is). Isso pode ser feito de algumas maneiras - consulte  Uploading Data into a New Revision of an Item para obter mais informações.
• Se você precisar alterar o(s) arquivo(s) armazenado(s) em um Item Arquivo Binário, 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 Arquivo Binário, 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 Modelo

Como parte das suas Preferências do Altium Designer, você pode definir documentos de modelo padrão usados ao criar um novo documento de um tipo específico. Isso é feito na guia Defaults da página Data Management – Templates page 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 documento (ActiveBOM Document, Out Job File, Multi-board Schematic e Multi-board Assembly), um documento de modelo padrão baseado em Workspace só pode ser obtido de um arquivo binário. Portanto, você precisa carregar o documento de modelo necessário na revisão de um arquivo binário e depois usá-lo como padrão para o novo documento.

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

Agora, quando você tentar definir um novo documento padrão 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 documento padrão, por meio do arquivo binário que o contém.