Pessoas: Todos os usuários
Planos: Business e Enterprise
Plataformas: navegador, desktop, dispositivo móvel
Os Azure Cards permitem que você importe itens de trabalho do Azure Boards (uma parte dos serviços Azure DevOps, anteriormente VSTS – solução em nuvem) para seus boards da Miro. Eles podem se tornar essenciais para suas retrospectivas remotas, dimensionamento de histórias, priorização de backlog, mapeamento de histórias e outras atividades do time. Você também pode usá-los em frameworks de Miro Kanban e mapeamento de histórias de usuário.
Os Azure Cards aprimoram sua experiência na Miro integrando-se diretamente com os Azure Boards, permitindo um gerenciamento de fluxo de trabalho contínuo para diversas atividades do time.
Principais funcionalidades
A integração dos cartões do Azure oferece várias funcionalidades principais:
- Importe Azure Cards usando o seletor de itens de trabalho do Azure boards no aplicativo. Isso inclui várias opções de classificação.
- Pesquisa de itens de trabalho do Azure boards no seletor no aplicativo.
- Alterações automatizadas e fáceis de ler na visualização do cartão ao aumentar e diminuir o zoom.
✏️ Garanta que seus cartões Azure estejam sempre atualizados com a votação de cartões, o que assegura que os usuários sempre recebam atualizações de cartão, 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 organizacional para todos os times ou no nível de time para times específicos.
- Após a adição do aplicativo, a integração deve ser conectada e autorizada no nível pessoal para importar os Azure Cards.
Este processo requer permissões administrativas específicas tanto na Miro quanto no Azure DevOps.
✏️ Para configurar com sucesso os Azure Cards com a Miro, o admin do Azure e o admin da Miro devem ser a mesma conta.
Embora adicionar Azure Cards exija permissões de Admin da empresa ou do time na Miro e permissões de grupo de Admin da Coleção de Projetos no Azure Boards, essas permissões podem ser feitas 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.
Adicionar Azure Cards para sua organização ou time
Admins da empresa da Miro podem adicionar cartões Azure para todos os times, enquanto admins do time podem adicioná-los para times específicos que gerenciam. Esta etapa torna o aplicativo 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, em seguida, 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), então clique em Próximo passo.
- Na tela "Revisar e adicionar Azure Cards", clique em Adicionar. O aplicativo será adicionado para sua empresa ou time.
-
Vá para a guia Gerenciar aplicativos, procure por Azure Cards e clique em Aprovar. O aplicativo agora 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.
Aplicar configurações personalizadas dos cartões Azure para times específicos
Se você precisar de configurações diferentes para times específicos do que a configuração global em nível de empresa, Admins do time podem configurar isso na área Aplicativos e integrações do Time.
- 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 Times, 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 você deseja ter 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.
-
Insira o URL da sua organização do Azure (que pode ser copiado do Azure DevOps) e clique em Conectar. 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.
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 deseja usar o Azure Cards deve autorizar pessoalmente a conexão à sua conta do Azure. Isso personaliza o seletor de cartões e permite a importação de todos os itens de trabalho do Azure que o usuário pode acessar.
Você pode encontrar o ícone do Azure Cards na barra de ferramentas de criação. Se o ícone não estiver lá, pode ser necessário procurá-lo:
- Na barra de Criação, selecione Ferramentas, mídia e integrações (+).
O painel Ferramentas, mídia e integrações abre. - Na guia Ferramentas, pesquise e selecione Azure Cards.
Para conectar sua conta:
- Clique no ícone do Azure Cards na barra de ferramentas. Um 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. Esta URL pode ser copiada do Azure DevOps; a Miro aceita tanto a URL personalizada da sua instância quanto o endereço geral https://dev.azure.com/ terminado com o nome da sua instância.
✏️ Observe que somente admins do time podem configurar a configuração inicial 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, certifique-se de ter os direitos de admin do time para o time.
Importar itens de trabalho do Azure para um board da Miro
Depois que o aplicativo Azure Cards estiver configurado e você tiver conectado sua conta pessoal, você poderá importar itens de trabalho do Azure para qualquer board do Miro associado ao time conectado. Há duas maneiras principais de fazer isso:
- Copie o URL do item de trabalho do Azure e cole-o diretamente no board da Miro. O item será automaticamente transformado em um cartão do Azure.
-
Use o seletor de Cartão do Azure: Clique no ícone do Azure Cards na barra de ferramentas para abrir o seletor.
Seletor de cartões do Azure
O seletor oferece suporte à pesquisa em todos os campos, permitindo que você encontre um cartão pelo seu título, tipo, status, etc. Você também pode usar uma robusta pesquisa por palavra-chave fornecida pela 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 navegar até o item de trabalho original do Azure, selecione um cartão no board e clique no botão Fonte no menu de contexto.
O botão de origem do cartão
Os cartões Azure podem ser usados como widgets de board autônomos ou como componentes de frameworks interativos de Kanban e Mapa de história do usuário. Você pode adicionar Azure Cards a esses frameworks arrastando-os.
Como trabalhar com Azure Cards no Kanban
Crie e edite cartões do Azure 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 e notas adesivas da Miro em cartões do Azure.
Criar um novo cartão do Azure
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 e também no seu board da Miro.
Criando um cartão do Azure na Miro
Converter cartões ou notas adesivas da Miro em cartões do Azure
Para converter um cartão ou nota adesiva existente da Miro em um cartão do Azure:
- Selecione a nota adesiva ou 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 na nota adesiva/cartão será convertido em 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.
Como converter uma nota adesiva em um cartão do Azure
Editar um Cartão do Azure
A opção de editar Azure Cards na Miro elimina o incômodo de alternar entre ferramentas. Para editar um cartão:
- Clique no cartão Azure 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 mudanças também serão refletidas no Azure DevOps.
A opção de editar um cartão do Azure na Miro
Alterar a cor do Cartão do Azure
Para personalizar a aparência dos seus Azure Cards no board:
Para alterar a cor de preenchimento de um cartão, clique no cartão ou cartões e escolha cor de preenchimento do 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 do Azure Cards
Se você não precisa mais da integração dos cartões do Azure, pode desinstalá-la. Desinstalar no nível do time requer permissões de admin do time.
- Acesse Configurações do time > Aplicativos e integrações > Azure Cards.
- Role para baixo e clique em Desinstalar para o time.
- Para desinstalar o Azure Cards apenas para a sua conta pessoal, clique em Desinstalar para mim.
Desinstale o aplicativo para todo o time ou apenas para você
Campos compatíveis do cartão do Azure
Os seguintes campos são compatíveis para 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 de cartões Azure
Se você encontrar problemas com a integração dos cartões Azure, consulte os problemas comuns e suas soluções abaixo.
O URL inserido não existe. Informe a URL existente ou verifique a ortografia. Além disso, verifique o seguinte:
- Certifique-se de que sua organização pode aceitar autorização de terceiros: em Configurações da organização > Políticas (Segurança) > certifique-se de que "Acesso a aplicativos de terceiros via OAuth" esteja habilitado.
- Sua organização do Azure está em uma rede privada ou o firewall da sua empresa bloqueia conexões a redes externas. Faça as alterações necessárias na configuração 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 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 service hook (requer escopo "vso.serviceendpoint_manage")
- Receber metadados sobre projetos (essas informações são usadas para especificar itens de trabalho em eventos de assinatura corretamente)
- Os métodos a seguir também precisam ser acessíveis a todos os usuários que utilizam a integração:
Certifique-se de ter direitos de admin do time. Vá para a guia Usuários ativos nas configurações do seu time e promova-se a admin do time, se necessário. Isso se aplica à configuração inicial da conexão da Organização do Azure por um admin.
✏️ Se você tiver outros problemas, entre em contato com o Suporte da Miro.
Perguntas frequentes sobre os cartões Azure
Aqui estão respostas para algumas perguntas comuns sobre a integração dos cartões Azure.
Para que a integração dos cartões Azure funcione corretamente, especialmente em ambientes de rede restritos, pode ser necessário adicionar à lista de permissões 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