Adicionar e gerenciar faixas de informações no Azure Devops

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

Use faixas de informações para se comunicar de forma rápida e eficaz com os usuários do Azure DevOps. Alerte os usuários sobre alterações ou eventos futuros sem enviar e-mails em massa.

Especifique um dos três tipos de faixas: erro, informação ou aviso. Somente o último banner adicionado ou atualizado é exibido por vez. Os banners permanecem em vigor até a data de expiração.

A imagem a seguir mostra uma mensagem informativa. Os usuários podem cancelar a mensagem selecionando Fechar .

Limitamos os banners a 30 palavras, priorizamos por nível. Portanto, se você postar uma mensagem de aviso e uma mensagem informativa, a mensagem informativa só será exibida depois que o usuário fechar ou excluir a mensagem de aviso.

Pré-requisitos

• Permissões: seja membro do grupo Administradores de Coleção de Projetos .
• Níveis de acesso:
  • Instale a extensão do marketplace Configurações de Banner. Para obter mais informações, confira Instalar extensões.
  • Instale a extensão da CLI do Azure DevOps.
    • Entre no Azure DevOps usando az login.
    • Para os exemplos neste artigo, defina a organização padrão usando az devops configure --defaults organization=YourOrganizationURL.

Gerenciar banners usando a extensão Configurações de banner

A extensão Configurações de Banner fornece um painel de configurações em Configurações da organização para adicionar e gerenciar banners em todo o site. A extensão suporta os seguintes recursos:

• Mostrar faixas em qualquer página no Azure DevOps
• Escolha entre três níveis de mensagens: Informações, Aviso e Erro
• Escolher uma data de expiração para uma mensagem
• Incluir hiperlinks em banners usando a sintaxe markdown

Abrir Configurações da organização

Para adicionar ou excluir um banner, abra as configurações da organização, role para baixo até a seção Extensões e escolha Banner.

As configurações da organização definem recursos para todos os projetos, respectivamente, para toda a organização. Para obter uma visão geral de todas as configurações da organização, consulte Função de administrador de coleção de projetos e gerenciamento de coleções de projetos.

1. Escolha o logotipo do Azure DevOps para abrir Projetos e escolha Configurações da organização.

   

Adicionar e gerenciar banners

Portal da Web

1. Se nenhum banner for definido, selecione Criar um novo banner. Caso contrário, selecione Editar mais para o banner e vá para a etapa 3.

   

2. Insira o texto do banner na caixa de texto. Selecione Editar mais para alterar o nível da mensagem e definir a data de expiração.

   

3. Salve suas alterações.

4. (Opcional) Exclua todos os banners ou selecione o ícone da lixeira para excluir um banner específico.

CLI do Azure

Comandos de faixa de administrador da CLI do Azure

Comando	Descrição
az devops admin banner add	Adicione um novo banner e mostre-o imediatamente.
az devops admin banner list	Listar banners.
az devops admin banner remove	Remova um banner.
az devops admin banner show	Mostrar detalhes de um banner.
az devops admin banner update	Atualize a mensagem, o nível ou a data de expiração de um banner.

Os parâmetros a seguir são opcionais para todos os comandos e não estão listados nos exemplos fornecidos neste artigo.

• detect: detectar a organização automaticamente. Valores aceitos: false, true. O padrão é verdadeiro.
• org: URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio de git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Adicionar um banner

Para adicionar um banner, digite o az devops admin banner add comando.

az devops admin banner add --message
                           [--expiration]
                           [--id]
                           [--type {error, info, warning}]

Parâmetros

• message: Obrigatório. Cadeia de caracteres de texto que especifica a mensagem de banner a ser exibida. As strings de texto são limitadas a um máximo de 30 palavras.

  A mensagem pode conter links no formato HTML (<a href='https://example.org'>Link text</a>). Qualquer e comercial na url, por exemplo, na cadeia de caracteres de consulta, deve ser escapado no formato de entidade xml (&).

• expiração: opcional. Data/hora em que o banner não deve mais ser exibido para os usuários. Por exemplo, "2019-06-10 17:21:00 UTC", "2019-06-10".

• ID: Opcional. ID do banner a ser atualizado. Esse identificador é necessário para alterar ou remover a mensagem posteriormente. Um identificador exclusivo é criado automaticamente se um não for especificado.

• tipo: Opcional. Tipo de banner a ser exibido. Valores válidos: error, info, warning. O padrão é info.

Exemplo

Por exemplo, o comando a seguir adiciona um banner de informações, que expira em 4 de setembro de 2019. Quando uma ID não é especificada, uma ID exclusiva é atribuída automaticamente.

az devops admin banner add --message "INFORMATION: Network domain updates will occur on September 3. <a href='https://example.org?page=network-updates&amp;anchor=september-3-2019'>More information</a>" --expiration  2019-09-04 --type  info
{
  "3d584103-6a94-4f46-8696-f424278da072": {
    "expirationDate": "2019-09-04T00:00:00-07:00",
    "level": "info",
    "message": "INFORMATION: Network domain updates will occur on September 3"
  }
}

Listar banners

Para determinar quais banners são definidos, insira o az devops admin banner list comando.

az devops admin banner list 

Exemplo: saída json padrão

Se você não especificar a saída, a lista será exibida no formato json. Para outras opções de formato de saída, consulte Formatos de saída para comandos da CLI do Azure.

Por exemplo, o comando a seguir indica que dois banners estão definidos.

az devops admin banner list
{
  "04c4d27f-1fee-4f23-9c44-57ed6a9efef8": {
    "level": "info",
    "message": "BANNER-MESSAGE-BANNER-MESSAGE"
  },
  "27f016aa-be13-4e3b-a1da-8b98d239e074": {
    "level": "warning",
    "message": "WARNING - This is a test warning message."
  }
}

Exemplo: saída de tabela

Para listar os banners em formato de tabela, use a opção de --output table comando.

az devops admin banner list 
ID                                    Message                            Type     Expiration Date
------------------------------------  ---------------------------------  -------  -----------------
04c4d27f-1fee-4f23-9c44-57ed6a9efef8  BANNER-MESSAGE-BANNER-MESSAGE      Info
27f016aa-be13-4e3b-a1da-8b98d239e074  WARNING - This is a test warning message. 

Remover um banner

Para excluir um banner, use o az devops admin banner remove comando. Especifique o ID do banner, que você pode encontrar listando os banners.

az devops admin banner remove --id

Parâmetros

• ID: Obrigatório. ID do banner a ser removido.

Exemplo

Por exemplo, o comando a seguir remove o banner com id=e090e7b0-4499-4b8f-a09b-1eddf7fdeb44. Nenhuma resposta é retornada.

az devops admin banner remove --id e090e7b0-4499-4b8f-a09b-1eddf7fdeb44

Detalhes do banner da lista

Para listar informações sobre um único banner, use o az devops admin banner show comando. Especifique o ID do banner, que você pode encontrar listando os banners.

az devops admin banner show --id

Parâmetros

• ID: Obrigatório. ID do banner para listar detalhes.

Exemplo

Aqui listamos os detalhes do banner com id=7653f414-3c01-424f-8f84-e51aa99b797c.

az devops admin banner show --id 7653f414-3c01-424f-8f84-e51aa99b797c
{
  "7653f414-3c01-424f-8f84-e51aa99b797c": {
    "expirationDate": "2024-09-04T07:00:00+00:00",
    "level": "info",
    "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
  }
}

Atualizar um banner

Você pode alterar a mensagem, o tipo e a expiração de um banner usando o az devops admin banner update comando.

az devops admin banner update --id
                              [--expiration]
                              [--message]
                              [--type {error, info, warning}]

Parâmetros

• ID: Obrigatório. ID do banner a ser atualizado.
• expiração: opcional. Data/hora em que o banner não deve mais ser exibido para os usuários. Para desconfigurar a expiração do banner, forneça um valor vazio para esse argumento, por exemplo, "2019-06-10 17:21:00 UTC", "2019-06-10".
• message: String de texto que especifica a mensagem de banner a ser exibida.
• tipo: Opcional. Tipo de banner a ser exibido. Valores válidos: error, info, warning. O padrão é info.

Exemplo

Por exemplo, o comando a seguir atualiza a cadeia de caracteres de mensagem para o banner e atualiza a data de expiração para o final do ano.

az devops admin banner update --id 7653f414-3c01-424f-8f84-e51aa99b797c --message "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum.." --expiration  2019-12-31
{
  "7653f414-3c01-424f-8f84-e51aa99b797c": {
    "expirationDate": "2019-12-31T00:00:00-08:00",
    "level": "info",
    "message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.."
  }
}

Artigos relacionados

• Introdução ao gerenciamento de sua organização ou coleção de projetos
• Saiba mais sobre projetos e como dimensionar sua organização
• Introdução à CLI do Azure DevOps
• Usar comandos az devops admin banner