Поділитися через

Практичні поради з використання служби організаційної звітності Microsoft Learn

  • Стаття

У цій статті описано практичні поради з використання служби "Learn Organizational Reporting" (Навчитися організаційній звітності).

Загальні відомості про угоду про доступ до даних і спільний доступ до даних microsoft Learn

Використовуючи цю службу спільного доступу до даних, ви визнаєте та приймаєте Угоди про доступ до даних і спільний доступ до даних Microsoft, дозволити корпорації Майкрософт надавати спільний доступ до даних Learn вашій організації, щоб дізнатися, як користувачі ввіходите за допомогою ідентифікатора клієнта вашої організації. Ознайомтеся з цією угодою та ознайомтеся з нею, перш ніж використовувати Службу звітування організації Microsoft Learn і включно з виходом у будь-якому середовищі виробництва.

Планування рішення для звітування, яке використовуватиметься для візуалізації даних, запропонованих у цій службі

Служба звітування про організацію Microsoft Learn надає необроблені дані про завершення організаціям і за замовчуванням не має приладних дощок. Ви можете взяти дані та експортувати їх до CSV, щоб швидко переглянути дані, але їх потрібно об'єднати, щоб вони були ефектними.

Ми надали шаблон Power BI Learn Organizational Reporting Power BI для сховища SQL DB з багатьма стандартними графічними відображеннями даних, але ви також можете використовувати будь-яке рішення для звітування за вашим вибором. Плануйте заздалегідь те, що хочете використовувати, щоб можна було підключити його до сховища даних у рамках процесу налаштування.

Загальні відомості про модель вмісту Learn

Щоб ефективно використовувати відповідь служби організаційної звітності Microsoft Learn, важливо розуміти типи вмісту, доступного в Microsoft Learn, і їхні зв'язки між собою. Докладні відомості див. в статті Докладні відомості про типи вмісту.

Зокрема:

  • Ідентифікатор UID означає "Унікальний ідентифікатор" і унікальний для кожного об'єкта вмісту. Якщо ідентифікатор UID зміниться, навіть якщо заголовок або інші метадані залишаються незмінними, вміст вважається новим об'єктом.
  • Модулі – це основний об'єкт у каталозі навчальних курсів Learn. Всі вони здатні стояти поодинці, в тому сенсі, що вони навчають сценарію або концепції наскрізного в них і не вимагають прийняття обов'язкових модулів. Для деяких це так, і вони не є частиною навчального шляху. Для інших користувачів вони об'єднуються в один або кілька навчальних шляхів, які допомагають користувачу створювати більш розширені концепції. Модуль не має бути частиною навчального шляху, або він може бути частиною одного або кількох.
  • Одиниці не написані як автономний вміст. Вони мають бути прийняті в певному порядку для модуля. З цієї причини ми включаємо посилання на сторінку відомостей про модуль і першу одиницю, щоб користувачі могли почати роботу з ним і продовжити роботу з вмістом.

Дізнайтеся, як працює локалізація в learn і як локалізований вміст відображається у результатах звітування організації

Microsoft Learn підтримує понад 65 локалей на сайті, і значна частина вмісту була перекладена на ці мови. Ми прагнемо зробити вміст доступним для всіх мов, у яких викладаються продукти в вмісті, але не всі мовні можливості перекладали вміст.

Якщо пов'язаний із цим перекладом запис локалізації недоступний, вміст сайту та відповідь API "повертаються" до англійської мови як стандартний. У разі виходу API англійські метадані відобразяться в інших відповідях на мовні формати після повернення. Однак URL-адреса вмісту й надалі вказуватиме на мову, навіть якщо основний вміст може відкотитися назад, і причина полягає в тому, щоб користувач міг і надалі переходити сайтом у цій локалізації (у якій відображатиметься переклад колонтитула та будь-яке інше посилання з доступним перекладом).

Коли оновлення публікуються в англійському вмісті, наші конвеєри локалізації працюють над тим, щоб локалізовані версії оновилися якомога швидше – зазвичай протягом кількох днів після початкової зміни. Повний список підтримуваних локалізаторів можна переглянути в нижньому колонтитулі сайту (виберіть посилання на мову, якою ви переглядаєте сайт).

Наші записи про завершення навчального вмісту є локалізованими, тобто ми не розрізняємо локалізовані версії вмісту як окремі об'єкти в записах про завершення навчання користувачів. Незалежно від мови, якою користувач пройде навчання, він отримає кредит за загальний об'єкт, і ми не зберігаємо посилання на те, якою мовою його завершено. Це означає, що якщо ви впровадите дані служби навчального процесу Learn Organizational Reporting service, вам знадобиться взяти це до уваги і, якщо ви завантажите об'єкти вмісту як окремі об'єкти, впровадите рівновіддаленість між ними, щоб незалежно від того, якою мовою користувач завершив навчання, він отримає кредит на них іншими мовами і не повинен його повторно використовувати.

Дізнайтеся, як працює керування версіями вмісту в Learn і як воно відображається в результатах звітування про організацію

Примітно, що весь час оновлюється вміст. Зазвичай оновлення публікують двічі на день. Вони можуть бути незначними, наприклад незначними змінами тексту або основними, наприклад основними виправленнями, додаваннями або видаленнями. Загалом, портфелем вмісту керується як масовий, висококонкурсований проект із відкритим кодом із тисячами співавторів, і, як такий, зміни відбуваються весь час. Якщо ви використовуєте дані служби звітування про організацію Learn у своїй виробничій системі, ви повинні знати про це та мати можливість працювати з нею.

Коли додаються нові об'єкти вмісту, вони відображатимуться як новий об'єкт (визначений ідентифікатором UID) у відповіді. Коли вміст змінюється, ви можете визначити його last_modified значення. Коли вміст буде видалено, його буде видалено з відповіді. Хоча іноді в відповіді API оновлюється незначна затримка вмісту, коли користувач стежить за URL-адресою вмісту, він завжди бачитиме найновіші відомості. У разі видалення стара URL-адреса переспрямовуватиме на новий вміст або можливості.

Наразі немає посилань на версії вмісту, окрім дати last_modified.

Розуміння обмежень служби звітування організації

Див. статтю Обмеження в статті Огляд функцій служби Learn Organizational Reporting service.

Регулярно оновлюйте дані

Якщо для підтримки бізнес-процесів або відображення для клієнтів як частини інтерфейсу сайту використовуються відомості каталогу з даних служби "Learn Organizational Reporting" (Дізнайтеся, як служба звітування про організацію), переконайтеся, що вміст оновлюється принаймні раз на день.

Примітно, що весь час оновлюється вміст. Зазвичай оновлення публікують двічі на день. Вони можуть бути незначними, наприклад незначними змінами тексту або основними, наприклад основними виправленнями, додаваннями або видаленнями. Загалом, портфелем вмісту керується як масовий, висококонкурсований проект із відкритим кодом із тисячами співавторів, і, як такий, зміни відбуваються весь час. Якщо ви використовуєте дані служби звітування про організацію у своїй виробничій системі, ви повинні знати про це та мати можливість працювати з нею.

Регулярно оновлюйте приєднані відомості Microsoft Entra

Щоб дізнатися, на кого посилається кожен запис про завершення, потрібно приєднати дані набору даних організаційної звітності до відомостей Microsoft Entra, щоб імена відображалися поряд із записами про завершення. Якщо ви не оновили дані, приєднані до Microsoft Entra, можливо, у вас є записи про завершення з застарілими даними персоналу або відсутні дані PII, пов'язані з ними.

Посилання на документацію розробника

Документація розробника служби Learn Organizational Reporting service містить повний перелік даних, наданих у рамках відповіді, і рекомендації щодо того, як кожне поле рекомендовано використовувати для підтримки чудового навчального досвіду.

Наступні кроки

Щоб отримати додаткові відомості для підтримки в Learn Organizational Reporting Service, перегляньте такі статті: