이 문서의 목적상 '스냅숏'이라는 용어의 사용은 학생 정보 시스템에서 특정 시점의 데이터를 가져오는 일반적인 프로세스와 관련이 있습니다. 해당 데이터는 플랫 파일에 저장된 다음 Learn에서 사용(스냅숏 컨트롤러 아님)됩니다.

스냅숏은 스냅숏용 학생 정보 시스템 프레임워크 내에서 지원되는 두 통합 유형(읽기: 데이터 형식), 즉 스냅숏 XML 및 스냅숏 플랫 파일(또는 분리된 데이터)을 사용하는 학생 정보 시스템을 통해 프로비저닝되었으므로 특정 시점의 데이터를 사용하여 통합하는 기능을 제공합니다. 스냅숏 플랫 파일은 '발전적인' 지원 형식이며 새 데이터 객체를 지원하는 업데이트를 수신합니다. 스냅숏 XML은 유지 관리 업데이트만 수신합니다.

두 스냅숏 통합 유형은 모두 적절한 엔드포인트에 대한 데이터 파일의 HTTP 게시를 사용합니다.


지원되는 데이터

지원되는 데이터
데이터 객체스냅숏 플랫 파일 지원스냅숏 XML 지원
사용자
코스
멤버십
(등록 및 직원 배정)
카탈로그 범주
조직
참관인
교육기관 내 역할
노드 
교차 목록 코스 
용어 
표준(코스 특성) 

요구 사항

선택한 통합 유형(적절한 구분 기호를 사용하는 스냅숏 플랫 파일 또는 스냅숏 XML)에 대해 서식이 지정된 데이터를 생성하려면 학생 정보 시스템의 기능이 필요합니다.

다시 한번 말하지만 스냅숏 컨트롤러 및 스냅숏 XML 데이터 형식은 새 객체 지원 또는 기능 개발이 아닌 유지 관리 업데이트만 수신하므로 첫 번째로 선택하는 통합 옵션이 되어서는 안 됩니다. 향후 언젠가 고객에게 조정을 위해 충분한 시간을 제공하면서 지원을 제거한다는 내용이 공지될 것입니다.

데이터 샘플을 확인하려면 Enterprise 1.1의 두 버전(표준 및 Vista) 간에 데이터 형식이 약간 다르다는 점에 주의하면서 Enterprise 1.1 예시 섹션을 참조하십시오.

설정: 스냅숏 통합 유형

학생 정보 시스템 통합과 관련된 데이터를 이해하는 것 외에도 스냅숏 통합의 통합 유형을 설정하려면 선택한 스냅숏 유형에서 지원되는 데이터 객체가 고객의 통합 목표를 충족하는지 확인하고 학생 정보 시스템 기능 및 엔드포인트에 대해 숙지하고 있어야 합니다. 또한 특정 파일 형식에 대해서도 이해해야 합니다. Learn 시스템 관리자의 학생 정보 시스템 통합 UI에서 다음 단계를 수행하여 스냅숏 통합을 생성할 수 있습니다. 데이터 통합 > 학생 정보 시스템 통합

다음 단계는 두 스냅숏 통합 유형에 대해 모두 동일합니다. 통합 유형 선택 시 주요 차이점은 데이터가 XML('스냅숏 XML' 선택)인지 아니면 구분된 파일(스냅숏 플랫 파일)인지 여부입니다.

  1. '통합 생성'을 선택합니다.
  2. '스냅숏 XML' 또는 '스냅숏 플랫 파일'을 선택합니다.
  3. 다음 화면에 구성을 위해 수정할 수 있는 옵션이 표시됩니다.

    고급 구성(예: 데이터 매핑)을 수행하려면 통합을 '테스트' 또는 '활성' 상태로 설정해야 합니다.

    1. 통합 이름: '스냅숏 XML' 또는 '스냅숏 플랫 파일'을 입력합니다.
    2. 설명(선택 사항): 원하는 대로 통합에 대한 설명을 입력합니다(예: '스냅숏 XML 테스트' 또는 '스냅숏 플랫 파일 테스트').
    3. 공유 사용자명은 공유 비밀번호처럼 데이터 게시 작업에 사용됩니다.
    4. 통합 상태 설정:
      1. 비활성 - 통합이 처리를 수행하지 않습니다.
      2. 활성 - 통합이 처리를 수행하며 Learn 데이터를 업데이트합니다.
      3. 테스트 - 통합이 처리를 수행하며 Learn을 업데이트하지 않습니다.
    5. 로그 상세 표시 수준 설정 - '테스트'의 경우 '모든 진단 및 디버그 메시지'를 선택하는 것이 좋습니다. '활성'의 경우 '오류만' 또는 '오류 및 경고'와 같은 낮은 수준의 설정을 사용하는 것이 좋습니다.
    6. 다음으로 이 통합에 사용할 DSK(데이터 소스 키)를 선택합니다. 특정한 기존 DSK를 사용하거나, 새 키를 생성하거나, 피드에서 제공된 데이터 소스를 사용하도록 선택할 수 있습니다. DSK는 항상 데이터 피드를 처리하기 전에 생성해야 합니다.
    7. 스냅숏 플랫 파일만 상위 노드 관리를 지원합니다. 고객의 목표를 충족하도록 적절하게 선택합니다.
    8. 마지막으로 이 통합을 통해 처리된 객체와 패리티를 처리할 방법을 선택합니다. 일반적으로는 기본값을 사용해도 괜찮습니다.
    9. 사용할 수 있는 통합 객체의 고유한 하위 집합을 각각 처리하는 여러 통합 유형이 있을 수 있습니다.
    10. 제출하면 새 스냅숏 통합이 통합 목록에 나타납니다.

스냅숏 통합을 지원하려면 Learn에 데이터를 게시하도록 학생 정보 시스템을 구성하거나 Learn에 데이터를 게시하도록 앱의 서버 측 cron 또는 배치 작업을 구성하는 한 가지 단계를 더 완료해야 스냅숏 엔드포인트는 수행해야 하는 필수 작업에 따라 다릅니다.

Learn에 대한 모든 애플리케이션 서버 측 게시는 CURL을 사용하거나 cron 또는 배치 작업에서 트리거된 유사한 애플리케이션을 사용하여 이루어집니다.

curl -k -w %{http_code} -H "Content-Type:text/plain" -u SHARED_USERNAME:SHARED_PASSWORD --data-binary @PATH_TO_TEST_FILE ENDPOINT_URL

대체:

SHARED_USERNAME을 공유 사용자명으로 대체

SHARED_PASSWORD를 공유 비밀번호로 대체

PATH_TO_TEXT_FILE을 xml 데이터 파일의 경로로 대체

Replace ENDPOINT_URL을 엔드포인트 URL로 대체

다음과 같이 플랫 파일 통합의 상황에 맞는 메뉴에서 HTTP 정보 페이지로 이동하여 서버에서 엔드포인트 목록을 확인할 수 있습니다.

시스템 관리자(빌딩 블록) > 데이터 통합 > 학생 정보 시스템 통합 > (통합의 상황에 맞는 메뉴) > Http 정보

중간 계층 애플리케이션 또는 학생 정보 시스템에서 지원하는 경우 위의 프로토콜을 따르는 엔드포인트에 데이터를 바로 게시할 수 있습니다.

위 작업이 완료된 후, 데이터를 생성하고 게시하거나 Learn에 게시하기 위해 파일을 저장할 목적으로 학생 정보 시스템이 활성화되면 통합에서 로그 확인을 시작해야 합니다.

사용할 수 있는 데이터 객체에서 데이터를 평가하고 고급 구성/필드 매핑을 사용하여 조정해야 할지 여부를 결정하십시오. 이 기능을 설명하는 예시 섹션의 끝에 있는 필드 매핑에 관한 섹션을 참조하십시오.

데이터 파일 처리에 대해 자세히 알아보려면 스냅숏 플랫 파일 자동화를 참조하십시오.


스냅숏 통합

스냅숏 통합은 특정한 목적을 충족하는 데이터 집합을 기반으로 합니다. 예를 들어 시스템에서 사용자 또는 코스를 관리하기 위해 사용됩니다. 지원되는 두 유형(스냅숏 XML 및 스냅숏 플랫 파일) 중에서 지원되는 Learn 데이터 객체와 함께 가장 최신 파일로 간주되어야 하는 것은 스냅숏 플랫 파일뿐입니다.

모든 "파일 기반" 통합 유형(스냅숏 및 Enterprise 1.1 유형)에서와 마찬가지로 이러한 파일의 데이터를 사용하기 위한 프로세스로는 두 가지, 즉 GUI 업로드 피드 파일을 사용하는 프로세스 또는 http 데이터 전송(예: cURL)을 사용하는 프로세스가 있습니다. http 데이터 전송의 경우 작업을 트리거하기 위해 cron 또는 배치 작업이 사용될 수 있습니다. 또한 학생 정보 시스템 또는 중간 계층의 지원을 받는 경우 데이터 스트림이 직접 게시될 수 있습니다.

각 작업은 특정한 엔드포인트를 통해 이루어집니다. 애플리케이션 서버에 대한 이러한 엔드포인트는 메뉴의 통합 HTTP 정보 링크를 통해 사용할 수 있습니다.


스냅숏 엔드포인트

플랫 파일용 스냅숏 작업 엔드포인트

이 정보를 사용하여 스냅숏 플랫 파일 피드 파일을 통합에 게시하도록 학생 정보 시스템을 설정하십시오. 저장된 객체는 계속 보관되며 해당 데이터도 유지됩니다. 삭제된 객체는 제거됩니다. '전체 새로 고침'을 수행하면 피드 파일에 없는 모든 기존 객체가 제거됩니다. 특정 객체 유형의 파일을 일치하지 않는 엔드포인트에 게시하는 작업은 실패합니다. 예: 코스 데이터 파일을 개인 엔드포인트에 게시하는 작업이 실패합니다.

코스를 비활성화하면 해당 코스에서 멤버십이 비활성화됩니다. 이는 새로운 동작입니다.

Blackboard Learn 사용자 인터페이스에서도 작업의 엔드포인트 URL을 확인할 수 있습니다. 관리자 패널 > 데이터 통합 > 학생 정보 시스템 통합으로 이동합니다. 통합을 찾고 해당 메뉴를 연 다음 HTTP 정보를 선택합니다. 통합의 엔드포인트 URL이 표시됩니다.

작업엔드포인트 URL
코스 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/course/store
코스 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/course/refresh
코스 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/course/refreshlegacy
코스 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/course/delete
코스 연결 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/courseassociation/store
코스 연결 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/courseassociation/refresh
코스 연결 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/courseassociation/refreshlegacy
코스 연결 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/courseassociation/delete
코스 범주 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategory/store
코스 범주 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategory/refresh
코스 범주 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategory/refreshlegacy
코스 범주 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategory/delete
코스 범주 멤버십 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategorymembership/store
코스 범주 멤버십 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategorymembership/refresh
코스 범주 멤버십 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategorymembership/refreshlegacy
코스 범주 멤버십 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/coursecategorymembership/delete
코스 멤버십 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/membership/store
코스 멤버십 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/membership/refresh
코스 멤버십 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/membership/refreshlegacy
코스 멤버십 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/membership/delete
코스 표준 연결 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/standardsassociation/store
코스 표준 연결 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/standardsassociation/refresh
코스 표준 연결 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/standardsassociation/refreshlegacy
코스 표준 연결 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/standardsassociation/delete
계층 노드 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/node/store
계층 노드 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/node/refresh
계층 노드 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/node/refreshlegacy
계층 노드 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/node/delete
참관인 연결 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/associateobserver/store
참관인 연결 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/associateobserver/refresh
참관인 연결 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/associateobserver/refreshlegacy
참관인 연결 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/associateobserver/delete
조직 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organization/store
조직 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organization/refresh
조직 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organization/refreshlegacy
조직 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organization/delete
조직 연결 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationassociation/store
조직 연결 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationassociation/refresh
조직 연결 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationassociation/refreshlegacy
조직 연결 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationassociation/delete
조직 범주 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategory/store
조직 범주 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategory/refresh
조직 범주 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategory/refreshlegacy
조직 범주 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategory/delete
조직 범주 멤버십 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategorymembership/store
조직 범주 멤버십 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategorymembership/refresh
조직 범주 멤버십 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategorymembership/refreshlegacy
조직 범주 멤버십 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationcategorymembership/delete
조직 멤버십 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationmembership/store
조직 멤버십 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationmembership/refresh
조직 멤버십 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationmembership/refreshlegacy
조직 멤버십 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/organizationmembership/delete
개인 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/person/store
개인 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/person/refresh
개인 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/person/refreshlegacy
개인 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/person/delete
학기 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/term/store
학기 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/term/refresh
학기 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/term/refreshlegacy
학기 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/term/delete
사용자 연결 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/userassociation/store
사용자 연결 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/userassociation/refresh
사용자 연결 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/userassociation/refreshlegacy
사용자 연결 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/userassociation/delete
사용자의 교육기관 내 보조 역할 - 저장https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/secondaryinstrole/store
사용자의 교육기관 내 보조 역할 - 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/secondaryinstrole/refresh
사용자의 교육기관 내 보조 역할 - DSK로 전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/secondaryinstrole/refreshlegacy
사용자의 교육기관 내 보조 역할 - 삭제https://<servername.domain.edu>/webapps/bb-data-integration-flatfile-BB<DATABASEIDENTIFIER>/endpoint/secondaryinstrole/delete

레거시 스냅숏에 익숙한 경우 학생 정보 시스템의 프레임워크 플랫 파일 유형은 지원되는 새 데이터 객체에 헤더를 추가하는 것 외에는 형식을 변경하지 않습니다. 자세히 알아보려면 스냅숏 플랫 파일 데이터 형식스냅숏 플랫 파일 예를 참조하십시오.

XML용 스냅숏 작업 엔드포인트

이 정보를 사용하여 XML 피드 파일을 이 통합에 게시하도록 학생 정보 시스템을 설정하십시오. 저장된 객체는 계속 보관되며 해당 데이터도 유지됩니다. 삭제된 객체는 제거됩니다. '전체 새로 고침'을 수행하면 피드 파일에 없는 모든 기존 객체가 제거됩니다. 잘못된 객체 유형이 들어 있는 객체를 게시하는 작업은 실패합니다.

작업엔드포인트
기록 상태 사용https://<servername.domain.edu>/webapps/bb-data-integration-ss-xml-BB<DATABASEIDENTIFIER>/endpoint
전체 새로 고침https://<servername.domain.edu>/webapps/bb-data-integration-ss-xml-BB<DATABASEIDENTIFIER>/endpoint/refresh
삭제만https://<servername.domain.edu>/webapps/bb-data-integration-ss-xml-BB<DATABASEIDENTIFIER>/endpoint/delete

자세히 알아보기

SIS Framework 개요

데이터 소스 키 개요