Working with Items

Num Workspace ligado, cada entidade de design que pode ser armazenada, gerida e reutilizada é representada como um tipo específico de Item. Para dar resposta à 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 se baseia no Esquema de Nomenclatura de Revisões escolhido. Cada novo Item é criado numa pasta e, assim que tiver definido as pastas necessárias num Workspace, poderá criar novos Items na pasta selecionada, na região de Items do painel Explorer.

Tipos de Conteúdo Suportados

Diferentes Items são utilizados para armazenar e representar diferentes tipos de dados. Um Item pode representar um símbolo esquemático, outro um modelo de componente PCB, enquanto outro pode conter os dados de fabrico gerados a partir de um projeto de placa libertado. Para declarar o tipo de conteúdo que um Item (ou, mais precisamente, as suas revisões) irá conter, a sua propriedade Content Type tem de ser especificada ao criar ou editar esse Item. Dito de outra forma, está, na essência, a especificar o Item Type.

A tabela seguinte apresenta os vários tipos de conteúdo (tipos de Item) que podem ser criados manualmente por um utilizador num Workspace ligado, juntamente com os seus:

• Associated Folder Type – o tipo de pasta criado especificamente para armazenar conteúdo desse tipo, quando disponível. Isto não tem qualquer influência sobre o conteúdo da pasta. Apenas fornece uma 'pista' visual sobre o que está armazenado numa pasta e pode ser útil ao navegar num Workspace à procura 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 utilizado ao atribuir o ID único a um Item criado desse tipo de conteúdo, quando o Esquema de Nomenclatura de Itens da pasta principal utiliza a entrada $CONTENT_TYPE_CODE.

• Folder Type Code – o código utilizado ao atribuir o ID único a um Item criado desse tipo de conteúdo, quando o Esquema de Nomenclatura de Itens da pasta principal utiliza 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. É feita uma alteração e o novo conteúdo de dados é guardado/carregado/libertado numa nova revisão, garantindo que nenhuma revisão existente pode alguma vez ser sobrescrita e assegurando, assim, a máxima integridade. Os dados armazenados em cada revisão de um item são, por isso, tipicamente diferentes. Para identificar estas diferentes revisões de um Item, é utilizado um identificador de revisão (ID) que, em combinação com o ID do Item, cria um identificador único para cada libertação de um Item. Isto dá-nos o Item-Revision.

Assim, um ID completo de Item-Revisão identifica simplesmente uma revisão específica de um Item principal. Haverá sempre pelo menos uma revisão de um Item (a primeira libertação), mas poderá haver muitas, dependendo do número de vezes que os dados desse Item tiverem sido guardados/carregados/libertados. Um ponto importante a referir aqui é que só se pode libertar para um determinado Item-Revisão uma única vez. Se houver uma alteração, então tem de ser criado um novo Item-Revisão. Isto assegura a máxima integridade, uma vez que os dados contidos numa determinada revisão nunca podem ser sobrescritos por uma nova libertação para a mesma revisão. Para libertar novamente, tem de ser utilizado um novo Item-Revisão.

A forma mais simples de compreender o conceito de um Item e das suas revisões é pensar numa 'caixa', na qual são armazenados todos os dados dessa revisão específica desse Item específico. Quando o Item é libertado, os dados são colocados na caixa e a caixa é fechada. O ID do Item e o ID da Revisão tornam-se etiquetas na lateral dessa caixa – permitem reconhecer de imediato para que serve o conteúdo da caixa. Se os dados precisarem de ser atualizados e libertados novamente, o ID da Revisão é 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 são os dados necessários para construir ou representar essa revisão desse Item. O ato de libertar fecha a caixa, impedindo que quaisquer outros dados sejam libertados 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 utilizado para o Item principal. O formato específico utilizado num esquema é configurável e dependerá das necessidades de cada organização.

Notas de Alteração de Estado e de Libertação

Para melhorar o rasto de auditoria do conteúdo num Workspace, o Altium Designer permite introduzir notas ao alterar o estado do ciclo de vida de um Item-Revisão e, para muitos tipos de conteúdo, ao libertar os dados de origem para revisões planeadas no Workspace.

Notas de Alteração de Estado

Ao alterar o estado do ciclo de vida de um Item-Revisão num Workspace, utilize a região State change note da caixa de diálogo de alteração de estado subsequente para introduzir uma nota relevante para essa alteração.

Adicionar uma nota para explicar a alteração no estado do ciclo de vida de um Item-Revisão.

Notas de Libertação

Ao libertar dados de origem para uma nova revisão planeada de um Item num Workspace, utilize a região Release notes da caixa de diálogo Create Revision subsequente para introduzir uma nota relevante para essa libertação. Esta funcionalidade está disponível ao voltar a libertar qualquer tipo de Item que suporte o paradigma Direct Editing.

Exemplo de adição de uma nota de libertação durante a nova libertação de um empilhamento de camadas para um Workspace de destino.

Ver as Notas Associadas às Revisões de um Item

As notas adicionadas a qualquer revisão de um Item podem ser vistas nos seguintes locais:

• Detailed Item view – veja a nota de libertaçã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 tiver sido adicionada) também pode ser vista na representação gráfica do ciclo de vida da revisão.
• Explorer panel – mudar para o separador de vista de aspeto Lifecycle para uma Revisão de Item selecionada. Para cada estado na vida de uma revisão, a nota aplicável (se tiver sido adicionada) pode ser vista na representação gráfica do ciclo de vida da revisão. Além disso, veja a nota de publicaçã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 (poderá ser necessário ativar a apresentação desta coluna).

Visualização das 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.

Este 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, é disponibilizado um botão . Isto abrirá um componente recém-criado desse tipo no Component Editor. De forma semelhante, é apresentado um botão quando tiver sido selecionada uma pasta do tipo Output Job, e assim por diante. O botão surgirá após uma pesquisa de componente, conforme introduzida no campo de caminho do componente no topo do painel, o que cria uma atividade Part Request que se aplica ao componente selecionado nos resultados da pesquisa.

Colocação por Arrastar e Largar

A colocação de determinados Itens do Workspace num projeto de design PCB no Altium Designer é simplificada com a capacidade de arrastar e largar revisões destes tipos de Item para o documento ativo (e aplicável), diretamente a partir do painel Explorer. Está disponível 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á a flutuar no cursor em conformidade.
• 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á preso 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 no seu Workspace até ao Item necessário para colocação. A colocação envolve uma revisão específica desse Item, por isso certifique-se de que expande 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 pretendida e arraste uma instância da mesma para o documento de design.

Além disso, o Altium Designer suporta o acesso e a colocação de componentes a partir do Components panel.

Transferência de Dados de Conteúdo

Transfira os dados armazenados numa 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 transferidos para uma subpasta sob a diretoria escolhida, com o nome baseado no ID da Revisão do Item. Os ficheiros podem ser encontrados na pasta Released aí contida.

Tipo de Conteúdo de Ficheiro Binário

O Altium Designer, em conjunto com o seu Workspace ligado, oferece a possibilidade de armazenar ficheiros livres num tipo de conteúdo especial – o Item Binary File. Estes Itens podem ser criados para acomodar um ou mais ficheiros de qualquer formato. Isto permite-lhe tirar partido de forma eficaz da natureza segura do Workspace e sublinha o Workspace como o local perfeito para armazenar qualquer coisa, incluindo os seus ficheiros binários de origem em conjunto numa única entidade. E, para facilitar o fluxo simplificado de ficheiros de dados, é fornecida funcionalidade bidirecional de arrastar e largar, permitindo-lhe mover rapidamente ficheiros entre pastas no seu Workspace e pastas no Windows Explorer.

• Crie um Item do tipo de conteúdo Binary File no Workspace. Uma nova revisão de um Binary File Item pode ser criada carregando o(s) ficheiro(s) aplicável(eis). Isto pode ser feito de duas formas - consulte  Uploading Data into a New Revision of an Item para mais informações.
• Se precisar de alterar o(s) ficheiro(s) armazenado(s) num Binary File Item, carregue o(s) novo(s) ficheiro(s) necessário(s) para esse Item – o(s) novo(s) ficheiro(s) será(ão) armazenado(s) na revisão seguinte desse Item.
• Para abrir um ficheiro armazenado numa revisão de um Binary File Item, selecione esse ficheiro – no separador de vista de aspeto Details da revisão – e depois clique com o botão direito do rato e escolha o comando Open no menu de contexto. A aplicação relevante (ou o próprio Altium Designer) será utilizada para apresentar o ficheiro, quando aplicável.

Utilizar um Ficheiro Binário com Preferências de Template

Como parte das suas Preferências do Altium Designer, pode definir documentos template predefinidos utilizados ao criar um novo documento de um determinado tipo. Isto é feito a partir do separador Defaults da página Data Management – Templates da caixa de diálogo Preferences. Um documento template predefinido pode ser baseado em ficheiro ou proveniente de um Workspace ligado.

Para alguns tipos de documento (ActiveBOM Document, Out Job File, Multi-board Schematic e Multi-board Assembly), um documento template predefinido baseado no Workspace só pode ter origem num ficheiro binário. Por isso, tem de carregar o documento template necessário para a revisão de um ficheiro binário e depois utilizá-lo como predefinição para o novo documento.

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

Agora, quando tentar definir uma nova predefinição de documento a partir do Workspace ligado, pode procurar o ficheiro binário e a entrada das preferências será preenchida em conformidade.

Utilização bem-sucedida de um OutputJob como predefinição para novo documento, através do ficheiro binário que o contém.