스냅숏 플랫 파일의 데이터 형식
레거시 스냅숏(명령줄 스냅숏 도구)에 익숙한 경우 학생 정보 시스템의 프레임워크 플랫 파일 유형은 지원되는 새 데이터 객체에 헤더를 추가하는 것 외에는 형식을 변경하지 않으며, 이전에 선택 사항이었던 몇 가지 필드를 포함하기 위한 요구 사항도 변경되지 않습니다.
레거시 스냅숏과 동일한 순서 규칙이 스냅숏 플랫 파일에 적용됩니다. 간단히 말해 종속성이 충족되지 않는 한 피드는 성공하지 않습니다. 예를 들어, 멤버십과 관련된 객체가 포함된 사용자 피드 및 코스 피드가 모두 처리될 때까지 멤버십 피드는 성공하지 않으며, 마스터 코스(상위)가 생성될 때까지 하위 코스가 상위 코스에 연결되지 않을 수 있습니다. 용어와 노드에도 이 논리가 적용됩니다.
또한 엔드포인트에 게시된 데이터를 처리하는 것과 관련된 시스템 동작은 통합 수정 페이지를 통해 구성할 수 있습니다.
작은 정보
스냅숏 플랫 파일 단원에서 URL 및 관련 기능에 대한 자세한 설명을 확인하십시오.
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
테스트코스1
새 코스를 마스터 코스의 콘텐츠로 채우고자 할 때는 코스 피드 파일에 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
테스트조직1
멤버십
작업: 코스 회원권 생성 및 업데이트
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
작업: 용어 비활성화
용어 삭제 URL
샘플:
external_term_key
testTerm1
노드
작업: 노드 생성 및 업데이트
노드 저장 및 새로고침 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
작은 정보
코스 복사 및 코스 템플릿에 대해 알아보려면 기존 코스를 복사하여 코스 만들기를 참조하세요.