스냅숏 플랫 파일의 데이터 형식

레거시 스냅숏(명령줄 스냅숏 도구)에 익숙한 경우 학생 정보 시스템의 프레임워크 플랫 파일 유형은 지원되는 새 데이터 객체에 헤더를 추가하는 것 외에는 형식을 변경하지 않으며, 이전에 선택 사항이었던 몇 가지 필드를 포함하기 위한 요구 사항도 변경되지 않습니다.

레거시 스냅숏과 동일한 순서 규칙이 스냅숏 플랫 파일에 적용됩니다. 간단히 말해 종속성이 충족되지 않는 한 피드는 성공하지 않습니다. 예를 들어, 멤버십과 관련된 객체가 포함된 사용자 피드 및 코스 피드가 모두 처리될 때까지 멤버십 피드는 성공하지 않으며, 마스터 코스(상위)가 생성될 때까지 하위 코스가 상위 코스에 연결되지 않을 수 있습니다. 용어와 노드에도 이 논리가 적용됩니다.

또한 엔드포인트에 게시된 데이터를 처리하는 것과 관련된 시스템 동작은 통합 수정 페이지를 통해 구성할 수 있습니다.

ANGEL 클라이언트가 Blackboard로 전환 중

Blackboard와 ANGEL 데이터 피드 형식 사이에는 차이점이 있습니다. 이러한 차이점은 ANGEL에서 BLACKBOARD로 데이터 매핑하는 지식 경로에서 호출됩니다.

통합 데이터에서 허용되는 문자 집합

핵심 데이터 필드에서 포괄적으로 사용할 수 있는 안전한 문자 집합은 다음과 같습니다.

A-Z a-z 0-9 . ' , " : ! ? $ @ [ ] { } - _ *

비밀번호 및 외부 키에 포함할 수 있는 문자 집합은 다음과 같습니다.

% & # < > = \ + /

샘플에서 최소 데이터 필드 사용

이러한 샘플은 피드에 대한 최소한의 필수 데이터입니다. 즉, 각 피드에 대한 추가 객체는 학생 정보 시스템 프레임워크 스냅숏 플랫 파일의 고급 구성 사용자 지정 헤더 UI에서 도출될 수 있습니다. 또한 필드 매핑 UI에서 필드의 필수 속성을 도출할 수도 있습니다. 각 객체에 사용할 수 있는 값과 기본값의 예 및 설명이 포함된 전체 목록은 이 문서의 끝에 나와 있습니다. 설치에 사용된 전체 URL은 'HTTP 구성' 아래의 학생 정보 시스템의 프레임워크 관리자 UI를 통해 검색할 수 있습니다. 자세히 알아보려면 스냅샷 플랫 파일을 참조하세요.

아래의 샘플에서는 파이프 문자('|')를 구분 기호로 사용합니다. 구현을 구성할 때 어떤 구분 기호를 사용할지 선택할 수 있습니다.

보다 복잡한 데이터 사용 샘플은 스냅샷 플랫 파일 예제를 참조하세요.

사용자

작업: 사용자 생성 또는 업데이트

개인 저장소 또는 새로고침

샘플:

external_person_key|user_id|passwd|firstname|lastname|system_role

testPerson1|aanderson_test|changeme|Alpha|Anderson|none

testPerson2|bbrown_test|changeme|Beta|Brown|none

testPerson3|ccharlie_test|changeme|Chi|Charlie|none

testPerson4|ddavis_test|changeme|Delta|Davis|none

testPerson5|eedwards_test|changeme|Epsilon|Edwards|none

작업: 사용자 삭제/비활성화

사용자 삭제 URL

샘플:

external_person_key

testPerson1

작업: 개인 보조 교육 기관의 역할에 대한 피드백

URL: 역할 저장소/새로고침/삭제

샘플:

external_person_key|role_id

testPerson1|ALUMNI

testPerson1|PROSPECTIVE_STUDENT

testPerson2|ALUMNI

작업: 개인 관찰자 협회 피드백

URL: 연결 저장소/새로고침/삭제

샘플:

external_observer_key|external_user_key

testPerson6|testPerson1

코스

작업: 새 강의 생성 및 업데이트

코스 저장 또는 새로고침

샘플:

external_course_key|course_id|course_name

testCourse1|TEST_COURSE_1|Test Course 1

testCourse2|TEST_COURSE_2|Test Course 2

testCourse3|TEST_COURSE_3|Test Course 3

작업: 새로운 강좌 보기 결정

코스 저장 또는 새로고침

샘플:

external_course_key|course_id|course_name|course_experience

testCourse1|TEST_COURSE_1|Test Course 1|Original

testCourse2|TEST_COURSE_2|Test Course 2|Ultra

testCourse3|TEST_COURSE_3|Test Course 3|Instructor choice

지원되는 값은 ‘Original’, ‘Ultra’ 또는 ‘교수자 선택’입니다. 이 값은 삽입 전용이며 학생 정보 시스템 프레임워크를 통해 업데이트할 수 없습니다.

작업: 새 강좌 삭제 및 비활성화

코스 삭제 URL

샘플:

external_course_key

testCourse1

새 코스를 마스터 코스의 콘텐츠로 채우고자 할 때는 코스 피드 파일에 template_course_key 필드를 추가하세요. 예를 들어, 모든 새 수학 코스는 처음에 마스터 수학 코스의 자료를 포함해야 합니다.

조직

작업: 새 조직 생성 및 업데이트

조직을 저장하거나 새로고침

샘플:

external_organization_key|organization_id|organization_name

testOrg1|TEST_ORG_1|Test Org 1

testOrg2|TEST_ORG_2|Test Org 2

testOrg3|TEST_ORG_3|Test Org 3

작업: 새 조직 비활성화

조직 삭제

샘플:

external_organization_key

testOrg1

멤버십

작업: 코스 회원권 생성 및 업데이트

URL: 코스 멤버십 스토어 또는 새로고침

샘플:

external_person_key|external_course_key|role

testPerson1|testCourse1|instructor

testPerson1|testCourse2|student

testPerson2|testCourse1|student

testPerson3|testCourse1|student

testPerson4|testCourse2|instructor

testPerson5|testCourse3|student

작업: 코스 멤버십 비활성화

코스 멤버십 삭제 URL

샘플:

external_person_key|external_course_key

testPerson1|testCourse1

작업: 조직 멤버십 생성 및 업데이트

조직 멤버십 스토어 또는 새로고침

샘플:

external_person_key|external_organization_key|role

testPerson1|testOrg1|instructor

testPerson1|testOrg2|student

testPerson2|testOrg1|student

testPerson3|testOrg1|student

testPerson4|testOrg2|instructor

testPerson5|testOrg3|student

작업: 조직 멤버십 비활성화하기

조직 멤버십 스토어 또는 새로고침

샘플:

external_person_key|external_organization_key|role

testPerson1|testOrg1|instructor

학기

작업: 약관 생성 및 업데이트

용어 저장소 또는 새로고침

샘플:

external_term_key|name

testTerm1|Test Term 1|a|

testTerm2|Test Term 2|s|testTerm1

작업: 용어 비활성화

용어 삭제 URL

샘플:

external_term_key

testTerm1

과목

작업: 새 주제 생성/업데이트

URL: 주제 저장 또는 새로 고침

샘플:

external_subject_key|subject_id|subject_name|subject_type

testSubject1|TEST_SUBJECT__1|TestSubject1|U

testSubject2|TEST_SUBJECT__2|TestSubject 2|U

testSubject3|TEST_SUBJECT___3|TestSubject 3|U

작업: 새 과목 비활성화하기

URL: 제목 삭제

샘플:

external_subject_key

testSubject1

주제 연계

작업: 코스 연결 피드에 과목 생성/비활성화 작업

URL: 코스 연결 저장/새로 고침/삭제 대상

샘플:

external_association_key|external_subject_key|external_course_key

testSubjectToCourseAssociation1|testSubject1|testCourse1

testSubjectToCourseAssociation2|testSubject2|testCourse2

작업: 과목-조직 연결 피드 만들기/비활성화

URL: 조직 연결 저장/새로 고침/삭제 대상

샘플:

external_association_key|external_subject_key|external_org_key

testSubjectToOrgAssociation1|testSubject1|testOrg1

testSubjectToOrgAssociation2|testSubject2|testOrg2

프로그램

작업: 새 프로그램 만들기/업데이트

URL: 프로그램 저장 또는 새로 고침

샘플:

external_program_key|program_id|program_name|program_type

testProgram1|TEST_PROGRAM1|Test Program 1|U

testProgram2|TEST_PROGRAM2|Test Program 2|U

testProgram3|TEST_PROGRAM3|Test Program 3|G

작업: 새 프로그램 비활성화하기

URL: 프로그램 삭제

샘플:

external_program_key

testProgram1

프로그램 연결 정보

작업: 주제 연결 피드에 프로그램 생성/비활성화

URL: 주제 연결 저장/새로 고침/삭제 프로그램

샘플:

external_association_key|external_program_key|external_subject_key

testProgramToSubjectAssociation1|testProgram1|testSubject1

testProgramToSubjectAssociation2|testProgram2|testSubject2

노드

작업: 노드 생성 및 업데이트

노드 저장 및 새로고침 URL

샘플:

external_node_key|name

testNode1|Test Node 1

testNode2|Test Node 2

작업: 용어 비활성화

URL 삭제 중

샘플:

external_node_key

testNode1

노드 연결

작업: 노드에 대한 과정 생성·업데이트·비활성화

코스 협회 스토어/새로고침/삭제

샘플:

external_association_key|external_course_key|external_node_key

testCourseAssociation1|testCourse1|testNode1

testCourseAssociation2|testCourse2|testNode2

작업: 사용자와 노드의 연결 생성·업데이트·비활성화

사용자 연결 저장소/새로고침/삭제

샘플:

external_association_key|external_user_key|external_node_key

testUserAssociation1|testPerson1|testNode1

testUserAssociation2|testPerson2|testNode1

testUserAssociation3|testPerson1|testNode2

작업: 노드 연결 피드 조직 생성·업데이트·비활성화

조직 연결 저장소/새로고침/삭제

샘플:

external_association_key|external_organization_key|external_node_key

testOrgAssociation1|testOrg1|testNode1

testOrgAssociation2|testOrg2|testNode2

범주 지원

작업: 코스 카테고리 피드 생성·업데이트·비활성화

URL: 코스 카테고리 저장·새로 고침·삭제

샘플:

external_category_key|title

testCourseCategory1|Course Category 1

testCourseCategory2|Course Category 2

작업: 조직 범주 피드 생성/업데이트/비활성화

조직 카테고리 저장소/새로고침/삭제

샘플:

external_category_key|title

testOrgCategory1|Org Category 1

testOrgCategory2|Org Category 2

작업: 코스 범주 멤버십 피드 생성·업데이트·비활성화

URL: 강좌 카테고리 멤버십 스토어/새로고침/삭제

샘플:

external_course_key|external_category_key|available_ind

testCourse1|testCourseCategory1|Y

testCourse2|testCourseCategory2|Y

testCourse3|testCourseCategory1|Y

작업: 조직 범주 멤버십 피드 생성/업데이트/비활성화

URL: 조직 범주 멤버십 스토어/새로고침/삭제

샘플:

external_organization_key|external_category_key|available_ind

testOrg1|testOrgCategory1|Y

testOrg2|testOrgCategory2|Y

testOrg3|testOrgCategory1|Y

부모의 자녀 양육비

상위:하위 관계가 필요한 경우 'master_course_key' 필드를 코스 피드에 추가하십시오.

작업: 코스 간의 상하위 관계 설정하기

코스 스토어/새로고침

샘플:

external_course_key|course_id|course_name|master_course_key

testCourse1|TEST_COURSE_1|Test Course 1|

testCourse2|TEST_COURSE_2|Test Course 2|testCourse1

testCourse3|TEST_COURSE_3|Test Course 3|testCourse1

testCourse4|TEST_COURSE_4|Test Course 4|

testCourse5|TEST_COURSE_5|Test Course 5|testCourse4

이 예에서 TEST_COURSE_2와 TEST_COURSE_3은 상위 코스인 TEST_COURSE_1의 하위 코스입니다(TEST_COURSE_4는 아님). 모든 코스에 적절한 master_course_key에 대한 항목이 포함된 코스 피드와 별개로 하위 코스 피드를 실행할 수도 있습니다. 이전에 저장한 코스를 유지하려면 이 작업에 코스 저장소를 사용하십시오.

코스 사본/템플릿

새 코스를 '마스터' 코스의 콘텐츠로 채우고 싶은 경우 채우는 중인 코스 피드에 'template_course_key' 필드를 추가하십시오. 모든 새로운 수학 과정에는 처음에 마스터 수학 과정 자료를 포함해야 합니다.

샘플:

external_course_key|course_id|course_name|master_course_key|template_course_key

testCourse1|TEST_COURSE_1|Test Course 1||test_course_template1

testCourse2|TEST_COURSE_2|Test Course 2|testCourse1|

testCourse3|TEST_COURSE_3|Test Course 3|testCourse1|

testCourse4|TEST_COURSE_4|Test Course 4||test_course_template1

자세히 알아보기