유효성 검사 규칙 및 설명
데이터 형식별 일치 및 유효성 검사 규칙
| 데이터 형식 | 일치 규칙 | 유효성 검사 규칙 | 저장 값 |
|---|---|---|---|
| 고유 ID * | 대 / 소문자 | 받은 대로 | |
| 열거형** | 대/소문자를 구분하지 않습니다. | 소문자 일치 | CamelCase로 |
| String | 대 / 소문자 | 받은 대로 | |
| 전자 메일 | 소문자를 낮추려면 | RFC 5532(3.4.1) | 소문자를 낮추려면 |
| Date 또는 DateTime | ISO8601 | ISO8601 | ISO8601 |
| Phone | E.164 | E.164 | 받은 대로 |
| 부울 | 대/소문자를 구분하지 않습니다. | 'true' 또는 'false'에 일치 | 소문자를 낮추려면 |
*레코드는 모든 레코드에서 고유합니다. 전역적으로 고유한 식별자이지만 UUID(유니버설 고유 식별자) 형식을 사용할 수도 있거나 그렇지 않을 수도 있습니다.
** 학년 수준 ENUM의 들어오는 값(예: '1')에 누락된 선행 0은 정의된 값 목록(ENUM) '01'과 일치하며 '01'로 저장됩니다.
** 기본 ENUM 값에 대한 자세한 내용은 기본값 목록을 참조하세요.
전화 및 sms 필드는 더하기 문자가 전화 번호로 사용되고 성공하는 E.164 표준에 따라 서식이 지정되거나 국가 코드, 지역 코드, 전화 접두사 및 줄 번호가 뒤따르는 더하기 문자가 필요합니다. (예: +1234567890)
규칙 및 설명
| 규칙 이름 | 규칙 설명 | 상태 | 규칙 작업 | 친숙한 메시지 예제 | 에서 발생(원본 또는 쓰기에서 Microsoft Entra ID) |
|---|---|---|---|---|---|
| 내부 애플리케이션 오류 | 예기치 않은 오류가 발생했습니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | 처리하려고 할 때 애플리케이션 오류가 발생했습니다. {error} | 데이터 연결 & 데이터 관리 |
| 파일을 찾을 수 없음 | 필요한 파일을 찾을 수 없습니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | 경로에서 {expectedFileName}을(를) 찾을 수 없습니다. {Path}. {name}의 경로를 검사 {expectedFileName}이 있거나 파일 이름이 {expectedFileName}이고 동기화를 다시 실행해야 합니다. | 데이터 연결 |
| 작업 취소됨 | 데이터를 실행하는 동안 취소해야 하는 문제가 발생했습니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | {cancelMessage} 메시지와 함께 작업이 취소되었습니다. | 데이터 연결 |
| 헤더가 없습니다. | 정의된 파일 헤더를 포함하는 처리를 위해 올바르게 형식이 지정된 파일이 전송되는지 확인합니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | {fileName}에서 {expectedHeaderName}을(를) 찾을 수 없습니다. 추출을 수정하여 {expectedHeaderName}으로 읽거나 추가해야 합니다. 수정된 파일을 업로드하고 동기화를 다시 실행합니다. | 데이터 연결 |
| 헤더의 중복 열 | 동일한 헤더의 배수가 아닌 정의된 파일 헤더를 포함하는 처리를 위해 올바르게 형식이 지정된 파일이 전송되는지 확인합니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | {fileName}에서 둘 이상의 {expectedHeaderName}이(가) 발견되었습니다. 추출을 수정하고, 수정된 파일을 업로드하고, 동기화를 다시 실행하세요. | 데이터 연결 |
| 잘못된 파일 형식 | 지원되지 않는 파일 또는 폴더가 압축된 파일(zip)에 있는 경우 | 치명적인 오류 | 데이터 실행을 중지합니다. | 보관 유효성 검사에 실패했습니다. {archiveName}보관에 지원되지 않는 파일 {fileInArchive}이(가) 있습니다. | 데이터 연결 |
| 중복 파일을 찾습니다. | 보관 파일에 외부 보관 파일도 업로드되는 경우 예: users.csv 및 users.zip 업로드되고 users.zip users.csv 포함합니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | 보관 유효성 검사에 실패했습니다. 보관 {archiveName} 및 외부 보관에 있는 {fileInArchive}를 복제합니다. | 데이터 연결 |
| 중복 파일이 발견되었습니다. | 중복 파일이 여러 보관 파일에 있는 경우 예: users.zip 및 relationship.zip 업로드되고 relationship.zip users.csv 포함합니다. | 치명적인 오류 | 데이터 실행을 중지합니다. | 보관 유효성 검사에 실패했습니다. 보관 파일 {archiveName1}, {archiveName2}에 있는 중복 {fileInArchive}입니다. | 데이터 연결 |
| 상호 참조 매핑을 찾을 수 없음 | 제공 중인 연결된 데이터에서 연결된 데이터가 있는지 확인합니다(예: 사용자에 대한 organization 누락, 등록 섹션 누락). | 오류 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]에서 {record}에 대한 {entityType} 레코드를 찾을 수 없습니다. {entityType} sourcedId 및 {record} sourcedId가 올바른지 확인하거나 원본 시스템에서 데이터를 업데이트하고 동기화를 다시 실행합니다. | 데이터 연결 & 데이터 관리 |
| 선택적 상호 참조 매핑을 찾을 수 없음 | 제공 중인 연결된 데이터에서 연결된 데이터가 있는지 확인합니다(예: 사용자에 대한 organization 누락, 등록 섹션 누락). | 경고 | 레코드에서 값을 제거하고 게시할 레코드를 보냅니다. | {entityType}에 대한 {field} 필드의 선택적 참조 값 {value}이(가) {record}에 대해 잘못되었으며 처리를 진행하기 위해 레코드에서 값이 삭제되었습니다. {entityType} sourcedId 및 {record} sourcedId가 올바른지 확인하거나 원본 시스템에서 데이터를 업데이트하고 동기화를 다시 실행합니다. | 데이터 연결 |
| 날짜 시간 형식 오류 | 전달되는 데이터 값이 적절한 형식(ISO8601)되도록 합니다. | 오류 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]의 {field}에 있는 {record}에는 'YYYY-MM-DD' 형식이 아닌 날짜가 있습니다. | 데이터 연결 & 데이터 관리 |
| 누락된 필수 데이터 | 레코드에 필요한 필드에서 누락된 값을 검색하려면 | 오류 | 게시에서 레코드를 제거합니다. | 레코드를 만들기 위한 원본 [{fileName}/{apiEndPoint}]의 {field} 필드 이름에 {record}에 필요한 값이 없습니다. | 데이터 연결 & 데이터 관리 |
| 형식 값 오류 | 필드에 전달되는 데이터가 정의된 서식과 일치하는지 확인합니다. 데이터 형식별 일치 및 유효성 검사 규칙도 참조하세요. | 오류 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]의 {field}에 있는 {record}에는 {field}에 대한 적절한 형식의 값이 없습니다. | 데이터 연결 & 데이터 관리 |
| 구문 분석 오류 | 각 레코드에 대해 올바른 열의 데이터를 연결할 수 있습니다. 레코드는 단일 쉼표, 캐리지 리턴이 찾거나 따옴표가 누락되어 플래그가 지정될 수 있습니다. | 오류 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]에서 [if apiEndpoint}]를 구문 분석하여 열에서 데이터를 찾을 수 없습니다. 파일의 구분 기호가 단일 쉼표(,)이고 필드의 캐리지 반환이 허용되지 않는지 확인합니다. 쉼표와 큰따옴표를 포함하는 필드는 큰따옴표로 묶어야 합니다. 큰따옴표를 사용하여 필드를 묶는 경우 필드 내부에 나타나는 큰따옴표는 다른 큰따옴표와 함께 선행하여 이스케이프되어야 합니다. | 데이터 연결 |
| 최대 필드 길이 제약 조건을 위반했습니다. | 전달되는 데이터가 필드 길이를 초과하지 않도록 하여 데이터가 누락되도록 합니다. | 오류 | 게시에서 레코드를 제거합니다. | {record}의 {field}에 제공된 값이 지원되는 최대 {length} 문자 길이를 초과합니다. | 데이터 연결 |
| 잘못되었거나 누락된 참조 코드 | 레코드에 대해 전달되는 필수 필드의 참조 값 [열거형]을 찾을 수 없으면 레코드를 연결할 수 없는지 식별합니다. | 오류 | 게시에서 레코드를 제거합니다. | {record}의 {field}에 대한 {refValue} 값은 {refCodeEntity}에 없습니다. 원본 시스템을 수정하세요. | 데이터 연결 |
| 잘못된 선택적 참조 코드 | 레코드에 대해 전달되는 선택적 필드의 참조 값 [열거형]이 레코드를 연결할 수 없는지 식별합니다. | 경고 | 레코드에서 값을 제거하고 게시할 레코드를 보냅니다. | {record}의 {field}에 대한 {refValue} 값은 {refCodeEntity}에 없습니다. 원본 시스템을 수정하세요. | 데이터 연결 |
| 필요한 값이 누락된 선택적 데이터 | 레코드가 선택적 데이터에 대한 값을 전달하는 경우 현재 값이 필요한 추가 관련 데이터도 제공되고 있는지 확인합니다. | 경고 | 레코드에서 값을 제거하고 게시할 레코드를 보냅니다. | 값이 {record}에 대한 선택적 필드에 제공되었지만 데이터를 성공적으로 게시하기 위해 연결된 필드에 해당 값이 없습니다. | 데이터 연결 |
| 순환 참조 | 레코드에 부모 연결이 있는 경우 순환 참조가 제공되지 않았는지 확인합니다. | 경고 | 레코드에서 값을 제거하고 게시할 레코드를 보냅니다. | {entityType} {entityId}는 {entityType}(s) {entityList}를 사용하여 순환 참조에 연결됩니다. {entityParentIdField}의 값은 처리를 진행하기 위해 레코드에서 삭제됩니다. | 데이터 연결 |
| 사용자 매핑 식별자를 찾을 수 없음 | 구성된 사용자 ID 규칙에 따라 값이 있는지 확인합니다. | 오류 | 게시에서 레코드가 제거됨 | 사용자 {record}에 대한 사용자 매핑 식별자 {identifierType}을(를) 찾을 수 없습니다. | 데이터 연결 |
| 사용자 매핑 여러 일치 항목 발견 | 여러 Microsoft Entra 계정이 이 사용자와 일치하는 것으로 확인되면 첫 번째 AAD 계정만 일치에 사용됩니다. 추가 일치 항목이 삭제됩니다. | 오류 | 게시에서 보조 레코드를 제거합니다. | 매핑 식별자가 {identifierType}={value}인 사용자 {record}는 Microsoft Entra ID 여러 일치 항목을 찾았습니다. 발견된 첫 번째 일치 항목만 사용됩니다. Microsoft Entra ObjectId {AadObjectId}를 참조하세요. | 데이터 연결 |
| 사용자 매핑 충돌 일치 항목 발견 | 다른 사용자가 기존 및 일치하는 Microsoft Entra 계정에 자동으로 연결되지 않도록 합니다. | 오류 | 게시에서 레코드를 제거합니다. | 매핑 식별자가 {identifierType}={value}인 사용자 {record}는 ObjectId {AadObjectId}에 매핑된 기존 Microsoft Entra 일치합니다. 찾은 기존 일치 항목이 사용되며 이 일치 항목은 건너뜁습니다. | 데이터 연결 |
| 사용자 일치를 Microsoft Entra ID 찾을 수 없음 | 제공된 사용자 레코드가 사용자/구성된 일치 규칙을 기반으로 Microsoft Entra 사용자와 일치하는 항목을 찾을 수 없음을 알릴 수 없습니다. | 경고 | 레코드가 Microsoft Entra ID 일치하지 않음 | 매핑 식별자가 {identifierType}={value}인 사용자 {record}이(가) Microsoft Entra User와 일치하지 않았습니다. 이는 제공된 값이 구성된 사용자 ID 규칙에 따라 원본 시스템에서 올바르지 않거나 Azure Active Directory Sync가 최신 실행 전에 사용자를 아직 추가하지 않은 것일 수 있습니다. | 데이터 연결 |
| 누락된 사용자 연결 | 사용자 레코드가 제공되었지만 학생 또는 교직원 역할로 organization 또는 학생에게 문의 역할에 연결되지 않음을 알 수 있습니다. | 경고 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]의 사용자 {record}에 조직 & 역할 연결 데이터 또는 연락처 관계 연결 데이터가 없습니다. 유효한 사용자인 경우 원본 데이터를 업데이트하여 적절한 조직 & 역할 또는 연락처 관계 연결을 제공하세요. | 데이터 연결 |
| 기본 역할이 지정되지 않음 | 사용자에 대해 여러 역할 레코드가 제공되지만 그 중 하나가 기본 역할로 표시되지 않음을 알 수 있습니다. | 경고 | 레코드가 수신됨으로 추가됨 | 사용자 {record}에 대한 원본 [{fileName}/{apiEndPoint}]의 여러 역할 레코드가 동일한 organization 대한 기본 역할로 역할 중 하나를 표시하지 않고 발견되었습니다. 원본에서 이 사용자의 역할 중 하나를 기본으로 지정하는 것이 좋습니다. | 데이터 연결 |
| 지정된 여러 기본 역할 | 여러 역할 레코드가 제공되고 여러 역할이 기본 역할로 표시됨을 알 수 있습니다. | 경고 | 레코드가 수신됨으로 추가됨 | 사용자 {record}에 대한 원본 [{fileName}/{apiEndPoint}]의 여러 역할 레코드가 발견되어 동일한 organization 대한 기본 역할로 정의되었습니다. 원본에서 이 사용자의 역할 중 하나를 기본으로 지정하는 것이 좋습니다. | 데이터 연결 |
| 사용자 역할 누락 역할 그룹 연결 | 사용자의 역할이 유효한 역할을 제공했지만 역할 그룹에 연결되지 않은 것을 식별합니다. 따라서 어떤 일치 규칙을 사용해야 하는지 확실하지 않습니다. | 오류 | 게시에서 레코드를 제거합니다. | 원본 [{fileName}/{apiEndPoint}]의 사용자 {record}은(는) 유효한 역할 {value}에 연결되지만 역할은 역할 그룹에 연결되지 않습니다. {value}를 역할 그룹에 연결하려면 값 목록을 업데이트해야 합니다. | 데이터 연결 |
| 일반 사후 데이터 오류 | 레코드를 제출할 때 오류가 반환되었습니다. | 오류 | 게시에서 레코드를 제거합니다. | {error}로 인해 {record}을(를) 추가할 수 없습니다. 원본 시스템을 검사 수정하도록 업데이트하세요. | 데이터 연결 |
| UPN 형식 오류 | 사용하거나 생성한 사용자 계정 이름이 Microsoft Entra 요구 사항을 충족하기 위해 올바르게 형식이 지정되지 않았다는 것을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | 사용자 레코드: {record}에는 Microsoft Entra ID 사용자 개체를 만들기 위한 올바른 형식의 사용자 계정 이름{value}이(가) 없습니다. 사용자 이름 구성에 대해 선택한 필드를 기반으로 원본 시스템에서 이 사용자의 레코드에 대한 데이터를 수정하세요. | 데이터 관리 |
| 잘못된 속성 값 Microsoft Entra | Microsoft Entra ID 쓰기를 시도하는 이유에 잘못된 문자가 표시됨을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | 하나 이상의 잘못된 속성으로 인해 Active Directory에서 {record}를 만들거나 업데이트할 수 없습니다. {field}의 {record}에 대한 값을 확인하여 알파 숫자 문자만 포함하고 공백이 없고 256자 미만인지 확인합니다. 원본 시스템의 데이터를 수정하거나 {FlowName}의 특수 문자 바꾸기 설정을 활성화하세요. | 데이터 관리 |
| 종속 라이선스 누락 | 종속 라이선스가 레코드에 할당되지 않았음을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | 종속 라이선스는 현재 {record}에 할당되지 않습니다. 예를 들어 클래스룸 라이선스를 사용하려면 {record}에 이미 Exchange Online 및 SharePoint Online에 대한 라이선스가 있어야 합니다. 종속 라이선스를 할당하고 동기화를 다시 실행하여 이 문제를 해결합니다. | 데이터 관리 |
| 사용 가능한 라이선스 없음 | 사용자에게 할당할 라이선스가 없음을 알 수 있습니다. | 오류 | 사용이 허가되지 않은 레코드 | {record}에 라이선스를 할당하지 못했습니다. 라이선스가 만료되었거나 모두 사용되었습니다(이 유형의 사용 가능한 모든 라이선스가 할당됨). {licenseType}의 라이선스를 더 추가하고 동기화를 다시 실행하여 수정합니다. | 데이터 관리 |
| 그룹의 마지막 소유자를 제거할 수 없음 | 동기화된 기존 팀 클래스 그룹에 대한 소유자 레코드가 없음을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 제거되지 않음 | {teamsType}에 하나 이상의 소유자가 있어야 하므로 {teamsType}에서 {record}을(를) 제거할 수 없습니다. 하나 이상의 소유자가 할당되었는지 확인하려면 원본 시스템에서 데이터를 검사 업데이트하거나 필터 선택을 검사. | 데이터 관리 |
| 리소스 크기를 초과했습니다. | 레코드에 조직 연결이 너무 많다는 것을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | {record}이(가) 너무 많은 학교(30개 이상)에 할당되었습니다. 더 이상 필요하지 않은 학교에서 {record}의 멤버 자격을 제거하세요. | 데이터 관리 |
| 중복 대상 항목 | Microsoft Entra ID 동일한 sourceId를 사용하여 두 개 이상의 레코드가 존재한다는 것을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | Active Directory에서 {record}에 대해 동일한 sourcedId를 가진 두 개 이상의 레코드가 있습니다. 잘못된 ID를 식별하고 제거하세요. | 데이터 관리 |
| Microsoft Entra 일치 항목을 찾을 수 없음 | 대상을 Microsoft Entra ID 찾을 수 없으므로 원본에서 Microsoft Entra ID 링크를 추가할 수 없음을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 연결되지 않음 | Active Directory에서 일치하는 항목을 찾을 수 없기 때문에 {record}을(를) 업데이트할 수 없습니다. 인바운드 흐름에 대한 ID 일치 조건을 확인합니다. | 데이터 관리 |
| 기존 개체가 발견되었습니다. | Microsoft Entra ID 동일한 sourceId에 대한 링크가 이미 있음을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | {entityType}에 대한 {record}은(는) 이전에 동일한 sourcedId를 사용하여 이미 만들어졌습니다. 이전 {entityType}을(를) 사용 중지하거나 제거하세요. | 데이터 관리 |
| 잘못된 보안 주체 이름 형식 | 생성 중인 사용자 계정 이름에서 예기치 않은 형식이 발견되어 링크를 추가할 수 없음을 알 수 있습니다. | 오류 | 레코드가 Microsoft Entra ID 연결되지 않음 | Active Directory에서 일치하는 항목을 찾을 수 없기 때문에 {record}을(를) 업데이트할 수 없습니다. 사용자 계정 이름의 형식이 예기치 않은 경우 | 데이터 관리 |
| 온-프레미스 소유 개체를 동기화할 수 없습니다. | 테넌트가 온-프레미스에서 Microsoft 365 테넌트로 Azure Active Directory 동기화를 사용하고 있음을 알리며, AAD의 사용자 값에 대해 표시되는 변경 내용은 원본 데이터에서 업데이트되지 않습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | 온-프레미스 Active Directory에서 동기화되는 {record}의 속성(예: 이름)을 업데이트할 수 없습니다. 먼저 온-프레미스 Active Directory를 변경하세요. | 데이터 관리 |
| 중복 보안 그룹 ID | Microsoft Entra ID 허용되지 않고 추가 보안 그룹을 만들 수 없는 특수 문자를 제거한 후 중복 보안 그룹 ID가 생성되었음을 테넌트에게 알렸습니다. | 오류 | 레코드가 Microsoft Entra ID 게시되지 않음 | org sourcedId: {identifierValue}에 대해 특수 문자가 제거된 후 여러 보안 그룹에 중복 식별자 값 {identifierSource}이(가) 있습니다. | 데이터 관리 |