Adicionar Markdown a um dashboard

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Use o widget Markdown para apoiar sua equipe e as partes interessadas adicionando informações como:

  • Golos da equipa.
  • Ligações para:
    • Listas de pendências ou quadros de equipas.
    • Métricas.
    • Outros itens localizados em um compartilhamento de rede, como um OneNote, site do SharePoint ou páginas wiki.
  • Datas importantes ou prazos-alvo.

Eis um exemplo:
Captura de ecrã de um widget Exemplo de Markdown.

Pré-requisitos

  • Acesso:
  • Permissões:
    • Painéis de equipe: para adicionar, editar ou gerenciar um painel de equipe, atenda aos seguintes requisitos:
      • Seja um membro da equipa.
      • Seja membro do grupo Administradores de Projeto.
  • Acesso:
    • Qualquer pessoa com acesso a um projeto, incluindo partes interessadas, pode visualizar painéis.
    • Seja membro do projeto e tenha acesso Básico, tenha permissões específicas de painel concedidas a você para o painel selecionado, seja membro do grupo Administradores de Projeto ou seja atribuído à função de administrador da equipe.
  • Ferramentas:
    • Instale ou habilite a extensão do Analytics Marketplace. Os widgets do Google Analytics não estarão disponíveis se o Google Analytics não estiver instalado, habilitado ou em execução.
    • Ative o Google Analytics para que os widgets do Google Analytics funcionem com seu painel.

Nota

Os dados exibidos em um gráfico ou widget estão sujeitos às permissões concedidas ao usuário conectado. Por exemplo, se um usuário não tiver permissões para exibir itens de trabalho em um caminho de área específico, esses itens não serão exibidos em um widget de resultados de consulta no painel. Para obter mais informações, consulte Perguntas frequentes sobre o uso de painéis.

Sintaxe Markdown suportada

O widget Markdown suporta recursos padrão do CommonMark, como:

  • Títulos
  • Parágrafos e quebras de linha
  • Trechos em bloco
  • Régua horizontal
  • Ênfase (negrito, itálico, rasurado)
  • Tabelas
  • Listas, ordenadas e não ordenadas
  • Ligações
  • Imagens
  • Personagens em fuga

Para obter detalhes sobre o uso, consulte Orientações de sintaxe para uso básico de Markdown.

Por razões de desempenho, o widget Markdown não adiciona suporte para muitos recursos estendidos, muitos dos quais são suportados no wiki. Recursos estendidos impediriam o tempo de carregamento do widget. Por exemplo, os seguintes recursos estendidos de Markdown não são suportados no widget Markdown:

  • Sintaxe HTML incorporada
  • Realce de código (wiki/outros suportam codificação de cores com reconhecimento de sintaxe de linguagem, o CommonMark apenas renderiza o código como texto pré-formatado simples)
  • Listas de verificação
  • Personagens Emoji
  • Anexos
  • Fórmulas matemáticas

Conecte-se ao seu projeto

Para adicionar o widget Markdown a um painel, conecte-se ao seu projeto usando um navegador da Web compatível.

Abra um navegador da Web, conecte-se ao seu projeto e selecione Painéis de visão geral>.

Captura de ecrã do portal Web, abra Dashboards.

Se você precisar alternar para um projeto diferente, selecione o logotipo do Azure DevOps para procurar todos os projetos.

Adicionar o widget Markdown

Se você precisar adicionar um painel, consulte Adicionar, renomear e excluir painéis.

Para adicionar o widget Markdown ao painel, selecione Editar. O catálogo de widgets será aberto automaticamente.

  1. Adicione ou arraste o widget Markdown para o painel onde você deseja que ele esteja localizado.

    Captura de tela do widget Markdown.

  2. Selecione Edição concluída para sair da edição do painel. Isso descartará o catálogo de widgets. Em seguida, você pode configurar o widget Markdown conforme necessário.

  3. Selecione o ícone de ícone de engrenagem engrenagem para abrir a caixa de diálogo de configuração do widget.

    Para editar um widget Markdown, talvez seja necessário ser um administrador de equipe, um membro do grupo Administradores de Projeto ou receber permissões. Para obter mais informações, consulte Definir permissões do painel.

  4. Ajuste o tamanho do widget conforme necessário para ajustar o conteúdo do Markdown que você inserirá. O tamanho maior é de 10 telhas de largura por 10 telhas de altura. Você sempre pode ajustar isso mais tarde.

    Captura de tela da caixa de diálogo de configuração do widget Markdown, altere o tamanho.

  5. Insira o texto e a sintaxe Markdown na caixa de diálogo de configuração da configuração. Para obter a sintaxe suportada, consulte Orientação de sintaxe para arquivos Markdown, widgets, wikis e comentários de solicitação pull.

    Aqui mostramos um texto simples com uma lista com marcadores de quatro links

    Captura de tela para Configurar markdown, entrada de texto.

    Gorjeta

    Para criar um link para uma página wiki, use a seguinte sintaxe:
    /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

    Para criar um link para um arquivo, página ou imagem de repositório dentro do projeto, clique no arquivo e use a URL completa.

    Isso renderiza o seguinte widget:

    Captura de tela do portal da Web, widget Markdown de exemplo.

    Nota

    Não há suporte para links para documentos em compartilhamentos de file:// arquivos. Esta restrição foi implementada por motivos de segurança.

  6. Opcionalmente, você pode optar por apontar para um arquivo em seu repositório.

    Captura de tela do widget Configurar Markdown com um arquivo de repositório.