Comentários em Documentos

Altium Training

Altium Essentials: Design Review and Commenting

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Num relance

Saiba como os comentários em documentos no Altium Designer ajudam as equipes a revisar projetos compartilhados no Workspace sem modificar os documentos de projeto originais. Este guia aborda os tipos de documento compatíveis, a inserção de comentários e respostas, a atribuição de tarefas quando disponível e o gerenciamento de feedback pelo painel Comentários e Tarefas. Continue lendo para aproveitar melhor os comentários nas revisões de projeto da sua equipe.

- Descubra onde é possível adicionar comentários e como acessar o painel Comentários e Tarefas.
- Aprenda a vincular comentários a objetos, pontos ou áreas, dependendo do tipo de documento.
- Explore filtros, configurações de notificação e exportações em PDF para organizar e compartilhar o feedback das revisões.
Aprofunde-se com a IA:

Quando integrados a um Workspace conectado, os projetos do Altium Designer permitem que uma equipe de projeto distribuída trabalhe de forma colaborativa em projetos armazenados e gerenciados centralmente. A interface de projeto permite adicionar comentários a vários documentos de projeto para aprimorar o processo de colaboração. Os comentários, ou seja, notas adicionadas pelos usuários, podem ser inseridos nos documentos e respondidos por outros usuários.

O painel Comments and Tasks 
O painel Comments and Tasks 

Os comentários inseridos ficam disponíveis em tempo real para os usuários colaboradores (aqueles que têm acesso compartilhado ao documento) e são salvos no servidor independentemente do projeto, sem alterar de forma alguma os documentos que o compõem. O recurso de comentários é gerenciado pelo painel Comments and Tasks. Quando uma entrada de comentário é selecionada no painel Comments and Tasks, o sistema abre (e carrega, se necessário) o documento de projeto associado.

O painel Comments and Tasks permite adicionar comentários a uma área ou ponto definido no documento ativo de um projeto do Workspace e atribuir esses comentários a membros do Workspace, essencialmente criando tarefas para eles. O painel permite que todos os usuários que trabalham no documento adicionem comentários e visualizem todos os comentários sem modificar o documento em si. Esse recurso facilita processos sólidos de colaboração e é inestimável quando é necessário apontar problemas no documento sem realizar mesclagens e gerar conflitos. O painel Comments and Tasks pode ser usado essencialmente para criar uma lista de tarefas e, à medida que o projeto evolui, os comentários podem ser resolvidos e encerrados. Os comentários inseridos ficam disponíveis em tempo real para os usuários colaboradores — aqueles que têm acesso compartilhado ao documento — e são salvos no Workspace independentemente do projeto, sem alterar de forma alguma os documentos que o compõem.

Se você não tiver acesso à funcionalidade de criação e gerenciamento de tarefas, essa funcionalidade não estará disponível, e o painel terá o nome Comments.

Para obter informações sobre projetos da perspectiva do Workspace, consulte Workspace Projects (Workspace do Altium 365, Workspace do Enterprise Server).

Observe que comentários e tarefas podem ser adicionados e gerenciados tanto no Altium Designer quanto no Workspace relacionado, por meio da visualização de projeto em sua interface de navegador. A funcionalidade dos dois sistemas de comentários é essencialmente a mesma e, como os dados do projeto e dos comentários são armazenados no Workspace, os sistemas trabalham em conjunto em tempo real.

Consulte Commenting in the Web Viewer (Workspace do Altium 365, Workspace do Enterprise Server) para obter informações detalhadas sobre o sistema de comentários na interface de navegador de um Workspace.

Onde é possível adicionar comentários

Esquemático

Um comentário pode ser aplicado a um objeto, a um ponto específico ou a uma área em um documento esquemático.

PCB

Um comentário pode ser aplicado a um objeto, a um ponto específico ou a uma área em um documento de PCB (no modo de layout 2D) — .

Observe que, ao focar um comentário em um documento de PCB, a visualização mudará automaticamente para a mesma que o revisor utilizou (camadas visíveis, camada ativa, vista superior/inferior). Um exemplo de mudança na configuração de visualização ao focar um comentário é mostrado abaixo.

Javascript ID: PCB_Support1

A configuração de visualização antes de focar um comentário: todas as camadas de sinal estão habilitadas, Bottom é a camada ativa e a placa é mostrada pelo lado inferior.

A placa após focar um comentário (é aplicada a mesma visualização utilizada quando o comentário foi adicionado): Top é a única camada de sinal habilitada, Top é a camada ativa e a placa é mostrada pelo lado superior.

Draftsman

Um comentário pode ser aplicado a um ponto específico ou a uma área em um documento Draftsman de um projeto de PCB, de múltiplas placas ou de chicotes elétricos — .

Esquemático de múltiplas placas

Os comentários em documentos de esquemático de múltiplas placas ficam disponíveis quando a opção MBS.Comments está habilitada na caixa de diálogo Configurações avançadas.

Um comentário pode ser aplicado a um objeto ou a um ponto específico em um documento de esquemático de múltiplas placas — .

Montagem de múltiplas placas

Os comentários em documentos de montagem de múltiplas placas ficam disponíveis quando a opção MBA.Comments está habilitada na caixa de diálogo Configurações avançadas.

Um comentário pode ser aplicado a um ponto específico no documento de montagem de múltiplas placas — .

Diagrama de fiação e desenho de layout de chicotes elétricos

Os comentários em documentos de diagrama de fiação e desenho de layout de chicotes elétricos ficam disponíveis quando a opção Harness.Comments está habilitada na caixa de diálogo Configurações avançadas.

Um comentário pode ser aplicado a um objeto, a um ponto específico ou a uma área em um documento de diagrama de fiação ou desenho de layout de um projeto de chicotes elétricos .

ActiveBOM

Os comentários em documentos ActiveBOM ficam disponíveis quando a opção BOM.Comments está habilitada na caixa de diálogo Configurações avançadas.

Um comentário pode ser aplicado a uma linha em um documento ActiveBOM — .

Acesso ao painel Comentários e tarefas

O painel pode ser acessado em um projeto do Workspace das seguintes maneiras:

  • Clique no botão Panels no canto inferior direito da área de projeto e selecione Comments and Tasks.

    O ícone do Workspace ao lado do nome de um painel no menu do canto inferior direito da área de projeto indica que é necessária uma conexão com um Workspace para visualizar os dados do painel associado. Um ícone azul () significa que há uma conexão ativa com um Workspace. Um ícone cinza () indica que não há conexão com um Workspace no momento, e você será orientado a se conectar a um Workspace antes de poder acessar os dados do painel.

  • Selecione o comando View » Panels » Comments and Tasks nos menus principais.

  • Clique duas vezes no pino de marcação de um comentário inserido na área de projeto.

Para acessar o painel Comments and Tasks, o documento ativo deve ser um documento esquemático, de PCB, ActiveBOM, de esquemático de múltiplas placas ou Draftsman de um projeto aberto do Workspace. Apenas os projetos atualmente compartilhados com você estarão disponíveis para seleção.

Adicionar um comentário quando não estiver conectado a um Workspace

Antes de usar o recurso de comentários, certifique-se de estar conectado ao seu Workspace e de ter aberto um projeto e um dos tipos de documento que oferecem suporte a comentários (incluindo esquemático, PCB 2D, Draftsman e ActiveBOM). Use o comando File » Open Project para escolher um projeto do Workspace entre aqueles que foram compartilhados com você. O painel Comments and Tasks fornecerá orientações sobre esses pré-requisitos.

Se você já aproveita os benefícios da sua assinatura, mas ainda não criou um Workspace do Altium 365 para sua empresa, pode testar os recursos de comentários no modo de demonstração. Ao entrar na sua conta Altium pelo Altium Designer e trabalhar com um projeto local, você pode inserir até três comentários. Para usar todas as funcionalidades do recurso de comentários e salvar os comentários inseridos, o projeto deve ser disponibilizado no Workspace – um controle apropriado para isso será fornecido na caixa de mensagem abaixo da caixa de diálogo pop-up de comentários na área de projeto.

Experimente o recurso de comentários no modo de demonstração enquanto ainda não tiver um Workspace do Altium 365 ativado.
Experimente o recurso de comentários no modo de demonstração enquanto ainda não tiver um Workspace do Altium 365 ativado.

Opções do painel Comentários e tarefas

Use os botões na parte superior do painel Comments and Tasks para definir a disponibilidade dos comentários no painel e na área do editor e especificar se os usuários mencionados serão notificados.

O botão  do painel alterna a visibilidade dos pinos de marcação de comentários no documento. As entradas de comentários na lista do painel Comentários e tarefas ainda podem ser selecionadas normalmente.

Use o menu suspenso de filtros no painel () para configurar a filtragem de comentários e o botão  associado para alternar entre a visualização filtrada e a não filtrada.

  • TYPE - habilite o tipo a ser exibido. Todos estão habilitados por padrão.

  • SCOPE - habilite Current document para exibir apenas os comentários do documento atual.

  • ASSIGNEE - todas as opções estão desabilitadas por padrão. Portanto, todas as tarefas e comentários são exibidos e classificados por nome (a primeira entrada da lista é o usuário atual). Quando as caixas de seleção de um ou mais usuários são marcadas, as entradas desses usuários são exibidas. 

  • Clear Filters - use para restaurar rapidamente as configurações padrão de filtragem.

Use as opções do menu do botão  para configurar a visibilidade dos comentários e as notificações:

  • Unresolved Only – os comentários que foram resolvidos não são incluídos na lista.

  • Notification settings – clique para abrir a caixa de diálogo Notification Settings e configurar o recebimento de alertas por e-mail para todas as atividades de comentários neste projeto (All), apenas para os comentários em que você é mencionado ou designado como responsável (My), ou para não receber nenhum alerta por e-mail (None). ► Exemplo de conteúdo de e-mail.

  • Export Comments – clique para abrir a caixa de diálogo Comment Export Configuration e configurar a exportação de comentários para um arquivo PDF.

O PDF gerado incluirá informações sobre os comentários no projeto: ID do comentário, autor, data e hora de criação, texto do comentário, responsável (para tarefas) e status (para um comentário, se está Resolved; para uma tarefa, seu status To Do / In Progress / Resolved). Você pode optar por exportar todos os comentários associados ao projeto, independentemente de quando foram feitos, ou apenas os comentários feitos entre versões específicas do projeto. Há também algumas opções para definir quais capturas de tela incluir no documento PDF gerado. Juntas, elas fornecem informações sobre onde está um comentário e a que ele se aplica (ponto, componente, área). Se você deixar ambas desmarcadas, obterá apenas os comentários em si. Após configurar, clique em Export para gerar o PDF, usando a caixa de diálogo seguinte para determinar onde salvá-lo e com qual nome (por padrão, o nome do projeto).

A exportação de comentários para PDF também pode ser configurada e gerada por meio de um arquivo Output Job como parte do processo de liberação do projeto. Adicione um Export Comments gerador de saída à categoria Report Outputs.

Observe que o recurso de exportação de comentários está disponível apenas para membros do Workspace em que o projeto está armazenado. Ele não está disponível para usuários com quem o projeto foi compartilhado fora do Workspace.
  • Entire designs snapshots - inclua uma captura de cada documento de origem com um comentário dentro do período Period especificado. Isso fornece uma confirmação visual de onde o comentário está no documento por meio de um marcador de comentário numerado.
  • Original design screenshots - inclua a captura original feita quando um comentário foi criado (e que está disponível na janela Contextual Commenting ao clicar em um marcador de comentário na área principal de projeto). Isso mostra o ponto, a área ou o componente ao qual o comentário se aplica.

Inserção

Para inserir um comentário na área de projeto de um editor gráfico baseado em objetos, como o editor de esquemáticos, de PCB 2D ou o Draftsman, primeiro execute o comando correspondente. Isso pode ser feito de uma das seguintes maneiras:

  • Clique no botão  disponível no painel Comments and Tasks.

  • Clique em  próximo ao canto superior direito da área de projeto.

  • Clique em Place » Comment nos menus principais.

  • Use o atalho de teclado Ctrl+Alt+C.

  • Clique com o botão direito do mouse na área de projeto e selecione Comment.

Dependendo do tipo de documento (veja acima), os comentários podem ser atribuídos a um objeto, a um ponto específico ou a uma área no documento ativo. O comando ativa o modo de inserção de comentários, e o cursor muda para uma cruz com um círculo azul que detecta e destaca objetos para seleção:

  • Clique em um objeto destacado para anexar (fixar) um comentário a esse objeto.

  • Clique em uma área não destacada para anexar um comentário a esse ponto específico do documento.

  • Clique fora de um objeto e arraste o cursor para criar uma área retangular destacada e anexar um comentário à área especificada ().

Em um documento ActiveBOM, clique em uma célula para adicionar um comentário à linha correspondente da BOM. Clique com o botão direito do mouse em uma linha e selecione o comando Comment para adicionar um comentário a essa linha.

A ação de inserção abre uma caixa de diálogo de entrada de comentário que oferece um campo para digitar o texto do comentário e, para documentos gráficos, também uma opção adicional para adicionar um desenho à mão livre ao comentário, quando aplicável (). Selecione a opção Assign a task to para atribuir uma tarefa a si mesmo ou a um dos usuários mencionados no comentário (veja os detalhes abaixo). Clique em  para confirmar a criação do comentário, que será associado a um pino de marcação numerado no documento, e também adicionar uma entrada de resumo do comentário ao painel Comments and Tasks.

Inserção de um comentário em um objeto, menção a outro usuário registrado no comentário, movimentação do pino indicador do comentário e adição de um desenho à mão livre ao comentário.

Um comentário inserido fica imediatamente disponível para todos os usuários com acesso ao projeto e também estará disponível na visualização do projeto pelo navegador no Workspace conectado.

O número de caracteres que podem ser inseridos em um comentário padrão e em uma tarefa é limitado a 2000.

Menções e atribuições de tarefas

Além do texto na caixa de diálogo de inserção de comentários, é possível adicionar uma referência de 'menção' a qualquer outro usuário ou função registrado no Workspace conectado, digitando o caractere @. Selecione um nome/e-mail na lista suspensa para adicionar a referência ao usuário (membro do Workspace) ao comentário e também como uma entrada Assign a task to — basicamente, uma task será atribuída ao usuário. Desmarque esta última opção se não quiser que o comentário seja considerado especificamente atribuído a esse usuário. Um grupo de funções (por exemplo, 'Engenheiros') e, consequentemente, os usuários que o compõem também podem ser adicionados como uma menção.

Se um usuário mencionado não tiver acesso ao projeto atual, você receberá uma solicitação para compartilhá-lo com esse usuário. Essa opção está disponível se você for o proprietário do projeto ou um administrador do Workspace. Os direitos de acesso do usuário são concedidos por meio da caixa de diálogo Compartilhar; o usuário receberá um e-mail notificando-o sobre o acesso compartilhado. Se você cancelar a caixa de diálogo Compartilhar, o projeto não será compartilhado, mas o comentário será inserido normalmente.

► Veja mais informações sobre como compartilhar um projeto.

Quando uma tarefa é atribuída a um usuário, a imagem/foto desse usuário é exibida no canto superior esquerdo da caixa de diálogo do comentário e do cartão do comentário no painel Comments and Tasks. Além disso, a tarefa receberá um nome composto pelo nome do projeto e pelo número sequencial (por exemplo, Kame_FMU-1), em vez de um número simples, como ocorre nos comentários normais. Esse nome também é exibido na caixa de diálogo do comentário e no cartão do comentário. Clique nele para abrir a página Tasks do projeto na interface do navegador do Workspace, com a tarefa selecionada em foco na lista de tarefas.

Uma tarefa pode ser vinculada a um commit do projeto ao salvar o projeto no Workspace conectado. Conforme indicado na dica da caixa de diálogo Salvar no servidor, adicione o ID da tarefa ao campo Comment (conforme exibido no painel Comments and Tasks); a tarefa será vinculada ao commit do projeto que será criado após clicar em OK na caixa de diálogo.

O link para o commit será exibido no painel de detalhes da tarefa quando o cartão da tarefa for selecionado na página Tasks da interface do navegador do Workspace (Workspace do Altium 365, Workspace do Enterprise Server) ou na visualização Tasks da página de gerenciamento detalhado do projeto (Workspace do Altium 365, Workspace do Enterprise Server). Clique no link para abrir a visualização History do projeto com o commit relacionado destacado na linha do tempo.

O link para o commit vinculado será exibido no painel de detalhes da tarefa. Passe o cursor sobre a imagem para ver a página History que é aberta após clicar no link e o commit relacionado destacado na linha do tempo.
O link para o commit vinculado será exibido no painel de detalhes da tarefa. Passe o cursor sobre a imagem para ver a página History que é aberta após clicar no link e o commit relacionado destacado na linha do tempo.

Posicionamento

A localização de um comentário no espaço do editor é alterada arrastando seu 'pino' associado para uma nova posição, durante ou após sua inserção. Quando selecionado, o pino do comentário inclui uma linha de conexão com o objeto ou a área a ele associado.

Embora seja possível mover (arrastar) um pino de comentário no editor de documentos, o ponto ou a área definidos inicialmente não podem ser modificados.

Observe que um comentário também pode ser posicionado durante sua inserção inicial, clicando e arrastando no modo de inserção ().

Colar imagens

Você pode adicionar uma imagem a um comentário copiando-a primeiro de uma janela do Explorer ou de uma página do navegador, clicando com o botão direito na imagem para copiá-la para a área de transferência. Para anexar a imagem, use o botão direito e selecione Paste (ou o atalho Ctrl+V ) no próprio comentário (no campo que exibe Add others with @ or paste images). 

Cada imagem pode ter no máximo 2 MB. Após colá-la no comentário, clique na imagem para exibi-la por inteiro, conforme mostrado na imagem à direita.

Você também pode publicar um comentário que contenha apenas uma imagem colada, sem nenhum texto, conforme mostrado abaixo.

Desenho

Ao inserir ou editar um comentário, selecione o botão de opção  para adicionar um desenho à mão livre com o cursor de caneta exibido. Clique e arraste para criar linhas e, em seguida, clique com o botão direito para concluir e associar o desenho ao comentário selecionado.

Para acessar o modo Freehand Drawing do painel Properties, pressione a tecla Tab quando o modo de desenho à mão livre estiver ativo (isso é indicado pelo ícone  no espaço de projeto). Essas opções permitem desfazer e refazer comentários no menu suspenso Commands e alterar a largura, o tamanho e a cor no menu suspenso Properties .

Tarefas gerais

As tarefas gerais (tarefas aplicadas ao projeto atual, mas que não estão associadas a um comentário ou documento do projeto) são listadas no painel em um grupo separado, abaixo da entrada do projeto. O mesmo conteúdo e os mesmos atributos são exibidos no painel para tarefas gerais (responsável, prioridade etc.).

As tarefas gerais são listadas no painel Comments and Tasks.
As tarefas gerais são listadas no painel Comments and Tasks.

Clique em uma entrada de Tarefa geral no painel para acessar suas caixas de diálogo de comentários. Use a caixa de diálogo para publicar comentários (incluindo aqueles com imagens coladas) para a Tarefa geral selecionada.

Uma tarefa geral para um projeto pode ser criada na página Tasks da interface do navegador do Workspace ao acessar a página de gerenciamento detalhado do projeto. Para saber mais, consulte Management of a Specific Project ( Workspace do Altium 365, Workspace do Enterprise Server).

Comentários desvinculados

Quando um documento do projeto é removido ou seu UniqueID é alterado, os comentários do documento podem se tornar "desvinculados". Esses comentários ainda podem ser acessados na seção recolhível Detached Comments do painel. Clique no bloco de um comentário desvinculado no painel Comments and Tasks para exibir sua caixa de diálogo na área de projeto do documento aberto no momento.

Trabalhando com comentários

Os comentários inseridos em um documento de projeto são registrados tanto no painel Comments and Tasks (como uma sequência de entradas numeradas) quanto no editor do documento correspondente (como marcadores numerados). Cada entrada do painel representa uma discussão e fornece informações resumidas, incluindo quem inseriu o comentário e quando, o texto do comentário inicial, quaisquer menções/atribuições aplicadas e o número de respostas na discussão.

Uma discussão é aberta ao selecionar sua entrada no painel Comments and Tasks ou ao clicar no marcador associado na área de projeto. Isso destaca o comentário no editor do documento e abre a caixa de diálogo do comentário, que inclui o comentário inicial e quaisquer respostas dos usuários. Se um comentário selecionado estiver associado a outro documento de projeto, o sistema abrirá (e carregará, se necessário) esse documento.

Navegação pelos comentários selecionando marcadores na área de projeto e entradas no painel Comments and Tasks.

Caixa de diálogo de comentários

A interação com um comentário inserido ocorre por meio da caixa de diálogo pop-up de comentários, que mostra todas as entradas da discussão selecionada e inclui opções para visualizar, responder, editar, resolver e excluir uma entrada. A caixa de diálogo é aberta ao inserir um comentário ou ao selecionar um comentário existente no painel Comments and Tasks ou na área de projeto. Pressione Esc ou clique na área de projeto para fechar a caixa de diálogo de comentários.

Percorra todos os comentários disponíveis em sequência usando os botões anterior/próximo () no cabeçalho da caixa de diálogo.

Visualizar

Selecione a opção Original Snapshot no comentário inicial para ver uma captura da área do editor no momento em que o comentário foi inserido. Clique no ícone no canto superior direito da captura de tela ou na própria captura para abrir uma visualização em tamanho real (clique no ícone  no canto superior direito dessa visualização ou na própria imagem para fechá-la).

Responder

Insira o texto e, opcionalmente, uma menção a um usuário ('@') no campo Reply para adicionar uma nova entrada à discussão. Selecione a opção Assign a task to para criar uma tarefa atribuída a um usuário especificado na lista suspensa. Clique em  para confirmar a entrada.

Editar e excluir

Um comentário existente pode ser editado por seu autor usando a opção Edit disponível no menu  do comentário. Clique no botão  para confirmar a edição do comentário.

Use a opção Delete para remover o comentário selecionado no momento. Observe que toda a discussão será removida se o comentário inicial (em vez de uma resposta) for excluído.

Use a opção Convert to Task para converter o comentário em uma tarefa atribuída a você.

Use a opção Copy Link para copiar a URL da discussão. Esse link pode ser usado para abrir este projeto no Web Viewer da interface do Workspace no navegador, com um objeto, ponto ou área do comentário ampliado e centralizado.

Resolver

Clique no botão / para alternar o estado do comentário entre Resolved e Unresolved (o padrão). Um comentário resolvido (fechado como concluído) fica inativo e não pode ser editado, e tanto sua entrada no painel Comments and Tasks quanto seu marcador no documento ficam esmaecidos.

Definindo prioridades e status de tarefas

Se um comentário de tarefa tiver sido atribuído a um usuário, sua prioridade e seu status poderão ser definidos. Uma tarefa é imediatamente definida com a prioridade Medium e o status To Do ao ser criada, mas esses valores podem ser alterados clicando no controle associado na parte superior da caixa de diálogo de comentários.

Tag de commit, ID de revisão da liberação e informações de revisão de projeto 

As tags de commit e os IDs de revisão da liberação são exibidos ao visualizar os comentários/tarefas aplicáveis tanto no painel Comments and Tasks quanto na caixa de diálogo de comentários do Altium Designer.

  • Os comentários criados no Web Viewer ao visualizar o instantâneo do projeto de um commit com tag incluirão o nome da tag associada. Clique no link do nome da tag para abrir o instantâneo do commit relacionado no Web Viewer.

  • Os comentários criados no Web Viewer ao visualizar uma liberação específica incluirão o ID de revisão da liberação. Clique no link do ID de revisão da liberação para abrir o Portal de Fabricação dessa liberação.

  • Os comentários criados no Web Viewer ao visualizar um instantâneo de revisão de projeto incluirão a entrada da revisão de projeto. Clique no link da revisão de projeto para abrir a página da revisão.

Trabalhando com tarefas do Jira

Se a integração com o Jira estiver habilitada e configurada para seu Workspace do Altium 365, um comentário inserido incluirá a opção adicional de criar e vincular um item no seu serviço Atlassian Jira®. Assim como os comentários convencionais e suas tarefas associadas, os itens do Jira inseridos podem ser visualizados, editados e comentados nos documentos de projeto, além de visualizados/selecionados por meio do painel Comments and Tasks.

Uma instância de tarefa do Jira inserida é sincronizada com seu respectivo item no espaço do Jira. A sincronização bidirecional de dados entre os itens do Jira e as tarefas do Workspace permite gerenciar projetos de engenharia por meio do espaço do Jira em conjunto com o Altium 365.

  • Consulte a página Integração com o Jira para obter uma visão geral das funcionalidades.

  • Consulte a página Explorando a interface baseada em navegador para obter detalhes sobre como configurar a integração com o Jira para seu Workspace do Altium 365.

  • Consulte a página Web Viewer para obter detalhes sobre como trabalhar com tarefas do Jira no Web Viewer da interface do Workspace do Altium 365 no navegador.

Criar um item do Jira

Para inserir uma tarefa de item do Jira em um projeto de engenharia, primeiro insira uma instância de comentário da maneira habitual e, em seguida, selecione a opção Jira Issue na caixa de diálogo de comentários. Depois, escolha um tipo de item e adicione um resumo para criar a tarefa sincronizada do item do Jira.

Insira uma tarefa do Jira no documento do projeto atual, primeiro inserindo uma instância de comentário. O modo alternativo Jira está disponível no menu suspenso Comment.

Inicie a inserção da tarefa do Jira selecionando a opção Jira Issue no menu Comment da caixa de diálogo.

Clique na opção Create Issue se ela ainda não estiver selecionada.

Selecione o tipo de issue a ser criada na lista suspensa Issue Type, que inclui os tipos disponíveis no seu serviço Jira.

Insira um Summary para a issue e, opcionalmente, uma descrição e um responsável. A lista suspensa Assignee incluirá apenas os usuários que são membros registrados da sua conta Jira. Selecione Post para confirmar.

A issue do Jira é inserida na posição inicial do comentário no documento, é incluída no painel Comments and Tasks, fornece um link para a issue no espaço Jira e inclui acesso interativo às configurações de prioridade da tarefa (Medium, High etc.) e de status (To Do, In Progress etc.).

 
 
 
 
 
 
  • O número de caracteres que podem ser inseridos ao publicar ou responder a um comentário relacionado ao Jira é limitado a 20.000.

  • Ao criar uma tarefa do Jira pelo Altium Designer, os seguintes campos são compatíveis:

    • Texto

    • Número

    • Campo de URL

    • Lista suspensa

    • Lista suspensa com pesquisa (para usuário (responsável), pesquisa de issues do Jira e pesquisa de uma tarefa pai ao criar uma subtarefa)

    • Campo de seleção múltipla (são apresentadas caixas de seleção com um 'aviso' para selecionar pelo menos uma opção para continuar – ).

Selecione o Task ID da issue do Jira do Workspace na caixa de diálogo de comentários ou no painel Comments and Tasks para abrir essa issue diretamente no espaço Jira em uma nova guia do navegador padrão. O Task ID do Workspace é mapeado para o Issue Key no espaço Jira, e os principais parâmetros do Jira, como Resumo, Descrição, Responsável e Comentários, são mapeados entre as duas instâncias. O usuário do Workspace que criou a issue do Jira é o relator da issue no Jira. Observe que uma imagem instantânea do documento atual do Workspace é incluída como anexo do Jira se a opção Attach original snapshot tiver sido selecionada ao criar a issue do Jira do Workspace (veja acima).

Uma tarefa do Jira inserida no Workspace criará uma issue sincronizada no espaço Jira. As duas são vinculadas pelo mapeamento do Task ID do Workspace com o Issue Key do Jira.
Uma tarefa do Jira inserida no Workspace criará uma issue sincronizada no espaço Jira. As duas são vinculadas pelo mapeamento do Task ID do Workspace com o Issue Key do Jira.

Além dos parâmetros mapeados entre as issues do Workspace e do Jira, as configurações de status Priority e Progress relacionadas à tarefa também são sincronizadas. Por exemplo, alterar a prioridade da tarefa da issue do Workspace de Medium para High será imediatamente refletido na issue do Jira, e alterar o estado de progresso de To Do para In Progress no Jira também alterará o estado da issue do Jira do Workspace. Pode ser necessário atualizar os dados (clicando no botão  na parte superior do painel Comments and Tasks) para visualizar os dados atualizados.

Vincular a uma issue do Jira

A integração do Altium 365 com o Jira também permite vincular uma tarefa do Workspace a uma issue existente no seu serviço Atlassian Jira por meio do modo Jira Issue da caixa de diálogo de comentários. Você pode vincular a qualquer issue do projeto Jira especificado, que será então sincronizada com a tarefa do Jira do Workspace.

Javascript ID: LinkJiraIssue

Insira uma instância de comentário na área do documento ou no objeto que deseja associar a uma issue existente do Jira e, em seguida, selecione o modo Jira Issue e a opção Link Issue na caixa de diálogo de comentários.

Use a lista suspensa Select or search issues para selecionar a issue do Jira (mostrada como um texto Summary) que será vinculada à instância da tarefa do Jira recém-inserida. Comece a digitar no campo de texto para pesquisar a issue do Jira desejada.

A lista suspensa Jira Issue da caixa de diálogo mostrará a issue selecionada do espaço Jira. Se necessário, marque a opção Attach original snapshot para transferir uma imagem da visualização atual do documento para o Jira.

Clique no botão Post para estabelecer o vínculo entre a tarefa do Jira do Workspace e a issue selecionada do Jira.

A nova tarefa da issue do Jira é exibida no painel Comments and Tasks e na caixa de diálogo de comentários, que incluirá todos os comentários existentes (ou adicionados) – selecione a opção Show all Replies da caixa de diálogo para ver a lista completa.

A issue vinculada do Jira agora está sincronizada com a tarefa do Jira do Workspace, que inclui o Comments da issue e está definida com os estados de Progress e Priority definidos pela issue do Jira – In Progress e High neste exemplo. Observe que as entradas de Web links da issue do Jira agora indicarão que uma tarefa do Jira do Workspace do Altium 365 foi vinculada (ou vinculada novamente) a essa issue.

Uma issue existente do Jira é vinculada a uma tarefa do Workspace ao especificar sua entrada Jira Issue no modo Link Issue da caixa de diálogo de comentários do Workspace.
Uma issue existente do Jira é vinculada a uma tarefa do Workspace ao especificar sua entrada Jira Issue no modo Link Issue da caixa de diálogo de comentários do Workspace.

Painel de tarefas

O painel To-Do está disponível quando a opção UI.PanelToDoList está ativada na caixa de diálogo Configurações avançadas.

Embora seu Workspace conectado ofereça um conjunto abrangente de recursos para comentários e atribuição de tarefas descritos acima, você também pode acessar o painel To-Do para acompanhar suas tarefas. O painel To-Do lista todos os itens de tarefas atualmente definidos para o projeto ativo. Um item de tarefa é usado como lembrete de uma tarefa que precisa ser realizada posteriormente em relação a um documento.

O painel To-Do
O painel To-Do

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents