동기화 상태 및 모니터링

홈 dashboard

데이터 처리 중에 SDS(School Data Sync)는 데이터 레이크에 좋은 데이터를 가져오고 잘못된 데이터에 플래그를 지정하여 데이터의 유효성을 검사합니다. 각 동기화 실행이 끝나면 상태 및 모니터링을 지원하기 위해 통계가 생성됩니다.

데이터의 상태를 확인하기 위해 는 데이터 일치 및 유효성 검사 규칙을 통해 전달되어 데이터 레이크로만 들어가는 좋은 필수 및 선택적 데이터를 보호할 수 있습니다. 유효성 검사를 통과하지 않는 데이터는 오류 또는 경고로 식별되며 데이터 레이크로 전송되지 않습니다.

오류 또는 경고가 발견되지 않은 경우 실행 결과는 완료됨입니다. 홈 dashboard "데이터 오류 또는 경고를 찾을 수 없음"과 "마지막 실행 중에 데이터 오류 또는 경고가 발생하지 않았습니다. 훌륭한 일을 계속하세요!"

오류 및 경고가 발견되면 실행 결과는 오류와 함께 완료됩니다.

• 필요한 데이터에 대한 레코드의 값이 데이터 일치 및 유효성 검사 규칙을 통과하지 못한 경우 오류가 발생합니다. 레코드가 제거되고 데이터 레이크로 전송되지 않았습니다.

경고만 발견되면 실행 결과는 경고와 함께 완료됩니다.

• 선택적 데이터에 대한 레코드의 값이 데이터 일치 및 유효성 검사 규칙을 통과하지 못한 경우 경고가 발생합니다. 값이 제거되었지만 레코드가 데이터 레이크로 전송되었습니다.

홈 대시보드는 '데이터에 몇 가지 문제가 발견되었습니다'라고 알리고 동기화 상태를 조사하도록 권장합니다. 동기화 실행 결과에 대한 자세한 내용은 동기화 상태 조사를 선택합니다.

동기화 상태

동기화 상태는 동기화된 데이터의 상태를 더 잘 이해하고 데이터 조사를 지원하는 데 도움이 되는 도구입니다.

데이터에 대한 변경 내용은 가장 최근 동기화 실행의 데이터 변경 내용에 따라 발생합니다.

동기화 실행은 데이터 연결 및 관리 구성을 모두 시퀀싱하는 것입니다.

동기화 상태는 또한 최근 14개 실행의 기록 표현을 제공합니다.

• 실행 시작: 전체 실행이 시작될 때 타임스탬프를 찍습니다.
• 실행 종료: 전체 실행이 종료된 경우 타임스탬프를 찍습니다.
• 상태 실행: 모든 데이터 흐름에서 전체 상태
  • 실행 중: 적극적으로 실행 중
  • 완료됨: 오류 또는 경고 없이 완료됨
  • 오류로 완료됨: 완료되었지만 오류가 발견됨
  • 경고 완료: 완료되었지만 경고만 발견됨
  • 실패: 시스템 또는 고객에 의해 실행이 취소됨

플래그가 지정된 데이터를 조사하려면 보고서 다운로드 를 선택하여 보고서의 복사본을 검색할 수 있습니다.

보고서의 형식은 다음과 같습니다.

열 이름	설명	예제
규칙	유효성 검사 규칙의 표현	RequiredDataViolated
ExternalIdentifier	원본 시스템에서 관련 엔터티의 외부/원본 ID	7B2C8A0B33-F7E5-460B-993A-7257165430F7
심각도	플래그가 지정된 데이터의 심각도 표현	유효성 검사 오류, 유효성 검사 경고
EntityCode	오류와 관련된 영역 표현	개인, 조직, 등록
FriendlyMessage	오류 및 경고 메시지 기반	레코드를 만들기 위한 원본 [{fileName}/{apiEndPoint}]의 {field} 필드 이름에 {record}에 필요한 값이 없습니다.
FlowName	인바운드 또는 아웃바운드 흐름의 이름	OneRoster API 인바운드
SourceSystemName	레코드가 발생한 원본의 이름	Contoso SIS
시간	데이터/처리 중 레코드가 식별된 시간(UTC)입니다.	2023-08-21T02:53:00Z

• 데이터 일치 및 유효성 검사 규칙에 대한 자세한 내용은 유효성 검사 규칙 및 설명을 참조하세요.
• 지원되는 기본 값 목록에 대한 자세한 내용은 기본값 목록을 참조하세요.
• familyName, givenName 및 메일은 연락처/보호자 역할이 있는 사용자에게 필요합니다.
• 전화 및 SMS가 E.164에 있고 +가 포함되어야 합니다. (예: +1234567890)

팁

원본 데이터를 업데이트하기 위해 첫 번째 실행 후 변경 내용을 수동으로 업로드하려면 SDS v2.1 CSV를 사용하여 원본 데이터 업데이트를 참조하세요.

경고

해당 실행이 있는 최대 업로드 수는 달력 일당 6회입니다. 그런 다음 업로드하는 경우 12시간마다 SDS 자동화된 실행 주기를 기반으로 최대 2회까지만 실행됩니다.

수정을 위한 오류 우선 순위 지정

오류를 해결할 때 다른 오류 문제를 해결하기 전에 동일한 엔터티 코드에 대한 대부분의 인스턴스를 사용하여 유효성 검사 오류의 우선 순위를 지정하는 것이 좋습니다.

유효성 검사 오류로 인해 동일한 데이터 실행 내의 각 instance 대한 수많은 후속 오류가 발생할 수 있습니다. 종종 이러한 유효성 검사 오류를 수정하면 유효성 검사 중에 발견된 많은 명단 관련 오류를 먼저 수정합니다.

동기화 상태 보기 세부 정보

실행에서 통계를 보려면 세부 정보 보기를 선택하여 플라이아웃을 열어 실행 세부 정보를 확인할 수 있습니다. 실행의 통계는 개요 탭에 표시됩니다.

오류 및 경고가 발생한 단계를 더 잘 이해하려면 단계 탭을 선택합니다. 정보는 사용하도록 설정된 데이터 구성 관리에 따라 다음 단계로 나뉩니다.

• 기관 데이터

• Microsoft 365 사용자

• Microsoft 365 그룹

• Microsoft IT 그룹

• 최신 상태

  • 완료됨: 오류 또는 경고 없이 완료됨
  • 오류로 완료됨: 완료되었지만 오류가 발견됨
  • 경고와 함께 완료됨: 완료되었지만 경고만 발견됨
  • 실패: 시스템 또는 고객에 의해 실행이 취소됨

참고

자세한 내용은 실행 세부 정보에 있는 통계에 대한 기관 및 실행 통계를 참조 하세요.

SDS에서 데이터가 있는지 확인하고 활성 상태 설정하는 방법

참고

Academic Year 구성에 대한 자세한 내용은 Academic Year 처리를 참조하세요.

세션에 대한 사용자의 연결(예: 학년도)은 organization 연결된 역할을 기반으로 합니다.

클래스에 대한 사용자의 연결은 세션에 대한 링크도 포함하는 등록에 연결된 역할을 기반으로 합니다.

연결된 데이터에 따라 이러한 규칙은 데이터 저장소에서 레코드 및 해당 세션 상태 대한 인식을 확인하는 데 사용됩니다.

• 데이터는 새 레코드가 처음으로 표시되는 시기를 반영합니다.
  • SDS는 처음 표시된 날짜(시간) 및 마지막으로 수정한 날짜(시간)를 현재 날짜로 설정하고, 적절한 경우 레코드를 "세션에서 활성 상태"로 표시하여 true로 표시합니다.
• 데이터는 후속 실행에 동일한 레코드가 있을 때 반영됩니다.
  • SDS는 처음 표시된 날짜(시간) 값을 유지하고, 마지막으로 수정한 날짜(시간)를 현재로 설정하고, "세션에서 활성 상태"를 true로 둡니다.
• 데이터는 동일한 레코드가 후속 실행에 없을 때 반영됩니다.
  • SDS는 처음 표시된 날짜(시간) 및 마지막으로 수정한 날짜(시간) 값을 유지하고 적절한 경우 레코드를 "세션에서 활성 상태"로 false로 표시합니다.
    • 조직, 사용자(사용자) 및 세션 레코드가 시간이 지남에 따라 유지되고 비활성화되지 않을 때 예외가 발생합니다.
    • "비활성화됨"에 대한 롤링 업데이트가 있습니다. 예를 들어 사용자 레코드가 없는 경우 시스템은 기존 처음 본 날짜(시간) 및 마지막으로 수정한 날짜(시간) 값을 유지합니다. 시스템은 사용자의 조직/역할 및 등록 레코드에 대해 "세션에서 활성 상태"를 false로 설정합니다.

참고

데이터 처리에 대한 자세한 내용은 SDS의 유효성 검사 및 데이터 상태 개요를 참조하세요.