Прием данных с помощью 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 Администратор.
Нажмите кнопку Начать.
Нажмите Продолжить.
Предоставьте несколько минут для подготовки служб к клиенту перед следующим шагом.
Выберите Создать новый входящий поток и Далее , чтобы продолжить.
Выберите источник данных. Для SDS CSV 2.1 выберите параметр Подключиться к моим данным.
Выберите формат. Для CSV-файла выберите параметр CSV. Рядом , чтобы продолжить.
Необходимо указать имя SIS/SMS. Кроме того, выберите SDS v2.1 CSV. Нажмите кнопку Далее, чтобы продолжить.
Выберите Обзор файлов , чтобы открыть диалоговое окно обзора и выбора.
Примечание.
После первоначальной отправки во время создания входящего потока необходимо всегда предоставлять один и тот же набор файлов для последующей отправки, независимо от того, какие изменения данных вносятся в необязательные файлы или нет. Если этого не сделать, система определит, что записи больше не активны, и пометит их как таковые.
Перейдите к расположению файла и выберите файлы.
См. раздел Формат 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
Завершив выбор файлов, нажмите кнопку Далее , чтобы продолжить. Система проверит имена выбранных файлов, прежде чем перейти к следующему экрану. Если необходимый файл не найден, появится сообщение, и вам нужно обратиться к файлу или файлам и повторно выбрать его.
После проверки имен файлов файлы будут отправлены для проверки структуры выбранных файлов и правильно отформатированы с именами заголовков на основе спецификации SDS CSV версии 2.1.
Если появится сообщение: Один или несколько из приведенных ниже файлов не соответствуют ожидаемому формату, просмотрите экран, чтобы проверить, не правильно ли форматируются какие-либо файлы. Вам потребуется вернуться к предыдущему экрану, чтобы повторно выбрать файлы после устранения проблем.
Если появится сообщение: Нам не удается найти один или несколько необязательных файлов, просмотрите экран, чтобы узнать, какие файлы не найдены. Если вы не ожидаете этого сообщения, необходимо вернуться к предыдущему экрану, чтобы повторно выбрать файлы. В противном случае нажмите кнопку Далее , чтобы продолжить.
После проверки схемы файла SDS выполнит быструю проверку данных из отправленных файлов. Отправленные данные проходят через некоторые правила сопоставления и проверки данных SDS, чтобы помочь определить необходимые и предоставленные необязательные данные. Это не все правила проверки, но те, которые наиболее часто встречаются.
Совет
Результаты проверки данных не блокируются во время подключения или отправки CSV. У вас есть два варианта: выйти и вернуться позже после исправления данных или перейти к следующему шагу, чтобы продолжить настройку подключения к данным и позже предоставить исправленные данные с последующими отправками.
Чтобы получить дополнительные сведения о данных, помеченных для исследования, выберите просмотреть сведения об имени файла из списка, чтобы детализировать конкретные элементы.
Вы также сможете скачать отчет по файлу, чтобы начать исследование и исправления в исходной системе.
Помеченные столбцы файлов отображаются с возможностью расширения и изучения того, какое правило или правила помечают их.
Щелкнув правило, вы увидите другую сводку по 10 самым лучшим записям, например.
После завершения исследования закройте диалоговые окна и нажмите кнопку Далее.
Выберите текущий учебный год и укажите понятное имя, например 2023 или 2022–2023. (Символы должны быть utf8 или будут автоматически удалены).
Важно!
Учебный год используется для связывания входящих данных для создания исторических данных за год. Подход сопоставляется с учебным годом и календарным годом. Если ваш учебный год охватывает календарный год, например, начинается 15.08.2022 и заканчивается 15.06.2023, то выбранным значением учебного года будет окончание 2023 года. Дополнительные сведения см. в разделе Обработка учебного года.
Введите даты начала и окончания учебного года.
Введите дату прекращения синхронизации данных SDS на основе определенного учебного года для этого источника. Чаще всего синхронизация данных о дате окончания учебного года, которую вы только что ввели, перестают синхронизировать.
Нажмите кнопку Далее, чтобы продолжить.
Выберите параметры правила удостоверений пользователей. Сделайте выбор для ролей сотрудников и учащихся.
Примечание.
Сопоставление пользователей выполняется с входящим потоком и не записывает и не обновляет пользовательские объекты в 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.
После того как вы будете удовлетворены выбранными параметрами, нажмите кнопку Далее , чтобы продолжить.
- Атрибут из источника: атрибут пользователя на основе данных, поступающих из SIS/SMS.
Просмотр сведений, представленных на странице Просмотр и создание. Если все выглядит правильно, нажмите кнопку Создать . В противном случае вы сможете вернуться к правильному.
Поток входящих данных создан, и первый запуск ожидается, нажмите кнопку Готово . Проверьте состояние первого запуска.
Совет
Вы можете настроить конфигурацию управления данными сразу после определения конфигурации данных Connect, во время активного первого запуска или позже после завершения первого запуска.
Чтобы проверка о состоянии выполнения, вернитесь на страницу домашней панели мониторинга.
Если проблемы с данными отсутствуют, на панели мониторинга "Главная" отобразится сообщение "Нет ошибок данных или предупреждений найдено" и "Во время последнего запуска не произошло никаких ошибок или предупреждений данных. Продолжайте большую работу!"
Если с вашими данными обнаружены проблемы, на панели мониторинга "Главная" отображается сообщение "Мы обнаружили некоторые проблемы с вашими данными" и рекомендуется исследовать работоспособность синхронизации.
Примечание.
Чтобы вручную отправить изменения после первого запуска для обновления изменений из исходных данных , см. статью Обновление исходных данных с помощью CSV-файла SDS
Максимальное количество отправки с соответствующим выполнением составляет шесть раз за календарный день. После шести раз в день при отправке он будет выполняться еще два раза на основе автоматической частоты выполнения SDS каждые 12 часов.