A funcionalidade de Aquisição de Dados de um Workspace disponibiliza um utilitário simplificado que permite, essencialmente, copiar dados entre dois Workspaces (ver informações de compatibilidade). O veículo através do qual isto é feito – a sua interface para o Serviço de Aquisição de Dados – é o Content Cart. Este é o centro de controlo para definir o que será adquirido a partir do Workspace de origem e transferido para o Workspace de destino indicado – uma fiel carrinha de mudanças que “transporta” os dados selecionados entre residências de Workspace estabelecidas.
Não há melhor forma de ilustrar o funcionamento de uma funcionalidade do que através de um exemplo. Assim, para mostrar os detalhes do Content Cart e a sua utilização na aquisição de dados, este artigo analisa a aquisição de alguns componentes entre os seguintes Workspaces:
-
Source Server – um Workspace com o nome
Company Workspace.
-
Target Server – um segundo Workspace com o nome
Secondary Company Workspace.
Aceder ao Cart
O acesso à caixa de diálogo Content Cart é feito a partir do painel Explorer. Ao navegar no Workspace de origem a partir do qual pretende obter dados, clique com o botão direito numa Revisão de Item que pretenda adquirir e escolha o comando Operations » Add to Content Cart no menu de contexto. Pode adicionar uma ou mais Revisões de Item selecionadas, ou até uma pasta de Items. O acesso inicial ao cart carrega-o com a(s) Revisão(ões) de Item selecionada(s) no Workspace de origem no momento do acesso:
-
Uma única revisão específica de um Item.
-
Múltiplas revisões específicas do mesmo Item.
-
As revisões mais recentes de múltiplos Items.
-
As revisões mais recentes de todos os Items na pasta selecionada (e na respetiva estrutura descendente). Isto permite-lhe carregar uma pasta inteira para o cart, preservando a sua estrutura de pastas. Para adquirir uma pasta (e a respetiva estrutura descendente), selecione-a na região Server Folders do Workspace de origem (no Explorer painel), depois clique com o botão direito e escolha o comando Operations » Add to Content Cart no menu de contexto.
Selecionar a entrada de nível superior de um Item irá carregar a revisão mais recente desse Item no cart.
Também pode aceder ao Content Cart a partir de várias vistas de aspeto no Explorer painel, incluindo as vistas de aspeto Where-used e Children. Também pode ser acedido a partir da janela Search Results.
Um exemplo de acesso ao Content Cart.
Items That Can Be Acquired
Os seguintes tipos de Item podem ser adquiridos de um Workspace de origem para um Workspace de destino, utilizando a funcionalidade de Aquisição de Dados:
-
Modelo 3D
-
Preferências do Altium Designer
-
Componente (incluindo Part Choices associados)
-
Template de Componente
-
Ficha de dados
-
Footprint
-
Folha esquemática gerida
-
Outputjob
-
Template esquemático
-
Script
-
Modelo de simulação
-
Símbolo
Além disso, ao adquirir uma pasta de items a partir do Workspace de origem, são suportados os seguintes tipos de pasta:
-
Components
-
Pasta genérica
Acquisition Considerations
Aspetos a ter em conta ao adquirir dados:
Note que o parâmetro Component Type não é transferido durante o processo de aquisição, pelo que os componentes transferidos irão surgir na localização Uncategorized do destino, tanto no painel Components do Altium Designer como na página Components do Workspace. Pode aplicar o Component Type pretendido a uma ou várias entradas de componentes utilizando a operação Change Component Type no Explorer painel do Altium Designer.
-
Managed Schematic Sheet Item – revisões aplicáveis dos seguintes objetos filho associados: Item(s) Component, Item(s) Symbol, Item(s) Footprint, Item(s) 3D Model, Item(s) Simulation Model, Item(s) Component Template, Item(s) Datasheet, Item Schematic Template.
-
O ciclo de vida de uma revisão de Item de origem adquirida assumirá o estado inicial “pós-libertação”, conforme determinado pela definição de ciclo de vida atribuída ao Item de destino. Qualquer histórico de ciclo de vida da revisão do Item de origem será simplesmente ignorado.
-
Se um Item filho de um Item Component/Managed Schematic Sheet de origem escolhido não puder, por qualquer razão, ser adquirido, então a aquisição desse Item Component/Managed Schematic Sheet escolhido não prosseguirá.
Uma Revisão de Item filho que seja utilizada por múltiplos Items pai – por exemplo, um Item Symbol ou Item Footprint partilhado – é adquirida apenas uma vez, e não por cada Revisão de Item pai que seja adquirida.
Acquiring Data Process - Summary
Utilize o Content Cart para adquirir todo o conteúdo de dados de que necessita. O processo de aquisição de Items de dados a partir de um servidor de origem é simples e pode ser resumido nos seguintes passos:
-
O servidor de origem é determinado automaticamente como o servidor atualmente ativo, mas pode ser alterado para outro servidor ligado através do menu seletor disponível no canto superior esquerdo do painel Explorer.
-
Utilize o menu suspenso do nome do servidor de destino do Content Cart (destacado a azul) para selecionar um servidor de destino alternativo a partir da lista, que é preenchida com os servidores atualmente ligados – escolha a opção Server Administration para ativar/desativar ligações a servidores. Para Components, o destino também pode ser especificado como um ficheiro Integrated Library (IntLib) guardado localmente.
-
A Revisão de Item original é listada na grelha principal. Pode adicionar qualquer número de Revisões de Item adicionais ao cart. Para isso, clique no controlo Add More Items no canto superior direito da caixa de diálogo e escolha a entrada Select para aceder à caixa de diálogo Choose Item (uma instância do painel Explorer). A partir daqui, pode navegar no servidor de origem em busca de mais Items, adicionando-os um de cada vez ou em lote, utilizando as ferramentas padrão de seleção múltipla. Em alternativa, escolha a entrada Add manually para aceder à caixa de diálogo Add new items dialog. Esta caixa de diálogo permite-lhe colar uma lista externa dos items de que necessita (um item por linha), que podem depois ser pesquisados no servidor de origem, utilizando um critério de pesquisa escolhido (GUID, Item ID, Name ou MPN). Selecione e remova Revisões de Item da lista (clique no botão 
) se decidir que afinal não devem ser adquiridas.
-
Clique no controlo Change Settings no canto inferior direito da caixa de diálogo Content Cart para aceder à caixa de diálogo Content Cart Structure dialog. A partir daqui, pode definir opções predefinidas para cada um dos tipos de Data Item suportados para aquisição pela funcionalidade. Isto envolve especificar uma pasta predefinida no servidor de destino, bem como a Lifecycle Definition predefinida, os esquemas de nomenclatura de Item e de Revisão, e um índice inicial. Tem também a opção de adicionar uma nota, que pode fornecer informação útil a outras pessoas ao navegarem pelo seu conteúdo adquirido.
-
Depois de escolhidos os Items de origem pretendidos, clique no botão 
. Isto prepara o servidor de destino para a aquisição, verificando o estado das revisões dos Items envolvidos (caso já tenham sido adquiridas anteriormente), as ligações pai-filho, e propondo a ação necessária que, para novas aquisições, será Transfer new revision and item. Embora as opções predefinidas de aquisição previamente especificadas sejam aplicadas durante esta fase de preparação, as propriedades dos Items de destino propostos podem ser modificadas individualmente, conforme necessário. Para o fazer, selecione um Item na lista e clique no botão 
.
-
Concluída a preparação, clicar no botão 
fará prosseguir a aquisição. Irá surgir uma caixa de diálogo de confirmação inicial – clique em Yes para prosseguir com a transferência do conteúdo entre os servidores de origem e de destino. Uma caixa de diálogo de confirmação secundária confirmará o resultado da aquisição – navegue pelos Items adquiridos no servidor de destino através do painel Explorer.
Utilize as opções na caixa de diálogo Content Cart Structure para modificar as definições predefinidas de aquisição em conformidade com os esquemas utilizados (e preferidos!) para esses tipos de Item no servidor de destino. Por predefinição, estas definições são configuradas para adquirir cada tipo de Item numa pasta distinta sob uma pasta raiz, referida como o nome do Content Cart. O nome predefinido está no formato Content Cart – <Current Date> – <Current Time> e é refletido na caixa de diálogo Content Cart.
Isto pode ser alterado para um nome mais significativo, conforme necessário. Em alternativa, pode escolher uma pasta no servidor de destino para a qual o conteúdo no Cart será entregue. Esta pode ser uma pasta existente ou uma pasta completamente nova, criada no momento. As definições de aquisição na caixa de diálogo Content Cart Structure são predefinições de nível geral – as propriedades ao nível de cada Item individual podem ser definidas, se necessário, permitindo um controlo mais detalhado.
Se uma Revisão de Item já tiver sido adquirida e o Item de origem não tiver sido novamente libertado desde essa aquisição, o respetivo
Status será
Already Exists para refletir isso. Uma vez que não há qualquer ação a realizar, o campo
Action será apresentado como
Nothing to do. Note que as Revisões de Item no
Trash são detetadas como adquiridas (
Already Exist).
Pontos de dados adquiridos de volta à sua fonte original. Esta informação de ligação ancestral pode ser vista alterando o separador de visualização de aspeto da revisão do Item de destino para o seu separador de visualização de aspeto Origin.
Especificar Workspaces de Origem e de Destino
Os dois Workspaces envolvidos na aquisição são especificados na região superior da caixa de diálogo Content Cart. O Workspace de origem é determinado automaticamente, com base na localização da(s) Revisão(ões) do Item que especificou para adquirir – tipicamente, o Workspace em que tem sessão iniciada nesse momento (Company Workspace neste exemplo). Se estiver ligado a vários Workspaces, clique no nome do Workspace de destino, ou no controlo 
à sua direita, para aceder a uma lista pendente dos Workspaces atualmente ligados. Mude de Workspace conforme necessário.
-
Embora possa estar ligado a mais do que um Workspace, lembre-se de que só pode ter sessão iniciada num único Workspace em cada momento – este será o seu Active Server.
-
O menu pendente associado ao Workspace de destino também fornece acesso rápido à página Data Management – Servers da caixa de diálogo Preferences, através da entrada Server Administration. Isto pode ser útil se ainda não se ligou/iniciou sessão no Workspace de destino pretendido.
Especificação dos Workspaces de origem e de destino envolvidos na aquisição.
Dar Nome ao Carrinho
Os dados adquiridos a partir do Workspace de origem serão copiados para novas revisões de Items no Workspace de destino. Por predefinição, estes Items ficarão localizados numa estrutura de pastas definida e recém-criada dentro desse Workspace de destino. A pasta de nível superior para este conteúdo adquirido recebe o nome do próprio carrinho. O nome por predefinição está no formato Content Cart - <Current Date> - <Current Time> e é determinado no momento em que o carrinho é acedido. Este nome pode ser alterado para outro mais significativo, conforme necessário, clicando no controlo Change, à direita do nome do carrinho.
Utilize a caixa de diálogo Content Cart Name Selection subsequente para introduzir diretamente o nome preferido para o carrinho. Em alternativa, pode escolher uma pasta no Workspace de destino para a qual o conteúdo do Carrinho será entregue. Esta pode ser uma pasta existente ou uma pasta totalmente nova criada no momento. Procure e selecione uma pasta existente para o carrinho utilizando a caixa de diálogo Choose Folder – acedida clicando no botão 
, na extremidade direita do campo Content Cart Name. Ou crie uma nova pasta dentro da estrutura de pastas, utilizando comandos do menu de clique direito.
Um Content Cart pode ser nomeado conforme necessário. Pode alterar o nome do carrinho (que será entregue numa pasta de nível superior com esse nome) ou optar por depositar o conteúdo do carrinho numa pasta específica.
É possível criar qualquer número de 'pastas' de Content Cart ao adquirir dados para o Workspace de destino, proporcionando máxima flexibilidade relativamente ao local onde o conteúdo adquirido é armazenado. Lembre-se de que, independentemente de onde os dados adquiridos são inicialmente armazenados na estrutura de pastas do Workspace de destino, pode mover livremente Items e pastas conforme necessário.
Especificar os Items a Adquirir
A área principal da caixa de diálogo Content Cart apresenta uma 'grelha de aquisição' – listando todas as Revisões de Item que escolheu adquirir a partir do Workspace de origem. Pode 'carregar' qualquer número de Revisões de Data Item no Content Cart para aquisição a partir do Workspace de origem. O acesso inicial ao carrinho carrega-o com a(s) Revisão(ões) de Item que estavam selecionadas no Workspace de origem no momento do acesso, mas pode carregar qualquer número de Items adicionais. Para o fazer, clique no controlo Add More Items no canto superior direito da caixa de diálogo e escolha a entrada Select para aceder à caixa de diálogo Choose Item (uma versão 'simplificada' do painel Explorer). A partir daqui, pode navegar no Workspace de origem para encontrar mais Items. Lembre-se de que pode optar por adicionar:
-
Uma única revisão específica de um Item.
-
Várias revisões específicas do mesmo Item.
-
As revisões mais recentes de vários Items.
-
As revisões mais recentes de todos os Items na pasta selecionada (e respetiva estrutura descendente).
Em alternativa, escolha a entrada Add manually para aceder à caixa de diálogo Add new items. Esta caixa de diálogo permite-lhe colar uma lista externa de items de que necessita (um item por linha), que poderá depois ser pesquisada no Workspace de origem, utilizando um critério de pesquisa escolhido (GUID, Item ID, Name ou MPN).
A grelha principal de aquisição, listando todas as Revisões de Item escolhidas para aquisição a partir do Workspace de origem.
Qualquer Revisão de Item pode ser removida da lista selecionando-a e clicando no botão
.
Preparação do Carrinho
Depois de escolhidas as Revisões de Item de origem, o Content Cart tem agora de ser 'preparado para entrega' ao Workspace de destino. Para o fazer, clique no botão 
. Isto prepara o Workspace de destino para a aquisição – verificando o estado das Revisões de Item escolhidas envolvidas (caso já tenham sido adquiridas anteriormente), as ligações pai-filho e propondo a ação a executar. Os resultados desta fase de preparação são apresentados na grelha principal de aquisição.
Um exemplo de Content Cart, preparado e pronto para entrega ao Workspace de destino.
Para cada Revisão de Item envolvida na aquisição, a região Source da grelha expande-se para apresentar todas as Revisões de Item-filho aplicáveis e, opcionalmente, a pasta em que residem no Workspace de origem. Para cada Revisão de Item (tanto pai como filho), pode ser apresentada a seguinte informação na região Target da grelha:
Tenha em atenção que o processo de aquisição também detetará um item existente no
Workspace Trash do destino, que será considerado como adquirido e definido com o estado
Already Exists. Esvazie o Trash e execute novamente o processo de aquisição se pretender readquirir esse Item.
Clique no cabeçalho de uma coluna para ordenar pelos dados dessa coluna por ordem ascendente. Clique novamente para ordenar por ordem descendente. Clique e arraste o cabeçalho de uma coluna para alterar a ordem das próprias colunas – as localizações válidas são distinguidas por setas verticais de posicionamento. Clique com o botão direito para aceder a controlos para ativar/desativar a apresentação de colunas de dados nas regiões Source e Target (algumas das colunas listadas acima podem estar desativadas por predefinição).
Estrutura do Carrinho
Como parte da fase de preparação, o carrinho utiliza definições predefinidas para cada tipo de Item que pode ser adquirido. Estas definições são definidas na caixa de diálogo Content Cart Structure, acedida clicando no controlo Change Settings no canto inferior direito da caixa de diálogo Content Cart.
As definições de aquisição por predefinição são definidas na caixa de diálogo Content Cart Structure.
Estas definições são usadas para determinar as propriedades das Revisões de Item recém-criadas no Workspace de destino – criadas prontas e no estado planeado, para receber dados das Revisões de Item originais no Workspace de origem. Incluem uma pasta predefinida no Workspace de destino, bem como a Definição de Ciclo de Vida predefinida, os Esquemas de Nomenclatura de Item e de Revisão, e um índice inicial. Também é definida uma nota predefinida, no formato Acquired from <SourceWorkspaceName>.
Em termos de pastas de destino no Workspace de destino, cada tipo de Item será adquirido para uma pasta distinta sob:
-
Uma pasta-pai de nível superior, com o nome do próprio Content Cart
-
Uma pasta existente, definida através da caixa de diálogo de seleção Content Cart Name.
Modifique estas definições de aquisição por predefinição em conformidade com os esquemas utilizados (e preferidos!) para esses tipos de Item no seu Workspace de destino. Clique numa célula para aceder aos controlos de edição.
-
Tenha em atenção que as Part Choices associadas a um componente são automaticamente propagadas para o Workspace de destino. A entrada Part Choice List na caixa de diálogo Content Cart structure aplica-se apenas ao Altium Vault legado e a versões anteriores do Altium Designer.
-
Reponha as definições da estrutura para os valores predefinidos clicando no botão
.
As definições de aquisição na caixa de diálogo Content Cart Structure são predefinições de nível grosseiro. Para Itens que nunca foram adquiridos anteriormente – pelo que o Item principal e a revisão inicial estão a ser criados de novo (Action é Transfer new revision and item) – podem ser definidas propriedades ao nível de cada Item individual, se necessário, proporcionando um controlo mais refinado. Para o fazer, selecione uma Revisão de Item na grelha principal de aquisição e clique no botão 
. Isto dar-lhe-á acesso à caixa de diálogo Edit Item, a partir da qual poderá modificar as propriedades do Item conforme necessário, substituindo as definições predefinidas.
Para um maior controlo, pode definir propriedades ao nível de cada Item individual.
Quaisquer alterações ao nome do carrinho, às suas definições predefinidas de estrutura, ou aos próprios Itens individuais, exigem que a preparação seja executada novamente, para atualizar a grelha de aquisição com essas alterações.
Entrega do Carrinho
Depois de concluída a preparação, clique no botão 
para prosseguir com a aquisição. Será apresentada uma caixa de diálogo de confirmação, a notificá-lo de que o Content Cart está prestes a ser transferido do Workspace de origem para o Workspace de destino – clique em Yes para prosseguir. Uma segunda caixa de diálogo de confirmação confirmará o resultado da aquisição, ficando os Itens adquiridos disponíveis para consulta no Workspace de destino através do painel Explorer.
Se, antes de fechar a caixa de diálogo
Content Cart, executar novamente a preparação – clicando em
– os campos
Status e
Action serão atualizados para refletir o resultado, apresentando
Already Exists e
Nothing to do, respetivamente.
Os dados adquiridos apontam para a sua fonte original. Esta informação de ligação ancestral pode ser vista mudando para o separador de vista de aspeto
Origin da Revisão de Item de destino. Para saltar rapidamente para a Revisão de Item da fonte original, clique no botão
.
Aquisição de Dados no Formato IntLib
Também tem a possibilidade de adquirir componentes do seu Workspace para uma Biblioteca Integrada (*.IntLib). E, ao colocar componentes a partir dessa Biblioteca Integrada, as ligações reais remetem para os componentes no Workspace. Isto permite-lhe utilizar eficazmente os componentes do Workspace da sua empresa em modo offline, assegurando ao mesmo tempo que o design mantém uma verdadeira ligação a esses componentes no Workspace de origem.
Aquisição para um IntLib
A partir da caixa de diálogo Content Cart, o processo para adquirir para um IntLib é o seguinte:
-
Clique na ligação Select target server e escolha IntLib file no menu.
Defina o destino da Content Cart como sendo um ficheiro IntLib.
-
Especifique o nome e a localização para o ficheiro IntLib gerado. Por predefinição, o ficheiro será nomeado no formato Integrated_Library - <Date> - <Time>.IntLib e gerado na localização \Users\Public\Documents\Altium\AD<Version>\Library\ExportCmpLib. Modifique isto conforme necessário através da caixa de diálogo Save As – acedida ao clicar na ligação Change .
Aceite a pasta de destino e o nome de ficheiro predefinidos, ou altere-os conforme necessário.
-
Se necessitar de adquirir componentes adicionais para o mesmo IntLib, clique na ligação Add More Items e escolha a entrada Select para aceder à caixa de diálogo Choose Item (uma versão "simplificada" do painel Explorer panel). A partir daqui, pode navegar no Workspace de origem à procura de mais Itens. Em alternativa, escolha a entrada Add manually para aceder à caixa de diálogo Add new items. Esta caixa de diálogo permite-lhe colar uma lista externa dos itens de que necessita (um item por linha), que poderão depois ser procurados no Workspace de origem, utilizando um critério de pesquisa escolhido (GUID, Item ID, Name ou MPN).
-
Quando estiver pronto, clique no botão para prosseguir com a geração do IntLib. Será criado um pacote temporário de Biblioteca Integrada (*.LibPkg), com os ficheiros de origem SchLib (com símbolos, parâmetros e ligações a modelos) e PcbLib (com modelos de footprint) gerados e adicionados. Este é depois compilado para produzir o ficheiro IntLib, que é gerado na pasta especificada. Uma caixa de diálogo de informação confirmará a geração bem-sucedida do ficheiro.
Entregue o carrinho na pasta de destino, que conterá o ficheiro de Biblioteca Integrada necessário.
Utilização do IntLib
Após a geração, o IntLib pode ser adicionado como parte das bibliotecas disponíveis não pertencentes ao Workspace para o software (através do separador Installed da caixa de diálogo Available File-based Libraries dialog). Ficará então disponível para utilização a partir do painel Components panel. Coloque os componentes do IntLib no seu design conforme necessário. Embora esteja efetivamente a trabalhar com os componentes em modo "offline", as ligações de volta aos componentes originais do Workspace asseguram a continuidade quando voltar a trabalhar "online" diretamente a partir do seu Workspace.
AI-localized