원로스터 CSV
설명
ManageBac+는 관리자가 OneRoster 1.2 표준 의 ManageBac+ 버전을 사용하여 사용자, 수업, 등록 및 관련 데이터를 가져오고 내보낼 수 있도록 지원합니다 . 이 기능은 설정 > 데이터 교환 에서 이용할 수 있으며, 가져오기 전에 데이터의 정확성을 확인하는 유효성 검사 보고서가 포함되어 있습니다.
OneRoster 표준은 IMS 글로벌 학습 컨소시엄 에서 개발 및 유지 관리하며 , 이러한 데이터 교환을 위한 프레임워크를 제공합니다. 기술 구현에 대한 설명은 다음 링크에서 확인할 수 있습니다.
ManageBac+ OneRoster 1.2 CSV 사용자 지정 사양
수출
ManageBac+ 에서 내보내기란 시스템의 데이터를 외부 형식으로 전송하는 프로세스를 의미하며, 이를 통해 사용자는 정보를 공유, 백업 또는 다른 시스템과 통합할 수 있습니다.
내보내기를 시작하려면 데이터 교환 관리자에서 내보내기 탭으로 이동하십시오.
'2단계 - 모드 옵션 (일괄 및 분할)'이 표시되면 다른 관리자가 이미 내보내기를 완료한 것입니다. 원하는 내보내기 방법을 선택하고 '내보내기 진행'을 클릭하세요.
ManageBac+ 의 대량 내보내기 와 델타 내보내기는 데이터 관리에서 서로 다른 목적을 수행합니다.
- 일괄 내보내기 : 이 프로세스는 모든 관련 레코드를 한 번에 내보냅니다. 일반적으로 초기 설정이나 새 시스템으로 전환할 때와 같이 전체 데이터 세트가 필요한 경우에 사용됩니다. 이 방법을 사용하면 기존의 모든 데이터가 캡처되어 전송됩니다.
- 델타 내보내기 : 이 프로세스는 마지막 내보내기 이후 변경된 레코드(새로 생성, 업데이트 또는 삭제된 항목 등)만 내보냅니다. 전체 데이터 세트를 전송하지 않고도 데이터를 최신 상태로 유지할 수 있어 지속적인 동기화 작업을 더욱 효율적으로 수행할 수 있습니다. 델타 내보내기는 대량 내보내기가 완료된 후에만 수행할 수 있습니다.
'내보내기 진행'을 클릭하면 내보내기 작업이 백그라운드에서 시작되고 사용자는 Exchange 기록 탭으로 이동합니다.
완료되면 가장 최근에 내보낸 파일을 찾아 다운로드 버튼(아래쪽 화살표)을 클릭하여 ZIP 파일을 다운로드하세요.
다운로드한 파일을 검토하십시오. 파일 내용에는 모든 엔티티와 ManageBac+ 의 사용자 지정 사양 에서 해당 엔티티가 표현되는 방식이 포함되어 있습니다.
수입
데이터 교환 관리자를 통해 가져오기 프로세스를 시작하려면 가져오기 탭에서 ZIP 파일을 선택하십시오.
컴퓨터에서 OneRoster ZIP 파일을 선택하고 [저장] 을 클릭하여 업로드하세요.
필수 입력 항목을 입력하세요:
manifest.csv 파일 에 source.systemname 과 source.systemcode 가 포함되어 있지 않으면 업로드 영역 아래에 입력해야 할 두 개의 필드가 나타납니다. 자세한 내용은 파일 사양 > manifest.csv 섹션을 참조하십시오.
만약 이러한 값들이 이미 manifest.csv 파일 에 있다면 , 해당 필드들은 미리 채워져 있으므로 입력할 필요가 없습니다.
모든 설정이 완료되면 하단의 '유효성 검사 진행' 버튼을 클릭하세요. 그러면 OneRoster 및 ManageBac+ 유효성 검사가 백그라운드에서 실행되는 가져오기 작업이 시작됩니다.
OneRoster 가져오기는 한 번에 하나만 진행할 수 있습니다.
상단의 '교환 기록' 탭에서 가져오기 상태를 확인하세요. 가져오기가 완료되면 가장 최근에 가져온 항목을 찾아 유효성 검사를 검토하세요.
교환 보고서 페이지가 열리고 요약 정보 와 OneRoster ZIP 파일에 업로드된 모든 CSV 파일이 표시됩니다.
각 CSV 탭에서 오류 및 경고는 문제가 발생한 셀 내에서 해당 색상으로 강조 표시됩니다.
탭은 세 개가 있으며, 처음에 기본적으로 선택되는 탭은 '유효하지 않음' 입니다.
유효함 — 경고나 유효성 검사 오류가 없는 모든 행을 포함합니다.
경고 — 경고가 하나 이상 포함된 모든 행을 표시합니다.
유효하지 않음 — 하나 이상의 유효하지 않은 행이 포함된 모든 행을 포함합니다.
경고 또는 무효화와 관련된 메시지를 이해하려면 행 정보를 클릭하여 펼치십시오.
경고는 가져오기를 차단하지는 않지만 잠재적인 문제를 나타냅니다. 관리자는 상황에 따라 경고를 무시하거나 조정할 수 있습니다.
유효하지 않은 레코드는 기능 요구 사항을 충족하지 않으므로 가져오기를 진행할 수 없습니다.
무효화의 원인이 된 모든 문제를 해결한 후, 업데이트된 ZIP 파일을 사용하여 새 가져오기를 수행하십시오.
데이터 엔티티
아래 표는 ManageBac+ 의 다양한 엔티티가 OneRoster 1.2 엔티티 및 CSV 파일 과 어떻게 대응하는지 보여주며 , 데이터 모델의 차이를 고려하면서 원활한 데이터 교환을 보장합니다.
| OneRoster 1.2 엔티티(들) | ManageBac+ 엔티티 | OneRoster CSV 파일 |
| 조직 -> 지역 | 해당 없음 | 조직 |
| 기관 -> 학교 | 학교 | 조직 |
| 조직 -> 프로그램 확장 | 프로그램 | 조직 |
| 학사 일정 -> 학년도 | 학년도 | academicSessions |
| 행동 | 주제 그룹 | 행동 |
| 강좌 -> 과목 | 주제 | 행동 |
| 수업 | 수업 | 수업 |
| 사용자, 역할 -> 학생, 인구 통계 | 재학생 | 사용자, 역할, 인구 통계 |
| 사용자, 역할 -> 교사 | 선생님들 | 사용자, 역할 |
| 사용자, 역할 -> 상위 사용자 | 부모 | 사용자, 역할 |
| 사용자, 역할 -> 관리자 | 관리자 | 사용자, 역할 |
| 사용자 -> 에이전트 | 부모/자녀 관계 | 사용자 |
| 등록 | 수업 멤버십 | 등록 |
예를 들어, ManageBac+ 의 학생은 OneRoster에서 "학생" 역할을 가진 사용자 에 해당합니다 . OneRoster에서 사용자 와 역할은 각각 users.csv 와 roles.csv 파일에 정의됩니다 .
데이터 교환 관리자는 위에 나열된 레코드만 업데이트하며 다른 데이터는 수정하지 않습니다.
소량 수입 vs 대량 수입
데이터 교환 프로세스 에서 중요한 차이점은 델타 가져오기 와 대량 가져오기 의 차이입니다 .
- 델타 수입 :
- 기존 ManageBac+ 레코드를 일치시키고 업데이트합니다 .
- 레코드가 존재하지 않는 경우 새 레코드를 생성합니다.
- 원본 데이터에 포함되지 않은 레코드는 변경하지 않고 그대로 둡니다 .
- 대량 수입 :
- 델타 가져오기 와 동일한 작업 (레코드 일치, 업데이트 및 생성)을 수행합니다.
- 또한, 소스 데이터에 존재하지 않는 ManageBac ManageBac+ 의 활성 레코드를 모두 보관합니다 .
- 예를 들어, "IB 생물학" 과 같은 수업이 ManageBac+ 에서 활성화되어 있지만 원본 데이터에 없는 경우, 가져오기 처리가 완료된 후 해당 수업은 보관 처리 됩니다.
요약하자면, 대량 가져오기는 원본 데이터에서 레코드를 생성하고 업데이트할 뿐만 아니라 원본 데이터 에서 누락된 레코드를 보관 처리합니다 .
학년 전환 기간 동안 일괄 가져오기를 수행하는 경우 OneRoster에는 학년 그룹이 포함되어 있지 않으므로 별도로 관리해야 한다는 점에 유의하십시오 .
가져오기 시 레코드 일치
ManageBac+ 델타 가져오기와 대량 가져오기 모두에서 소스 데이터의 레코드와 시스템의 레코드를 일치시키기 위해 두 가지 주요 전략을 사용합니다.
- sourcedId가 이전에 사용된 적이 있는 경우 , 다음 항목에 설명된 매칭 방법을 사용하여 해당 레코드와 직접 매칭됩니다.
- sourcedIds를 기준으로 일치시킬 수 없거나 처음 발견하는 경우, 다음 표는 각 엔티티에 대한 일치 전략을 설명합니다.
| 실재 | 소스 열(또는) | (MB)와 일치함 |
| 학교 | orgs.types == "학교" | 현재 재학 중인 학교와 일치합니다 (단 1건의 기록만 있음) |
| 프로그램 | orgs.sourcedId 는 첫 번째 밑줄 뒤의 접미사와 일치합니다. | 프로그램 코드와 일치합니다. (예: abc-dedf_diploma 는 IB 디플로마 입니다.) |
| 학술 세션 | academicSessions.startDate , academicSessions.endDate | 연도/학기 시작/종료 날짜와 일치합니다. |
| 행동 | 강좌 제목 | 주제 그룹 제목과 일치 |
| 주제 | courses.subjects[] | 배열의 각 문자열은 제목과 일치합니다. |
| 수업 | 클래스.클래스코드 | 클래스 ID와 일치함 |
| 사용자 | 사용자.사용자 이름 | 학생/교사/학부모 이메일과 연결됨 |
자주 묻는 질문
질문: OneRoster란 무엇이며, ManageBac+ 는 왜 OneRoster의 사용자 지정 사양을 사용하는 것입니까?
OneRoster는 IMS 글로벌 학습 컨소시엄에서 개발한 널리 사용되는 규격으로, 학생 정보, 강좌 데이터, 등록 현황 등 교육 데이터를 시스템 간에 표준화하여 교환할 수 있도록 합니다. ManageBac+ 는 OneRoster 1.2를 자체 구현하여 " ManageBac+ OneRoster Dialect"(MB OR Dialect)라는 맞춤형 규격을 사용합니다. 이는 기본 OneRoster 규격의 데이터 모델이 ManageBac+ 의 기능적 요구 사항과 다르기 때문입니다. 이러한 맞춤형 구현을 통해 ManageBac+ 자체 데이터 구조 및 기능에 맞춰 레코드를 가져오고 내보낼 수 있습니다.
질문: ManageBac+ OneRoster 가져오기/내보내기에 포함되는 파일은 무엇이며, 필수 파일은 무엇입니까?
ManageBac+ OneRoster 데이터는 CSV 파일이 포함된 ZIP 아카이브 형태로 교환됩니다. manifest.csv 파일은 필수입니다. 다음 파일들은 선택 사항이지만, 해당 엔티티가 포함된 경우 아카이브에 반드시 있어야 합니다. academicSessions.csv, orgs.csv, courses.csv, classes.csv, roles.csv, users.csv, enrollments.csv, demographics.csv. 선택 파일이라도 내용이 비어 있는 경우 필수 열 헤더를 포함해야 합니다.
질문: 각 파일에는 어떤 열이 필요하며, 허용되는 값은 무엇입니까?
이러한 세부 정보는 기술 구현을 설명하는 자료 에 제공되어 있으며 , 해당 자료는 여기에서 참조할 수 있습니다.
ManageBac+ OneRoster 1.2 CSV 사용자 지정 사양
질문: OneRoster 데이터를 ManageBac+ 로 가져올 때 적용되는 유효성 검사 규칙은 무엇입니까?
ManageBac+ 가져온 모든 CSV 파일에 여러 가지 공통 유효성 검사를 적용합니다. 이러한 유효성 검사 결과는 데이터 교환 기록 탭에 보고됩니다. 각 엔티티에는 일련의 유효성 검사가 있으며, 자세한 내용은 기술 구현을 설명하는 자료에서 확인할 수 있습니다 . 해당 자료는 여기에서 참조할 수 있습니다.
ManageBac+ OneRoster 1.2 CSV 사용자 지정 사양
질문: ManageBac+ 와 다른 OneRoster 1.2 호환 시스템 간에 데이터를 교환할 때 차이점과 잠재적인 비호환성은 무엇입니까?
ManageBac+ 에서 OneRoster 1.2 표준을 구현하는 타사 시스템으로 데이터를 내보낼 경우, 일반적으로 호환성이 보장됩니다. ManageBac+ 사용자, 과정, 수업과 같은 추가 메타데이터 열을 파일에 포함시키는데, 이러한 열은 수신 시스템에서 일반적으로 무시할 수 있습니다.
하지만 타사 시스템에서 ManageBac+ 로 데이터를 가져올 때는 ManageBac+ 의 사용자 지정 사양으로 인해 특정 요구 사항을 충족해야 합니다. 예를 들어, 수업 및 강좌는 특정 유형(ext:program)의 조직과 연결되어야 하며, 사용자, 강좌 및 수업 파일에 추가 메타 열이 필요할 수 있습니다. 학사 일정 데이터 가져오기 또한 일부 요구 사항을 충족해야 합니다.
질문: ManageBac+ 데이터 교환 관리자에서 "일괄 내보내기"와 "변경 사항 내보내기"의 차이점은 무엇입니까? 일괄 내보내기는 선택한 데이터를 모두 내보내 ManageBac+ 의 현재 정보의 전체 스냅샷을 제공합니다. 이는 일반적으로 최초 내보내기 시 수행됩니다. 반면 변경 사항 내보내기는 마지막으로 일괄 내보내기가 성공적으로 완료된 이후 발생한 변경 사항(추가, 수정 및 삭제)만 내보냅니다. 변경 사항 내보내기를 수행하려면 이전에 최소 한 번 이상 일괄 내보내기를 완료해야 합니다.
질문: ManageBac+ 로 OneRoster ZIP 파일을 가져올 때 소스 시스템 이름과 코드를 어디에서 지정해야 합니까?
ManageBac+ 특히 여러 학생 정보 시스템의 명단 데이터를 가져올 때 OneRoster 데이터의 출처를 식별하기 위해 source.systemname과 source.systemcode 필드를 필요로 합니다. 이러한 필드가 manifest.csv 파일에 포함되어 있지 않은 경우, 데이터 교환 관리자에 ZIP 파일을 업로드한 후 수동으로 입력하라는 메시지가 표시됩니다. 동일한 소스 시스템에서 가져올 때는 이러한 값이 일관적이어야 합니다.
질문: 내보내기 시 델타 방식을 선택할 수 없는 이유는 무엇입니까?
답변: 델타 방식을 사용하려면 먼저 첫 번째 대량 내보내기를 완료해야 합니다. 최초 대량 내보내기가 완료되면 델타 방식을 사용할 수 있게 됩니다. 델타 방식은 마지막 전체 대량 내보내기 이후 변경된 내용만 내보냅니다.
질문: ManageBac+ 의 사용자 지정 OneRoster 사양에서 학년 그룹은 어디에 지정해야 하나요?
답변: 현재 학년별 그룹 기능은 지원되지 않습니다. 하지만 ManagaBac의 기능 요구 사항을 충족하는 데 필요한 확장 기능을 지원하기 위해 OneRoster와의 협력을 검토 중입니다. 학년별 그룹 멤버십 관리는 설정 > 명단 > 멤버십에서 하시는 것을 권장합니다.
질문: 거래 내역 페이지의 상태는 무엇을 의미합니까?
답변: ManageBac+ 에는 다음과 같은 설명이 있는 네 가지 상태가 있습니다.
예약됨 - 시스템에서 가져오기 일정을 성공적으로 예약했으며, 추후 시작될 예정으로 대기열에 추가되었음을 의미합니다. 시작되면 '처리 중'으로 상태가 변경됩니다.
처리 중 - 이는 시스템이 현재 내보내기 또는 가져오기 관련 백그라운드 작업을 진행 중임을 의미합니다. 일시적인 상태이며 아래 상태 중 하나로 변경될 예정입니다.
실패 - 이 상태가 표시되면 백그라운드 작업이 완료되지 않았음을 의미합니다. 내보내기 오류의 경우 ManageBac+ 지원팀에 문의하십시오( 요청 제출 ). 가져오기 오류의 경우 눈 모양 아이콘을 클릭하여 보고서 보기 페이지를 열고 유효성 검사 오류를 확인한 후 다음 가져오기를 위해 수정하십시오.
성공 - 이는 작업이 오류 없이 완료되었음을 의미합니다.