Managing Content with the Item Manager

Altium Designer, em conjunto com o seu Workspace ligado, oferece a capacidade de atualizar componentes num desenho de placa existente para utilizar componentes que residem nesse Workspace. Os componentes provenientes de bases de dados e de bibliotecas baseadas em ficheiros podem ser atualizados individualmente para componentes do Workspace, ou atualizados em lote através da correspondência automática de parâmetros no Altium Designer Item Manager.

Utilizando um sistema de regras altamente configurável para direcionar componentes adequados no Workspace, a caixa de diálogo Item Manager fornece uma forma rápida e eficaz de converter o projeto PCB atual para um projeto que utiliza Componentes do Workspace.

A Item Manager disponibiliza duas capacidades principais relativamente a componentes e folhas de circuito esquemático reutilizável num projeto de desenho de placa:

• Migration – em primeiro lugar, permite a conversão de um projeto de desenho que utiliza componentes e folhas esquemáticas baseados em abordagens tradicionais para a utilização de entidades do Workspace (componentes e folhas geridas). Neste contexto, pode ser vista como fornecendo uma função de “converter para utilizar dados do Workspace”.
• Synchronization – em segundo lugar, depois de um desenho ter sido convertido para utilizar conteúdo do Workspace, a Item Manager fornece uma forma simples de sincronizar o conteúdo utilizado no desenho com qualquer conteúdo de origem correspondente no Workspace que tenha sido atualizado. Neste contexto, pode ser vista como fornecendo uma funcionalidade de “atualizar a partir de dados do Workspace”.

Como informação de contexto, note que um componente individual num desenho pode ser atualizado para um componente do Workspace diretamente a partir do painel Properties no Editor de Esquemáticos. Para o fazer, selecione o componente na folha esquemática e depois utilize o menu pendente Source do painel para escolher um Workspace como fonte de dados do componente – é necessário estar ligado ao Workspace para ter acesso. A caixa de diálogo Component source subsequente fornece a opção de selecionar um componente de destino a partir do Workspace ou simplesmente ligar o componente ao Workspace, mantendo ou substituindo o identificador do componente (Design Item ID).

Se o componente do Workspace tiver sido selecionado, os dados do componente acedidos irão substituir o componente e os modelos existentes, e atualizar os parâmetros do componente. O painel também indicará o estado atual do ciclo de vida e o estado da revisão do componente, como mostrado abaixo.

Um componente local pode ser convertido num componente do Workspace individualmente, ou em massa utilizando o Item Manager. Aqui pode ver o componente original. Passe o cursor sobre a imagem para ver o componente substituído pela sua contraparte do Workspace.

Em alternativa, os componentes podem ser substituídos através do documento ActiveBOM do projeto (BomDoc).

Embora esta fosse uma abordagem trabalhosa para atualizar todos os componentes locais de um desenho para componentes do Workspace, mesmo num desenho de placa de pequena escala, a Item Manager fornece um método de conversão simples e automatizado que utiliza correspondência avançada de parâmetros (Automatching) e uma abordagem de atualização em lote. Uma aplicação típica da Item Manager seria atualizar um desenho de placa existente para utilizar componentes do Workspace e folhas esquemáticas geridas que tenham sido migradas para um Workspace a partir de bibliotecas da empresa.

Aceder ao Item Manager

A caixa de diálogo Item Manager é acedida a partir do Tools menu principal de um documento esquemático ativo (Tools » Item Manager) e apresenta todos os componentes e símbolos de folha encontrados no projeto ativo de desenho de placa.

Selecione o separador inferior Unmanaged ou Components da caixa de diálogo para preencher a lista de componentes no desenho atual. Essencialmente, a secção esquerda da caixa de diálogo mostra as definições de componentes do projeto ativo (Current Settings), enquanto a secção direita lista como estas irão mudar (New Settings) quando tiverem sido atribuídos componentes adequados do Workspace provenientes do Workspace. A região New Settings tem os mesmos campos que a região Current Settings . Para visualizar e aceder a símbolos de folha, selecione o separador Sheet Symbols.

Aceda ao Item Manager a partir do Tools menu principal do Editor de Esquemáticos. A caixa de diálogo será preenchida automaticamente com os componentes (e folhas esquemáticas) do desenho atual.

A forma como os dados dos componentes são apresentados na caixa de diálogo Item Manager é altamente configurável, com base nas colunas de dados que estão ativadas e/ou agrupadas. Isto permite que a lista do conteúdo do desenho e os respetivos parâmetros de sistema/utilizador sejam mostrados de uma forma que corresponde a abordagens específicas de identificação de componentes – todos os parâmetros do item, como por exemplo números de peça proprietários da empresa, podem ser apresentados conforme necessário.

Colunas

Para configurar que colunas são apresentadas no Item Manager, clique com o botão direito na área do cabeçalho de colunas da caixa de diálogo e selecione Columns » Select Columns no menu de contexto. A caixa de diálogo Select columns oferecerá todos os parâmetros disponíveis, incluindo os especificamente do desenho local ([Current Settings]) e do conteúdo no Workspace ([New Settings]). Utilize o controlo em forma de “olho” à esquerda de uma entrada para mostrar a coluna () ou não ().

As colunas apresentadas, e a sua ordem, podem ser configuradas de acordo com os seus sistemas de Workspace/bibliotecas e preferências.

Passe o cursor sobre o cabeçalho de uma coluna para revelar o respetivo ícone de filtro que, quando selecionado, permite restringir a listagem no Item Manager a tipos de entrada específicos ou a um filtro criado à medida.

Agrupamento

Para agrupar os dados do conteúdo listado por uma coluna de parâmetro específica, como por exemplo categoria do tipo de componente ou documento esquemático, etc., arraste a entrada do cabeçalho de coluna pretendida para a linha de título superior da caixa de diálogo (conforme indicado pelo texto de ajuda). A lista de conteúdo será reconfigurada para agrupar as suas entradas pela coluna de parâmetro atribuída.

Qualquer cabeçalho de coluna de dados pode ser arrastado para a linha superior da caixa de diálogo para agrupar as entradas listadas por esse parâmetro.

Migração para Conteúdo de Projeto do Workspace

Partindo do princípio de que o Workspace ligado está preenchido com coleções de componentes e folhas esquemáticas geridas, o projeto atual de desenho da placa pode ser convertido para utilizar esse conteúdo sempre que exista uma correspondência adequada. A correspondência entre itens locais e do Workspace pode ser efetuada manualmente ou como processo automatizado através do Item Manager, com base em correspondência de parâmetros configurável. Quando concluído, as definições dos componentes locais serão atualizadas para as respetivas contrapartes no Workspace.

Escolher Manualmente Conteúdo do Workspace

Para substituir manualmente um componente local (ou esquemático) por uma versão do Workspace, selecione a sua entrada na lista Item Manager e depois Choose manually nas respetivas opções do menu de contexto do botão direito. Também pode fazer duplo clique num item na grelha para escolher manualmente um item. Na caixa de diálogo Substituir Componente que surge em seguida, procure e selecione um Item com correspondência adequada no Workspace (será utilizada a revisão mais recente desse Item).

Exemplo de escolha manual de um componente do Workspace para utilizar como origem do componente existente no desenho.

Quando a caixa de diálogo é fechada (OK), a informação do componente do Workspace selecionado preencherá a região New Settings da entrada na lista. Tenha em atenção que, uma vez que a entrada passa agora a ser uma entidade pendente do Workspace, a entrada atualizada é transferida da listagem sob o separador Unmanaged para a lista sob o separador Managed.

Os detalhes relativos ao Item do Workspace escolhido aparecem na região New Settings da grelha, listados sob o separador Managed.

Correspondência Automática de Componentes

Para automatizar o processo de escolha de conteúdo correspondente do Workspace, o Item Manager disponibiliza uma capacidade configurável de correspondência automática que tenta fazer corresponder cada componente local do desenho com um componente no Workspace ligado. Quando é encontrada uma correspondência, esse componente do Workspace será proposto para a atualização.

A chave para as capacidades de correspondência automática de parâmetros do Gestor de Itens são as regras e opções de atualização disponíveis na caixa de diálogo Item Manager Options, acedida a partir do botão Item Manager da caixa de diálogo . As regras configuráveis determinam quais os parâmetros dos componentes no desenho ativo (local) que são comparados com os parâmetros de todos os componentes do Workspace no Source server selecionado.

Crie regras simples ou complexas para corresponder com precisão componentes locais a componentes adequados no Workspace.

A eficácia destas regras na obtenção de uma correspondência entre componentes locais e do Workspace dependerá dos parâmetros de componente disponíveis, que serão específicos dos sistemas da empresa ou de preferências individuais. No cenário mais simples, embora talvez pouco provável, as entradas de parâmetro Comment ou Component Name podem coincidir entre os componentes locais e os componentes equivalentes do Workspace. No caso ideal, contudo, tanto os componentes locais como os do Workspace partilharão uma referência interna da empresa ou um parâmetro de número de peça do fabricante.

Para criar, por exemplo, uma regra desse tipo baseada no número de peça, selecione e modifique uma regra existente (que também pode ser renomeada) ou utilize o botão para criar uma nova regra – é necessário que uma regra esteja selecionada (assinalada) para poder ser editada. Tenha em atenção que as listas pendentes de seleção Local Parameter e Server Parameter são independentes, o que permite indicar parâmetros com nomes diferentes – no exemplo abaixo, o parâmetro local Libray Reference e o parâmetro do Workspace Part Number representam um número de referência interno de peça da empresa.

Regras complexas com múltiplos parâmetros exigem que todos os parâmetros de componente indicados correspondam aos de um componente no Workspace.

Executar uma regra de correspondência por número de peça/referência como a acima é suscetível de criar uma correspondência quase completa entre os componentes locais e os do Workspace. Com a regra estabelecida, o processo de correspondência é iniciado através do botão na caixa de diálogo Item Manager.

A caixa de diálogo Automatching items que surge em seguida indicará correspondências positivas com o ícone de estado e incluirá uma referência ao nome da regra bem-sucedida.

Exemplo de obtenção de uma correspondência bem-sucedida entre componentes locais e do Workspace para muitos componentes utilizando uma única regra baseada num número de peça comum.

Quando não é possível encontrar uma correspondência, a entrada aparecerá com o ícone de estado , em texto vermelho, e com uma referência incluída que indica o motivo do erro ou da falha de correspondência – será necessário criar uma Rule diferente ou adicional para obter uma correspondência bem-sucedida para esses componentes. Note também que uma regra pode detetar mais do que um componente do Workspace como correspondência, o que é considerado um resultado bem-sucedido, mas requer intervenção manual para ser resolvido. Este conflito é considerado um resultado “ambíguo” e pode ser resolvido na caixa de diálogo Item Manager – veja abaixo.

Quando o processo de automatch estiver concluído, feche a caixa de diálogo Automatching items (OK) para preencher a caixa de diálogo Items Manager com as novas definições de componente propostas. O conteúdo pendente do Workspace que será aplicado às entradas correspondidas é listado na região New Settings, no separador Managed da caixa de diálogo, ou no separador Components juntamente com o conteúdo que não foi correspondido.

As alterações pendentes ao conteúdo do Workspace são detalhadas na região New Settings da caixa de diálogo.

Para resolver qualquer conteúdo ambíguo, geralmente causado por múltiplas correspondências, selecione o separador Ambiguous Items (ou Ambiguous Footprints) e faça uma escolha adequada no menu pendente da célula Revision HRID, na secção New Settings da caixa de diálogo (que é apresentada como <Not selected> por predefinição). Note que múltiplas correspondências e, por conseguinte, as escolhas disponíveis, podem de facto estar a referir revisões diferentes do mesmo componente. Quando a questão for resolvida (deixar de ser classificada como ambígua), a entrada do componente será movida para as listas dos separadores Managed/Components.

Quando uma regra deteta mais do que uma correspondência, o separador Ambiguous Items oferece a capacidade de nomear uma escolha. Mais de seis correspondências resultarão num erro da regra.

Regras de Correspondência Avançadas

Conforme descrito acima, as regras Item Manager estabelecem correspondências de parâmetros entre os componentes locais do projeto e os componentes do Workspace. Pode ser criado qualquer número de regras, e estas funcionam com base numa prioridade descendente. Se a primeira regra (superior) falhar, então é aplicada a regra seguinte – efetivamente, uma relação Boolean OR sequencial. Uma regra só está ativa quando a respetiva caixa de seleção está ativada.

Quando o processo de automatch é executado, a coluna State Notes na caixa de diálogo Automatching items indica que regras falharam ao encontrar uma correspondência. Neste caso, é necessária uma regra diferente ou nova para fazer corresponder satisfatoriamente os parâmetros disponíveis.

Embora as regras básicas possam não conseguir encontrar uma correspondência para todos os componentes, podem ser criadas regras paramétricas mais específicas para alcançar um resultado totalmente correspondido.

Utilize o botão Item Manager Options da caixa de diálogo Add Rule para criar uma nova regra, e o respetivo  para aplicar várias condições de correspondência de parâmetros. Clique em  para remover o valor selecionado. À medida que cada condição de parâmetro é adicionada, a regra torna-se progressivamente mais específica, e todas as condições têm de ser satisfeitas para que a correspondência da regra tenha êxito – efetivamente, uma condição Boolean AND. Clique no botão Remove para remover a regra de correspondência selecionada.

Tomando o exemplo aqui apresentado, em que (por exemplo) os componentes não podem ser correspondidos por parâmetros de número de peça/referência, pode ser criada uma nova regra para fazer corresponder especificações adequadas para os condensadores sem correspondência listados acima.

As regras funcionam numa sequência de cima para baixo até ser encontrada uma correspondência. As regras com múltiplos parâmetros têm de satisfazer todas as condições para que haja correspondência.

Opções de Atualização

A caixa de diálogo Item Manager Options disponibiliza um conjunto de opções de atualização de conteúdo que podem ser utilizadas para refinar ainda mais a forma como os componentes do Workspace correspondidos automaticamente são aplicados ao desenho atual da placa.

A região Matching rules apresenta as regras atuais definidas para correspondência. Consulte a secção Automatching Components para saber mais. 

As Update options do Item Manager proporcionam uma forma flexível de determinar que parâmetros são atualizados e em que condições.

As opções são aplicadas ao desenho atual através do processo ECO e comportam-se da seguinte forma:

• Update ‘Lock Designator’ field – quando selecionada, o estado Locked do componente local para o campo Designator será substituído pelo respetivo estado no componente do Workspace associado.
• Update ‘Lock Part-ID’ field – quando selecionada, o estado Locked do seletor de ID de dispositivo multipartes do componente local passará a assumir o do componente do Workspace associado.
• Update Parameters – selecione para permitir que os parâmetros de um componente sejam atualizados para os do componente do Workspace associado. Ativa as opções abaixo.
  • botão – abre a caixa de diálogo Library Update Settings (ver abaixo).
  • Preserve parameter location – quando selecionada, a posição de um parâmetro visível na folha esquemática permanece inalterada, em vez de ser reposta para a posição predefinida do componente do Workspace associado.
  • Preserve parameter visibility – quando selecionada, o estado Visible de um parâmetro permanece inalterado, em vez de adotar o do componente do Workspace associado.

A caixa de diálogo Library Update Settings inclui uma lista de todos os parâmetros disponíveis, para todos os componentes, no projeto atual da placa (clique com o botão direito para aceder às funções de ativação/desativação em massa). Os parâmetros assinalados na lista serão atualizados quando um componente local for substituído/atualizado para um componente do Workspace – o comportamento dessa atualização é determinado pelas opções descritas abaixo.

Pode especificar com precisão quais os parâmetros do componente que são atualizados. Clique com o botão direito para opções de seleção.

O comportamento de substituição (ou adição) de parâmetros é determinado pelas duas opções inferiores na caixa de diálogo:

• Library parameters not in sheet – define o comportamento da atualização quando um parâmetro do componente do Workspace (Library) não existe no componente local (Sheet).
  • Add – o parâmetro é adicionado ao componente durante a atualização.
  • Do not add – o parâmetro não é adicionado ao componente durante a atualização.
  • Add if not blank – o parâmetro só é adicionado ao componente durante a atualização se tiver dados válidos (a sua entrada Value não está em branco).
• Sheet parameters not in library – define o comportamento da atualização quando um parâmetro do componente local (Sheet) não existe no componente do Workspace associado (Library).
  • Remove – o parâmetro existente (local) é eliminado do componente durante a atualização.
  • Do not remove – o parâmetro existente não é eliminado do componente durante a atualização.
  • Remove if blank – o parâmetro existente é eliminado do componente durante a atualização se não tiver dados válidos (a sua entrada Value está em branco).

Aplicar a Atualização

As alterações propostas que foram configuradas no Item Manager são aplicadas ao desenho atual da placa através da geração e execução de uma Engineering Change Order (ECO). Selecione o intervalo de componentes listados que pretende atualizar e, em seguida, a opção ECO pretendida no menu do botão – as opções são:

• Generate ECO – utilize este comando para gerar e executar um ECO através da caixa de diálogo Engineering Change Order. Na caixa de diálogo, pode percorrer as ações que serão executadas para implementar essas alterações e desativar quaisquer ações, conforme necessário. Quando estiver satisfeito, execute o ECO e as alterações serão aplicadas.
• Apply ECO – utilize este comando para criar e executar diretamente um ECO de forma “silenciosa” (sem que a caixa de diálogo Engineering Change Order apareça).

As alterações são implementadas através da utilização de uma Engineering Change Order (ECO), que pode ser executada de forma silenciosa ou através de uma caixa de diálogo (como mostrado).

O processo ECO executado atualizará os componentes do projeto em conformidade, que passarão então a ser listados na caixa de diálogo Item Manager como componentes do Workspace atualmente atualizados. Note que o ícone anterior de cada entrada () mudou para indicar a referência a um componente do Workspace ().

O Item Manager mostra as novas definições atuais para o conteúdo do desenho no projeto PCB. Os componentes de desenho anteriormente locais foram totalmente substituídos por componentes do Workspace.

No editor esquemático, os componentes atualizados estão ligados aos seus componentes correspondentes no Workspace – a informação da ligação ativa irá detetar uma alteração no estado de revisão do componente do Workspace quando/se este for posteriormente atualizado. Selecione um componente no espaço de desenho e observe o seu Source e a informação associada no Properties panel.

Exemplo que mostra a substituição bem-sucedida de um componente local, em que o painel Properties mostra a origem no Workspace e o estado de revisão do componente de substituição.

Sincronização com Conteúdo do Workspace Alterado

Durante o desenvolvimento de um produto, é muito provável que ocorram alterações nos componentes de origem do design ou nas folhas esquemáticas geridas. Por exemplo, os modelos de componentes podem ser atualizados para uma nova norma de desenho, ou as definições dos componentes podem ter sido atualizadas para adicionar novos parâmetros. Quaisquer alterações feitas aos componentes do Workspace e às folhas geridas utilizadas num design têm de ser detetadas e refletidas em quaisquer folhas esquemáticas afetadas.

Detetar quando são necessárias atualizações

Para um componente individual ou símbolo de folha selecionado, o modo apropriado Component ou Sheet Symbol do Properties panel fornece uma indicação imediata de que um objeto está desatualizado relativamente aos seus dados de origem no Workspace. Utilize o botão ou associado para atualizar os dados desse objeto a partir do seu Workspace de origem.

O estado desatualizado de um componente ou folha esquemática gerida é indicado no Properties panel quando o objeto é selecionado. É disponibilizado um botão para atualizar o objeto selecionado para a sua revisão mais recente.

Além de ser utilizado para detetar e gerir componentes e folhas esquemáticas que atualmente são entidades não pertencentes ao Workspace (indicadas como [Not Managed] e não provenientes de um Workspace), o Item Manager também é utilizado para detetar e gerir todo o conteúdo que esteja desatualizado.

Quando o Item Manager é aberto, deteta e lista automaticamente todos os componentes e folhas esquemáticas geridas (indicando se provêm de um Workspace ou não) e depois compara a Item-Revision de cada conteúdo do Workspace nos esquemáticos com as revisões disponíveis desse conteúdo no Workspace. Se existir conteúdo com uma revisão mais recente disponível no Workspace, isso é assinalado como Out of date na coluna Revision Status do Item Manager.

Tome nota de quaisquer componentes e folhas esquemáticas geridas que tenham sido detetados como estando Out of Date, selecione-os e, em seguida, clique com o botão direito do rato para executar uma Update.

Atualizar o conteúdo

Para atualizar o conteúdo desatualizado, este tem de ser selecionado e, em seguida, tem de ser aplicado o comando Update to latest revision a partir do menu de contexto do botão direito do rato. A região New Settings da caixa de diálogo mostrará então o detalhe de cada nova Item-Revision.

Depois de as alterações terem sido configuradas conforme necessário, essas alterações precisam de ser implementadas. Isto é feito através de uma Engineering Change Order (ECO). O menu pendente associado ao botão ECO , na parte inferior do Item Manager, disponibiliza duas formas de efetuar uma atualização:

• Generate ECO - utilize este comando para gerar e executar uma ECO através da caixa de diálogo Engineering Change Order. Ao utilizar a caixa de diálogo, pode analisar as ações que serão realizadas para implementar essas alterações. Pode desativar quaisquer ações conforme necessário - tem sempre controlo total sobre o que é alterado. Quando estiver pronto, execute a ECO e as alterações serão aplicadas.
• Apply ECO - utilize este comando para criar e executar diretamente uma ECO de forma silenciosa - sem que a caixa de diálogo Engineering Change Order seja apresentada.

Selecione o conteúdo desatualizado e utilize o comando do botão direito do rato Update to latest revision para carregar a região New Settings com os detalhes da revisão atualizada. Em seguida, aplique a atualização – através de uma ECO – ao(s) componente(s) e folha(s) esquemática(s) gerida(s) de volta ao design.

A verificação de que a substituição foi, de facto, bem-sucedida pode ser efetuada ao nível individual do componente/símbolo de folha nas folhas esquemáticas do projeto de design da placa. Aceda ao Properties panel de um item selecionado, que passará agora a mostrar uma ligação de regresso ao Item gerido de origem correspondente. Em alternativa, a verificação pode ser efetuada rapidamente de volta no Item Manager, que é atualizado para refletir as novas definições dos itens no projeto de design da placa, na região Current Settings da grelha.

Relatório do Item Manager

Antes de avançar com um processo de atualização ou alteração de componentes no Item Manager, poderá ser prudente gerar um instantâneo das informações atuais da listagem utilizando a função Export da caixa de diálogo. Para o fazer, clique com o botão direito do rato em qualquer ponto do Item Manager e selecione Export no menu de contexto; em seguida, navegue até uma localização adequada e atribua o nome pretendido ao relatório. O relatório é gerado como um ficheiro HTML e apresentado com o mesmo esquema que a visualização atual do Item Manager.

Selecione Export no menu do botão direito do rato para gerar um relatório a partir do Item Manager. O relatório é gerado em formato HTML e representa um instantâneo da listagem completa do Item Manager.