Liberando para um Workspace

Com a visualização Release em Online Mode, o processo de liberação segue um fluxo por etapas, com as entradas no lado esquerdo da visualização mostrando rapidamente em qual etapa você está:

1. Configure Server Release – nesta etapa do processo de liberação, você especifica os tipos de dados que deseja gerar: dados de origem (sempre gerados), dados de fabricação e dados de montagem (para o projeto base e cada variante detectada).

2. Validate Project – esta próxima etapa do processo de liberação é executada automaticamente quando um ou mais relatórios do tipo Validação são detectados nos arquivos OutJob atribuídos. Todos os geradores de saída de validação definidos em um arquivo Output Job atribuído ao item de dados que está sendo liberado são executados.

3. Generate Data – esta próxima etapa do processo de liberação é executada automaticamente. Aqui, todas as outras saídas — definidas nos arquivos OutJob atribuídos aos itens de dados incluídos — são executadas para gerar os dados a serem liberados nos respectivos itens de destino do Workspace.

4. Review Data – após a aprovação em todas as verificações de validação e a geração dos dados de saída, esta etapa do processo de liberação permite revisar os dados gerados.

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

5. Upload Data – após a confirmação da liberação na etapa anterior, esta próxima etapa é iniciada automaticamente. Ela simplesmente apresenta o progresso do upload dos dados para as revisões dos respectivos itens de dados no Workspace de destino.

6. Execution Report – esta é a etapa final do processo, que apresenta um resumo da liberação. São fornecidos links de navegação para acessar rapidamente as revisões dos itens geradas no painel Explorer. Se você acessou o Project Releaser como parte de um processo de liberação e publicação em um PLM, o botão será apresentado. Clique nele para continuar o fluxo de trabalho subjacente ao processo e publicar no PLM.

   Se você optar por usar o comando Prepare & Release & Publish to PLM (no menu associado ao botão ), o Project Releaser não fará uma pausa na etapa Execution Report, e nenhum botão será apresentado.

7. Publish to PLM – esta etapa está presente apenas ao executar a liberação no processo ativado correspondente (para liberar e depois publicar em um PLM). Esta etapa é iniciada automaticamente quando o botão é clicado na etapa anterior (ou acessada diretamente se o comando Prepare & Release & Publish to PLM, no menu associado ao botão , tiver sido usado). A caixa de diálogo Login Credentials será exibida. Insira o Username e a Password da sua instância de PLM e selecione o modelo de PLM que deseja usar (exibido no formato <PLMInstance>:<PublishingTemplate>).

   Observe que suas credenciais de login da instância de PLM são necessárias apenas na primeira publicação nessa instância. Elas serão armazenadas no Workspace. Depois disso, qualquer publicação desse projeto na mesma instância de PLM ocorrerá diretamente, de acordo com o fluxo de trabalho definido e o modelo de publicação escolhido.
   Se você estiver publicando pela primeira vez e os códigos de peça (no lado do PLM) ainda não estiverem associados ao projeto do Workspace, esses códigos serão criados no PLM e associados ao projeto como parte dessa publicação inicial. Você também pode definir entradas de componentes na instância de PLM para os componentes do Workspace, como parte da operação de publicação, para obter uma BOM de componentes no PLM (opcional, dependendo do modelo de publicação definido e usado ao publicar o projeto na instância de PLM).

Etapa on-line 1 – Configurar a liberação no servidor

Nesta etapa do processo de liberação, você especifica os tipos de dados que deseja gerar. Os itens de dados que podem ser liberados são:

• Source Data – um instantâneo do projeto de origem.
• Fabrication Data – os dados necessários para que um fabricante produza a placa nua.
• Assembly Data for the Base Design (no variations) – os dados necessários para que uma empresa de montagem monte todos os componentes na placa nua de acordo com uma lista de materiais, para o projeto base sem variações.
• Assembly Data for Design Variant n – os dados necessários para que uma empresa de montagem monte os componentes na placa nua de acordo com uma lista de materiais, para Variant n do projeto base.

O número de conjuntos de dados de montagem corresponderá ao projeto base (sem variações) e a todas as variantes detectadas definidas para esse projeto.

Etapa 1 do processo de liberação do projeto – configuração do que será incluído na liberação (quais dados gerar).

O item Source Data é sempre incluído em uma liberação. Os demais itens de dados são opcionais.

Definição dos esquemas de nomenclatura dos itens do Workspace

Ao liberar um projeto para o Workspace de destino pela primeira vez, você pode definir como serão nomeados os itens de dados de destino nesse Workspace (cujas revisões recebem os dados gerados). Isso é feito na guia Item Naming da caixa de diálogo Project Release Options, acessada pressionando o botão no canto inferior esquerdo da visualização (ou clicando no link Target Revision de um conjunto de dados a ser liberado e escolhendo Edit no menu de contexto). Use essa guia para:

• Definir o nome do projeto. Por padrão, esse campo será preenchido com o nome atual do projeto.
• Definir os esquemas de nomenclatura padrão para os vários itens de dados que podem ser gerados como parte da liberação. Clique em um campo na coluna Item ID e, em seguida, clique no botão à direita do campo para acessar a caixa de diálogo Choose Item (uma versão do painel Explorer), que permite selecionar como destino um Item existente no Workspace conectado no momento.

O item de projeto não é um item criado para receber dados de liberação, mas sim uma entidade usada como ponto de referência para apresentar a visão geral do projeto com os itens de dados liberados e como todos eles estão conectados ao visualizar um projeto no painel Explorer. Para obter mais informações, consulte a seção Visualização do projeto liberado.

Para alterar qualquer um dos esquemas de nomenclatura, clique no botão Settings para acessar a caixa de diálogo Naming Template Settings.

Defina o nome do projeto e a nomenclatura dos itens de dados gerados no Workspace de destino. Aqui, os campos são editáveis porque o projeto ainda não foi liberado.

Os seguintes formatos de macro podem ser usados em um modelo de nomenclatura:

• Parameter-based – permite o uso de parâmetros entre colchetes (por exemplo, [ProjectName], [VariantName], [ProjectParameter]).
• Numeric-based – permite o uso de quantificadores numéricos entre chaves (por exemplo, {0000}, {9000}).

Na guia Item Naming da caixa de diálogo Project Release Options, você pode clicar diretamente em uma entrada de esquema de nomenclatura e alterar a nomenclatura conforme desejado. Como alternativa, clique no botão à direita do campo para acessar a caixa de diálogo Choose Item (uma versão do painel Explorer), que permite selecionar como destino um Item existente no Workspace conectado no momento.

A nomenclatura dos itens pode ser alterada a qualquer momento durante a primeira etapa da visualização Release, ao configurar os dados que serão liberados no Workspace conectado no momento. Depois de clicar em , a nomenclatura associada não poderá ser alterada, pois os itens planejados com essa nomenclatura serão criados para cada conjunto de dados habilitado incluído na liberação – e esses itens ficam vinculados ao projeto. Portanto, mesmo que você não prossiga com a liberação dos dados nesses itens, eles continuarão existindo em estado de prontidão, e as entradas correspondentes do modelo de nomenclatura ficarão esmaecidas. Você pode excluir esses itens planejados ou usar o comando Browse (clique em uma entrada Target Revision para acessar o menu) e criar um novo Item de destino em cada caso, com a nomenclatura desejada.

Com os itens de dados que serão criados como parte da liberação configurados conforme necessário, clique no botão no canto inferior direito da visualização para prosseguir.

O botão tem dois estados. Clicar nele executará o comando padrão Prepare. Isso fará com que a liberação avance até a etapa Review Data — permitindo conferir se tudo está em ordem antes de confirmar a liberação dos dados. Se não quiser pausar para revisão, use o menu suspenso associado ao botão e escolha o comando Prepare & Release.

Várias verificações prévias à liberação são realizadas como parte da preparação, incluindo:

• Verificar se o projeto e todos os arquivos foram salvos.
• Verificar se o projeto e todos os arquivos relevantes foram registrados no VCS, se aplicável.
• Verificar se cada item de dados habilitado recebeu um nome.
• Garantir que o usuário tenha permissão para criar o item de destino (e sua revisão).
• Criar os Itens de destino necessários (e as revisões planejadas) no Workspace, quando ainda não existirem, e garantir que a próxima revisão seja usada para os itens que já existem.

Se algum problema for encontrado, serão oferecidas soluções para resolvê-lo (como salvar arquivos modificados localmente e registrá-los no VCS).

O Item Source Data é gerado neste momento — com uma cópia instantânea dos arquivos-fonte do projeto liberada para a revisão do item de destino.

Etapa on-line 2 – Validar o projeto

Após a conclusão da Etapa 1 sem problemas, esta próxima etapa do processo de liberação é executada automaticamente quando um ou mais relatórios do tipo Validação são detectados nos arquivos OutJob atribuídos. Todos os geradores de saída de validação definidos em um arquivo Output Job atribuído ao item de dados que está sendo liberado são executados. Isso inclui a execução de qualquer uma das seguintes verificações:

• Differences Report – usar o comparador para determinar se os documentos-fonte e os documentos de projeto da PCB estão corretamente sincronizados.
• Electrical Rules Check – verificar a validade elétrica e de representação do projeto-fonte capturado.
• Design Rules Check – verificar a validade do documento da PCB em relação às restrições de projeto especificadas para a placa.
• BOM Checks – verificar possíveis violações associadas a Itens de Projeto ou Opções de Peças no documento BOM de origem (*.BomDoc), quando disponível.
• Footprint Comparison Report – comparar os footprints da placa com os da biblioteca de origem para garantir que estejam atualizados e sejam correspondentes.
• Component State Checking – verificar componentes que estejam em estados restritos. Como parte da configuração, você determina a ação a ser tomada para cada estado atualmente definido de cada Definição de Ciclo de Vida atualmente definida no Workspace de destino: nenhuma ação, um aviso ou a geração de um erro. A última opção impedirá a liberação do projeto. Além disso, a execução da verificação gerará um relatório prático em HTML, permitindo identificar rapidamente quais componentes do projeto não estão em estados válidos.
• Environment Configuration Compliance Check – verificar se estão sendo usados apenas itens de dados permitidos pela configuração de ambiente disponível para a função atribuída a você (se aplicável). Essa verificação também pode garantir que todos os itens de projeto sejam provenientes de um Workspace.

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

Clicar em no canto inferior direito da visualização interromperá o processo de liberação.

Etapa on-line 3 – Gerar dados

Após a conclusão da Etapa 2 sem problemas, esta próxima etapa do processo de liberação é executada automaticamente. É aqui que todas as outras saídas — definidas nos arquivos OutJob atribuídos aos Itens de Dados incluídos — são executadas para gerar os dados que serão liberados nos respectivos itens de destino no Workspace.

Assim como nas outras etapas, mas de forma mais perceptível nesta, por levar mais tempo para ser executada, ícones são usados para apresentar o progresso da geração:

– ainda não executado/gerado.

– em execução/geração.

– gerado com sucesso.

– falha na geração.

Clicar em no canto inferior direito da visualização interromperá o processo de liberação.

Etapa on-line 4 – Revisar dados

Com todas as verificações de validação aprovadas e os dados de saída gerados, esta etapa do processo de liberação permite revisar os dados gerados.

Revise os dados gerados, verificando se tudo está como deveria, antes de confirmar a liberação e enviar os dados para o Workspace.

Por padrão, a página apresenta uma visualização simples (compacta) dos dados gerados. Alterne para uma visualização mais detalhada clicando no controle Details associado à seção de interesse.

Clique em um controle Details para alternar da visualização simples para a detalhada dos dados gerados da seção associada. Volte à visualização anterior clicando no controle Hide Details.

Na visualização compacta dos dados gerados, clique em um link View para abrir o arquivo de dados ou conjunto de arquivos associado, no editor correspondente do Altium Designer (por exemplo, o editor CAM para arquivos Gerber ou arquivos ODB++ compactados/descompactados) ou no aplicativo externo correspondente (por exemplo, o Microsoft Excel para uma lista de materiais). Na visualização detalhada, clique duas vezes em uma entrada para visualizar apenas esse arquivo.

Um teste comum de prontidão para liberação usado por muitos projetistas é comparar os arquivos Gerber gerados na liberação atual com os arquivos Gerber da liberação anterior. Clique no link Compare Gerber ao lado de uma saída Gerber e selecione uma liberação anterior no menu suspenso para comparar os dados Gerber preparados com os da liberação escolhida. Seu navegador padrão abrirá o Workspace da sua empresa e exibirá os resultados.

Acesso ao recurso de comparação de Gerber pelo Project Releaser, antes de liberar os dados para um Workspace.

► Saiba mais sobre o recurso Gerber Comparison (Workspace do Altium 365, Workspace do Enterprise Server).

Se, após revisar os dados, você perceber que precisa fazer modificações, clique no botão no canto inferior direito da visualização. Uma caixa de diálogo de confirmação será exibida, alertando que todos os dados gerados serão perdidos — clicar em OK cancelará a liberação e retornará você à Etapa 1 do processo.

Se todos os dados gerados estiverem corretos, prossiga com a liberação clicando no botão (também no canto inferior direito da visualização). A caixa de diálogo Confirm Release será exibida, resumindo as configurações do projeto que serão liberadas para o Workspace. Aqui, você também pode adicionar um Name (por padrão, a entrada aqui é [ProjectName]), Description e quaisquer notas de liberação pertinentes.

Confirmação do que será liberado, em termos das revisões de itens geradas, e possibilidade de alterar o nome e a descrição e adicionar notas de liberação.

Etapa on-line 5 – Upload de dados

Após a confirmação da liberação na etapa anterior, esta próxima etapa é iniciada automaticamente. Ela apenas apresenta o andamento do upload dos dados para as revisões dos itens de dados correspondentes no Workspace.

Esta etapa apenas mostra o andamento do upload dos dados gerados para as revisões de itens vinculadas no Workspace.

Etapa on-line 6 – Relatório de execução

Esta é a etapa final do processo, que fornece um resumo da liberação.

O relatório final da liberação.

Use os links de navegação para acessar rapidamente a revisão de item associada, que contém os dados liberados (dados de fabricação, dados de montagem e quaisquer conjuntos de dados personalizados), no painel Explorer — seu portal para o Workspace.

Visualização dos dados liberados do projeto diretamente no Workspace, por meio do painel Explorer.

Visualização do projeto liberado

Para um projeto do Workspace, você tem uma funcionalidade adicional disponível após a conclusão da liberação. Ao clicar no link Project Page, o último dos links de navegação na parte superior da página Execution Report, você abrirá o painel Explorer, que apresenta o projeto no Project View — disponível apenas para projetos do Workspace.

Se você já tiver visualizado o projeto em Classic View, talvez seja necessário alternar manualmente para Project View — os comandos estão disponíveis no menu associado ao botão , no canto superior direito do painel Explorer.

Você pode explorar um projeto do Workspace no painel Explorer com mais detalhes, por meio do Project View.

A região Releases (no canto inferior esquerdo da visualização) exibirá uma compilação das liberações associadas ao projeto, que inclui um resumo de cada liberação e dos pacotes que a compõem. Clique no botão nessa região para abrir a caixa de diálogo de alteração de estado em lote, que você pode usar para alterar o estado do ciclo de vida de vários itens relacionados à mesma liberação, de uma só vez, em um único processo em lote.

Também é possível acessar informações sobre as liberações do projeto no visualizador Web do Workspace de destino, aberto pelo botão do painel Explorer. No visualizador Web de um Workspace, todas as liberações associadas ao projeto podem ser acessadas na visualização Releases — ou na visualização Manufacture para um Workspace fornecido por um servidor local. A página lista todas as liberações do projeto, com a entrada mais recente no topo, e cada liberação pode ser aberta no Manufacturing Portal do Workspace pelo respectivo botão de abertura (). A visualização Manufacturing Portal fornece informações mais detalhadas sobre a liberação selecionada, incluindo os arquivos dos pacotes que a compõem, o conjunto completo de documentos do projeto e detalhes dos fabricantes e fornecedores dos componentes. Observe que o recurso Send to Manufacturer está disponível apenas em um Workspace do Altium 365. ► Consulte a página Visualização de liberações do Workspace do Altium 365 para obter mais informações.

Pronto — com o projeto liberado, basta fechar a visualização Release (usando o botão no canto inferior direito da visualização). E, quando você precisar liberar novamente o mesmo projeto no futuro, o Project Releaser facilitará esse processo de forma rápida e simples, incrementando automaticamente as revisões dos itens de destino.

Publicação em uma instância de PLM

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

Você pode publicar um projeto em uma instância de PLM como parte da execução do Project Releaser no Altium Designer. A operação de publicação usa um modelo de publicação – definido como parte da configuração de integração dessa instância de PLM – para controlar como os dados devem ser propagados para o PLM. Esse recurso está disponível por meio de um processo configurado adequadamente. Uma definição de processo de exemplo é fornecida como parte da instalação – Project Releaser with Publish – cujo fluxo de trabalho subjacente permite publicar na instância de PLM integrada como uma etapa adicional do Project Releaser. O diagrama do fluxo de trabalho é mostrado abaixo.

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

Após a ativação, o processo de publicação em uma instância de PLM como parte do Project Releaser pode ser acessado no Altium Designer pelo submenu Project » Project Releaser do projeto ativo ou pelo submenu de contexto Project Releaser, acessado ao clicar com o botão direito do mouse na entrada do projeto no painel Projects.

Acesso ao processo de publicação em uma instância de PLM como parte do Project Releaser

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

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

Se você executar o Project Releaser com o comando padrão Prepare, após revisar e liberar os dados, o botão será apresentado na etapa Execution Report. Clique nele para continuar o fluxo de trabalho subjacente do processo e publicar no PLM. A caixa de diálogo Login Credentials será exibida. Insira o Username e a Password da sua instância de PLM e selecione o modelo de PLM que deseja usar (exibido no formato <PLMInstance>:<PublishingTemplate>).

Se você optar por usar o comando Prepare & Release & Publish to PLM, a caixa de diálogo Login Credentials será apresentada diretamente ao final. O Project Releaser não será pausado na etapa Execution Report, e nenhum botão será apresentado.

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

Clique na aba Diagram para ver o fluxo de trabalho subjacente do processo.

A aba 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.

Verifique o status do processo de publicação no PLM pela interface do Workspace no navegador, na visualização Activities da página de gerenciamento detalhado do projeto. Para abrir a página de gerenciamento detalhado do projeto, selecione o projeto desejado na página Projects da interface do Workspace no navegador, clique no controle acima da lista de projetos e escolha a entrada Open no menu associado. Como alternativa, clique duas vezes diretamente na entrada do projeto desejado na lista. A página será aberta em uma nova aba do navegador. Você sempre poderá ver exatamente o que foi criado, como os números de peça na instância de PLM, no histórico do fluxo de trabalho do processo (aba History).