Sincronização de Dados do Banco de Dados de Componentes com os Dados do Workspace

As bibliotecas de componentes de banco de dados, cujos parâmetros de componentes são obtidos de um banco de dados mestre, podem ser sincronizadas com esse banco de dados após a migração da biblioteca para um Workspace do Altium 365 ou Workspace do Enterprise Server.

Usando o recurso Components Synchronization do Altium Designer, conforme descrito abaixo, os dados de uma tabela selecionada no banco de dados mestre são usados para criar um perfil de sincronização totalmente configurado e mapeado, que pode ser executado sob demanda ou como um processo agendado. Como resultado, as atualizações de dados no banco de dados mestre serão propagadas para os parâmetros dos componentes correspondentes em um Workspace conectado.

Esse recurso permite que empresas que gerenciam dados de componentes de forma centralizada em um banco de dados de sistema corporativo aproveitem os benefícios de um Workspace, mantendo a sincronização com seu sistema corporativo (PLM, PDM, ERP etc.) — ou simplesmente com um banco de dados compartilhado ou arquivo CSV. No modo de sincronização automática, uma tarefa agendada do Windows realizará a atualização dos dados do banco de dados para o Workspace independentemente do cliente de projeto Altium Designer.

Consulte Importação de bibliotecas existentes para seu Workspace conectado para obter informações sobre como importar bibliotecas de banco de dados para seu Workspace.

Criação de uma configuração de sincronização de componentes

A sincronização do banco de dados com o Workspace é estabelecida por meio da criação e configuração de um documento Components Synchronization Configuration (*.CmpSync) no Altium Designer. Quando estiver conectado ao seu Workspace, crie o novo documento usando o comando de menu File » New » Components Synchronization Configuration.

Adicione a fonte de dados mestre desejada à configuração de sincronização usando o botão ou arrastando e soltando os arquivos apropriados na área Data Sources da interface. A configuração aceita as seguintes fontes de dados de parâmetros de componentes:

• Arquivos de biblioteca de banco de dados (*.dBLib) — que se conectam a uma fonte de banco de dados mestre.

• Arquivos de banco de dados do Access (*.mdb, *.accdb)

• Planilhas do Excel (*.xlsx)

• Arquivos CSV (*.csv)

• Outras fontes de dados, como interfaces compatíveis com OLE DB baseadas em servidor (incluindo bancos de dados PostgreSQL), por meio de uma string de conexão proprietária.

No exemplo abaixo, uma biblioteca de banco de dados de componentes de diodo Zener foi adicionada à configuração — observe que essa dBLib já foi migrada para o Workspace. O banco de dados de origem da biblioteca (Semi_8.mdb) contém as tabelas DiodeGP e Zeners, sendo que esta última está habilitada para sincronização.

Selecione a tabela de dados (ou as tabelas) a ser sincronizada no painel Properties. Ela será então acessada como uma fonte de dados paramétricos que preenche a listagem Components Preview. O sistema tentará identificar o tipo de componente (resistor, capacitor etc.) a partir dos dados dos parâmetros e, em seguida, aplicará esse Component Type e seu Component Template correspondente à configuração — se necessário, essas configurações podem ser selecionadas manualmente. Selecione uma entrada de tabela em Data Sources para ver a configuração atual no painel Properties.

Neste exemplo, o tipo de componente (Zeners) foi identificado e seu Template de componente foi aplicado. O template determina então a pasta de destino no Workspace, o esquema de nomenclatura dos componentes e a definição de ciclo de vida aplicada. As entradas de componentes são associadas às entradas do banco de dados de origem por meio de um identificador exclusivo, conforme especificado na entrada Key Parameter do painel Properties — neste caso, é usado Part Number, embora Name ou até mesmo Description fossem igualmente eficazes.

Sincronização

Quando estiver satisfeito com as configurações de sincronização, salve o documento de configuração e execute a sincronização do banco de dados com os componentes da biblioteca do Workspace usando o botão , ou configure uma sincronização agendada ().

No exemplo mostrado abaixo, o parâmetro de descrição de duas entradas de componentes foi atualizado no banco de dados de origem/mestre. Essas alterações podem ser visualizadas clicando no botão de atualização () na interface de configuração — isso é opcional e não afeta a sincronização dos dados atualizados.

Uma sincronização subsequente atualizará os parâmetros dos componentes do Workspace com os dados atuais dos campos do banco de dados. Essa alteração pode ser visualizada nos painéis Components e Explorer. Atualize suas visualizações usando a tecla F5 ou o botão , respectivamente.

Como pode ser visto no painel Explorer, novas revisões foram criadas para os dois componentes atualizados. Os parâmetros que gerarão novas revisões de componentes quando forem atualizados a partir do banco de dados mestre são determinados pelas definições de Parameter Mapping na configuração de sincronização.

Mapeamento de parâmetros

O controle dos parâmetros sincronizados está disponível na região Parameter Mapping do painel Properties, que apresenta uma grade com a relação entre os parâmetros de destino do Workspace e os parâmetros (campos) do banco de dados de origem. Também estão disponíveis configurações para o tipo de parâmetro transferido (texto ou com reconhecimento de unidades) e o controle da criação de novas revisões para parâmetros atualizados.

Em termos de mapeamento de parâmetros, as colunas da tabela representam o destino no Workspace (Parameter) e os campos do banco de dados de origem/mestre (Column), como nos dados das colunas mostrados na grade Components Review da interface principal de configuração. Os parâmetros podem ser removidos da sincronização (ignorados) ou remapeados para outro parâmetro disponível. Os nomes dos parâmetros podem ser editados, e conjuntos de parâmetros podem ser adicionados, editados e removidos. Os parâmetros básicos do componente (ID, Name, Description) podem ser remapeados, mas, fora isso, são somente leitura.

A imagem acima mostra três estados de mapeamento de parâmetros no painel Properties. À esquerda, nenhum modelo de componente foi aplicado; a imagem central mostra o resultado quando um modelo foi especificado; e a imagem à direita demonstra o mapeamento de parâmetros e o controle de revisões modificados.

• Imagem à esquerda: por padrão, sem um modelo aplicado, os parâmetros são essencialmente mapeados em uma correspondência um a um entre o banco de dados mestre e os componentes do Workspace. O parâmetro ID definido como <Auto> aqui representa a criação automática (se necessária) do parâmetro Revision ID do Workspace, que está relacionado à configuração Revision Naming Scheme do item atual, em Advanced no painel. Observe também que o campo Comment do banco de dados é mapeado automaticamente para o parâmetro Name do Workspace.

• Imagem central: quando um modelo de componente é aplicado (Zeners aqui), os campos de parâmetros do banco de dados são mapeados para os parâmetros equivalentes do modelo. O sistema interpreta automaticamente os mapeamentos de parâmetros comuns, como de Pin Count para Pins (um parâmetro do modelo), neste caso. Os parâmetros que não estão definidos no modelo são mapeados em uma correspondência um a um — os nove parâmetros na parte inferior da lista neste exemplo.

• Imagem à direita: vários parâmetros do banco de dados foram removidos da configuração de sincronização ao definir os modos de suas colunas como <Skip>. O parâmetro PackageReference foi mapeado para o campo Footprint do banco de dados mestre. A opção Revision foi desmarcada para os parâmetros VZ(Max), VZ(Min) e ZZ(Max), o que significa que uma alteração em seus valores no banco de dados mestre não criará uma nova revisão no Workspace quando a sincronização ocorrer. No entanto, o valor alterado será propagado normalmente para o componente do Workspace.

Mapeamento de opções de peças

Usando o documento de configuração de sincronização de componentes, você pode definir e sincronizar informações de opções de peças. O controle dos parâmetros sincronizados está disponível na região Part Choices Mapping do painel Properties. Use os botões na parte inferior da região para adicionar e remover pares de parâmetros de opções de peças (Manufacturer / Part Number) e as opções do menu suspenso para definir o mapeamento. Quando os mapeamentos são definidos, os parâmetros correspondentes aparecem nas colunas Part Choice n na área da grade do documento.

Painel de propriedades

Quando o documento ativo é um documento de configuração de sincronização de componentes (*.CmpSync), o painel Properties apresenta as opções de configuração. As seções recolhíveis a seguir contêm informações sobre as opções e os controles disponíveis.

Sincronização agendada

As configurações de sincronização salvas são configuradas para o processamento automatizado de componentes do banco de dados para o Workspace por meio da caixa de diálogo Auto Synchronization Schedule, aberta pelo botão na interface principal.

A sincronização agendada, de acordo com o perfil de configuração atual, pode ser definida para um horário específico de cada dia, para um determinado horário em vários dias da semana ou para quando você fizer logon no Windows. Você também pode desativar a sincronização quando não estiver conectado. Quando suas configurações forem confirmadas com o botão , a configuração será adicionada como uma tarefa recorrente no Windows Task Scheduler. Defina como No automatic synchronization para remover um agendamento de sincronização existente.

A sincronização do banco de dados com os componentes também pode ser executada pela linha de comando usando o aplicativo ComponentSync.Executor.exe, localizado na pasta \System da instalação do software. A sintaxe do comando é ComponentSync.Executor.exe [configuration file name]. Um exemplo típico seria:
C:\Program Files\Altium\AD<Solution/Version>\System\ComponentSync.Executor.exe C:\Users\Public\Documents\Altium\CmpSync\MySyncConfig.CmpSync