Público: Todos os usuários
Planos: Business, Enterprise
Plataformas: navegador, desktop, mobile
Os Azure Cards permitem que você importe work items do Azure Boards (parte dos serviços do Azure DevOps, anteriormente VSTS, solução em nuvem) para seus boards da Miro. Eles podem ser essenciais para suas retrospectivas remotas, dimensionamento de histórias, priorização do backlog, mapeamento de histórias e outras atividades do time. Você também pode usá-los em Miro Kanban e em frameworks de mapeamento de histórias de usuário.
Os Azure Cards melhoram sua experiência na Miro ao integrar-se diretamente ao Azure Boards, permitindo gerenciar o fluxo de trabalho de forma fluida em diversas atividades do time.
Principais funcionalidades
A integração com Azure Cards oferece várias funcionalidades principais:
- Importar Azure Cards usando o seletor de itens de trabalho do Azure Boards no aplicativo. Isso inclui várias opções de classificação.
- Pesquisar itens de trabalho do Azure Boards no seletor do aplicativo.
- Alterações automatizadas e fáceis de ler na visualização do cartão ao aumentar e diminuir o zoom.
✏️ Garanta que seus Azure Cards estejam sempre atualizados por meio de verificações periódicas, que asseguram que os usuários recebam atualizações dos cartões mesmo se webhooks falharem.
Configurar a integração do Azure Cards
A configuração é necessária em dois níveis:
- O aplicativo deve ser adicionado no nível da organização para todos os times, ou no nível do time para times específicos.
- No nível pessoal, a integração deve ser conectada e autorizada por todos os usuários que importarem os Azure Cards.
Esse processo exige permissões administrativas específicas tanto na Miro quanto no Azure DevOps.
✏️ Para configurar com sucesso o Azure Cards na Miro, o admin do Azure e o admin da Miro devem ser a mesma conta.
Embora adicionar Azure Cards exija permissões de admin do time ou Admin da empresa na Miro e permissões do grupo Project Collection Admin no Azure Boards, essas permissões podem ser reduzidas (fazer downgrade) após a conclusão da conexão. No entanto, o admin não pode ser removido e deve manter o acesso ao projeto do Azure.
Como adicionar Azure Cards no nível da organização ou do time
Admins da empresa podem adicionar Azure Cards para todos os times, enquanto os admins do time podem adicioná‑lo para os times específicos que gerenciam. Esta etapa torna o app Azure Cards disponível para conexão.
✏️ Para conectar os Azure Cards no nível do time, você deve ser um admin do time.
- Navegue até as Configurações do seu perfil (clique no ícone de três traços do menu principal e escolha Configurações do perfil, ou, no painel, clique no seu avatar no canto superior direito e escolha Configurações).
- Clique em Aplicativos e então navegue até a guia Adicionar aplicativos no lado direito.
- Digite "Azure Cards" e selecione-o na lista suspensa. Clique em Adicionar.
- Na próxima caixa de diálogo, escolha Todos os times ou Em times específicos (escolha seu time, se necessário), e clique em Próximo passo.
- Na tela "Revisar e adicionar Azure Cards", clique em Adicionar. O aplicativo será adicionado para sua empresa ou time.
- Acesse a guia Gerenciar aplicativos, procure por Azure Cards e clique em Aprovar. O aplicativo será aprovado no nível da empresa ou do time.
- Em seguida, conecte sua organização do Azure à Miro. No painel Aplicativos, vá para Gerenciar aplicativos.
- Procure por "Azure Cards" na sua lista de aplicativos e clique em Configurações.
-
No painel de configurações do Azure Cards, adicione o URL da sua instância do Azure e clique em Conectar. Forneça suas credenciais de login do Microsoft Azure.
-
Na caixa de diálogo de autorização, clique em Aceitar para concluir a conexão do Azure à Miro.
Adicionar configurações personalizadas do Azure Cards a times específicos
Se precisar de configurações diferentes para times específicos em relação à configuração global de nível de empresa, os admins do time podem configurá-las na área do time Aplicativos e integrações.
- Na página de configurações do seu perfil, clique em Times.
- Clique no time ao qual você deseja aplicar configurações personalizadas.
- No painel do time, clique em Aplicativos e integrações.
- Encontre Azure Cards e clique nele.
- No painel Configurações do aplicativo, escolha Aplicar configurações personalizadas no menu suspenso à direita e conecte a conta do Azure para a qual deseja aplicar configurações personalizadas.
- Autorize a Miro no Azure DevOps com sua conta da Microsoft: clique em Conectar ao lado de "Conta da Microsoft" e efetue login na sua conta da Microsoft, permitindo que a Miro a utilize.
- Informe o URL da organização do Azure (que pode ser copiado do Azure DevOps) e clique em Conectar. A Miro aceitará tanto o URL personalizado da sua instância quanto o endereço geral https://dev.azure.com/ que termine com o nome da sua instância.
Adicionar configurações personalizadas do Azure Cards a times específicos
Conecte sua conta pessoal do Azure para usar os cartões do Azure
Após um admin da Miro instalar e aprovar o aplicativo, cada membro do time que desejar usar o Azure Cards deve autorizar pessoalmente a conexão com sua conta do Azure. Isso personaliza o seletor de cartões e permite importar todos os work items do Azure aos quais o usuário tem acesso.
Você encontra o ícone do Azure Cards na barra de Criação. Se o ícone não estiver lá, talvez seja necessário procurá-lo:
- Na barra de Criação, selecione Ferramentas, mídia e integrações (+).
O painel Ferramentas, mídia e integrações será aberto. - Na guia Ferramentas, pesquise e selecione Azure Cards.
Conecte sua conta:
- Clique no ícone do Azure Cards na barra de ferramentas. Uma janela pop-up solicitará que você Autorize.
- Clique no botão Autorizar e clique em Continuar. Você será levado para a página Configurações do time > Aplicativos e & integrações.
- Use o painel Configurações do aplicativo para conectar sua conta da Microsoft à Miro e especifique a instância do Azure que você gostaria de usar. Essa URL pode ser copiada do Azure DevOps; a Miro aceitará tanto a URL personalizada da sua instância quanto o endereço geral https://dev.azure.com/ terminando com o nome da sua instância.
✏️ Observe que somente admins do time podem definir a configuração inicial no nível do time ou da empresa. Se você não vir o botão Conectar para a URL da organização do Azure durante a configuração do admin, verifique se você tem direitos de admin do time neste time.
Importar itens de trabalho do Azure para um board da Miro
Depois que o app Azure Cards estiver configurado e você tiver conectado sua conta pessoal, você pode importar itens de trabalho do Azure para qualquer board da Miro associado ao time conectado. Existem duas maneiras principais de fazer isso:
- Copie a URL do item de trabalho do Azure e cole-a diretamente no board da Miro. O item se transformará automaticamente em um Azure Card.
-
Use o seletor do Azure Cards: Clique no ícone do Azure Cards na barra de ferramentas para abrir o seletor.
Seletor do Azure Cards
O seletor oferece pesquisa em todos os campos, permitindo encontrar um cartão pelo título, tipo, status, etc. Você também pode usar a robusta pesquisa por palavra-chave com tecnologia da Microsoft.
Pesquisar Azure Cards no seletor
Você pode filtrar cartões por projeto, responsável, tipo, área e status, o que desbloqueia a filtragem avançada de itens de trabalho do Azure diretamente na Miro.
Filtrar Azure Cards no seletor
Para acessar o work item original no Azure, selecione um cartão no board e clique no botão Source do menu de contexto.
Os Azure Cards podem ser usados como widgets autônomos no board ou como componentes de frameworks interativos Kanban e mapa da história (do usuário). Você pode adicionar Azure Cards a esses frameworks arrastando-os.
Criar e editar Azure Cards diretamente na Miro
A integração bidirecional entre a Miro e o Azure DevOps permite que os times criem novos itens de trabalho do Azure e editem os existentes diretamente de um board da Miro. Você também pode converter cartões da Miro e notas adesivas existentes em Azure Cards.
Criar um novo Azure Card
Para criar um novo item de trabalho do Azure a partir da Miro:
- Selecione Azure Cards na barra de ferramentas Criação e escolha Criar item de trabalho no canto superior direito do seletor.
- Preencha os campos do cartão, escolha um projeto, tipo de item, responsável e clique em Criar. O novo item será criado no seu diretório do Azure DevOps, assim como no seu board da Miro.
Converter cartões da Miro ou notas adesivas em Azure Cards
Para converter um cartão da Miro ou uma nota adesiva existente em um Azure Card:
- Selecione a nota adesiva ou o cartão no board.
- Clique na opção de conversão (geralmente um ícone do Azure DevOps ou Converter em item de trabalho do Azure) no menu de contexto do objeto.
- Defina os parâmetros do cartão (como projeto, tipo de item) na caixa de diálogo e clique em Converter. O texto da nota adesiva/cartão será convertido no título do cartão.
💡 Economize tempo convertendo em massa notas adesivas ou cartões da Miro em cartões do Azure. Clique e arraste para selecionar todos os objetos que deseja converter e, no menu de contexto, selecione Converter em itens de trabalho do Azure.
Editar um cartão do Azure
A opção de editar cartões do Azure na Miro evita o incômodo de alternar entre ferramentas. Para editar um cartão:
- Clique no Azure Card no seu board da Miro.
- Clique no ícone de caneta (editar) no menu de contexto do cartão. Uma janela pop-up será aberta, permitindo que você edite os campos do item.
- Clique em Atualizar para salvar as alterações. As alterações também serão refletidas no Azure DevOps.
Alterar a cor do Azure Card
Para personalizar a aparência dos seus Azure Cards no seu board da Miro:
Para alterar a cor de preenchimento de um cartão, clique no cartão ou cartões e escolha cor de preenchimento no menu de contexto. Se você duplicar o cartão ou cartões, todas as cópias subsequentes terão a mesma cor de preenchimento.
Desinstalar a integração Azure Cards
Se você não precisar mais da integração Azure Cards, pode desinstalá-la. Desinstalar no nível do time requer permissões de admin do time.
- Vá para Configurações do time > Apps e integrações > Azure Cards.
- Selecione Desinstalar para o time.
Campos do Azure Card suportados
Os seguintes campos são suportados para os Azure Cards na Miro:
- Título
- Projeto
- Tipo
- Status
- Descrição (sem suporte a edição)
- Item de trabalho pai
- Responsável
- Prioridade
- Story points
- Área
- Iteração
- Critérios de aceitação
Sem suporte a campos personalizados.
Solução de problemas do Azure Cards
Se encontrar problemas com a integração do Azure Cards, consulte os problemas e soluções mais comuns abaixo.
O URL inserido não existe. Informe o URL existente ou verifique a ortografia. Verifique também o seguinte:
- Certifique-se de que sua organização pode aceitar autorizações de terceiros: em Configurações da organização > Políticas (Segurança) > verifique se Third-party application access via OAuth está ativado.
- Sua organização do Azure está em uma rede privada ou o firewall da sua empresa bloqueia conexões externas. Faça as alterações necessárias nas configurações do seu firewall e VPN, adicionando nossos domínios à sua lista de permissões: miro.com*, *.miro.com, mirostatic.com*, *.mirostatic.com, realtimeboard.com*, *.realtimeboard.com, *static.miro-apps.com. Se usar um proxy, configure um proxy reverso que nos permita acesso. Certifique-se de preencher o campo URL do Azure DevOps nas configurações com o endereço que podemos acessar (o endereço pode ser diferente do endereço real do seu Azure DevOps restrito). Você também pode prolongar o valor do tempo limite no seu servidor proxy.
- Todas as solicitações de integração passam por um balanceador de carga da Amazon, portanto, não é possível fornecer informações de rede específicas pela Miro.
O usuário do Azure conectado no momento não tem as permissões necessárias. O usuário do Azure em cujo nome a instância do Azure será conectada à Miro deve ter acesso a estes métodos da REST API:
- Criar assinatura de gancho de serviço ("vso.serviceendpoint_manage" escopo necessário)
- Receber metadados sobre projetos (essas informações são usadas para especificar corretamente os work items nos eventos de assinatura)
- Os métodos a seguir também precisam ser acessíveis a todos os usuários que utilizam a integração:
Verifique se você tem permissões de admin do time. Vá para a guia Usuários ativos nas configurações do seu time e torne-se admin do time, se necessário. Isso vale para a configuração inicial da conexão da organização do Azure por um admin.
✏️ Se tiver outros problemas, entre em contato com o Suporte da Miro.
Perguntas frequentes sobre Azure Cards
A seguir, respostas para algumas perguntas comuns sobre a integração do Azure Cards.
Para que a integração Azure Cards funcione corretamente, especialmente em ambientes de rede restritos, pode ser necessário permitir os seguintes endereços IP:
18.203.61.162 54.220.74.201 54.216.81.236 54.73.153.141 52.215.228.26 52.16.47.17 54.217.180.21