Releasing to a Workspace

Com a vista Release em Online Mode, o processo de libertação é um fluxo faseado, com as entradas no lado esquerdo da vista a mostrarem-lhe, de relance, em que fase se encontra atualmente:

  1. Configure Server Release – esta fase do processo de libertação é onde especifica o(s) tipo(s) de dados que pretende gerar: Dados de Origem (sempre gerados), Dados de Fabrico, Dados de Montagem (para o design base e cada variante detetada).

  2. Validate Project – esta fase seguinte do processo de libertação é executada automaticamente quando um ou mais relatórios do tipo Validation são detetados nos ficheiros OutJob atribuídos. Todos os geradores de saída de validação definidos num ficheiro Output Job atribuído ao item de dados a libertar são executados.

  3. Generate Data – esta fase seguinte do processo de libertação é executada automaticamente. É aqui que todas as outras saídas – definidas nos ficheiros OutJob atribuídos aos Itens de Dados incluídos – são executadas, para gerar os dados a libertar para os itens de destino relevantes no Workspace.

  4. Review Data – com todas as verificações de validação aprovadas e os dados de saída gerados, esta fase do processo de libertação permite-lhe rever os dados gerados.

    Se optar por utilizar os comandos Prepare & Release ou Prepare & Release & Publish to PLM (no menu associado ao botão ), o Project Releaser não fará pausa na fase Review Data.

  5. Upload Data – após confirmar a libertação na fase anterior, esta fase seguinte é iniciada automaticamente. Apresenta simplesmente o progresso do carregamento dos dados para as revisões dos Itens de Dados relevantes no Workspace de destino.

  6. Execution Report – esta é a fase final do processo, fornecendo um resumo da libertação. São disponibilizadas ligações de navegação para procurar rapidamente as Revisões de Itens geradas no painel Explorer. Se tiver acedido ao Project Releaser como parte de um processo para libertar e publicar para um PLM, será apresentado o botão . Clique nele para continuar o fluxo de trabalho subjacente do processo, para publicar no PLM.

    Se optar por utilizar o comando Prepare & Release & Publish to PLM (no menu associado ao botão ), o Project Releaser não fará pausa na fase Execution Report e não será apresentado qualquer botão .
  7. Publish to PLM – esta fase só está presente ao executar a libertação no âmbito do processo ativado relevante (para libertar e depois publicar para um PLM). Esta fase é iniciada automaticamente quando se clica no botão na fase anterior (ou é iniciada diretamente se tiver sido usado o comando Prepare & Release & Publish to PLM (no menu associado ao botão )). Será apresentada a caixa de diálogo Login Credentials. Introduza o Username e a Password da sua instância de PLM e selecione o Modelo de PLM que pretende utilizar (que surge no formato <PLMInstance>:<PublishingTemplate>).

    Tenha em atenção que as credenciais de início de sessão da sua instância de PLM só são necessárias na primeira vez que publica para essa instância. Depois disso, ficarão armazenadas com o Workspace. A partir daí, qualquer publicação desse projeto para essa mesma instância de PLM prosseguirá diretamente, de acordo com o fluxo de trabalho definido e o modelo de publicação escolhido.
    Se estiver a publicar pela primeira vez e os números de peça (no lado do PLM) ainda não estiverem associados ao projeto do Workspace, esses números de peça serão criados no PLM e associados ao projeto como parte dessa publicação inicial. Tem também a possibilidade de definir entradas de componentes para componentes do Workspace na instância de PLM, como parte da operação de publicação – para obter uma BOM de componentes dentro do PLM (opcional, com base no modelo de publicação definido e utilizado ao publicar o projeto para a instância de PLM).

Fase Online 1 – Configurar a libertação no servidor

Esta fase do processo de libertação é onde especifica o(s) tipo(s) de dados que pretende gerar. Os Itens de Dados que podem ser libertados são:

  • Source Data – uma captura do design de origem.
  • Fabrication Data – os dados necessários por uma casa de fabrico para criar a placa nua.
  • Assembly Data for the Base Design (no variations) – os dados necessários por uma casa de montagem para povoar totalmente a placa nua de acordo com uma Bill of Materials, e para o design base sem variantes.
  • Assembly Data for Design Variant n – os dados necessários por uma casa de montagem para povoar a placa nua de acordo com uma Bill of Materials, e para Variant n do design base.

O número de conjuntos de dados de montagem corresponderá ao design base (sem variantes) e a todas as variantes detetadas definidas para esse design.

Além disso, pode adicionar e configurar secções Custom Data – permitindo-lhe criar um conjunto personalizado de dados de libertação. Isto destina-se mais à compatibilidade retroativa, ou a fluxos de dados personalizados. Não são criadas referências, exceto para os dados de origem. Pode adicionar e configurar qualquer número de conjuntos de dados personalizados como parte da libertação (clique no controlo Add Section por baixo da lista de itens de dados atualmente definidos).

Fase 1 do processo de libertação do projeto – configurar o que será incluído na libertação (que dados gerar).
Fase 1 do processo de libertação do projeto – configurar o que será incluído na libertação (que dados gerar).

O item Source Data está sempre incluído numa libertação. Os outros itens de dados podem ser incluídos opcionalmente.

Com os itens de dados a criar como parte da libertação configurados conforme necessário, clique no botão , na parte inferior direita da vista, para prosseguir.

O botão tem dois estados. Ao clicar nele, será iniciado o comando Prepare padrão. Isto prosseguirá com a libertação até à fase Review Data — permitindo-lhe essencialmente confirmar que está tudo em ordem antes de efetivar a libertação dos dados. Se não quiser fazer uma pausa para revisão, utilize o menu suspenso associado ao botão e escolha o comando Prepare & Release.

São efetuadas várias verificações pré-libertação como parte da preparação, incluindo:

  • Garantir que o projeto e todos os ficheiros foram guardados.
  • Garantir que o projeto e todos os ficheiros relevantes foram submetidos ao VCS, se aplicável.
  • Garantir que a cada item de dados ativado foi atribuído um nome.
  • Assegurar que o utilizador tem permissões para criar o item de destino (e a revisão).
  • Criar os Itens de destino necessários (e revisões planeadas) no Workspace, quando ainda não existirem, e garantir que a revisão seguinte é utilizada para os itens que já existem.

Se forem encontrados problemas, ser-lhe-ão propostas soluções para os resolver (como guardar ficheiros modificados localmente e submetê-los ao VCS).

Se forem encontrados documentos externos no projeto a ser libertado (documentos associados ao projeto mas armazenados numa pasta diferente da pasta do projeto ou de uma subpasta da pasta do projeto), será aberta a caixa de diálogo External files, com uma lista de documentos externos (). Para evitar potenciais problemas, recomenda-se que todos os documentos associados ao projeto sejam armazenados na pasta do projeto ou numa sua subpasta.

O Item Source Data é gerado nesta altura — com uma captura instantânea dos ficheiros do projeto de design de origem libertada para a revisão do item de destino.

Fase Online 2 – Validar Projeto

Depois de a Fase 1 ser concluída sem problemas, esta fase seguinte do processo de libertação é executada automaticamente quando um ou mais relatórios do tipo Validation são detetados nos ficheiros OutJob atribuídos. Todos os geradores de saída de validação definidos, definidos num ficheiro Output Job atribuído ao item de dados a ser libertado, são executados. Isto inclui a execução de qualquer um dos seguintes:

  • Differences Report – utilizar o comparador para determinar se os documentos de origem e de design PCB estão corretamente sincronizados.
  • Electrical Rules Check – verificar a validade elétrica/de desenho do design de origem capturado.
  • Design Rules Check – verificar a validade do documento PCB em relação às restrições de design ao nível da placa especificadas.
  • BOM Checks – verificar possíveis violações associadas a Design Items ou Part Choices no documento BOM de origem (*.BomDoc), quando disponível.
  • Footprint Comparison Report – comparar as footprints na placa com a respetiva biblioteca de origem para garantir que estão atualizadas e correspondentes.
  • Component State Checking – verificar componentes que se encontrem em estados restritos. Como parte da configuração, determina a ação a tomar para cada estado atualmente definido, de cada Lifecycle Definition atualmente definida no Workspace de destino: sem ação, um aviso ou gerar um erro. Esta última opção impedirá a libertação do design. Além disso, a execução da verificação gerará um relatório prático em HTML, permitindo-lhe ver rapidamente quais os componentes do design que não se encontram em estados válidos.
  • Environment Configuration Compliance Check – verificar se apenas estão a ser utilizados itens de dados permitidos pela configuração do ambiente disponível para utilização pela sua função atribuída (se aplicável). Esta verificação também pode assegurar que todos os itens de design têm origem num Workspace.

Se a validação for bem-sucedida, é apresentado o ícone , com o texto Passed. Caso contrário, será apresentado o ícone , com o texto Failed.

A libertação falhará se alguma das verificações de validação não for concluída com sucesso.
Ao clicar em , na parte inferior direita da vista, o processo de libertação será interrompido.

Fase Online 3 – Gerar Dados

Depois de a Fase 2 ser concluída sem problemas, esta fase seguinte do processo de libertação é executada automaticamente. É aqui que todas as restantes saídas — definidas nos ficheiros OutJob atribuídos aos Itens de Dados incluídos — são executadas, para gerar os dados a libertar para os itens de destino relevantes no Workspace.

Tal como nas outras fases, mas de forma mais notória nesta, uma vez que demora mais tempo a executar, são utilizados ícones para apresentar o progresso da geração:

– ainda não executado/gerado.

– a ser executado/gerado.

– gerado com sucesso.

– falha na geração.

Ao clicar em , na parte inferior direita da vista, o processo de libertação será interrompido.

Fase Online 4 – Rever Dados

Com todas as verificações de validação concluídas com sucesso, e os dados de saída gerados, esta fase do processo de lançamento permite-lhe rever os dados gerados.

Se optar por utilizar o comando Prepare & Release (a partir do menu associado ao botão ), o Project Releaser não fará uma pausa na fase Review Data.

Reveja os dados gerados, verificando se tudo está como deve estar, antes de confirmar o lançamento e de carregar os dados para o Workspace.
Reveja os dados gerados, verificando se tudo está como deve estar, antes de confirmar o lançamento e de carregar os dados para o Workspace.

Por predefinição, a página apresenta uma vista simples (compacta) dos dados gerados. Mude para uma vista mais detalhada clicando no controlo Details associado a uma secção de interesse.

Clique num controlo Details para mudar da vista simples para a vista detalhada dos dados gerados da secção associada. Para voltar atrás, clique no controlo Hide Details.
Clique num controlo Details para mudar da vista simples para a vista detalhada dos dados gerados da secção associada. Para voltar atrás, clique no controlo Hide Details.

Na vista compacta dos dados gerados, clique numa ligação View para abrir o ficheiro de dados ou conjunto de ficheiros associado, quer no editor relevante dentro do Altium Designer (por exemplo, o editor CAM para ficheiros Gerber ou ficheiros ODB++ comprimidos/não comprimidos), quer na aplicação externa relevante (por exemplo, o Microsoft Excel para uma Lista de Materiais). Na vista detalhada, faça duplo clique numa entrada para ver apenas esse ficheiro.

Um teste comum de prontidão para lançamento usado por muitos designers é comparar os ficheiros Gerber gerados da versão atual com os ficheiros Gerber da versão anterior. Clique na ligação Compare Gerber junto de uma saída Gerber e selecione uma versão anterior no menu pendente para comparar os dados Gerber preparados com os da versão escolhida. O seu navegador predefinido abrirá o Company Workspace e apresentará os resultados.

Aceder à funcionalidade de comparação de Gerber a partir de Project Releaser, antes de lançar os dados para um Workspace.
Aceder à funcionalidade de comparação de Gerber a partir de Project Releaser, antes de lançar os dados para um Workspace.

Saiba mais sobre a funcionalidade Gerber Comparison (Altium 365 Workspace, Enterprise Server Workspace).

Na secção Source Data, na vista compacta, clicar na ligação View abrirá o Explorador de Ficheiros do Windows na pasta temporária onde foi guardado o instantâneo dos ficheiros de origem do projeto. Esta funcionalidade também é disponibilizada através da ligação Explore, à direita do cabeçalho das secções. Na verdade, cada secção tem esse tipo de controlo, para saltar rapidamente para a subpasta desses dados dentro da pasta temporária.

Na vista detalhada, os comandos no menu de contexto do botão direito disponibilizam a capacidade de abrir um documento e explorar até ao local onde foi gerado (na pasta temporária). Também pode adicionar colunas de dados para a localização da pasta e a data de criação – clique com o botão direito na área do cabeçalho de uma grelha e escolha o comando Select Columns, obtendo acesso a uma caixa de diálogo com a qual pode ajustar os dados apresentados.

Se, depois de rever os dados, concluir que precisa de fazer modificações, clique no botão no canto inferior direito da vista. Surgirá uma caixa de diálogo de confirmação, alertando-o para o facto de que todos os dados gerados serão perdidos – clicar em OK cancelará o lançamento e regressará à Fase 1 do processo.

O sistema impede naturalmente qualquer modificação dos ficheiros de design entre a preparação do lançamento e o lançamento dos dados para o Workspace. Se alterar os ficheiros de design de alguma forma, o processo de lançamento será terminado e regressará à fase inicial, antes da preparação do lançamento.

Se os dados gerados estiverem todos corretos, prossiga com o lançamento clicando no botão (também no canto inferior direito da vista). Surgirá a caixa de diálogo Confirm Release, resumindo as configurações do projeto que serão lançadas para o Workspace. Tem também aqui a oportunidade de adicionar um Name (por predefinição, a entrada aqui é [ProjectName]), Description e de adicionar quaisquer notas de lançamento pertinentes.

Confirmação do que será lançado, em termos das Item-Revisions geradas, e possibilidade de alterar Nome/Descrição e adicionar notas de lançamento.
Confirmação do que será lançado, em termos das Item-Revisions geradas, e possibilidade de alterar Nome/Descrição e adicionar notas de lançamento.

Fase Online 5 – Carregar Dados

Depois de confirmar o lançamento na fase anterior, entra automaticamente nesta fase seguinte. Esta limita-se a apresentar o progresso do carregamento dos dados para as revisões dos Items de dados relevantes no Workspace.

Esta fase reflete simplesmente o progresso do carregamento dos dados gerados para as Item-Revisions associadas no Workspace.
Esta fase reflete simplesmente o progresso do carregamento dos dados gerados para as Item-Revisions associadas no Workspace.

Fase Online 6 – Relatório de Execução

Esta é a fase final do processo, fornecendo um resumo do lançamento.

O relatório final do lançamento.
O relatório final do lançamento.

Utilize as Navigation Links para aceder rapidamente à Item Revision associada, que contém os dados lançados (Fabrication Data, Assembly Data e quaisquer conjuntos de Custom Data), no painel Explorer – o seu portal para o Workspace.

Visualização dos dados lançados do projeto, diretamente no Workspace, através do painel Explorer.
Visualização dos dados lançados do projeto, diretamente no Workspace, através do painel Explorer.

Os parâmetros definidos para variantes de projeto são incluídos nas revisões correspondentes dos conjuntos de dados de montagem. Ao visualizar o projeto no Explorer do painel Classic View, selecione a revisão do conjunto de dados de montagem pretendida e mude para o separador de vista de aspeto Parameters para ver os parâmetros da variante.

Foi adicionado um parâmetro de variante VariantLabel = A à variante de projeto Default. O conjunto de dados de montagem lançado inclui este parâmetro, e este pode ser encontrado no separador de vista de aspeto Parameters no painel Explorer.
Foi adicionado um parâmetro de variante VariantLabel = A à variante de projeto Default. O conjunto de dados de montagem lançado inclui este parâmetro, e este pode ser encontrado no separador de vista de aspeto Parameters no painel Explorer.

É tudo – com o seu projeto lançado, pode simplesmente fechar a vista Release (utilizando o botão no canto inferior direito da vista). E, quando precisar de voltar a lançar o mesmo projeto no futuro, o Project Releaser facilita-o de forma rápida e simples, incrementando automaticamente as Item-Revisions de destino.

De cada vez que efetuar um lançamento do projeto, será adicionado um mosaico de evento Project Released à cronologia da vista History do projeto. A pessoa que efetuou o lançamento é apresentada pelo nome (e fotografia), juntamente com a data e a hora. Se tiver sido adicionada uma nota de lançamento no momento em que os dados gerados foram lançados para o Workspace – através da caixa de diálogo Confirm Release dialog – essa nota também será apresentada no mosaico. Cada um dos conjuntos de dados incluídos no lançamento também será listado.

Tenha em atenção que, se o commit mais recente do projeto ainda não tiver uma etiqueta, será atribuída automaticamente uma etiqueta a esse commit mais recente. Esta etiqueta terá a forma de RELEASE_<RevisionID>, em que <RevisionID> é o número de revisão das fontes do projeto libertadas (A.1A.2, etc.), por exemplo, RELEASE_A.3.

Exemplo de um mosaico de evento Project Released na vista History do projeto. Como o commit mais recente do projeto não tinha etiqueta, foi etiquetado após a libertação.
Exemplo de um mosaico de evento Project Released na vista History do projeto. Como o commit mais recente do projeto não tinha etiqueta, foi etiquetado após a libertação.

Saiba mais sobre o Histórico do Projeto.

Publicação numa instância PLM

Related pages: Integração PLM (Altium 365 Workspace, Enterprise Server Workspace), Publicação num PLM

Tem a capacidade de publicar um design numa instância PLM, como parte da execução do Project Releaser no Altium Designer. A operação de publicação utiliza um modelo de publicação — definido como parte da configuração de integração dessa instância PLM — para controlar a forma como os dados devem ser propagados para o PLM. Esta funcionalidade está disponível através de um processo adequadamente configurado. É fornecida uma definição de processo de exemplo como parte da instalação — Project Releaser with Publish — cujo fluxo de trabalho subjacente permite a publicação na instância PLM integrada como uma etapa adicional do Project Releaser. O diagrama do fluxo de trabalho é apresentado abaixo.

Esta definição de processo não pode ser ativada nem utilizada tal como está. Por isso, funciona mais como um “modelo” — edite-a de acordo com os requisitos da sua empresa, atribua-lhe um nome e guarde-a como uma nova definição de processo, que poderá can depois ativar e utilizar.

O diagrama do fluxo de trabalho da definição de processo de exemplo predefinida Project Releaser with Publish 
O diagrama do fluxo de trabalho da definição de processo de exemplo predefinida Project Releaser with Publish 

Depois de ativado, o processo de publicação numa instância PLM como parte do Project Releaser pode ser acedido no Altium Designer a partir do submenu Project » Project Releaser do projeto ativo ou do submenu de contexto Project Releaser, acedido clicando com o botão direito do rato na entrada do projeto de design no painel Projects.

Aceder ao processo de publicação numa instância PLM como parte do Project Releaser
Aceder ao processo de publicação numa instância PLM como parte do Project Releaser

O Project Releaser será apresentado, com uma etapa adicional — 7. Publish to PLM. Além disso, está disponível um comando no menu associado ao botão Prepare & Release & Publish to PLM — caso pretenda executar o Project Releaser sem parar para rever os dados gerados e o relatório de execução.

Um comando adicional para executar o Project Releaser sem parar para rever os dados gerados e o relatório de execução
Um comando adicional para executar o Project Releaser sem parar para rever os dados gerados e o relatório de execução

Se executar o Project Releaser com o comando padrão Prepare, depois de rever e libertar os dados, será apresentado o botão na etapa Execution Report. Clique nele para continuar o fluxo de trabalho subjacente do processo, para publicar no PLM. Será apresentada a caixa de diálogo Login Credentials. Introduza o Username e a Password da sua instância PLM e selecione o Modelo PLM que pretende utilizar (que aparece no formato <PLMInstance>:<PublishingTemplate>).

Se optar por utilizar o comando Prepare & Release & Publish to PLM, ser-lhe-á apresentada diretamente a caixa de diálogo Login Credentials. O Project Releaser não fará pausa na etapa Execution Report e não será apresentado qualquer botão .
Tenha em atenção que as credenciais de início de sessão da sua instância PLM só são necessárias na primeira vez que publicar nessa instância. Estas serão depois armazenadas com o Workspace. Depois disso, qualquer publicação desse projeto nessa mesma instância PLM prosseguirá diretamente, de acordo com o fluxo de trabalho definido e o modelo de publicação escolhido.

A caixa de diálogo Login Credentials acedida durante a primeira publicação na instância PLM.
A caixa de diálogo Login Credentials acedida durante a primeira publicação na instância PLM.

Clique no separador Diagram para ver o fluxo de trabalho subjacente do processo.

O separador Diagram da caixa de diálogo Login Credentials
O separador Diagram da caixa de diálogo Login Credentials

Clique no botão para prosseguir com o processo de publicação, de acordo com esse fluxo de trabalho.

Se estiver a publicar pela primeira vez e os números de peça (do lado do PLM) ainda não estiverem associados ao projeto do Workspace, esses números de peça serão criados no PLM e associados ao projeto como parte dessa publicação inicial. Também tem a capacidade de definir entradas de componentes para componentes do Workspace na instância PLM, como parte da operação de publicação — para obter uma BOM de componentes no PLM (opcional, com base no modelo de publicação definido e utilizado ao publicar o projeto na instância PLM).
Verifique o estado do processo de publicação no PLM através da interface do navegador do Workspace, na vista Activities na página de gestão detalhada do projeto. A página de gestão detalhada do projeto é aberta selecionando o projeto pretendido na página Projects da interface do navegador do Workspace, clicando no controlo acima da lista de projetos e escolhendo a entrada Open no menu associado. Em alternativa, faça duplo clique diretamente na entrada do projeto pretendido na lista. A página será aberta num novo separador do navegador. Poderá sempre ver exatamente o que foi criado, como números de peça na instância PLM, como parte do histórico do fluxo de trabalho do processo (separador History).
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Conteúdo