Najlepsze rozwiązania dotyczące korzystania z usługi raportowania organizacyjnego Microsoft Learn
W tym artykule opisano najlepsze rozwiązania dotyczące korzystania z usługi Learn Organizational Reporting Service.
Omówienie umowy dotyczącej dostępu do danych i udostępniania danych w usłudze Microsoft Learn
Korzystając z tej usługi udostępniania danych, potwierdzasz i akceptujesz umowę dostępu do danych i udostępniania usługi Microsoft Learn, aby umożliwić firmie Microsoft udostępnianie danych platformy Learn organizacji użytkownikom platformy Learn logujących się przy użyciu identyfikatora dzierżawy organizacji. Zapoznaj się z tą umową i zapoznaj się z tą umową przed rozpoczęciem korzystania z usługi raportowania organizacyjnego Microsoft Learn i dołączania danych wyjściowych w dowolnym środowisku produkcyjnym.
Planowanie rozwiązania do raportowania, którego użyjesz do wizualizacji danych oferowanych w tej usłudze
Usługa raportowania organizacyjnego usługi Microsoft Learn udostępnia nieprzetworzone dane uzupełniania organizacjom i nie ma domyślnie żadnych pulpitów nawigacyjnych. Możesz pobrać dane i wyeksportować je do pliku CSV, aby szybko wyświetlić dane, ale należy połączyć je ze sobą, aby mieć wpływ.
Udostępniliśmy szablon Learn Organizational Reporting Power BI dla magazynu bazy danych SQL, który zawiera wiele standardowych wizualizacji danych, ale możesz również użyć dowolnego wybranego rozwiązania do raportowania. Zaplanuj, czego chcesz użyć, aby można było połączyć go z magazynem danych w ramach procesu konfiguracji.
Omówienie witryny Learn con tryb namiotu l
Aby efektywnie korzystać z odpowiedzi usługi Raportowanie organizacyjne w usłudze Microsoft Learn, ważne jest, aby zrozumieć typy zawartości dostępne w środowisku Microsoft Learn i ich relacje ze sobą. Aby uzyskać więcej informacji, zapoznaj się z artykułem Learn content types (Typy zawartości platformy Learn).
Szczególności:
- UID oznacza "Unikatowy identyfikator" i jest unikatowy dla każdego obiektu zawartości. Jeśli identyfikator UID zmieni się, nawet jeśli tytuł lub inne metadane pozostaną takie same, zawartość jest traktowana jako nowy obiekt.
- Moduły są podstawowym obiektem w katalogu szkoleniowym usługi Learn. Wszyscy są w stanie stanąć w spokoju, w tym sensie, że uczą scenariusza lub koncepcji end-to-end w nich i nie wymagają podejmowania modułów wymagań wstępnych. Dla niektórych jest to i nie są częścią ścieżki szkoleniowej. W przypadku innych użytkowników są one połączone w jedną lub więcej ścieżek szkoleniowych, które przyjmują użytkownika przez tworzenie bardziej zaawansowanych pojęć. Moduł nie musi być częścią ścieżki szkoleniowej lub może być częścią co najmniej jednej.
- Jednostki nie są zapisywane jako zawartość autonomiczna. Mają one zostać podjęte w określonej kolejności dla modułu. Z tego powodu dołączymy link do strony szczegółów modułu i pierwszą jednostkę, aby użytkownicy mogli tam rozpocząć pracę i przejść przez zawartość.
Informacje o sposobie działania lokalizacji w usłudze Learn i sposobie odzwierciedlenia zlokalizowanej zawartości w danych wyjściowych raportowania organizacji
Platforma Microsoft Learn obsługuje ponad 65 ustawień regionalnych w witrynie i większość zawartości została przetłumaczona na te ustawienia regionalne. Chcemy udostępnić zawartość we wszystkich językach, w których produkty nauczane w zawartości są dostępne, ale nie wszystkie środowiska regionalne mają dostęp do przetłumaczonej zawartości.
Jeśli rekord ustawień regionalnych nie ma dostępnego skojarzonego tłumaczenia, zawartość witryny i odpowiedź interfejsu API "wraca" do języka angielskiego jako domyślną. W przypadku danych wyjściowych interfejsu API zobaczysz metadane języka angielskiego w innych odpowiedziach ustawień regionalnych, gdy nastąpi powrót. Jednak adres URL do zawartości nadal będzie wskazywać ustawienia regionalne, mimo że główna zawartość może wrócić i przyczyną jest umożliwienie użytkownikowi nadal nawigowania po tej witrynie w tych ustawieniach regionalnych (co spowoduje wyświetlenie przetłumaczonego nagłówka/stopki oraz dowolnego innego linku z dostępnym tłumaczeniem).
Po opublikowaniu aktualizacji w języku angielskim nasze potoki lokalizacji działają tak szybko, aby zlokalizowane wersje były aktualizowane tak szybko, jak to możliwe — zwykle w ciągu kilku dni od pierwotnej zmiany. Pełną listę obsługiwanych ustawień regionalnych można wyświetlić za pomocą stopki witryny (wybierz link do języka, w którym przeglądasz witrynę).
Nasze rekordy ukończenia zawartości szkoleniowej są niezależne od ustawień regionalnych, co oznacza, że nie rozróżniamy zlokalizowanych wersji zawartości jako oddzielnych obiektów w naszych rekordach ukończenia trenowania użytkownika. Bez względu na język, w jakim użytkownik ukończy szkolenie, otrzyma środki na ogólny obiekt i nie przechowujemy odwołania do tego, w jakim języku został ukończony. Oznacza to, że jeśli zaimplementujesz dane usługi Learn Organizational Reporting Service w środowisku szkoleniowym, musisz wziąć to pod uwagę i, jeśli załadujesz obiekty zawartości w postaci oddzielnych obiektów, zaimplementuj równoważność między nimi, aby bez względu na język, w którym użytkownik ukończy szkolenie, uzyska kredyt w innych językach i nie musi go ponownie pobierać.
Dowiedz się, jak działa przechowywanie wersji zawartości w usłudze Learn i jak jest ono odzwierciedlone w danych wyjściowych raportowania organizacji
W szczególności zawartość jest aktualizowana przez cały czas. Publikujemy aktualizacje zwykle dwa razy dziennie. Mogą one być drobne, takie jak drobne zmiany tekstu lub główne, takie jak główne poprawki, dodatki lub usunięcia. Ogólnie rzecz biorąc, portfolio zawartości jest zarządzane jako ogromny, wysoce zarządzany projekt open source z tysiącami współautorów, a w związku z tym zmiany są wykonywane przez cały czas. Jeśli używasz danych usługi Learn Organizational Reporting Service w systemie produkcyjnym, należy pamiętać o tym i mieć system w stanie go obsłużyć.
Po dodaniu nowych obiektów zawartości będą one wyświetlane jako nowy obiekt (zidentyfikowany przez UID) w odpowiedzi. Podczas modyfikowania zawartości można określić na podstawie jej last_modified wartości. Po usunięciu zawartości zostanie ona usunięta z odpowiedzi. Chociaż czasami występuje niewielkie opóźnienie w aktualizowaniu zawartości w odpowiedzi interfejsu API, gdy użytkownik podąża za adresem URL do zawartości, zawsze będzie widzieć najbardziej aktualne informacje. W przypadku usunięcia stary adres URL przekierowuje do nowej zawartości lub środowiska.
Obecnie nie ma odwołań do wersji zawartości poza datą last_modified .
Omówienie ograniczeń usługi raportowania organizacyjnego
Zobacz Artykuł Omówienie funkcji raportowania organizacyjnego w temacie Ograniczenia.
Regularnie odświeżaj dane
Jeśli używasz informacji katalogu z danych usługi Learn Organizational Reporting Service do obsługi procesów biznesowych lub wyświetlania dla klientów w ramach środowiska witryny, upewnij się, że odświeżasz zawartość co najmniej raz dziennie.
W szczególności zawartość jest aktualizowana przez cały czas. Publikujemy aktualizacje zwykle dwa razy dziennie. Mogą one być drobne, takie jak drobne zmiany tekstu lub główne, takie jak główne poprawki, dodatki lub usunięcia. Ogólnie rzecz biorąc, portfolio zawartości jest zarządzane jako ogromny, wysoce zarządzany projekt open source z tysiącami współautorów, a w związku z tym zmiany są wykonywane przez cały czas. Jeśli używasz danych usługi raportowania organizacyjnego w systemie produkcyjnym, należy pamiętać o tym i mieć system w stanie go obsłużyć.
Upewnij się, że dołączone informacje firmy Microsoft są regularnie odświeżane
Aby dowiedzieć się, kto odwołuje się do każdego rekordu ukończenia, musisz dołączyć dane zestawu danych raportowania organizacyjnego do informacji o usłudze Microsoft Entra, więc nazwy pojawiają się wraz z rekordami ukończenia. Jeśli nie odświeżysz danych dołączonych do firmy Microsoft, możesz mieć rekordy ukończenia z nieaktualnymi danymi personelu lub brak skojarzonych z nimi danych osobowych.
Dokumentacja dla deweloperów
Dokumentacja dla deweloperów usługi Learn Organizational Reporting Service zawiera pełną listę danych dostarczonych w ramach odpowiedzi oraz zalecenia dotyczące sposobu, w jaki każde pole jest zalecane do obsługi wspaniałych środowisk szkoleniowych.
Następne kroki
Aby uzyskać więcej informacji na temat obsługi usługi Learn Organizational Reporting Service, zapoznaj się z następującymi artykułami: