Document Commenting

Quando integrados com um Workspace ligado, os projetos do Altium Designer permitem que uma equipa de design distribuída trabalhe colaborativamente em projetos armazenados e geridos de forma centralizada. A interface de design suporta comentários em vários documentos de design para melhorar o processo de colaboração no design. Os comentários, ou seja, notas adicionadas pelos utilizadores, podem ser colocados nos documentos e receber respostas de outros utilizadores.

O painel Comments and Tasks 

Os comentários colocados estão disponíveis em tempo real para os utilizadores que colaboram (aqueles que têm acesso partilhado ao documento) e são guardados no servidor independentemente do projeto, sem alterar de forma alguma os documentos que o constituem. A funcionalidade de comentários é gerida através do 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 design 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, criando essencialmente tarefas para eles. O painel permite que todos os utilizadores que estejam a trabalhar no documento adicionem comentários e vejam todos os comentários sem modificarem efetivamente o próprio documento. Esta funcionalidade facilita processos de colaboração robustos e é inestimável quando é necessário assinalar problemas no documento sem efetuar fusões físicas nem gerar conflitos. O painel Comments and Tasks pode essencialmente ser utilizado para criar uma lista de tarefas pendentes e, à medida que o design evolui, os comentários podem ser resolvidos e fechados. Os comentários colocados estão disponíveis em tempo real para os utilizadores que colaboram – aqueles que têm acesso partilhado ao documento – e são guardados no Workspace independentemente do projeto, sem alterar de forma alguma os documentos que o constituem.

Tenha em conta que os comentários e as tarefas podem ser adicionados e geridos tanto no Altium Designer como no Workspace relacionado através da vista de design da respetiva interface de navegador. A funcionalidade dos dois sistemas de comentários é essencialmente a mesma e, uma vez que tanto o projeto como os dados de comentários são armazenados no Workspace, os sistemas funcionam em conjunto em tempo real.

Consulte Commenting in the Web Viewer (Altium 365 Workspace, Enterprise Server Workspace) 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 num documento esquemático.

PCB

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

Draftsman

Um comentário pode ser aplicado a um ponto específico ou a uma área num documento Draftsman de um projeto PCB, Multi-board ou Harness Design – .

Esquemático Multi-board

Um comentário pode ser aplicado a um objeto ou a um ponto específico num documento Multi-board Schematic – .

Montagem Multi-board

Um comentário pode ser aplicado a um ponto específico no documento Multi-board Assembly – .

Harness Wiring Diagram e Layout Drawing

Um comentário pode ser aplicado a um objeto, a um ponto específico ou a uma área num documento Wiring Diagram ou Layout Drawing de um projeto de design de arnês .

ActiveBOM

Um comentário pode ser aplicado a uma linha num documento ActiveBOM – .

Acesso ao painel Comments and Tasks

O painel pode ser acedido a partir de um projeto do Workspace das seguintes formas:

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

  O ícone do Workspace junto ao nome de um painel no menu no canto inferior direito do espaço de design indica que é necessária uma ligação a um Workspace para ver os dados do painel associado. Um ícone azul () significa que existe atualmente uma ligação a um Workspace. Um ícone cinzento () indica que atualmente não existe ligação a um Workspace e será encaminhado para estabelecer ligação a um Workspace antes de poder aceder aos dados do painel.

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

• Faça duplo clique no pino marcador de um comentário colocado no espaço de design.

Adicionar um comentário quando não está ligado a um Workspace

Antes de utilizar a funcionalidade de comentários, certifique-se de que está ligado ao seu Workspace e de que abriu um projeto e um dos tipos de documento que suportam comentários (incluindo esquemático, PCB 2D, Draftsman e ActiveBOM). Utilize o comando File » Open Project para escolher um projeto do Workspace entre aqueles que foram partilhados consigo. O painel Comments and Tasks fornecerá indicações sobre estes pré-requisitos.

Opções do painel Comments and Tasks

Utilize os botões no topo do painel Comments and Tasks para definir a disponibilidade dos comentários no painel e no espaço do editor e para especificar se os utilizadores mencionados são notificados.

O botão  do painel alterna a visibilidade dos pinos marcadores de comentário no documento. As entradas de comentário na lista do painel Comments and Tasks podem continuar a ser selecionadas como habitualmente.

Utilize o menu pendente de filtro no painel Comments and Tasks () para configurar a filtragem de comentários e o botão associado  para alternar entre a vista filtrada e a não filtrada.

• Tasks only - ative esta opção para mostrar apenas comentários que estejam atribuídos a um utilizador.
• ASSIGNED TO - todas as opções estão desativadas por predefinição. Consequentemente, todas as tarefas/comentários são mostrados e ordenados por nome (a primeira entrada da lista é o utilizador atual). Quando as caixas de verificação são ativadas para um ou mais utilizadores, serão apresentadas as entradas desses utilizadores. 

Utilize 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 tenham sido resolvidos não são incluídos na lista.

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

• Notification settings – clique para abrir a caixa de diálogo Notification Settings e configurar a receção de alertas por email para toda a atividade de comentários neste design (All), apenas para os comentários em que é mencionado ou lhe são atribuídos (My), ou para não receber quaisquer alertas por email (None). ► Exemplo de conteúdo de email.

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

  

  O PDF de saída incluirá informações sobre os comentários no design: ID do comentário, autor, data e hora de criação, texto do comentário, responsável atribuído (para tarefas) e estado (para um comentário, se estiver Resolved; para uma tarefa, o seu estado To Do / In Progress / Resolved). Pode optar por exportar todos os comentários associados ao design, independentemente de quando esses comentários foram feitos, ou apenas os comentários feitos entre versões específicas do design. Existem também algumas opções para definir que capturas de ecrã incluir no documento PDF gerado. Em conjunto, ambas fornecem informação sobre onde está um comentário e a que se aplica (ponto, componente, área). Se deixar ambas desmarcadas, obterá apenas os próprios comentários. Depois de configurado, clique em Export para gerar o PDF, usando a caixa de diálogo seguinte para determinar onde guardar e com que nome (por predefinição, o do projeto).

  • Entire designs snapshots - incluir uma imagem de cada documento de origem com um comentário dentro do Period de tempo indicado. Isto fornece uma confirmação visual de onde o comentário se encontra no documento, através de um marcador de comentário numerado.
  • Original design screenshots - incluir a Captura Original que foi tirada quando um comentário foi criado (e que é a captura disponível na janela Contextual Commenting quando se clica num marcador de comentário no espaço principal do design). Isto mostra o ponto, área ou componente a que o comentário se aplica.

  A exportação de comentários para PDF também pode ser configurada e gerada através de um ficheiro Output Job como parte da libertação do projeto. Adicione um outputter Export Comments como parte da categoria Report Outputs.

  Tenha em atenção que a funcionalidade de exportação de comentários só está disponível para membros do Workspace onde o projeto reside. Não está disponível para utilizadores com quem o projeto tenha sido partilhado fora do Workspace.

Colocação

Para colocar um comentário no espaço de design de um editor gráfico baseado em objetos, como esquemático, PCB 2D ou Draftsman, execute primeiro o respetivo comando. Isto pode ser feito através de uma das seguintes formas:

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

• Clique em  perto do canto superior direito do espaço de design.

• Clique em Place » Comment nos menus principais.

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

• Clique com o botão direito e selecione Comment no espaço de design.

Dependendo do tipo de documento (ver 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 invoca o modo de colocação de comentários, e o cursor muda para uma mira com um círculo azul que deteta e realça objetos para seleção:

• Clique num objeto realçado para anexar (fixar) um comentário a esse objeto.

• Clique numa área não realçada para anexar um comentário a esse ponto específico do documento.

• Clique afastado de um objeto e arraste o cursor para criar uma área retangular realçada e anexar um comentário à área especificada ().

Num documento ActiveBOM, clique numa célula num documento ActiveBOM para adicionar um comentário a essa linha da BOM. Clique com o botão direito numa linha e selecione depois o comando Comment para adicionar um comentário a esta linha.

A ação de colocação abre então uma caixa de diálogo de introdução de comentário que disponibiliza um campo para introduzir 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 próprio ou a um dos utilizadores mencionados no comentário (ver detalhes abaixo). Clique em  para confirmar a criação do comentário, o que associará o comentário a um marcador de pino numerado no documento, e também adicionará uma entrada de resumo do comentário ao painel Comments and Tasks.

Colocar um comentário num objeto, mencionar outro utilizador registado no comentário, mover o indicador de pino do comentário e adicionar um desenho à mão livre ao comentário.

Menções e Atribuições de Tarefas

Juntamente com o texto na caixa de diálogo de introdução de comentário, pode ser adicionada uma referência de 'menção' para qualquer outro utilizador ou função registada no Workspace ligado, introduzindo o carácter @. Selecione um nome/email na lista suspensa para adicionar a referência do utilizador (membro do Workspace) ao comentário, e também como uma entrada Assign a task to – essencialmente, será atribuída uma task ao utilizador. Desmarque esta última opção se não pretender que o comentário seja considerado como especificamente atribuído a esse utilizador. Um grupo de Função (por exemplo, 'Engineers'), e portanto os utilizadores que o constituem, também pode ser adicionado como menção.

Se um utilizador mencionado não tiver acesso ao projeto atual, ser-lhe-á proposto partilhá-lo com esse utilizador. Esta opção está disponível se for o proprietário do projeto ou um administrador do Workspace. Os Direitos de Acesso do Utilizador são concedidos através da caixa de diálogo Partilhar; o utilizador receberá um email a notificá-lo do acesso partilhado. Se cancelar a caixa de diálogo Partilhar, o projeto não será partilhado, mas o comentário será colocado normalmente.

► Veja mais informações sobre partilhar um design.

Quando uma tarefa é atribuída a um utilizador, a imagem/fotografia desse utilizador será mostrada no canto superior esquerdo da caixa de diálogo do comentário e no bloco do comentário no painel Comments and Tasks. Além disso, a tarefa terá como nome o nome do projeto e o número de sequência (por exemplo, Kame_FMU-1) em vez de um número simples, como acontece com os comentários normais. Este nome também é mostrado na caixa de diálogo do comentário e no bloco 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.

Posicionamento

A localização de um comentário no espaço do editor é movida arrastando o respetivo 'pino' para uma nova posição – durante ou após a sua colocação. Quando selecionado, o pino do comentário inclui uma linha de ligação ao seu objeto ou área associada.

Tenha em atenção que um comentário também pode ser posicionado durante a sua colocação inicial clicando e arrastando em modo de colocação ().

Colar Imagens

Pode adicionar uma imagem a um comentário copiando primeiro a imagem de uma janela Explorer  ou de uma 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, use o clique com o botão direito Paste (ou o atalho Ctrl+V ) no próprio comentário (no campo onde aparece Add others with @ or paste images). 

Cada imagem pode ter no máximo 2 MB. Depois de ser colada no comentário, clique na imagem para apresentar a imagem completa, como mostrado na imagem à direita.

Também pode publicar um comentário se este incluir apenas uma imagem colada sem qualquer texto, como mostrado abaixo.

Desenho

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

Para aceder ao modo Freehand Drawing do painel Properties, prima a tecla Tab quando o modo de desenho à mão livre estiver ativo (isto é indicado pelo ícone  no espaço de design). Estas opções permitem-lhe 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 num grupo separado sob a entrada do projeto. O mesmo conteúdo e atributos são mostrados no painel para as tarefas gerais (responsável, prioridade, etc.).

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

Clique numa entrada de Tarefa Geral no painel para aceder às respetivas caixas de diálogo de comentários. Utilize a caixa de diálogo para publicar comentários (incluindo os que contêm imagens coladas) para a Tarefa Geral selecionada.

Comentários Desanexados

Quando um documento do projeto é removido, ou o seu UniqueID foi alterado, os comentários desse documento podem ficar "desanexados". Esses comentários continuam a poder ser acedidos a partir da região expansível Detached Comments do painel. Clique no bloco de um comentário desanexado no painel Comments and Tasks para mostrar a respetiva caixa de diálogo no espaço de desenho do documento atualmente aberto.

Trabalhar com Comentários

Os comentários colocados num documento de design são registados tanto no painel Comments and Tasks (como uma sequência de entradas numeradas) como no editor de documentos correspondente (como gráficos de pino numerados). Cada entrada do painel representa um tópico de comentários e fornece informação resumida, incluindo quem colocou o comentário e quando, o texto do comentário inicial, quaisquer menções/atribuições aplicadas e o número de respostas no tópico.

Um tópico de comentários é aberto selecionando a respetiva entrada no painel Comments and Tasks ou clicando no pino associado no espaço de desenho. Isto realça o comentário no editor de documentos e abre a caixa de diálogo da entrada do comentário, que inclui o comentário inicial e quaisquer respostas dos utilizadores. Se o comentário selecionado estiver associado a outro documento de design, o sistema abrirá (e carregará, se necessário) esse documento.

Navegar pelos comentários selecionando marcadores de pino no espaço de desenho e selecionando entradas no painel Comments and Tasks.

Caixa de Diálogo de Comentários

A interação com um comentário colocado é feita através da caixa de diálogo pop-up de comentários, que mostra todas as entradas no tópico de comentários selecionado e inclui opções para pré-visualizar, responder, editar, resolver e eliminar uma entrada. A caixa de diálogo é aberta ao colocar inicialmente um comentário ou quando um comentário colocado é selecionado no painel Comments and Tasks ou no espaço de desenho. Prima Esc ou clique no espaço de desenho para fechar a caixa de diálogo de comentários.

Pré-visualização

Selecione a opção Original Snapshot no comentário inicial para ver uma captura gráfica da área do editor no momento em que o comentário foi colocado. Clique no ícone no canto superior direito da captura de ecrã, ou na própria captura, para abrir uma pré-visualização em tamanho completo (clique no ícone  no canto superior direito desta pré-visualização, ou na própria imagem, para a fechar).

Responder

Introduza texto e, opcionalmente, uma menção a um utilizador ('@') no campo Reply para adicionar uma nova entrada ao tópico de comentários. Selecione a opção Assign a task to para criar uma tarefa atribuída a um utilizador especificado na lista pendente. Clique em  para confirmar a entrada.

Editar e Eliminar

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

Utilize a opção Delete para remover o comentário atualmente selecionado. Tenha em atenção que todo o tópico será removido se o comentário inicial (em vez de uma Resposta) for eliminado.

Utilize a opção Convert to Task para converter o comentário numa tarefa atribuída a si próprio.

Utilize a opção Copy Link para copiar o URL do tópico de comentários. Esta ligação pode ser usada para abrir este projeto em Web Viewer da interface do navegador do Workspace, com um objeto, ponto ou área do comentário ampliado e centrado.

Resolver

Clique no botão / para alternar o estado do comentário entre Resolved e Unresolved (o predefinido). Um comentário resolvido (fechado como concluído) fica inativo e não editável, e tanto a respetiva entrada no painel Comments and Tasks como o respetivo marcador de pino no documento ficam a cinzento.

Definir Prioridades e Estados de Tarefas

Se um comentário de tarefa tiver sido atribuído a um utilizador, a sua prioridade e estado podem ser definidos. Uma tarefa é inicialmente definida de imediato com prioridade Medium e estado To Do, mas estes podem ser alterados clicando num controlo associado na parte superior da caixa de diálogo do comentário.

Etiqueta de Commit, ID de Revisão de Release e Informação de Revisão de Design 

As etiquetas de commit e os IDs de revisão de release são apresentados ao visualizar os comentários/tarefas aplicáveis, tanto no painel Comments and Tasks como na caixa de diálogo de comentários no Altium Designer.

• Os comentários criados no Web Viewer ao visualizar o instantâneo de design de um commit com etiqueta incluirão o nome da etiqueta associada. Clique na ligação do nome da etiqueta para abrir o instantâneo do commit relacionado no Web Viewer.

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

• Os comentários criados no Web Viewer ao visualizar um instantâneo de Design Review incluirão a entrada de revisão de design. Clique na ligação da revisão de design para abrir a página da revisão.

Trabalhar com Tarefas Jira

Se a Integração Jira estiver ativada e configurada para o seu Altium 365 Workspace, então um comentário colocado incluirá a opção adicional de colocar e ligar a um issue do Jira no seu serviço Atlassian Jira®. Tal como os comentários convencionais e as respetivas tarefas associadas, os issues Jira colocados podem ser visualizados, editados e comentados a partir dos documentos de design, e visualizados/selecionados através do painel Comments and Tasks.

Uma instância de tarefa Jira colocada é sincronizada com o respetivo issue no espaço Jira. A sincronização bidirecional de dados entre os issues Jira e as tarefas do Workspace permite que a gestão do projeto de design seja realizada através do espaço Jira em conjunto com o Altium 365.

Criar um Issue Jira

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

❯ ❮ Javascript ID: CreateJiraIssue

Coloque uma tarefa Jira no documento atual do projeto começando por colocar uma instância de comentário. O modo Jira alternativo está disponível no menu pendente Comment. Invoque a colocação da tarefa Jira selecionando a opção Jira Issue no menu Comment da caixa de diálogo. Clique na opção Create Issue se ainda não estiver selecionada. Selecione o tipo de issue a criar na lista pendente Issue Type, que inclui os disponíveis no seu serviço Jira. Introduza um Summary do issue e, opcionalmente, descrição/responsável. A lista pendente Assignee incluirá apenas os utilizadores que sejam membros registados da sua conta Jira. Selecione Post para confirmar. O issue Jira é colocado na posição inicial do comentário do documento, é incluído no painel Comments and Tasks, fornece uma ligação para o issue no espaço Jira e inclui acesso interativo às definições da sua prioridade de tarefa (Medium, High, etc.) e do seu estado (To Do, In Progress, etc.).

Selecione o Task ID do issue Jira do Workspace na caixa de diálogo do comentário ou no painel Comments and Tasks para abrir diretamente esse issue no espaço Jira num novo separador do seu navegador predefinido. O Task ID do Workspace corresponde ao Issue Key no espaço Jira, e os principais parâmetros do Jira, como Summary, Description, Assignee e Comments, são mapeados entre as duas instâncias. O utilizador do Workspace que criou o Issue Jira é o Issue Reporter no lado do Jira. Tenha em atenção que uma imagem instantânea do documento atual do Workspace é incluída como anexo no Jira se a opção Attach original snapshot tiver sido selecionada ao criar o Issue Jira do Workspace (ver acima).

Uma tarefa Jira colocada no Workspace irá criar um item sincronizado no Jira, no respetivo espaço. Ambos ficam ligados pelo mapeamento do Workspace Task ID com o Jira Issue Key.

Juntamente com os parâmetros mapeados entre os itens do Workspace e do Jira, as definições de estado relacionadas com a tarefa Priority e Progress também são sincronizadas. Por exemplo, mover a tarefa do item do Workspace de um estado de prioridade Medium para High será imediatamente refletido no item do lado do Jira, e alterar o estado de progresso de To Do para In Progress do lado do Jira irá, de forma semelhante, alterar o estado do item Jira do Workspace. Pode ser necessária uma atualização dos dados (executada ao clicar no botão  no topo do painel Comments and Tasks) para ver os dados atualizados.

Ligar a um item Jira

A Integração Jira do Altium 365 também permite que uma Tarefa do Workspace seja ligada a um item Jira existente no seu serviço Atlassian Jira através do modo Jira Issue da caixa de diálogo de comentários. Pode ligar a qualquer item no projeto Jira especificado, que será então sincronizado com a tarefa Jira do Workspace.

❯ ❮ Javascript ID: LinkJiraIssue

Coloque uma instância de comentário na área do documento ou no objeto que pretende associar a um item Jira existente e, em seguida, selecione o modo Jira Issue e a opção Link Issue na caixa de diálogo de comentários. Utilize a lista pendente Select or search issues para selecionar o item Jira (mostrado como um texto Summary) que será ligado à instância da tarefa Jira recentemente colocada. Comece a escrever no campo de texto para procurar o item Jira pretendido. A lista pendente Jira Issue da caixa de diálogo mostrará o item selecionado do espaço Jira. Se necessário, assinale a opção Attach original snapshot para transferir para o Jira uma imagem da vista atual do documento. Clique no botão Post para estabelecer a ligação entre a tarefa Jira do Workspace e o item Jira selecionado. A nova tarefa do item Jira é apresentada no painel Comments and Tasks e na caixa de diálogo de comentários, que incluirá quaisquer comentários existentes (ou adicionados) – selecione a opção Show all Replies da caixa de diálogo para ver a lista completa.

O item Jira ligado está agora sincronizado com a tarefa Jira do Workspace, o que inclui o Comments do item e fica definido para os estados Progress e Priority definidos pelo item Jira – In Progress e High neste exemplo. Note que as entradas Web links do item Jira irão agora indicar que uma tarefa Jira do Workspace do Altium 365 foi ligada (ou ligada novamente) a este item.

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

Painel To-Do

Embora o seu Workspace ligado disponibilize um conjunto abrangente de funcionalidades para comentários e atribuição de tarefas descritas acima, também pode aceder ao painel To-Do para acompanhar as suas tarefas. O painel To-Do lista todos os itens To-Do que estão atualmente definidos para o projeto ativo. Um item To-Do é utilizado como lembrete para uma tarefa que precisa de ser realizada mais tarde em relação a um documento.

O painel To-Do

To-Do Panel Content and Use

O painel To-Do pode listar dois tipos de itens 'to-do' para o projeto ativo:

• Um item To-Do ao nível do projeto.
• Um item To-Do ao nível do documento - adicionado a um documento baseado em texto dentro do projeto.

Para cada item To-Do, é apresentada a seguinte informação:

• Done - esta caixa de verificação permite assinalar o item quando a tarefa definida tiver sido concluída.
• Action Item - a tarefa efetiva que precisa de ser realizada.
• Priority - a importância da tarefa a realizar (Lowest, Low, Normal (predefinição), High, Highest).
• Document - uma referência ao documento de origem ao qual foi adicionado um item To-Do ao nível do documento.
• Owner - pode ser o nome da pessoa que introduz a tarefa ou que a irá efetivamente executar.
• Category - pode ser a área específica dentro do projeto em que a tarefa a realizar se enquadra (por exemplo, esquemáticos, regras de desenho, routing, restrições, etc.).

Adicionar itens To-Do ao nível do projeto

Os itens To-Do ao nível do projeto são adicionados a partir do próprio painel. Antes de adicionar quaisquer itens, certifique-se de que o documento ativo na janela do editor de desenho é um dos documentos de desenho do projeto para o qual pretende definir itens To-Do.

Para adicionar um novo item To-Do, clique com o botão direito dentro do painel e escolha a entrada Add Project To-Do Item no menu de contexto subsequente que aparece. A caixa de diálogo Edit To-Do Item será aberta.

Utilize esta caixa de diálogo para introduzir texto adequado para a tarefa que tem de ser realizada para o projeto. Utilize os campos disponíveis na caixa de diálogo para definir uma task's Priority, Owner, and Category. Depois de definir o item conforme necessário, clique em OK para adicionar o novo item ao painel.

Adicionar itens To-Do ao nível do documento

Os itens To-Do ao nível do documento são adicionados a um documento de origem baseado em texto (por exemplo, ficheiro VHDL, ficheiro de restrições, documento de código-fonte embebido, etc.). Antes de adicionar quaisquer itens, certifique-se de que o documento pretendido está ativo na janela do editor de desenho e de que esse documento pertence ao projeto cujos itens To-Do globais está atualmente a definir.

Para adicionar um novo item To-Do, coloque o cursor de texto na posição pretendida dentro do documento onde deseja colocar um item To-Do, clique com o botão direito e escolha a entrada Add To-Do Item no menu pop-up subsequente que aparece. A caixa de diálogo Edit To-Do Item é apresentada. Utilize esta caixa de diálogo para introduzir texto adequado relativo à tarefa que tem de ser realizada no documento. Utilize os campos disponíveis na caixa de diálogo para definir uma Priority, Owner e Category para a tarefa (por exemplo, verificação de formatação, revisão de código, etc.). Depois de definir o item To-Do conforme necessário, clique em OK para fechar a caixa de diálogo e regressar o foco ao documento atual. Surgirá uma entrada para o item To-Do no painel To-Do e também no ponto assinalado pela posição atual do cursor de texto. A entrada surgirá como um comentário (entre o(s) delimitador(es) de comentário definidos para esse tipo de documento), incluindo o texto efetivo do item e um identificador único, conforme mostrado na imagem abaixo.

Menu do botão direito

O menu do botão direito disponibiliza os seguintes comandos:

• Goto Source - este comando fica disponível quando o item selecionado no painel é um item To-Do ao nível do documento. Utilize este comando para abrir (caso ainda não esteja aberto) o documento de origem associado referido no campo Document do item e torná-lo o documento ativo na janela do editor de desenho. O cursor de texto será colocado no início do texto do item To-Do.
• Add Project To-Do Item - adiciona ao painel um item To-Do ao nível do projeto para o projeto ativo.
• Edit - edita o item To-Do selecionado. A caixa de diálogo Edit To-Do Item será apresentada, permitindo-lhe efetuar as alterações necessárias.
• Delete - elimina do painel o item To-Do selecionado.
• Show Completed Items - com esta opção ativada, apenas os itens To-Do que tenham sido marcados como concluídos (opção Done ativada) permanecerão visíveis no painel.
• Report - gera um relatório com todos os itens To-Do atualmente apresentados no painel. Depois de iniciar o comando, a caixa de diálogo Report Preview será aberta, na qual pode configurar, imprimir e exportar o relatório em vários formatos de ficheiro.

Notas

• Se tiver sido definido no painel um item To-Do ao nível do documento e o documento de origem correspondente for o documento ativo na janela do editor de desenho, o texto de toda a entrada To-Do no painel ficará a negrito.
• Fazer duplo clique numa entrada de item To-Do no painel abrirá a caixa de diálogo Edit To-Do Item, permitindo-lhe modificar a definição da tarefa.
• As entradas no painel podem ser ordenadas por qualquer coluna clicando no respetivo cabeçalho. Clique uma vez para ordenar por ordem ascendente; clique novamente para ordenar por ordem descendente.
• A filtragem direta permite-lhe saltar rapidamente para uma entrada de item To-Do escrevendo diretamente no painel. Pode filtrar com base em qualquer coluna de dados do painel. Utilize as teclas Right Arrow e Left Arrow para alternar entre colunas para filtragem, ou clique diretamente num campo dentro de uma coluna. Para utilizar esta funcionalidade de filtro, clique dentro de uma coluna de dados e escreva a primeira letra da entrada para a qual pretende saltar. A primeira entrada nessa coluna que começar pela letra que escrever ficará selecionada, e a letra será realçada para mostrar que a filtragem do conteúdo da coluna se baseia na letra introduzida.