스냅샷 플랫 파일

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

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

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

지원되는 데이터

요구 사항

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

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

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

설정: 스냅숏 통합 유형

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

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

1. 통합 생성을 선택합니다.

2. 스냅숏 XML 또는 스냅숏 플랫 파일을 선택합니다. 다음 화면에서 구성 옵션을 선택합니다. 

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

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

스냅숏 통합을 지원하려면 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을 공유 사용자 ID로 대체

SHARED_PASSWORD를 공유 비밀번호로 대체

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

ENDPOINT_URL을 엔드포인트 URL로 대체

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

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

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

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

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

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

스냅숏 통합

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

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

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

데이터 파일 생성

1. 관리자 도구의 통합에서 데이터 통합을 선택합니다.
2. 학생 정보 시스템 통합을 선택합니다.
3. 파일을 수동으로 생성하는 경우 통합 생성 드롭다운 메뉴에서 스냅샷 플랫 파일을 선택합니다.
4. 통합 이름을 입력합니다(필수). 설명을 입력하는 옵션이 제공됩니다.
5. 공유 사용자 ID 및 공유 비밀번호를 입력하여 보안을 추가할 수 있습니다. 이는 엔드포인트에 게시하는 데 더 자주 사용됩니다.
6. 피드 파일 구분 기호에서 데이터 파일의 필드를 구분하는 문자를 선택합니다.
7. 통합 상태에서 비활성, 활성 또는 테스트 중 하나를 선택합니다.
8. 로그 상세 표시 수준에서 원하는 로그의 세부 수준을 선택합니다.  

데이터 지원 영역에서는 논리적 데이터 세분화를 수행할 수 있습니다.  예를 들어 서로 다른 두 캠퍼스에 대해 서로 다른 학생 정보 시스템이 두 개 있는 경우 이 두 캠퍼스를 세분화할 수 있습니다(또는 다른 학기에 대한 데이터를 세분화하려는 경우).  

1. Learn 데이터 소스에서는 데이터 소스를 인바운드 데이터에 정의할지 또는 모든 새 인바운드 데이터에 동일한 Learn 데이터 소스를 사용할지 선택할 수 있습니다.  
2. 배치 UID 접두사를 입력하는 옵션이 있습니다. 이는 ID 충돌을 방지하기 위해 이 통합에서 생성된 객체의 식별자에 접두사를 붙이는 데 사용됩니다. 이 통합에 대한 데이터를 생성한 후에는 수정하지 않는 것이 좋습니다.
3. 상위 계층 노드에서 노드 배치를 선택합니다.

고급 구성에는 예를 들어 특정 레코드가 배치에 없는 상황을 처리하는 옵션 배열이 있습니다. 이 사용 사례에서는 기본 선택 항목을 그대로 둡니다.

데이터를 입력했으면 제출을 선택합니다. 이렇게 하면 통합을 위한 파일이 생성됩니다.

통합을 위한 데이터 파일 업로드:  

1. 관리자 패널의 통합에서 데이터 통합을 선택합니다.
2. 학생 정보 시스템 통합을 선택합니다.
3. 업로드할 파일의 메뉴를 선택합니다. 피드 파일 업로드를 선택합니다.
4. 데이터 유형 메뉴에서 데이터 형식을 선택합니다. 통합의 가장 일반적인 항목은 계층 노드(파일이 계층을 나타내는 경우), 코스 연계, 조직 연계 및 사용자 연계입니다.  
5. 작업 유형의 경우 가장 일반적인 옵션은 저장입니다. 
   • 전체 데이터 비교를 수행하고 파일에 없는 항목을 삭제하려는 경우 전체 새로 고침을 사용합니다. 이 옵션을 사용할 때는 주의해야 합니다. 
   • 삭제를 사용하여 업로드 중인 기록을 삭제합니다.  
6. 제출을 선택합니다.

SIS 로그를 확인하여 추가되었는지 확인할 수 있습니다. 큰 파일의 경우 업로드하는 데 몇 분 정도 걸릴 수 있습니다. 도구 및 유틸리티에서 로그를 선택한 다음 SIS 로그를 선택합니다. 

스냅숏 엔드포인트

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

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

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

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

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

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

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

자세히 알아보기

학생 정보 시스템 프레임워크 개요

데이터 소스 키 개요