Karty Azure – Centrum pomocy Miro

Osoby: Wszyscy użytkownicy
Plany: Business, Enterprise
Platformy: Przeglądarka, aplikacja desktopowa, aplikacja mobilna

Azure Cards pozwalają importować work items z Azure Boards (w ramach usługi Azure DevOps, dawniej VSTS - rozwiązanie w chmurze) na Twoje tablice Miro. Mogą być niezbędne podczas zdalnych retrospektyw, szacowania zadań, priorytetyzacji backlogu, mapowania historii użytkownika oraz innych aktywności zespołu. Możesz też używać ich w kanbanie Miro oraz w ramach mapowania historii użytkownika.

Azure Cards ulepszają doświadczenie w Miro, integrując się bezpośrednio z Azure Boards i umożliwiając płynne zarządzanie przepływem pracy podczas różnych aktywności zespołu.

Najważniejsze funkcje

Integracja Azure Cards oferuje kilka kluczowych funkcji:

Importuj Azure Cards za pomocą wbudowanego narzędzia wyboru elementów pracy Azure Boards. Obejmuje ono różne opcje sortowania.
Wyszukuj elementy pracy Azure Boards w wbudowanym narzędziu wyboru.
Automatyczne, czytelne zmiany wyświetlania kart podczas przybliżania i oddalania.

✏️ Zapewnij, że Azure Cards są zawsze aktualne dzięki odpytywaniu kart, które gwarantuje, że użytkownicy zawsze otrzymują aktualizacje kart nawet jeśli webhooki zawiodą.

Konfiguracja integracji Azure Cards

Konfiguracja jest wymagana na dwóch poziomach:

Aplikacja musi zostać dodana na poziomie organizacji (dla wszystkich zespołów) lub na poziomie zespołu (dla wybranych zespołów).
Po dodaniu aplikacji integrację trzeba połączyć i autoryzować na koncie osobistym, aby importować Azure Cards.

Ten proces wymaga określonych uprawnień administracyjnych zarówno w Miro, jak i w Azure DevOps.

✏️ Aby prawidłowo skonfigurować Azure Cards w Miro, administrator Azure i administrator Miro muszą używać tego samego konta.

Aby dodać Azure Cards, wymagane są uprawnienia administratora zespołu lub administratora firmy w Miro oraz uprawnienia grupy Project Collection Admin w Azure Boards. Te uprawnienia można obniżyć po zakończeniu połączenia. Administratora nie można jednak usunąć — musi on zachować dostęp do projektu w Azure.

Dodaj Azure Cards dla organizacji lub zespołu

Administratorzy firmy Miro mogą dodać aplikację Azure Cards dla wszystkich zespołów, natomiast administratorzy zespołu mogą dodać ją dla konkretnych zespołów, którymi zarządzają. Ten krok udostępnia aplikację Azure Cards do połączenia.

✏️ Aby połączyć Azure Cards na poziomie zespołu, musisz być administratorem zespołu.

Przejdź do Ustawień profilu (kliknij ikonę menu i wybierz Ustawienia profilu, albo z pulpitu kliknij swój awatar w prawym górnym rogu i wybierz Ustawienia).
Kliknij Aplikacje i przejdź do karty Dodaj aplikacje po prawej stronie.
Wpisz "Azure Cards" i wybierz ją z listy rozwijanej. Kliknij Dodaj.
W następnym oknie dialogowym wybierz Wszystkie zespoły lub W określonych zespołach (w razie potrzeby wybierz swój zespół), a następnie kliknij Następny krok.
Na ekranie "Przejrzyj i dodaj Azure Cards" kliknij Dodaj. Aplikacja zostanie dodana dla Twojej firmy lub zespołu.
Przejdź do karty Zarządzaj aplikacjami, wyszukaj Azure Cards i kliknij Zatwierdź. Aplikacja zostanie teraz zatwierdzona na poziomie firmy lub zespołu.
Następnie połącz swoją organizację w Azure z Miro. W panelu Aplikacje przejdź do Zarządzaj aplikacjami.
Wyszukaj „Azure Cards” na liście aplikacji i kliknij Ustawienia.
W panelu ustawień Azure Cards dodaj adres URL swojej instancji Azure i kliknij Połącz. Podaj swoje dane dostępowe do Microsoft Azure.
W oknie dialogowym autoryzacji kliknij Akceptuj, aby zakończyć łączenie Azure z Miro.

Zastosuj niestandardowe ustawienia Azure Cards dla konkretnych zespołów

Jeśli potrzebujesz innych ustawień dla konkretnych zespołów niż globalna konfiguracja na poziomie firmy, administratorzy zespołów mogą skonfigurować je w obszarze zespołu Apps & Integrations.

Na stronie ustawień profilu kliknij Teams.
Kliknij zespół, dla którego chcesz zastosować niestandardowe ustawienia.
W panelu zespołu kliknij Apps & Integrations.
Znajdź Azure Cards i kliknij.
W panelu ustawień aplikacji wybierz Zastosuj niestandardowe ustawienia z listy rozwijanej po prawej, a następnie połącz konto Azure, dla którego chcesz zastosować niestandardowe ustawienia.
Autoryzuj Miro w Azure DevOps za pomocą swojego konta Microsoft: kliknij Połącz obok „konto Microsoft” i zaloguj się na swoje konto Microsoft, pozwalając Miro na jego użycie.
Wprowadź swój adres URL organizacji Azure (możesz go skopiować z Azure DevOps) i kliknij Połącz. Miro zaakceptuje zarówno spersonalizowany adres URL Twojej instancji, jak i ogólny https://dev.azure.com/ kończący się nazwą Twojej instancji.

Dodawanie niestandardowych ustawień Azure Cards do konkretnych zespołów

Połącz swoje osobiste konto Azure, aby korzystać z Azure Cards

Po zainstalowaniu i zatwierdzeniu aplikacji przez administratora Miro każdy członek zespołu, który chce korzystać z Azure Cards, musi osobiście autoryzować połączenie ze swoim kontem Azure. Spowoduje to spersonalizowanie wybieraka kart i umożliwi import wszystkich elementów pracy Azure, do których masz dostęp.

Ikonę Azure Cards znajdziesz na pasku tworzenia. Jeśli jej tam nie ma, może być konieczne jej wyszukanie:

W pasku tworzenia wybierz Narzędzia, Multimedia i Integracje (+).
Otworzy się panel Narzędzia, Multimedia i Integracje.
Na karcie Narzędzia wyszukaj i wybierz Azure Cards.

Aby połączyć swoje konto:

Kliknij ikonę Azure Cards na pasku narzędzi. Pojawi się okienko z prośbą o Autoryzację.
Kliknij przycisk Autoryzuj, a następnie Kontynuuj. Zostaniesz przeniesiony do strony Ustawienia zespołu > Aplikacje i integracje.
Użyj panelu ustawień aplikacji, aby połączyć swoje konto Microsoft z Miro i wskazać instancję Azure, której chcesz używać. Ten adres URL możesz skopiować z Azure DevOps; Miro akceptuje zarówno spersonalizowany adres Twojej instancji, jak i ogólny https://dev.azure.com/ zakończony nazwą Twojej instancji.

✏️ Uwaga — tylko administratorzy zespołu mogą skonfigurować początkowe ustawienia na poziomie zespołu lub firmy. Jeśli podczas konfiguracji nie widzisz przycisku Połącz dla adresu URL organizacji Azure, upewnij się, że masz uprawnienia administratora zespołu w tym zespole.

Importowanie elementów pracy Azure na tablicę Miro

Gdy aplikacja Azure Cards zostanie skonfigurowana i połączysz swoje konto osobiste, możesz importować elementy pracy Azure na dowolną tablicę Miro powiązaną z połączonym zespołem. Istnieją dwa główne sposoby, aby to zrobić:

Skopiuj adres URL elementu pracy w Azure i wklej go bezpośrednio na tablicę Miro. Element automatycznie zamieni się w kartę Azure.
Użyj selektora kart Azure: kliknij Azure Cards na pasku narzędzi, aby go otworzyć.

Selektor kart Azure

Picker obsługuje wyszukiwanie we wszystkich polach, dzięki czemu możesz znaleźć kartę po tytule, typie, stanie itp. Możesz też skorzystać z zaawansowanego wyszukiwania słów kluczowych obsługiwanego przez Microsoft.

Wyszukiwanie Azure Cards w pickerze

Możesz filtrować karty według projektu, przypisanego użytkownika, typu, obszaru i stanu, co umożliwia zaawansowane filtrowanie elementów pracy w Azure bezpośrednio w Miro.

Filtrowanie Azure Cards w pickerze

Aby przejść do oryginalnego elementu pracy w Azure, wybierz kartę na tablicy i kliknij przycisk Źródło w jej menu kontekstowym.

Azure Cards można używać jako samodzielne widżety tablicy lub jako elementy interaktywnych szablonów Kanban i Mapa historyjki (użytkownika). Możesz dodać Azure Cards do tych szablonów, przeciągając je.

Twórz i edytuj Azure Cards bezpośrednio w Miro

Dwukierunkowa integracja między Miro a Azure DevOps pozwala zespołom tworzyć nowe elementy pracy w Azure oraz edytować istniejące bezpośrednio z tablicy Miro. Możesz także przekonwertować istniejące karty Miro i karteczki na Azure Cards.

Utwórz nową Azure Card

Aby utworzyć nowy element pracy w Azure z poziomu Miro:

Wybierz Azure Cards z paska narzędzi tworzenia, a następnie w prawym górnym rogu panelu wyboru kliknij Utwórz element pracy.
Wypełnij pola karty, wybierz projekt, typ elementu i osobę przypisaną, a następnie kliknij Utwórz. Nowy element zostanie utworzony w Twojej instancji Azure DevOps oraz na tablicy Miro.

Konwertuj karty Miro lub karteczki na Azure Cards

Aby przekonwertować istniejącą kartę Miro lub karteczkę na Azure Card:

Wybierz karteczkę lub kartę na tablicy.
Kliknij opcję konwersji (zwykle ikona Azure DevOps lub "Konwertuj na element pracy Azure") w menu kontekstowym obiektu.
Ustaw parametry karty (np. projekt, typ elementu) w oknie dialogowym i kliknij Konwertuj. Tekst z karteczki lub karty zostanie użyty jako tytuł karty.

💡 Oszczędź czas, wykonując zbiorczą konwersję karteczek lub kart Miro na Azure Cards. Kliknij i przeciągnij, aby zaznaczyć wszystkie obiekty, które chcesz skonwertować, a w menu kontekstowym wybierz Konwertuj na elementy pracy Azure.

Edycja karty Azure

Możesz edytować karty Azure bez przełączania się między narzędziami. Aby edytować kartę:

Kliknij kartę Azure Card na tablicy Miro.
Kliknij ikonę pióra (edycja) w menu kontekstowym karty. Otworzy się okno podręczne, w którym możesz edytować pola elementu.
Kliknij Aktualizuj, aby zapisać zmiany. Zmiany zostaną również odzwierciedlone w Azure DevOps.

Zmień kolor karty Azure Card

Aby dostosować wygląd kart Azure Card na tablicy:

Aby zmienić kolor wypełnienia karty, kliknij kartę lub karty i z menu kontekstowego wybierz Kolor wypełnienia. Jeśli zduplikujesz kartę lub karty, wszystkie kolejne kopie będą miały ten sam kolor wypełnienia.

Odinstalowanie integracji Azure Cards

Jeśli nie potrzebujesz już integracji Azure Cards, możesz ją odinstalować. Odinstalowanie na poziomie zespołu wymaga uprawnień administratora zespołu.

Przejdź do Ustawienia zespołu > Aplikacje i integracje > Azure Cards.
Wybierz Odinstaluj dla zespołu.

Obsługiwane pola Azure Cards

Poniższe pola są obsługiwane dla Azure Cards w Miro:

Tytuł
Projekt
Typ
Stan
Opis (edycja nie jest obsługiwana)
Element nadrzędny (WI)
Przypisana osoba
Priorytet
Story points
Obszar
Iteracja
Kryteria akceptacji

Pola niestandardowe nie są obsługiwane.

Rozwiązywanie problemów z Azure Cards

Jeśli napotkasz problemy z integracją Azure Cards, zapoznaj się z poniższymi typowymi problemami i rozwiązaniami.

Adres URL jest nieprawidłowy

Użyty adres URL jest nieprawidłowy. Sprawdź pisownię i formatowanie. Na przykład adres organizacji Azure musi kończyć się ukośnikiem (/).

Nie można uzyskać dostępu do adresu URL organizacji Azure

Wprowadzony adres URL nie istnieje. Wpisz poprawny adres URL lub sprawdź pisownię. Sprawdź też:

Upewnij się, że Twoja organizacja może akceptować autoryzację aplikacji innych firm: w Ustawienia organizacji > Polityki (Bezpieczeństwo) > sprawdź, czy opcja "Dostęp aplikacji innych firm przez OAuth" jest włączona.
Twoja organizacja Azure znajduje się w sieci prywatnej lub zapora sieciowa firmy blokuje połączenia zewnętrzne. Wprowadź niezbędne zmiany w konfiguracji zapory sieciowej i VPN, dodając nasze domeny do listy dozwolonych: miro.com*, *.miro.com, mirostatic.com*, *.mirostatic.com, realtimeboard.com*, *.realtimeboard.com, *static.miro-apps.com. Jeśli używasz serwera proxy, skonfiguruj reverse proxy umożliwiający nam dostęp. Upewnij się, że w polu Azure DevOps URL w ustawieniach znajduje się adres, do którego mamy dostęp (adres ten może różnić się od rzeczywistego adresu Twojego ograniczonego Azure DevOps). Możesz też wydłużyć limit czasu na serwerze proxy.
Wszystkie żądania integracji przechodzą przez load balancer Amazona, dlatego Miro nie jest w stanie podać szczegółowych informacji sieciowych.

Nie udało się utworzyć subskrypcji service hook

Obecnie zalogowany użytkownik Azure nie ma niezbędnych uprawnień. Użytkownik Azure, w imieniu którego instancja Azure zostanie połączona z Miro, musi mieć dostęp do następujących metod REST API:

Utwórz subskrypcję service hook ("vso.serviceendpoint_manage" zakres wymagany)
Pobierz metadane dotyczące projektów (informacje te są używane do poprawnego określania elementów pracy w zdarzeniach subskrypcji)
Następujące metody muszą być również dostępne dla wszystkich użytkowników korzystających z integracji:

Użytkownik username@microsoft.com nie ma dostępu do żadnego projektu pod określonym adresem URL organizacji Azure.

Nie masz dostępu do żadnych projektów w używanej organizacji Azure. Aby importować karty, musisz mieć do nich dostęp po stronie Azure Boards. Skontaktuj się z właścicielem organizacji Azure i poproś o zaproszenie do tej organizacji. Ten artykuł pomoże Ci ustalić nazwę właściciela organizacji.

Nie udało się utworzyć subskrypcji usługi Service Hook: użytkownik username@microsoft.com nie jest właścicielem organizacji. Poproś właściciela organizacji o skonfigurowanie tego kroku.

Musisz być zarówno właścicielem organizacji Azure, jak i administratorem firmy Miro, aby skonfigurować Azure Cards w Miro.

Autoryzacja wygasła. Ponownie połącz integrację w ustawieniach zespołu.

Autoryzacja Azure wygasła. Ponownie połącz integrację na poziomie osobistym zgodnie z opisem w sekcji "Connect your personal Azure account to use Azure Cards" powyżej.

Karta, nad którą pracujesz, zachowuje się nieoczekiwanie.

- Do tego może dojść, jeśli karta została odłączona od organizacji Azure. Na przykład gdy skopiowano kartę z innej tablicy lub pracujesz na tablicy, która została przeniesiona między zespołami. Aby rozwiązać problem, dodaj ponownie element Azure do tablicy.

Liczba zwróconych elementów pracy przekracza limit 200. Zmień zapytanie, aby zwrócić mniejszą liczbę elementów.

Jeśli zobaczysz ten komunikat o błędzie, oznacza to, że wybrano zbyt wiele zadań do dodania na tablicę jako karty. Ogranicz liczbę zadań, korzystając z paska wyszukiwania. Obecnie po otwarciu okna wyboru nie są stosowane żadne filtry i wyświetlane są wszystkie zadania z ostatnich trzech miesięcy. Za każdym razem, gdy okno wyboru próbuje wyświetlić ponad 200 zadań, otrzymasz ten komunikat o błędzie.

Nie widzę przycisku Połącz podczas próby połączenia mojej organizacji Azure z Miro w ustawieniach Miro.

Upewnij się, że masz uprawnienia administratora zespołu. Przejdź do karty Aktywni użytkownicy w ustawieniach zespołu i awansuj się na administratora zespołu, jeśli to konieczne. Dotyczy to początkowej konfiguracji połączenia organizacji Azure przez administratora.

✏️ Jeśli napotkasz inne problemy, skontaktuj się z pomocą Miro.

Najczęściej zadawane pytania dotyczące Azure Cards

Poniżej znajdziesz odpowiedzi na najczęściej zadawane pytania dotyczące integracji Azure Cards.

Jakie adresy IP należy dodać do listy dozwolonych dla Azure Cards?

Aby integracja Azure Cards działała poprawnie, szczególnie w środowiskach z ograniczeniami sieciowymi, może być konieczne dodanie następujących adresów IP do listy dozwolonych:

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

Co się stanie z istniejącymi kartami Azure Cards po odłączeniu & odinstalowaniu aplikacji Azure Cards?

Karty pozostają nienaruszone na tablicach Miro i nie dochodzi do utraty danych; jednak przestają się synchronizować z Azure, a przycisk Źródło znika.

Artykuły w tej sekcji