Рекомендации по использованию службы отчетов организации Microsoft Learn
В этой статье описаны рекомендации по использованию службы отчетов организации Learn.
Общие сведения о соглашении о доступе к данным и совместном доступе к данным Microsoft Learn
При использовании этой службы общего доступа к данным вы подтверждаете и принимаете соглашение о доступе и совместном доступе к данным Microsoft Learn, чтобы корпорация Майкрософт делиться данными с вашей организацией для пользователей Learn, выполнив вход с идентификатором клиента вашей организации. Прочитайте и изучите это соглашение перед использованием Службы отчетов организации Microsoft Learn и включая выходные данные в любой рабочей среде.
Планирование решения для создания отчетов, которое вы будете использовать для визуализации данных, предлагаемых в этой службе
Служба отчетов организации Microsoft Learn предоставляет необработанные данные завершения организациям и не имеет панелей мониторинга по умолчанию. Вы можете взять данные и экспортировать их в CSV-файл, чтобы быстро просмотреть данные, но их необходимо объединить вместе, чтобы быть затронутыми.
Мы предоставили шаблон Power BI для организации Power BI для хранилища БАЗЫ данных SQL с множеством стандартных визуализаций данных, но вы также можете использовать любое решение для создания отчетов. Заранее спланируйте то, что вы хотите использовать, чтобы подключить его к хранилищу данных в рамках процесса установки.
Общие сведения о con режим палатки l
Чтобы эффективно использовать ответ службы отчетов организации Microsoft Learn, важно понять типы контента, доступные в Microsoft Learn, и их отношения друг с другом. Дополнительные сведения см. в статье о типах контента Learn.
Заметно:
- UID обозначает "Уникальный идентификатор" и является уникальным для каждого объекта содержимого. Если идентификатор пользовательского интерфейса изменяется, даже если заголовок или другие метаданные остаются неизменными, содержимое считается новым объектом.
- Модули — это основной объект в каталоге обучения Learn. Они все способны стоять в одиночку, в том смысле, что они учат сценарий или концепцию сквозной в них и не требуют принятия необходимых модулей. Для некоторых это так, и они не являются частью пути обучения. Для других пользователей они объединяются в одну или несколько схем обучения, которые принимают пользователя с помощью создания более сложных концепций. Модуль не должен быть частью схемы обучения или может быть частью одного или нескольких.
- Единицы не записываются как автономное содержимое. Они должны приниматься в определенном порядке для модуля. Поэтому мы даем ссылку на страницу сведений о модуле и первый урок, чтобы пользователи могли начать с этого места и продолжить работу с содержимым.
Узнайте, как локализация работает в Learn и как локализованное содержимое отражается в выходных данных отчетов организации
Microsoft Learn поддерживает более 65 языковых стандартов на сайте, и большая часть содержимого была переведена в эти языковые стандарты. Мы стремимся сделать содержимое доступным на всех языках, в которых продукты, обучаемые в содержимом, доступны, но не все интерфейсы языкового стандарта имеют доступный контент.
Если запись языкового стандарта не имеет связанного перевода, содержимое сайта и ответ API "возвращается" на английский язык по умолчанию. В случае выходных данных API вы увидите метаданные английского языка в других ответах языкового стандарта при возврате. Однако URL-адрес содержимого по-прежнему указывает на языковой стандарт, несмотря на то, что основное содержимое может вернуться, и причина заключается в том, чтобы пользователь по-прежнему перемещаться по сайту в этом языковом стандарте (который будет отображать переведенный верхний или нижний колонтитул и любую другую ссылку, которая имеет доступный перевод).
Когда обновления публикуются на английском языке, наши конвейеры локализации работают для получения локализованных версий обновления как можно скорее — обычно в течение нескольких дней после первоначального изменения. Вы можете просмотреть полный список поддерживаемых языковых стандартов с помощью нижнего колонтитула сайта (выберите ссылку на язык, в который вы просматриваете сайт).
Наши записи завершения содержимого обучения не зависят от языкового стандарта, то есть мы не различаем локализованные версии содержимого как отдельные объекты в записях завершения обучения пользователей. Независимо от того, какой язык пользователь завершает обучение, он получит кредит на общий объект, и мы не сохраняем ссылку на какой язык он был завершен. Это означает, что если вы реализуете данные службы "Аналитика организации" в процессе обучения, необходимо учитывать это и, если вы загружаете объекты содержимого в виде отдельных объектов, реализуйте эквивалентность между ними, чтобы независимо от того, какой язык пользователь завершает обучение, они получат кредит на другие языки и не должны повторно выполнять его.
Узнайте, как работает управление версиями содержимого в Learn и как оно отражается в выходных данных отчетов организации
В частности, содержимое обновляется все время. Обычно мы публикуем обновления дважды в день. Они могут быть незначительными, например незначительными изменениями текста или основными, такими как основные редакции, дополнения или удаления. Как правило, портфель содержимого управляется как массивный, высокоуправляемый проект с открытым исходным кодом с тысячами участников, и, как это, изменения происходят все время. Если вы используете данные службы "Аналитика организации" в рабочей системе, вы должны знать об этом и иметь возможность ее обрабатывать.
При добавлении новых объектов содержимого в ответе они будут отображаться как новый объект (идентифицируемый uiD). При изменении содержимого можно определить на основе его last_modified значения. При удалении содержимого он будет удален из ответа. Хотя в ответе API иногда возникает небольшая задержка при обновлении содержимого, когда пользователь следует URL-адресу содержимого, они всегда будут видеть самые актуальные сведения. В случае удаления старый URL-адрес перенаправляется на новое содержимое или интерфейс.
В настоящее время нет ссылок на версии содержимого за пределами last_modified даты.
Общие сведения об ограничениях службы "Организационные отчеты"
Общие сведения об ограничениях см. в статье об ограничениях в этой статье.
Регулярное обновление данных
Если вы используете сведения о каталоге из данных службы "Аналитика организационных отчетов" для поддержки бизнес-процессов или отображения для клиентов в процессе работы с сайтом, убедитесь, что вы обновляете содержимое по крайней мере один раз в день.
В частности, содержимое обновляется все время. Обычно мы публикуем обновления дважды в день. Они могут быть незначительными, например незначительными изменениями текста или основными, такими как основные редакции, дополнения или удаления. Как правило, портфель содержимого управляется как массивный, высокоуправляемый проект с открытым исходным кодом с тысячами участников, и, как это, изменения происходят все время. Если вы используете данные службы "Организационные отчеты" в рабочей системе, вы должны знать об этом и иметь возможность его обрабатывать.
Убедитесь, что ваши присоединенные сведения о Microsoft Entra регулярно обновляются
Чтобы узнать, кто ссылается на каждую запись завершения, необходимо присоединить данные набора данных организационной отчетности к данным Microsoft Entra, поэтому имена отображаются вместе с записями завершения. Если вы не обновляете данные, присоединенные к Microsoft Entra, возможно, у вас есть записи завершения с устаревшими данными персонала или отсутствующие данные piI, связанные с ними.
Справочник по документации разработчика
Документация разработчика службы "Аналитика организации" содержит полный список данных, предоставляемых в рамках ответа, и рекомендации по использованию каждого поля для поддержки большого опыта обучения.
Следующие шаги
Дополнительные сведения о поддержке службы Reporting Service Learn для организации см. в следующих статьях: