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.

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 inserir comentários em diversos documentos de projeto para aprimorar o processo de colaboração. 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 que colaboram no projeto (aqueles que têm acesso compartilhado ao documento) e são salvos no servidor independentemente do projeto, sem alterar de nenhuma forma 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 definida ou a um ponto no documento ativo de um projeto do Workspace e atribuir esses comentários a membros do Workspace, criando, essencialmente, 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 de colaboração eficazes e é inestimável quando é necessário apontar problemas no documento sem realizar mesclagens que possam 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 que colaboram no projeto — aqueles que têm acesso compartilhado ao documento — e são salvos no Workspace independentemente do projeto, sem alterar de nenhuma forma os documentos que o compõem.

Se você não tiver acesso ao recurso de criação e gerenciamento de tarefas, esse recurso não estará disponível, e o painel será chamado Comments.

Para obter informações sobre projetos da perspectiva de um 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 tanto os dados do projeto quanto os 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 os comentários são suportados

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 em um comentário em um documento de PCB, a visualização muda automaticamente para a mesma que o revisor utilizava (camadas visíveis, camada ativa, vista superior/inferior). Um exemplo de mudança de configuração de visualização ao focar em um comentário é mostrado abaixo.

Javascript ID: PCB_Support1

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

A placa após focar em um comentário (a mesma visualização de quando o comentário foi adicionado é aplicada): Top é a única camada de sinal habilitada, Top é a camada ativa e a placa é exibida 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 chicote elétrico – .

Esquemático de múltiplas placas

Os comentários em documentos esquemáticos 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 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 chicote elétrico

Os comentários em documentos de diagrama de fiação e desenho de layout de chicote elétrico 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 chicote elétrico .

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 a partir de um projeto do Workspace das seguintes formas:

  • Clique no botão Panels no canto inferior direito do espaço de projeto e selecione Comments and Tasks.

    O ícone do Workspace ao lado do nome de um painel no menu do canto inferior direito do espaço de projeto indica que é necessária uma conexão com um Workspace para visualizar os dados do painel associado. Um ícone azul () indica 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 marcador de um comentário inserido no espaço de projeto.

Para acessar o painel Comments and Tasks, o documento ativo deve ser um documento esquemático, de PCB, ActiveBOM, esquemático de múltiplas placas ou Draftsman de um projeto do Workspace aberto. 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 aceitam 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ê usufrui dos 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. Quando estiver conectado à sua conta Altium pelo Altium Designer e trabalhando com um projeto local, você poderá inserir até três comentários. Para usar todos os recursos 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 no espaço de projeto.

Experimente o recurso de comentários no modo de demonstração se ainda não tiver um Workspace do Altium 365 ativado.
Experimente o recurso de comentários no modo de demonstração se 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 no espaço do editor e especificar se os usuários mencionados serão notificados.

 
 
 
 
 

O botão  do painel alterna a visibilidade dos pinos marcadores 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 Comments and Tasks () para configurar a filtragem de comentários e o botão  associado para alternar entre as visualizações com e sem filtro.

  • Tasks only - ative esta opção para mostrar apenas os comentários atribuídos a um usuário.
  • ASSIGNED TO - todas as opções estão desativadas por padrão. Consequentemente, todas as tarefas/comentários são exibidos e ordenados por nome (a primeira entrada na 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. 

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.

  • Current document only – mostrar apenas os comentários inseridos no documento atualmente ativo.

  • 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 aos quais é atribuído (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 ele 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. Também há algumas opções para definir quais capturas de tela incluir no documento PDF gerado. Juntas, ambas fornecem informações sobre onde um comentário está e a que ele se aplica (ponto, componente, área). Se você deixar ambas desmarcadas, obterá apenas os próprios comentários. 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 da 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 onde o projeto reside. Ele não está disponível para usuários com os quais o projeto foi compartilhado fora do Workspace.
  • Entire designs snapshots - inclua uma captura de cada documento de origem que tenha um comentário dentro do período especificado Period. Isso fornece uma confirmação visual da localização do comentário 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 é a captura disponível na janela Contextual Commenting quando um marcador de comentário é clicado no espaço de projeto principal). Ela mostra o ponto, a área ou o componente ao qual o comentário se aplica.

Inserção

Para inserir um comentário no espaço de projeto de um editor gráfico baseado em objetos, como esquemático, PCB 2D ou Draftsman, primeiro execute o comando correspondente. Isso pode ser feito por meio de uma das seguintes ações:

  • 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 e selecione Comment na área de projeto.

Dependendo do tipo de documento (veja acima), os comentários podem ser associados a um objeto, a um ponto específico ou a uma área do documento ativo. O comando ativa o modo de posicionamento de comentários, e o cursor muda para uma mira 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 àquela linha da BOM. Clique com o botão direito em uma linha e selecione o comando Comment para adicionar um comentário a essa linha.

A ação de posicionamento abre uma caixa de diálogo de inserção de comentários que oferece um campo para inserir o texto do comentário e, em 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 você 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 marcador numerado no documento e também adicionará uma entrada de resumo do comentário ao painel Comments and Tasks.

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

Um comentário posicionado fica imediatamente disponível para todos os usuários com acesso ao projeto e também estará disponível na visualização do projeto no navegador do 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 inserindo 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, portanto, os usuários que o compõem, também pode ser adicionado como menção.

Se um usuário mencionado não tiver acesso ao projeto atual, você será solicitado a compartilhá-lo com esse usuário. Esta 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á posicionado 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 será exibida no canto superior esquerdo da caixa de diálogo do comentário e do bloco de 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 com os comentários comuns. Esse nome também é exibido na caixa de diálogo do comentário e no bloco de comentário. Clique nele para abrir a página Tasks do projeto na interface do Workspace no navegador 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. Como indica a dica na 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 bloco da tarefa for selecionado na página Tasks da interface do Workspace no navegador (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 na área do editor é alterada arrastando seu marcador associado para uma nova posição – durante ou após seu posicionamento. Quando selecionado, o marcador do comentário inclui uma linha de conexão com o objeto ou a área ao qual está associado.

Embora seja possível mover (arrastar) um marcador de comentário pelo 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 seu posicionamento inicial, clicando e arrastando no modo de posicionamento ().

Colagem de imagens

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

Cada imagem pode ter, no máximo, 2 MB. Depois de 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 que aparece. 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 na área 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 sob a entrada do projeto. O mesmo conteúdo e os mesmos atributos são exibidos no painel para as 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 (inclusive com imagens coladas) para a tarefa geral selecionada.

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

Comentários desvinculados

Quando um documento do projeto é removido ou seu UniqueID é alterado, os comentários desse documento podem ficar "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 de documentos correspondente (como marcadores numerados). Cada entrada do painel representa uma conversa de comentários 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 conversa.

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

Navegação pelos comentários selecionando os marcadores na área de projeto e as 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 conversa de comentários 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 pela primeira vez ou quando um comentário inserido é selecionado 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 sequencialmente 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 texto e, opcionalmente, uma menção a um usuário ('@') no campo Reply para adicionar uma nova entrada à conversa de comentários. Selecione a opção Assign a task to para criar uma tarefa atribuída a um usuário especificado no menu suspenso. 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. Observe que toda a conversa 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 conversa de comentários. Esse link pode ser usado para abrir este projeto no Web Viewer da interface do Workspace no navegador, com o 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 acinzentados.

Definindo prioridades e status das 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, mas eles 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 do projeto 

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

  • Os comentários criados no Web Viewer ao visualizar o snapshot do projeto de um commit com tag incluirão o nome da tag associada. Clique no link do nome da tag para abrir o snapshot do commit correspondente 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 Manufacturing Portal dessa liberação.

  • Os comentários criados no Visualizador Web ao visualizar um snapshot de Revisão de Design incluirão a entrada da revisão de design. Clique no link da revisão de design 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 o seu Workspace do Altium 365, um comentário inserido incluirá a opção adicional de criar e vincular uma issue do Jira no seu serviço Atlassian Jira®. Assim como os comentários convencionais e suas tarefas associadas, as issues do Jira inseridas podem ser visualizadas, editadas e receber comentários nos documentos de design, além de serem visualizadas/selecionadas pelo painel Comments and Tasks.

Uma instância de tarefa do Jira inserida é sincronizada com sua respectiva issue no ambiente Jira. A sincronização bidirecional de dados entre as issues do Jira e as tarefas do Workspace permite gerenciar projetos de design pelo ambiente Jira em conjunto com o Altium 365.

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

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

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

Criar uma issue do Jira

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

Insira uma tarefa do Jira no documento atual do projeto começando por inserir uma instância de comentário. O modo alternativo Jira está disponível no menu suspenso Comment.

Inicie a inserção de uma 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 registrados como membros 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 ambiente Jira e inclui acesso interativo às configurações de prioridade (Medium, High etc.) e status (To Do, In Progress etc.) da tarefa.

 
  • 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 principal 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 diretamente essa issue no ambiente Jira em uma nova guia do seu navegador padrão. O Task ID do Workspace é mapeado para o Issue Key no ambiente 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 do snapshot do documento atual do Workspace é incluída como anexo no 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 ambiente 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 ambiente 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 tarefa de issue do Workspace de uma prioridade Medium para High será refletido imediatamente 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 no 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 com o Jira do Altium 365 também permite vincular uma tarefa do Workspace a uma issue existente no seu serviço Atlassian Jira pelo 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 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 de 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 no ambiente 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 do Jira selecionada.

A nova tarefa de 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 Progress e Priority definidos pela issue do Jira – In Progress e High neste exemplo. Observe que as entradas 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 especificando 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 especificando 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á habilitada na caixa de diálogo Configurações avançadas.

Embora o 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 pendentes definidos atualmente para o projeto ativo. Um item de tarefa pendente serve 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