Правила и описания проверки
Правила сопоставления и проверки по типу данных
| Тип данных | Правило сопоставления | Правило проверки | Хранимое значение |
|---|---|---|---|
| Уникальный идентификатор * | С учетом регистра | Как получено | |
| ПЕРЕЧИСЛЕНИЯ** | Без учета регистра | Сопоставление с строчным регистром | Как верблюдюдка |
| String | С учетом регистра | Как получено | |
| В нижнем регистре | RFC 5532 (3.4.1) | В нижнем регистре | |
| Date или DateTime | ISO8601 | ISO8601 | ISO8601 |
| Phone | E.164 | E.164 | Как получено |
| Boolean | Без учета регистра | Сопоставление с "true" или "false" | В нижнем регистре |
*Запись уникальна для всех записей. Глобальный уникальный идентификатор, хотя он может принимать или не принимать форму универсального уникального идентификатора (UUID).
** Начальные нули "0", отсутствующие во входящем значении для ENUM уровня оценок, например "1", будут соответствовать определенному списку значений (ENUM) "01" и будут храниться как "01".
** Дополнительные сведения о значениях ENUM по умолчанию см. в разделе Список значений по умолчанию.
Ожидается, что поля телефона и sms должны быть отформатированы на основе стандарта E.164, где символ "плюс" используется и заменен номером телефона, или, скорее, символ "плюс", за которым следует код страны, код региона, префикс телефона и номер строки. (Пример: +1234567890)
Правила и описания
| Имя правила | Описание правила | Состояние | Действие правила | Пример понятного сообщения | Вызывается из (источник или запись в Microsoft Entra ID) |
|---|---|---|---|---|---|
| Внутренняя ошибка приложения | Произошла непредвиденная ошибка. | Катастрофическая ошибка | Останавливает выполнение данных | При попытке обработки произошла ошибка приложения: {error} | Подключение данных & управление данными |
| Файл не найден | Не удалось найти необходимый файл. | Катастрофическая ошибка | Останавливает выполнение данных | Не удалось найти {expectedFileName} в пути: {Path}. Пожалуйста, проверка путь к {Name}, чтобы убедиться, что {expectedFileName} существует или имя файла {expectedFileName} и выполните синхронизацию повторно. | Подключение данных |
| Операция отменена | Во время выполнения данных возникла проблема, которая требовала отмены. | Катастрофическая ошибка | Останавливает выполнение данных | Операция была отменена с сообщением: {cancelMessage} | Подключение данных |
| Заголовок не существует | Чтобы убедиться, что для обработки отправляется правильно отформатированный файл, содержащий определенные заголовки файлов. | Катастрофическая ошибка | Останавливает выполнение данных | Не удалось найти {expectedHeaderName} в {fileName}. Исправьте извлечение, чтобы добавить или убедиться, что он считывается как {expectedHeaderName}. Отправка исправленных файлов и повторное выполнение синхронизации. | Подключение данных |
| Дублированный столбец в заголовке | Чтобы убедиться, что для обработки отправляется правильно отформатированный файл, содержащий определенный заголовок файла, а не несколько одинаковых заголовков. | Катастрофическая ошибка | Останавливает выполнение данных | В {fileName}было найдено два или более {expectedHeaderName}. Выполните исправление извлечения, отправки исправленных файлов и повторного запуска синхронизации. | Подключение данных |
| Недопустимый формат файла | Если не поддерживаются файлы или папка присутствует в сжатом файле (ZIP). | Катастрофическая ошибка | Останавливает выполнение данных | Сбой проверки архива. Не поддерживаемый файл {fileInArchive}, найденный в архиве {archiveName}. | Подключение данных |
| Найдены повторяющиеся файлы | Если архив содержит файл, который также передается за пределы архива. Пример: users.csv и users.zip отправляются, а users.zip также содержит users.csv. | Катастрофическая ошибка | Останавливает выполнение данных | Сбой проверки архива. Дубликат {fileInArchive}, найденный в архиве {archiveName} и за пределами архива. | Подключение данных |
| Найден повторяющийся файл | При обнаружении повторяющихся файлов в нескольких архивах. Пример: users.zip и relationship.zip отправляются, а relationship.zip также содержит users.csv. | Катастрофическая ошибка | Останавливает выполнение данных | Сбой проверки архива. Дубликат {fileInArchive}, найденный в архивах {archiveName1}, {archiveName2}. | Подключение данных |
| Сопоставление перекрестных ссылок не найдено | Проверяет, найдены ли связанные данные по предоставленным связанным данным (например, отсутствует организация для пользователя, отсутствует раздел для регистраций). | Error | Удаляет запись из публикации | Не удалось найти запись {entityType} для {record} из источника [{fileName}/{apiEndPoint}]. Убедитесь, что {entityType} sourcedId и {record} sourcedId верны или обновите данные в исходной системе и выполните синхронизацию повторно. | Подключение данных & управление данными |
| Необязательное сопоставление перекрестных ссылок не найдено | Проверяет, найдены ли связанные данные по предоставленным связанным данным (например, отсутствует организация для пользователя, отсутствует раздел для регистраций). | Предупреждение | Удаляет значение из записи, отправляет запись для публикации | Для {record} обнаружено недопустимое необязательное ссылочного значения {value} в поле {field} для {entityType} и значение было удалено из записи для продолжения обработки. Убедитесь, что {entityType} sourcedId и {record} sourcedId являются правильными или обновите данные в исходной системе и выполните синхронизацию повторно. | Подключение данных |
| Ошибка формата даты и времени | Чтобы гарантировать, что передаваемые значения данных имеют правильный формат (ISO8601). | Error | Удаляет запись из публикации | {record} в {field} из источника [{fileName}/{apiEndPoint}] имеет дату, которая не имеет правильного формата: "ГГГГ-ММ-ДД". | Подключение данных & управление данными |
| Отсутствуют необходимые данные | Обнаружение отсутствующих значений в обязательном поле для записи. | Error | Удаляет запись из публикации | Для создания записи в имени поля отсутствует обязательное значение для {record}: {field} из источника [{fileName}/{apiEndPoint}]. | Подключение данных & управление данными |
| Ошибка форматирования значения | Чтобы данные, передаваемые в поле, соответствовали заданному формату. См. также правила сопоставления и проверки по типу данных. | Error | Удаляет запись из публикации | {record}, найденный в {field} из источника [{fileName}/{apiEndPoint}], не имеет правильно отформатированного значения для {field}. | Подключение данных & управление данными |
| Ошибка синтаксического анализа | Чтобы убедиться, что для каждой записи мы можем связать данные в правильном столбце. Записи могут быть помечены запятыми, найденными возвратами каретки или отсутствующими кавычками. | Error | Удаляет запись из публикации | Не удалось проанализировать [if api: {apiEndpoint}] из источника [{fileName}/{apiEndPoint}] для поиска данных в столбцах. Убедитесь, что разделитель в файле является одной запятой (,), а возврат каретки в полях запрещен. Поля, содержащие запятые и двойные кавычки, должны быть заключены в двойные кавычки. Если для заключения поля используются двойные кавычки, то двойная кавычка, появляющаяся внутри поля, должна быть экранирована путем его заполнения с помощью другой двойной кавычки. | Подключение данных |
| Ограничение максимальной длины поля нарушено | Чтобы гарантировать, что передаваемые данные не превышают длину поля, в результате чего отсутствуют данные. | Error | Удаляет запись из публикации | Значение, указанное для {field} в {record}, превышает максимальную поддерживаемую длину символов {length}. | Подключение данных |
| Недопустимый или отсутствующий ссылочный код | Определяет, не найдено ли ссылочного значения обязательного поля [Перечисление], передаваемого для записи для связывания записи. | Error | Удаляет запись из публикации | Значение {refValue} для {field} в {record} не найдено в {refCodeEntity}. Исправьте исходную систему. | Подключение данных |
| Недопустимый необязательный ссылочный код | Определяет, не найдено ли ссылочного значения дополнительного поля [Enum], передаваемого для записи для связывания записи. | Предупреждение | Удаляет значение из записи, отправляет запись для публикации | Значение {refValue} для {field} в {record} не найдено в {refCodeEntity}. Исправьте исходную систему. | Подключение данных |
| Необязательные данные отсутствуют соответствующее обязательное значение | Чтобы гарантировать, что если запись передает значение для необязательных данных, также передаются все дополнительные связанные данные, для которых теперь требуется значение. | Предупреждение | Удаляет значение из записи, отправляет запись для публикации | Значение было указано в необязательном поле для {record}, но отсутствует соответствующее значение в связанном поле для успешной публикации данных. | Подключение данных |
| Циклическая ссылка | Чтобы убедиться, что если запись имеет родительское сопоставление, циклическая ссылка не была предоставлена. | Предупреждение | Удаляет значение из записи, отправляет запись для публикации | {entityType} {entityId} связан в циклической ссылке с {entityType}(s) {entityList}. Значение для {entityParentIdField} будет удалено из записи, чтобы продолжить обработку. | Подключение данных |
| Идентификатор сопоставления пользователей не найден | Чтобы убедиться, что значение существует на основе настроенных правил удостоверений пользователей. | Error | Удалена запись из публикации | Идентификатор сопоставления пользователей {identifierType} не найден для пользователя {record}. | Подключение данных |
| Найдено сопоставление пользователей с несколькими совпадениями | Если обнаружено, что несколько учетных записей Microsoft Entra совпадают для этого пользователя, для сопоставления будет использоваться только первая учетная запись AAD. Дополнительные совпадения будут удалены. | Error | Удаляет вторичные записи из публикации | Пользователь {record} с идентификатором сопоставления {identifierType}={value} обнаружил несколько совпадений в Microsoft Entra ID. Будет использоваться только первое найденное совпадение, см. Microsoft Entra ObjectId {AadObjectId}. | Подключение данных |
| Найдены конфликтующие совпадения для сопоставления пользователей | Чтобы предотвратить автоматическое связывание другого пользователя с существующей и сопоставленной учетной записью Microsoft Entra. | Error | Удаляет запись из публикации | Пользователь {record} с идентификатором сопоставления {identifierType}={value} сопоставляется с существующим сопоставленным Microsoft Entra ObjectId {AadObjectId}. Будет использовано существующее совпадение, которое будет пропущено. | Подключение данных |
| Сопоставление пользователей с Microsoft Entra ID не найдено | Уведомляет о том, что указанная пользовательская запись не смогла найти совпадение с пользователем Microsoft Entra на основе настроенных правил сопоставления или идентифицировать пользователя. | Предупреждение | Запись не соответствует Microsoft Entra ID | Пользователь {record} с идентификатором сопоставления {identifierType}={value} не был сопоставлен с пользователем Microsoft Entra. Это может быть связано с неправильным значением из исходной системы на основе настроенных правил удостоверений пользователей или синхронизация Azure Active Directory еще не добавила пользователя до последнего запуска. | Подключение данных |
| Отсутствует ассоциация пользователей | Уведомляет о том, что запись пользователя предоставлена, но не связана как роль учащегося или сотрудника с организацией или роль контакта с учащимся. | Предупреждение | Удаляет запись из публикации | У пользователя {record} из источника [{fileName}/{apiEndPoint}] отсутствуют данные ассоциации "Организация & роли" или "Связь с контактами". Если это допустимый пользователь, обновите исходные данные, чтобы предоставить соответствующие связи с организацией & роли или связи контактов. | Подключение данных |
| Основная роль не указана | Уведомляет о том, что пользователю предоставлено несколько записей ролей, но одна из них не помечена как основная роль. | Предупреждение | Запись добавляется как полученная | Найдено несколько записей ролей из источника [{fileName}/{apiEndPoint}] для пользователя {record} без обозначения одной из ролей в качестве основной роли для одной организации. Рекомендуется указать одну из ролей этого пользователя в качестве основной из источника. | Подключение данных |
| Указано несколько основных ролей | Уведомляет о том, что предоставлено несколько записей ролей, а несколько помечаются как основная роль | Предупреждение | Запись добавляется как полученная | Найдено несколько записей ролей из источника [{fileName}/{apiEndPoint}] для пользователя {record} и определено как основная роль для одной организации. Рекомендуется указать одну из ролей этого пользователя в качестве основной из источника. | Подключение данных |
| Связь с отсутствующими группами ролей для роли пользователя | Определяет, что пользователю была предоставлена допустимая роль, но роль не связана с группой ролей, так как не уверена, какие правила сопоставления следует использовать. | Error | Удаляет запись из публикации | Пользователь {record} из источника [{fileName}/{apiEndPoint}] связан с допустимой ролью {value}, но роль не связана с группой ролей. Необходимо обновить список значений, чтобы связать {value} с группой ролей. | Подключение данных |
| Общая ошибка после публикации данных | При отправке записи была возвращена ошибка. | Error | Удаляет запись из публикации | Не удалось добавить {record} из-за {error}. Пожалуйста, проверка или обновите исходную систему для исправления. | Подключение данных |
| Ошибка формата имени участника-пользователя | Уведомляет о том, что используемое или созданное имя субъекта-пользователя неправильно отформатировано в соответствии с требованиями Microsoft Entra. | Error | Запись не размещена в Microsoft Entra ID | Пользовательская запись: {record} не имеет правильно отформатированного имени участника-пользователя: {value} для создания объекта пользователя в Microsoft Entra ID. Исправьте данные для записи этого пользователя в исходной системе на основе полей, выбранных для конфигурации имени пользователя. | Управление данными |
| Microsoft Entra недопустимое значение свойства | Уведомления о том, почему при попытке записи в Microsoft Entra ID | Error | Запись не размещена в Microsoft Entra ID | Не удается создать или обновить {record} в Active Directory из-за одного или нескольких недопустимых свойств. Проверьте значения {record} в {field}, чтобы убедиться, что они содержат только буквы и пробелы и менее 256 символов. Исправьте данные в исходной системе или активируйте параметр Заменить специальные символы в {FlowName}. | Управление данными |
| Отсутствует зависимая лицензия | Уведомляет о том, что зависимая лицензия не назначена записи. | Error | Запись не размещена в Microsoft Entra ID | Зависимая лицензия в настоящее время не назначается {record}. Например, для лицензии Classroom требуется, чтобы у {record} уже была лицензия на Exchange Online и SharePoint Online. Для решения этой проблемы назначьте зависимую лицензию и повторно выполните синхронизацию. | Управление данными |
| Нет доступных лицензий | Уведомляет о том, что не было лицензий для назначения пользователю. | Error | Запись не лицензирована | Не удалось назначить лицензию {record}. Срок действия лицензии истек или исчерпан (все доступные лицензии этого типа назначены). Исправление путем добавления дополнительных лицензий {licenseType} и повторного запуска синхронизации. | Управление данными |
| Не удается удалить последнего владельца группы | Уведомляет о том, что для существующей синхронизированной группы классов группы нет записей владельца. | Error | Запись, не удаленная из Microsoft Entra ID | {record} не удалось удалить из {teamsType}, так как {teamsType} должен иметь хотя бы одного владельца. Пожалуйста, проверка или обновите данные в исходной системе или проверка выбор фильтра, чтобы убедиться, что назначен хотя бы один владелец. | Управление данными |
| Превышен размер ресурса | Уведомляет запись о слишком большом количестве связей организаций. | Error | Запись не размещена в Microsoft Entra ID | {record} назначен слишком много школ (более 30). Удалите членство {record} из учебных заведений, которые больше не нужны. | Управление данными |
| Повторяющиеся целевые записи | Уведомляет о наличии двух или более записей с одинаковым sourceId в Microsoft Entra ID. | Error | Запись не размещена в Microsoft Entra ID | Существует две или более записей с одинаковым sourcedId для {record} в Active Directory. Определите и удалите неправильное удостоверение. | Управление данными |
| Совпадение Microsoft Entra не найдено | Уведомляет о том, что не удалось добавить ссылку из источника в Microsoft Entra ID, так как целевой объект не найден в Microsoft Entra ID. | Error | Запись, не связанная с Microsoft Entra ID | Не удается обновить {record}, так как соответствующая запись в Active Directory не найдена. Проверьте критерии соответствия удостоверений для входящего потока. | Управление данными |
| Существующий объект найден | Уведомляет, что ссылка для того же sourceId в Microsoft Entra ID уже найдена. | Error | Запись не размещена в Microsoft Entra ID | {record} для {entityType} уже был создан в прошлом с тем же sourcedId. Удалите или удалите старый {entityType}. | Управление данными |
| Недопустимый формат имени участника | Уведомляет о том, что не удалось добавить ссылку из-за неожиданного формата, найденного в создаваемом имени субъекта-пользователя. | Error | Запись, не связанная с Microsoft Entra ID | Не удается обновить {record}, так как соответствующая запись в Active Directory не найдена. Формат имени участника-пользователя непредвиден. | Управление данными |
| Не удается синхронизировать локальные объекты, принадлежащие | Уведомляет клиента, использующий синхронизацию Azure Active Directory из локальной среды в клиент Microsoft 365, что изменение, отображаемое для значения пользователя в AAD, не будет обновлено из исходных данных. | Error | Запись не размещена в Microsoft Entra ID | Не удается обновить свойства (например, имя) для {record}, который синхронизируется из локальной службы Active Directory. Сначала внесите изменения в локальную службу Active Directory. | Управление данными |
| Повторяющиеся идентификаторы группы безопасности | Уведомляет клиента о том, что после удаления специальных символов, которые не разрешены в Microsoft Entra ID и не могут создать дополнительную группу безопасности, был создан дубликат идентификатора группы безопасности. | Error | Запись не размещена в Microsoft Entra ID | Несколько групп безопасности имеют повторяющиеся значения идентификаторов {identifierSource} после удаления специальных символов для org sourcedId: {identifierValue}. | Управление данными |