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

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

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

URL 및 해당 기능에 대한 자세한 설명은 스냅숏 플랫 파일을 참조하십시오.


Learn으로 전환되는 ANGEL 고객

Learn과 ANGEL 데이터 피드 형식에는 차이점이 있습니다. 이러한 차이점은 ANGEL에서 LEARN 데이터 매핑 지식 경로로 호출됩니다.

통합 데이터에 사용할 수 있는 문자 집합

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

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

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

% & # < > = \ + /


최소 데이터 필드를 사용하는 샘플

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

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

더 복잡한 데이터 사용 샘플에 대한 내용은 스냅숏 플랫 파일의 예를 참조하십시오.


사용자

작업: 사용자 생성/업데이트(개인)

URL: 개인 저장 또는 새로 고침

샘플:

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


코스

작업: 새 코스 생성/업데이트

URL: 코스 저장 또는 새로 고침

샘플:

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

작업: 코스 보기 결정

URL: 코스 저장 또는 새로 고침

샘플:

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 필드를 추가하십시오. 예를 들어, 모든 새 수학 코스는 처음에 마스터 수학 코스의 자료를 포함해야 합니다.


조직

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

URL: 조직 저장 또는 새로 고침

샘플:

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

작업: 새 조직 비활성화

URL: 조직 삭제

샘플:

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

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

URL: 조직 멤버십 저장 또는 새로 고침

샘플:

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

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

URL: 조직 멤버십 저장 또는 새로 고침

샘플:

external_person_key|external_organization_key|role
testPerson1|testOrg1|instructor


용어

작업: 학기 생성/업데이트

URL: 학기 저장 또는 새로 고침

샘플:

external_term_key|name
testTerm1|Test Term 1

작업: 학기 비활성화

URL: 학기 삭제 URL

샘플:

external_term_key
testTerm1


노드

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

URL: 노드 저장 또는 새로 고침

샘플:

external_node_key|name
testNode1|Test Node 1
testNode2|Test Node 2

작업: 학기 비활성화

URL: 노드 삭제

샘플:

external_node_key
testNode1


노드 연결

작업: 코스-노드 연결 생성/업데이트/비활성화

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

샘플:

external_association_key|external_course_key|external_node_key
testCourseAssociation1|testCourse1|testNode1
testCourseAssociation2|testCourse2|testNode2

작업:사용자-노드 연결 생성/업데이트/비활성화

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

샘플:

external_association_key|external_user_key|external_node_key
testUserAssociation1|testPerson1|testNode1
testUserAssociation2|testPerson2|testNode1
testUserAssociation3|testPerson1|testNode2

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

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

샘플:

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

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

URL: 조직 범주 저장/새로 고침/삭제

샘플:

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' 필드를 코스 피드에 추가하십시오.

하위 관계를 할당하기 전에 상위 코드를 생성해야 합니다.

작업:코스 간 상위 하위 관계 생성

URL:코스 저장/새로 고침

샘플:

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

코스 복사 및 코스 템플릿에 대해 이해하려면 기존 코스를 복사하여 코스 생성을 참조하십시오.


자세히 알아보기

스냅샷 플랫 파일 머리글 설명