Projetos do Workspace

O Altium Designer, em conjunto com o Enterprise Server Workspace, disponibiliza suporte para Workspace Projects. Os projetos do Workspace destinam-se à fase de desenvolvimento do ciclo de vida do projeto, simplificando a criação e o fluxo de trabalho contínuo para projetos sob controlo de versões. O armazenamento centralizado sob o controlo do Workspace também permite que esta funcionalidade sirva de base para outros serviços colaborativos.

Alguns dos principais benefícios da utilização de projetos do Workspace são:

• Armazenamento simplificado. Não é necessário tomar decisões sobre localizações de armazenamento. As cópias de segurança e outros serviços básicos são assegurados.

• Base para funcionalidades colaborativas.

• Controlo de versões imposto.

• Vantagens de um sistema de comentários dedicado.

• Notificações e estado. O estado dos documentos, incluindo modificações locais, é visível para toda a equipa de design.

• O design de PCB em simultâneo funciona sem qualquer configuração complexa.

• Capacidade de partilhar com outros utilizadores uma vista interativa de um projeto, apenas de leitura e baseada no navegador, através do Web Viewer.

• Um conjunto de funcionalidades avançadas de controlo de versões, como uma vista interativa do histórico do projeto.

Em termos técnicos, um projeto do Workspace é a combinação de metainformação armazenada no Enterprise Server Workspace com uma integração estreita com o serviço de Controlo de Versões do próprio Workspace. O fluxo de trabalho típico é o seguinte:

1. Um utilizador cria um novo projeto do Workspace através da caixa de diálogo Create Project do Altium Designer, convertendo um projeto local existente através da caixa de diálogo Make Available On Server, ou a partir da interface do navegador do Workspace (detalhada abaixo). Durante a criação, esse utilizador define o nome e a descrição do projeto.

2. O acesso ao projeto é definido e gerido na interface baseada em navegador do Workspace, ou diretamente no Altium Designer.

3. Todos os colaboradores selecionam o projeto para abertura (quer a partir do Altium Designer, quer a partir da interface do navegador do Workspace), após o que este é automaticamente obtido como ficheiros de design.

Este documento analisa o trabalho com projetos através da interface do navegador do Enterprise Server Workspace. Para obter informações sobre como trabalhar com projetos no seu software de design, consulte Familiarizar-se com o Ambiente de Design Altium.

Criar um Novo Projeto do Workspace

Existem várias formas de criar um projeto do Workspace:

• Criação de um novo projeto a partir da interface baseada em navegador do Workspace, ou a partir do Altium Designer.
• Tornar um projeto existente (um projeto local, ou um projeto local atualmente sob controlo de versões externo) disponível no Workspace, a partir do Altium Designer – ou seja, converter um projeto local num projeto do Workspace. Consulte a página Tornar um Projeto Existente Disponível no Workspace para saber mais.
• Clonagem de um projeto do Workspace existente através da interface baseada em navegador do Workspace, ou clonando um projeto a partir do painel Projects do Altium Designer.
• Carregamento de um projeto local a partir da interface baseada em navegador do Workspace.

Para criar um projeto do Workspace diretamente através da interface do navegador do Workspace:

1. Inicie sessão na interface e selecione a opção de menu Projects para aceder à página Designs . Quaisquer projetos criados anteriormente serão aqui listados.

2. Clique no botão no topo da página e depois na opção de menu Create Project para abrir a janela Create Project .

   Se existirem definições de processo ativas disponíveis para o tema de processo Criações de Projeto – definidas no separador Project Creations da página Processes da interface do navegador do Workspace – então o menu do botão disponibilizará esses processos como opções em vez da opção Create Project. Escolha a entrada pretendida para invocar esse fluxo de trabalho do processo.

3. A janela apresentar-se-á inicialmente numa vista simplificada. Introduza o nome pretendido para o projeto, uma descrição (se necessário) e escolha um Modelo de Projeto adequado no menu pendente Templates.

   O nome do projeto deve começar por, e pode conter, A-Z, a-z ou 0-9. São permitidos underscores, hífenes e espaços, mas estes últimos só podem ser utilizados no meio do nome (os espaços no início e no fim serão ignorados). Não pode utilizar as seguintes palavras: AUX, COM1-COM9, LPT1-LPT9, CON, NUL e PRN. Além disso, o nome não pode conter os seguintes caracteres: \ . / ? % * : | " < >.

4. Clique no botão ​ para aceder ao campo Parent Folder. Utilize-o para especificar onde o projeto deve ser criado na estrutura de pastas do Workspace. Esta será a pasta atualmente aberta ou, caso contrário (por predefinição), Projects. Tenha em atenção que o caminho de pasta predefinido para novos projetos é especificado na página Admin – Settings – Projects da interface do navegador do Workspace. Na janela Create Project, clique na ligação Change  à direita do campo para aceder à estrutura de pastas do Workspace, a partir da qual poderá selecionar uma pasta alternativa para armazenar o projeto.

   Se a pasta predefinida (como Projects) não estiver acessível, o Workspace criará uma hierarquia Personal Folder para armazenar os seus projetos. Esta aparece como uma pasta privada de nível superior com o nome do seu utilizador, com uma subpasta My Projects para o armazenamento de projetos criados ou carregados. Os projetos recém-criados serão armazenados na pasta My Projects ou, se estiver atualmente aberta outra pasta acessível, um novo projeto será armazenado nessa pasta.

   • Tenha em atenção que o acesso de um utilizador às pastas do Workspace, incluindo a pasta Projects , é determinado pelas permissões de partilha de pastas configuradas através da página Explorer page (Admin – Explorer). Consulte Gerir Permissões de Criação de Projetos para mais informações.

   • Se pretender, pode organizar os projetos numa hierarquia de subpastas. Para mais informações, consulte a secção Trabalhar com Pastas do Workspace.

Definir um novo projeto do Workspace diretamente através da interface do navegador do Workspace.

Depois de definir o novo projeto conforme necessário, clique em – o novo projeto será criado. Voltará à lista de projetos ao nível do resumo, onde verá agora uma entrada para o projeto recém-criado.

Um projeto adicional do Workspace, criado através da interface do navegador.

Navegar nos Projetos do Workspace

A listagem de projetos na página Projects da interface do navegador do Workspace inclui todos os projetos que foram partilhados consigo e oferece um conjunto de controlos para aceder a funcionalidades de gestão de projetos. Utilize o botão  para mudar a página para o modo de pré-visualização de projetos (mosaicos gráficos) e o botão  para mudar a página para o modo de lista detalhada.

A página Projects da interface do navegador do Workspace – centro de comando para trabalhar com os seus projetos do Workspace. Aqui é apresentado o modo de lista detalhada da página. Passe o rato sobre a imagem para ver o modo de pré-visualização de projetos.

As entradas de projeto da vista são automaticamente ordenadas por data de Last modified, surgindo primeiro na lista o projeto modificado mais recentemente. Clique no botão para alterar a ordenação para o Nome do projeto e clique novamente para alternar entre ordem ascendente e descendente.

A vista do modo Lista () pode ser ordenada por Name, Author ou Date, utilizando o cabeçalho da coluna em cada caso. Clique uma vez para ordenar por ordem ascendente, clique novamente para ordenar por ordem descendente. As setas à direita do nome da coluna indicarão a direção de ordenação atualmente ativa.

A vista Projects disponibiliza dados de Properties e Activities relacionados com o projeto selecionado, disponíveis no painel lateral direito da vista.

A informação do painel lateral inclui: Properties separador: Project – um resumo de alto nível do estado do projeto, incluindo a sua pré-visualização (a vista 3D da placa, a imagem do documento esquemático multi-board ou a imagem do documento de cablagem do arnês). Child Projects (Projetos Multi-board apenas) – a lista de PCBs de subprojetos incluídas e ligadas a um projeto Multi-board – mostrar imagem. Clique numa ligação de subprojeto para abrir esse projeto PCB no Web Viewer como habitualmente. Shared With – os utilizadores e/ou grupos que têm acesso ao projeto. Passe o cursor sobre uma entrada para ver o nome completo do utilizador/grupo. Reports – as verificações de Regras Elétricas e de Regras de Projeto (ERC e DRC) que foram geradas para o projeto atualmente selecionado, incluindo o número de erros/violações em cada relatório. Selecione uma entrada ERC ou DRC para aceder e inspecionar os detalhes do relatório no projeto. Consulte a página Web Viewer para saber mais sobre Relatórios DRC e ERC. Parameters – metadados detalhados extraídos ou calculados a partir do próprio projeto. Clique no controlo Show More para expandir a lista completa. Where Used – uma lista de outros projetos, como projetos Multi-board, que incorporam este conteúdo do projeto. Clique numa entrada para abrir e visualizar esse projeto num novo separador do navegador. Releases – uma lista de versões do projeto por ordem cronológica. Clique numa entrada para abrir essa versão no Manufacturing Portal do Workspace. Activity separador – uma lista cronológica de eventos do projeto, como um Commit, Release ou um fluxo de processo concluído associado ao projeto.

Para cada projeto, as seguintes operações também são disponibilizadas pelos botões no topo da vista (e detalhadas nas secções ligadas que se seguem):

• Partilhar – controlos de acesso com os quais configurar permissões de acesso ao projeto.
• Funções – acesso por menu às funções do projeto. Também disponível a partir do botão de um projeto selecionado quando em modo de Pré-visualização:
  • Abrir – abre o projeto na sua vista detalhada centrada em CAD. Equivalente a clicar (modo de Pré-visualização) ou fazer duplo clique (modo de Lista) numa entrada de nome de projeto.
  • Mover – desloca o projeto para outra pasta principal dentro da estrutura de pastas do Workspace.
  • Editar – edita o projeto em termos do seu Name, Description e do Parameters do Workspace.
  • Clonar – cria uma cópia idêntica do projeto com outro nome.
  • Seguir/Deixar de seguir – seguir/deixar de seguir a atividade de um projeto recebendo notificações relacionadas (atualizado, libertado, etc.) no separador Activitiy do projeto, e também por email se as Notificações por Email estiverem ativadas.
  • Eliminar – remove a entrada do projeto movendo a sua estrutura e dados para o Trash do Workspace, onde pode ser eliminado permanentemente do Workspace ou restaurado ao seu estado anterior.

Também está incluída uma funcionalidade de Search do projeto que pode filtrar a listagem de projetos por um conjunto de propriedades como Nome, Autor, Descrição, etc. Introduza qualquer parte de uma cadeia de pesquisa no campo no topo da interface do navegador. A lista será atualizada para incluir apenas as entradas de projeto cujos atributos incluam a cadeia de pesquisa.

Para limpar a filtragem de pesquisa, clique na entrada principal da página Projects no painel de navegação à esquerda, ou limpe o campo de pesquisa e prima Enter.

Exemplo de utilização da funcionalidade de pesquisa, neste caso encontrando um projeto com base na sua Descrição.

Trabalhar com Pastas do Workspace

O Workspace também disponibiliza a capacidade de criar e gerir pastas de projeto dentro da estrutura do Workspace. Os projetos podem depois ser criados em qualquer pasta da hierarquia resultante ou movidos para essa pasta.

Para criar uma nova pasta sob a pasta de nível superior (predefinida) Project, escolha a opção Create Folder no menu do botão . Na janela Create Folder seguinte, especifique o nome da nova pasta, a sua pasta principal e uma descrição opcional. Uma nova pasta é sempre criada sob a pasta atualmente selecionada, que passa a ser a sua pasta principal.

Abra uma pasta criada selecionando o seu título e navegue de volta na hierarquia usando a navegação por breadcrumbs acima.

Use as opções do menu para modificar os detalhes de uma pasta (Edit), deslocar a pasta para outra pasta principal (Move) ou remover a pasta da estrutura de pastas do Workspace (Delete). Ao mover uma pasta, selecione uma nova pasta principal na árvore hierárquica da janela Move folder <folder> to.

Carregar um Projeto

Em Altium Designer, o comando Make Available on Server irá carregar um projeto local para o Workspace, onde passa a ser um projeto do Workspace sob o seu controlo de versões. Um processo equivalente pode ser realizado na interface do navegador do Workspace através da opção Upload Project disponível no menu do botão . Navegue até à pasta anfitriã de um projeto local e selecione-a para carregar esse projeto para a pasta do Workspace atualmente selecionada por predefinição, ou use a opção Change na lista Parent Folder da janela Upload Project para selecionar uma localização alternativa na hierarquia de pastas.

Quaisquer ligações de controlo de versões existentes no projeto local são ignoradas, e o projeto carregado passa a ser um projeto do Workspace totalmente controlado por versões – o projeto de origem local não é alterado de forma alguma.

Carregar um Conjunto de Ficheiros Gerber ou ODB++

O Workspace também aceita conjuntos de ficheiros de fabrico Gerber/ODB++ gerados em formato de arquivo, que podem ser carregados através das opções Upload Gerber ou Upload ODB++ disponíveis no menu do botão . O processo de carregamento é essencialmente o mesmo que o processo de carregamento de Projeto descrito acima.

❯ ❮ Javascript ID: AES_GerberODBupload_7_0.png

Selecione a opção New – Upload Gerber para navegar até e selecionar um conjunto de ficheiros Gerber arquivado no explorador de ficheiros do Windows. Na janela Upload Gerber, edite o Name proposto do projeto se necessário (que é obtido a partir do nome do arquivo Gerber) e adicione uma Description. Pode usar a opção Change para especificar uma localização de armazenamento do projeto diferente da pasta predefinida de armazenamento de projetos. O conjunto de ficheiros carregado será processado e adicionado à coleção de projetos do Workspace com um ícone Gerber inicial e, depois, com uma imagem de pré-visualização gerada após atualização ou visualização. Selecione a opção New – Upload ODB++ para navegar até e selecionar um ODB++ arquivado no explorador de ficheiros do Windows. Na janela Upload ODB++, edite o Name proposto do projeto se necessário (que é obtido a partir do nome do arquivo ODB++) e adicione uma Description. Pode usar a opção Change para especificar uma localização de armazenamento do projeto diferente da pasta predefinida de armazenamento de projetos. O conjunto de ficheiros carregado será processado e adicionado à coleção de projetos do Workspace com um ícone ODB++ inicial e, depois, com uma imagem de pré-visualização gerada após atualização ou visualização.

Clique no nome do projeto Gerber/ODB++ ou use a opção Open do menu associado para carregar o conjunto de ficheiros no visualizador dedicado do Workspace. Isto fornece uma vista composta de todos os ficheiros/camadas incluídos, permite ocultar camadas ou visualizá-las em exclusivo, oferece uma funcionalidade de medição ponto a ponto e aceita comentários colocados.

Mover um Projeto

Para deslocar um projeto para uma pasta diferente do Workspace, selecione a opção Move nas opções do menu pendente e selecione uma nova localização na hierarquia de pastas na janela Move project <project> to. Quando confirmado com o botão , o projeto selecionado ficará alojado sob a nova pasta principal especificada.

Partilhar um Projeto do Workspace

Assim que um projeto está no Workspace, irá querer determinar que utilizadores podem efetivamente aceder a esse projeto. Isto é feito partilhando o projeto, ou melhor, configurando as respetivas permissões de acesso.

Um projeto do Workspace é partilhado, por predefinição, com o seguinte:

• O Proprietário do projeto, que normalmente é o designer que o criou (ou o disponibilizou no Workspace): permissões de acesso totais (Leitura/Escrita).
• O grupo Administrators: permissões de acesso totais (Leitura/Escrita).
• Todos os membros do Workspace: com acesso apenas de visualização.

As permissões predefinidas para novos projetos podem ser definidas/alteradas na página Admin – Settings – Projects da interface do navegador do Workspace. Note que o Proprietário do projeto recebe inerentemente permissão para lhe aceder e, por isso, não está presente na lista.

A configuração das permissões de acesso pode ser realizada através da interface do navegador do Workspace e também diretamente no Altium Designer.

Para configurar o acesso a um projeto a partir da interface do navegador do Workspace, selecione a entrada do projeto na página Designs  (Projects no menu principal) e clique no botão para aceder à janela Share:<project> – ou escolha a opção Share no menu associado a uma entrada de projeto. Isto disponibiliza todos os controlos necessários para partilhar o projeto com outros utilizadores ou grupos.

Com os projetos geridos centralmente no Workspace, partilhar com outras pessoas é simplesmente uma questão de gerir as permissões de cada projeto.

Na janela Share <project>:

• Um utilizador/grupo tem acesso de Leitura/Escrita quando a opção Can Edit está ativada. Se esta opção estiver desativada, terá apenas acesso de Leitura.
• Um projeto pode ser partilhado com todos os membros do Workspace com acesso só de leitura (Can View) ou de leitura/escrita (Can Edit) utilizando o menu pendente da entrada Workspace Members na região Shared With.
• Para remover um utilizador/grupo existente do acesso partilhado a um projeto, clique na opção Remove no respetivo menu pendente associado.

Aspetos a ter em conta:

• Por predefinição, todos os utilizadores do Workspace poderão ver o projeto. Se pretender restringir o acesso a um conjunto específico de utilizadores e/ou grupos, tem primeiro de selecionar No access no menu pendente da entrada Workspace Members.
• O proprietário de um projeto tem acesso permanente de Leitura/Escrita.
• Também pode partilhar uma ligação direta para o projeto. A ligação é obtida clicando no controlo Copy Link, na parte inferior da janela Sharing. A ligação é copiada para a área de transferência. Quando utilizada, fornece ao utilizador aplicável – quando permitido – acesso à página de gestão detalhada do projeto, cuja visão geral é apresentada na secção seguinte.

Atividades de Projeto do Workspace

O Workspace oferece a capacidade única de aplicar Process Workflows configuráveis a projetos do Workspace, de modo a executar tarefas personalizadas, como realizar revisões de desenho e criar novos projetos. Os processos e os respetivos Workflows subjacentes são criados e configurados por um administrador do Workspace e, quando ativados, ficam disponíveis para os utilizadores tanto do Altium Designer como da interface do navegador do Workspace.

► Consulte Creating & Managing Processes para mais informações.
► Consulte Performing Design Reviews para informações sobre estes processos no Altium Designer.

Na perspetiva do utilizador, os Process Workflows e as suas etapas inerentes são considerados como Activities. As atividades disponíveis podem ser iniciadas pelos utilizadores, e as respetivas etapas do workflow podem ser concluídas pelos utilizadores atribuídos como uma sequência de tarefas – disponíveis através da página Tasks.

Selecione o menu na página Designs (Projects) e escolha entre os Processes disponíveis para iniciar uma atividade para o projeto atualmente selecionado. Preencha os campos e opções necessários nas janelas de formulário do processo que se seguem e, em seguida, inicie o processo (). Dependendo do Process Workflow que foi iniciado, poderá ser necessário submeter uma etapa seguinte () para preparar os dados para revisão.

São então criadas Workflow Tasks para o utilizador, ou utilizadores, atribuídos à atividade. Uma tarefa que se aplique a um utilizador com sessão iniciada aparecerá na página Tasks, onde pode ser tratada para fazer avançar o Workflow para a etapa seguinte.

Tenha em atenção que, se uma atividade tiver sido atribuída a um grupo – Engineers por exemplo – uma Task relacionada fica disponível para todos os membros desse grupo, bem como para quaisquer utilizadores individuais que tenham sido atribuídos à atividade. Nesses casos, qualquer um desses utilizadores pode concluir a etapa de revisão e submeter o resultado ().

Funções de Projeto do Workspace

As operações funcionais associadas aos projetos estão disponíveis no menu da página Designs  e incluem a capacidade de abrir, mover, editar, clonar, seguir e remover um projeto do Workspace. O menu também está disponível no botão de uma entrada de projeto selecionada:

Abrir um Projeto

Selecione a opção Open no menu de uma entrada de projeto ou no menu superior para abrir um projeto na sua vista centrada em CAD orientada para fabrico – ou, quando estiver no modo de Pré-visualização (), clique no nome do projeto. A vista fornece acesso a várias sub-vistas disponíveis no painel de navegação:

• Design – navegar e interagir com os documentos de design do projeto, inspecionar propriedades de objetos e colocar comentários de revisão. A vista aplica-se à revisão atual (mais recente) do projeto e utiliza a interface Web Viewer.
• Simulation – carregar ficheiros de resultados de simulação para o projeto atual, que ficam depois disponíveis para inspeção ou transferência por todos os utilizadores que tenham acesso ao projeto.
• Tasks – visualizar e interagir com uma interface do tipo fluxo que apresenta todas as Tarefas (trabalhos de atividade) que se aplicam ao projeto atual.
• Releases – visualizar informação resumida sobre todas as Releases do projeto atual, cada uma das quais pode ser aberta na vista Manufacturing Portal . Esta, por sua vez, fornece sub-vistas para os ficheiros do pacote de release, documentos de design e dados de fornecimento dessa release selecionada.
• Activities – visualizar Atividades de fluxo de trabalho do Processo ativas ou fechadas que se aplicam ao projeto atual.
• History – percorrer uma linha temporal progressiva dos principais eventos relacionados com o projeto, incluindo a sua criação, commits, releases e clones. Sempre que ocorre um evento suportado associado ao projeto, esse evento é adicionado à linha temporal como um bloco dedicado com várias ações (tais como comparações de dados de design), quando aplicável.
• Assembly Assistant – fornece acesso a uma ferramenta visual de montagem de placas baseada na interação entre entradas de BOM e os seus equivalentes gráficos. Pode ser invocado um processo auditado passo a passo que ajuda a avançar pelas etapas da montagem física de uma placa PCB. Isto proporciona uma vista do progresso de montagem monitorizado num único local, evitando processos complexos de verificação manual ou em papel da montagem da placa.

► Consulte Gestão de um Projeto Específico para mais informações.

Editar um Projeto

Para editar as propriedades de um projeto existente no Workspace, selecione a respetiva entrada na página Designs (Projects) e, em seguida, a opção Edit no respetivo menu ou no menu superior . Na janela Project Editing seguinte pode alterar o Name e a Description do projeto e gerir entradas de Parameters do Workspace.

Clique no botão na janela Project Editing para mostrar dados adicionais de propriedades derivados do projeto e armazenados com o mesmo. Selecione o controlo Parameters para aceder e adicionar (), editar ou remover () pares Nome/Valor de parâmetros. Estes são guardados no Workspace com o projeto e podem ser utilizados como Special Strings no Altium Designer – acedidos a partir do painel Properties com um objeto de texto colocado selecionado na área de design. Em contraste, os parâmetros do tipo Projeto são guardados no ficheiro do projeto (*.PrjPcb) e podem ser editados no Altium Designer.

Clonar um Projeto

Para clonar (duplicar) um projeto existente do Workspace, selecione a respetiva entrada na página Designs (Projects) e, em seguida, a opção Clone no respetivo menu ou no menu superior . Utilize a janela Clone Project para definir o nome e a descrição do projeto clonado – por predefinição, será utilizado o nome do projeto original com o sufixo - Copy.

Clique no botão para mostrar a informação da pasta principal de destino. A definição da pasta de destino corresponderá automaticamente ao nome do projeto, salvo especificação manual, ou poderá ser atribuída a uma pasta principal existente diferente através da opção Change.

Um projeto pode ser clonado no Altium Designer a partir da opção Clone do menu  no painel Explorer panel, ou clicando com o botão direito no nome de um projeto no painel Projects panel e escolhendo a opção Clone no menu de contexto.

Depois de definir os campos conforme necessário, clique no botão para confirmar. O projeto original será clonado (duplicado) juntamente com os seus ficheiros e dados constituintes, e será adicionado como uma nova entrada de projeto à listagem da página Projects.

Seguir um Projeto

Para 'seguir' – receber notificações relativas a – um projeto no Workspace, selecione a respetiva entrada na página Designs (Projects) e, em seguida, a opção Watch no respetivo menu ou no menu superior .

Quando segue um projeto, receberá notificações relacionadas com o projeto (tais como mensagens de commit, release e alteração de propriedades) no separador Activities no painel direito da interface. O criador do projeto será automaticamente definido para seguir esse projeto. Quando ativado, o comando mudará para Unwatch – selecione-o para deixar de seguir o projeto e cessar a receção de notificações para eventos relacionados com esse projeto.

Eliminar um Projeto do Workspace

Para eliminar (remover) um projeto existente do Workspace, selecione a respetiva entrada na página Designs (Projects) e, em seguida, a opção Delete no respetivo menu ou no menu superior . A ação é efetivamente uma 'eliminação suave', em que o repositório do projeto é movido para a área Trash do Workspace. Um projeto pode ser eliminado no Altium Designer utilizando a opção Delete do menu  no painel Explorer panel.

A partir dessa vista (selecione Trash no menu principal), a entrada do projeto pode ser completamente removida (Permanently Delete) ou a ação revertida (Restore). Tenha em conta que o botão removerá todas as entradas (quando possível) armazenadas no Lixo do Workspace.