Прием данных с помощью CSV-файла SDS версии 2.1

Настройка SDS для клиента Microsoft 365 для образования

  • клиент Microsoft 365 для образования

  • Требуются разрешения глобального администратора

    Предупреждение

    Для синхронизации учебной информационной системы (SIS) или системы управления учащимися (SMS) можно использовать csv-файлы (значения с разделив запятыми). SDS поддерживает отправку CSV-файлов только в формате UTF-8 и в соответствии с RFC. Каждый CSV-файл должен содержать данные для полей, отмеченных как "Да" в разделе "Обязательный", а поля , отмеченные как "Нет", являются необязательными. Заголовки полей, помеченные как обязательные, должны существовать в предоставленных файлах, иначе они не будут приняты. Заголовки полей, помеченные как "Необязательный", не обязательно должны присутствовать в файлах, если не передаются соответствующие необязательные данные. Дополнительные сведения см. в статье Формат CSV-файла SDS версии 2.1.

    Важно!

    Подключая данные учреждений и делая их доступными с помощью School Data Sync, вы подтверждаете, что имеете право делиться данными с корпорацией Майкрософт и обязуетесь соблюдать стандарты управления данными вашей организации.

Доступ к SDS и первый вход

Чтобы получить доступ к порталу SDS Администратор, запустите веб-браузер, перейдите к sds.microsoft.com, а затем войдите в систему с помощью учетной записи Microsoft 365 Global Администратор.

  1. Нажмите кнопку Начать.

    Снимок экрана: приветственное сообщение.

  2. Нажмите Продолжить.

    Снимок экрана: обзор SDS.

    Предоставьте несколько минут для подготовки служб к клиенту перед следующим шагом.

    Снимок экрана: ожидание завершения подготовки службы.

  3. Выберите Создать новый входящий поток и Далее , чтобы продолжить.

    Снимок экрана: запрос на создание нового входящего потока.

  4. Выберите источник данных. Для SDS CSV 2.1 выберите параметр Подключиться к моим данным.

  5. Выберите формат. Для CSV-файла выберите параметр CSV. Рядом , чтобы продолжить.

    Снимок экрана: выбор CSV-файла.

  6. Необходимо указать имя SIS/SMS. Кроме того, выберите SDS v2.1 CSV. Нажмите кнопку Далее, чтобы продолжить.

    Снимок экрана: запрос на ввод имени SIS и выбор формата CSV.

  7. Выберите Обзор файлов , чтобы открыть диалоговое окно обзора и выбора.

    Снимок экрана: выбор запроса на поиск CSV-файлов.

    Примечание.

    После первоначальной отправки во время создания входящего потока необходимо всегда предоставлять один и тот же набор файлов для последующей отправки, независимо от того, какие изменения данных вносятся в необязательные файлы или нет. Если этого не сделать, система определит, что записи больше не активны, и пометит их как таковые.

  8. Перейдите к расположению файла и выберите файлы.

    Снимок экрана: переход к расположению файла и выбор файлов.

    См. раздел Формат CSV-файла SDS версии 2.1.

    Обязательный: три перечисленных ниже файла должны быть выбраны перед выполнением. Если вы управляете только пользователями, а не классами, необходимо только предоставить эти файлы.

    • orgs.csv

    • users.csv

    • roles.csv

    Необязательный или обязательный: не требуется, если вы управляете только пользователями. Если вы также управляете классами и регистрациями классов, необходимо предоставить два перечисленных ниже файла вместе с тремя файлами выше. Если это не так, не выбирайте файлы с такими именами. Если выбран один из них, а другой нет, при нажатии кнопки Далее появляется сообщение о том, что один из этих файлов отсутствует. Перед продолжением необходимо исправить.

    • classes.csv

    • enrollments.csv

    Необязательный. Следующие файлы являются необязательными и используются для улучшения возможностей. Не требуется, если в приведенных выше файлах нет ссылок на данные на основе приведенных ниже примечаний.

    • academicSessions.csv (если roles.csv, classes.csv или courses.csv содержат данные академических сеансов, которые предоставляются во избежание сообщений об ошибках при обработке данных.)

    • courses.csv (Если данные classes.csv содержат ссылки на курсы, предоставляются во избежание сообщений об ошибках при обработке данных.)

    • demographics.csv

    • userFlags.csv

    • relationships.csv

  9. Завершив выбор файлов, нажмите кнопку Далее , чтобы продолжить. Система проверит имена выбранных файлов, прежде чем перейти к следующему экрану. Если необходимый файл не найден, появится сообщение, и вам нужно обратиться к файлу или файлам и повторно выбрать его.

    Снимок экрана: проверка имен файлов.

  10. После проверки имен файлов файлы будут отправлены для проверки структуры выбранных файлов и правильно отформатированы с именами заголовков на основе спецификации SDS CSV версии 2.1.

    • Если появится сообщение: Один или несколько из приведенных ниже файлов не соответствуют ожидаемому формату, просмотрите экран, чтобы проверить, не правильно ли форматируются какие-либо файлы. Вам потребуется вернуться к предыдущему экрану, чтобы повторно выбрать файлы после устранения проблем.

    • Если появится сообщение: Нам не удается найти один или несколько необязательных файлов, просмотрите экран, чтобы узнать, какие файлы не найдены. Если вы не ожидаете этого сообщения, необходимо вернуться к предыдущему экрану, чтобы повторно выбрать файлы. В противном случае нажмите кнопку Далее , чтобы продолжить.

    Снимок экрана: отправка и проверка заголовков файлов.

  11. После проверки схемы файла SDS выполнит быструю проверку данных из отправленных файлов. Отправленные данные проходят через некоторые правила сопоставления и проверки данных SDS, чтобы помочь определить необходимые и предоставленные необязательные данные. Это не все правила проверки, но те, которые наиболее часто встречаются.

    Снимок экрана: обработка файлов с помощью проверки данных.

    Снимок экрана: файлы, обработанные с помощью проверки данных.

    Совет

    Результаты проверки данных не блокируются во время подключения или отправки CSV. У вас есть два варианта: выйти и вернуться позже после исправления данных или перейти к следующему шагу, чтобы продолжить настройку подключения к данным и позже предоставить исправленные данные с последующими отправками.

  12. Чтобы получить дополнительные сведения о данных, помеченных для исследования, выберите просмотреть сведения об имени файла из списка, чтобы детализировать конкретные элементы.

    Вы также сможете скачать отчет по файлу, чтобы начать исследование и исправления в исходной системе.

    Помеченные столбцы файлов отображаются с возможностью расширения и изучения того, какое правило или правила помечают их.

    Снимок экрана: файл, выбранный для просмотра сведений.

    Щелкнув правило, вы увидите другую сводку по 10 самым лучшим записям, например.

    Снимок экрана: файл, выбранный для просмотра сведений о выбранном правиле.

    После завершения исследования закройте диалоговые окна и нажмите кнопку Далее.

  13. Выберите текущий учебный год и укажите понятное имя, например 2023 или 2022–2023. (Символы должны быть utf8 или будут автоматически удалены).

    Важно!

    Учебный год используется для связывания входящих данных для создания исторических данных за год. Подход сопоставляется с учебным годом и календарным годом. Если ваш учебный год охватывает календарный год, например, начинается 15.08.2022 и заканчивается 15.06.2023, то выбранным значением учебного года будет окончание 2023 года. Дополнительные сведения см. в разделе Обработка учебного года.

    Введите даты начала и окончания учебного года.

    Введите дату прекращения синхронизации данных SDS на основе определенного учебного года для этого источника. Чаще всего синхронизация данных о дате окончания учебного года, которую вы только что ввели, перестают синхронизировать.

    Нажмите кнопку Далее, чтобы продолжить.

    Снимок экрана: запрос на учебный год и дату остановки синхронизации.

  14. Выберите параметры правила удостоверений пользователей. Сделайте выбор для ролей сотрудников и учащихся.

    Примечание.

    Сопоставление пользователей выполняется с входящим потоком и не записывает и не обновляет пользовательские объекты в Microsoft Entra ID. Сопоставление выполняется и сохраняется в озере данных для образовательных учреждений. Дополнительные сведения см. в статье Управление пользователями в Microsoft 365 о записи ссылки на соответствие с исходящим потоком.

    • Атрибут из источника: атрибут пользователя на основе данных, поступающих из SIS/SMS.
      • Доступные варианты источника: Имя пользователя, Email и Идентификатор совпадения ActiveDirectory.
    • Атрибут для сопоставления: свойство пользователя в Microsoft Entra ID для сопоставления.
      • Доступные Microsoft Entra ID варианты сопоставления: UserPrincipalName и Mail.
    • (НЕОБЯЗАТЕЛЬНО) Если данные пользователя не содержат значение @domain , выберите домен из списка.

    Предупреждение

    Выбор домена необязателен и должен использоваться только в том случае, если входящие данные на основе выбранного атрибута из источника не содержат значение @domain . SDS не проверка и не добавляет, если значение отсутствует в записи. SDS добавит выбранный домен ко всем записям, что может привести к @domain@domain и не найти совпадений в этих экземплярах для существующего сопоставления пользователей с пользователями в Microsoft Entra ID.

    Предостережение

    Если пользователи SIS или SMS, например пользователи в группе ролей персонала, могут быть связаны с @domain1 , @domain2 или @domain3 , в исходные данные должен быть включен @domain на основе выбранного атрибута из выбранного источника (например, prefix@domain). Это необходимо для того, чтобы атрибут соответствовал: UserPrincipalName или Mail, чтобы найти правильный Microsoft Entra пользователя, с которым нужно сопоставить.

    В случае, когда пользователь имеет несколько ролей, следующие правила используются для определения правил соответствия сотрудников или учащихся между записью пользователя и объектом пользователя Microsoft Entra.

    • Если параметр isPrimary задан для всех ролей учащегося, даже если связь с ролью персонала существует, сопоставление выполняется на основе роли учащегося.

    • Если параметр isPrimary установлен для любой роли персонала, даже если связь с ролью учащегося существует, сопоставление выполняется на основе роли персонала.

    • Если параметр isPrimary задан как для роли персонала, так и для роли учащегося, сопоставление выполняется на основе роли персонала.

    • Если параметр isPrimary не задан для каких-либо ролей, особенно для ролей сотрудников и учащихся, то соответствие зависит от роли персонала.

    Важно!

    При настройке потока Управления пользователями в Microsoft 365 эти правила используются, если активируется параметр Create unmatched users (Создание несоответсвованных пользователей), чтобы определить конструкцию для свойства Microsoft Entra UserPrincipalName.

    После того как вы будете удовлетворены выбранными параметрами, нажмите кнопку Далее , чтобы продолжить.

    Снимок экрана: запросы правил удостоверений пользователей.]

  15. Просмотр сведений, представленных на странице Просмотр и создание. Если все выглядит правильно, нажмите кнопку Создать . В противном случае вы сможете вернуться к правильному.

    Снимок экрана: просмотр и создание.]

    Снимок экрана: обработка после выбора создания.]

  16. Поток входящих данных создан, и первый запуск ожидается, нажмите кнопку Готово . Проверьте состояние первого запуска.

    Снимок экрана: входящий поток создан.]

    Снимок экрана: домашняя панель мониторинга и действие

    Совет

    Вы можете настроить конфигурацию управления данными сразу после определения конфигурации данных Connect, во время активного первого запуска или позже после завершения первого запуска.

  17. Чтобы проверка о состоянии выполнения, вернитесь на страницу домашней панели мониторинга.

    Если проблемы с данными отсутствуют, на панели мониторинга "Главная" отобразится сообщение "Нет ошибок данных или предупреждений найдено" и "Во время последнего запуска не произошло никаких ошибок или предупреждений данных. Продолжайте большую работу!"

    Если с вашими данными обнаружены проблемы, на панели мониторинга "Главная" отображается сообщение "Мы обнаружили некоторые проблемы с вашими данными" и рекомендуется исследовать работоспособность синхронизации.

    Примечание.

    Чтобы вручную отправить изменения после первого запуска для обновления изменений из исходных данных , см. статью Обновление исходных данных с помощью CSV-файла SDS

    Максимальное количество отправки с соответствующим выполнением составляет шесть раз за календарный день. После шести раз в день при отправке он будет выполняться еще два раза на основе автоматической частоты выполнения SDS каждые 12 часов.