스냅숏 플랫 파일 사용자 예시

다음 예제에서는 사용자 데이터 피드를 구성하는 다양한 사용 사례를 보여줍니다. 이 예제들은 가능한 가장 간단한 데이터 피드를 활용합니다. 기관에서 추가 정보를 요구하는 경우가 있으며, 필요한 헤더와 데이터를 데이터 피드에 추가함으로써 이를 충족시킬 수 있습니다. 교육 기관의 정보 시스템과 등록 기관의 요구 사항 및 계획을 분석하면 데이터와 수명 주기 목표를 충족하기 위해 Blackboard에 적절히 입력해야 할 데이터의 깊이를 결정하는 데 도움이 됩니다.

사용자

사용자 데이터는 Blackboard에 접근 가능한 사용자, 교육 기관 내 역할 및 Blackboard 시스템 내 역할을 설명하는 기본 정보 집합입니다. SIS 데이터 맥락에서 USER 개체는 종종 ‘PERSON’으로 지칭되며, 이는 기존 표준을 반영한 것입니다. Blackboard는 맥락에 따라 사용자 관련 기록을 참조할 때 "PERSON" 및 "USER"를 사용합니다. 다음 예에서 "PERSON" 태그는 레코드를, "USER" 태그는 사람을 나타냅니다.

스냅샷 플랫 파일 데이터 관리

SIS 프레임워크는 UI 피드 업로드 및 Blackboard 시스템이 제공하는 URL 집합을 통한 스냅샷 플랫 파일 데이터 피드 업로드를 지원합니다.

시스템 관리 > 데이터 통합 > 학생 정보 시스템 통합 UI의 통합 메뉴에서 HTTP 정보에 접근하고 피드 파일을 업로드합니다.

두 경우 모두 데이터 작업은 통합 구성 및 선택한 작업 유형에 따라 결정된다. 선택한 데이터 작업 유형은 피드 데이터가 어떻게 ‘해석’되는지 결정하며, 각 URL은 통합 목표에 맞는 서로 다른 결과를 제공합니다.

Blackboard에 제공된 데이터는 업데이트, 제거 또는 수정될 수 있습니다. 그러므로 가장 기본적인 데이터 세트부터 시작하여 교육 기관의 데이터 요구 사항이 변할 때마다 그에 맞춰 확장할 수 있습니다.

UI와 HTTP를 통해 다음 작업을 사용할 수 있습니다.

PERSON이 작업하는 중인 오브젝트는 다음과 같습니다.

제공된 예제는 스냅숏 프레임워크 UI 피드 파일 업로드 기능을 사용하여 시연됩니다. 명령줄 및 프로그래밍 작업을 자동화하거나 활용하려면 스냅숏 플랫 파일 자동화를 참조하세요.

데이터 소스 키에 대한 알림

모든 데이터 객체는 해당 데이터 세트 내에서 그룹화를 위한 데이터 소스 키 변경 기능을 지원하며 연결된 데이터 소스 변경에 사용할 수 있습니다. - 참고: 이는 프레임워크 기반 데이터 피드에서 필수 필드가 아니며, 아래 예제에서 언급하지 않는 이상 통합이 단일 데이터 소스 사용으로 구성되어 있다고 가정합니다.

자세한 내용은 데이터 소스 키 관리를 참고하세요.

필드 매핑 참고 사항

필드 매핑은 들어오는 데이터를 Blackboard에 저장되기 전에 변경할 수 있는 기능을 제공합니다. 저장된 데이터를 완벽하게 제어할 수 있고, 제공된 학생 정보 시스템 데이터가 부족한 경우(예: 사용자 비밀번호 생성)에는 Blackboard의 특정 규칙을 충족할 수 있다. 객체 필드에 적용되면 연결된 스크립트가 사용자별로 실행되어 Blackboard에 저장되기 전에 데이터를 변경하거나 제공합니다. 스냅숏 플랫 파일 필드 매핑에 대한 자세한 내용은 스냅숏 플랫 파일 필드 매핑을 참조하십시오.

비밀번호 참고 사항

Blackboard에 로그인하려면 비밀번호가 필요하지만, PERSON 데이터 피드에서는 필수 필드가 아닙니다. 데이터 피드에 비밀번호가 제공되지 않으면 임의의 SHA512 비밀번호가 생성되어 Blackboard 데이터베이스에 저장됩니다. 외부 인증(예: LDAP)을 사용하는 경우에는 문제가 되지 않지만, Blackboard 데이터베이스를 사용하여 사용자 로그인 비밀번호를 저장하는 경우에는 어떻게 될까요? 이 경우 사용자는 로그인할 수 없으므로, 사용자 생성 시 반드시 비밀번호를 제공해야 합니다.

피드를 실행한 후 비밀번호를 변경하는 사용자의 경우 설정된 비밀번호로 로그인이 중단됩니다. 업데이트 작업 중 암호 필드가 업데이트되지 않도록 선택할 수 있습니다. Blackboard에서 업데이트할 때 현재 비밀번호를 유지할 수 있습니다. 이 옵션을 선택하지 않을 경우 암호가 변경되며 사용자에게 변경 사항을 통보해야 합니다.

Person 작업 예시

세 가지 학생 정보 시스템 통합 데이터 피드 패턴을 개략적으로 모든 사용자 데이터 작업에 적용할 수 있으며, 패턴 선택은 제공 가능한 데이터 및 통합 목표에 따라 달라집니다.

마지막으로, 이는 SIS 피드 패턴은 아니지만 언급할 만하며, UI의 데이터 소스 관리 도구를 사용하여 DSK 기준으로만 비활성화하거나 삭제할 수 있습니다. 이 방식으로 SIS에서 제공된 데이터를 관리할 때는 주의가 필요합니다. 학생 정보 시스템에서 제공되지 않거나 더 이상 제공되지 않는 데이터를 삭제할 때, 이는 테스트 작업 결과 데이터와 같은 경우에 매우 유용합니다.

기본 사항: 인간

사용자 계정을 설정하려면 기본 정보 집합이 필요합니다. 이 정보 집합은 스냅숏 플랫 파일 데이터 형식과 스냅숏 플랫 파일 헤더에 자세히 설명되어 있습니다.

데이터 요약

Blackboard에서 사용자 계정을 생성할 때 필요한 최소 데이터 세트 또는 헤더는 다음과 같습니다.

SIS 프레임워크는 통합 구성을 기반으로 필수가 아닌 필드의 기본값을 제공하거나 무시합니다. PERSON의 피드에서 필요하지 않은 두 개의 유용한 필드는 EMAIL과 SYSTEM_ROLE입니다. Blackboard 이메일을 통해 사용자들에게 알림을 주고받고 제공하기 위해서는 EMAIL이 필수적이므로 이 데이터를 피드에 제공하는 것이 좋습니다. SYSTEM_ROLE의 기본값은 구성된 설정인 NONE입니다.

개인정보 추가

PERSON정보를 추가하는 경우는 두 가지가 있습니다. 데이터 피드에 표시된 대로 레코드를 추가하거나 업데이트할 때 PERSON 정보를 추가로 저장하는 것이 첫 번째입니다. Blackboard에 이미 있는 개인정보를 새로 고친 후 데이터 파일에 표시된 대로 새 레코드를 추가하거나 기존 레코드를 업데이트하고, 데이터 파일에 없는 기존 레코드는 비활성화합니다.

점포 운영 사례

예제 #1: 개인계정 생성하기

Blackboard에 기존 계정에 영향을 주지 않고 사용자를 추가하는 방법. 모든 들어오는 데이터에 대해 동일한 데이터 소스를 사용하도록 통합이 설정되어 있습니다.

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

해결 방법

시스템에 추가할 각 PERSON의 필수 헤더와 데이터를 포함한 PERSONS.txt 파일을 생성합니다. 예:

STORE 작업을 사용하여 UI를 통해 이 파일을 PERSON 데이터 형식으로 업로드합니다. 사용자 계정이 생성되어 로그인할 수 있습니다.

사후 조건

aanderson_test, bbrown_test 및 gcarlin_test에 대한 PERSON 레코드가 생성됩니다.

예제 #2: 사용자 계정 업데이트

사용자 계정이 생성되었으며 변경이 필요합니다. 이전 예제에는 사용자의 이메일 주소가 포함되어 있지 않았습니다. aanderson_test의 이메일 주소가 있습니다.

전제 조건

업데이트는 기존 레코드에 적용되며, Blackboard에 레코드가 없는 경우 새로운 레코드가 생성됩니다.

해결 방법

시스템에 추가할 각 PERSON의 필수 헤더와 데이터를 포함한 PERSONS.txt 파일을 생성합니다. 예:

STORE 작업을 사용하여 UI를 통해 이 파일을 PERSON 데이터 형식으로 업로드합니다. 사용자 계정이 업데이트되고 있습니다.

사후 조건

aanderson_test에 대한 PERSON 레코드가 제공된 이메일 주소를 포함하도록 업데이트됩니다.

bbrown_test 및 gcarlin_test에 대한 PERSON 레코드는 영향을 받지 않습니다.

개인: 전체 새로 고침 작업

COMPLETE REFRESH는 STORE와는 다르게 작동합니다. COMPLETE REFRESH는 피드 파일 데이터와 Blackboard에 있는 레코드를 비교하여 새 레코드를 저장하고, 기존 레코드를 업데이트하며, 데이터 파일에 없는 Blackboard 레코드를 비활성화하는 두 가지 작업을 수행합니다.

예: 전체 새로 고침

SIS에서 제공하는 데이터에는 Blackboard에 액세스해야 하는 PERSON에 대한 전체 스냅샷이 포함됩니다. 이 데이터에는 추가할 PERSON 레코드, 업데이트할 PERSON 레코드, 그리고 이전 COMPLETE REFRESH 작업 이후 제거된 레코드가 포함되며, 이러한 레코드는 구성에 따라 적절히 처리되어야 합니다(비활성화 또는 삭제).

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

해결 방법

마지막 저장 작업의 데이터를 사용하여 데이터 피드에서 gcarlin_test를 제거합니다.

사후 조건

aanderson_test에 대한 PERSON 레코드는 유지되며 영향을 받지 않습니다.

bbrown_test에 대한 PERSON 레코드는 유지되며 이메일 주소를 포함하도록 업데이트됩니다.

gcarlin_test에 대한 PERSON 레코드는 통합 구성에 따라 비활성화되었거나 삭제 준비 상태로 표시됩니다.

개인: 데이터 소스별 전체 새로 고침 작업

COMPLETE REFRESH BY DATA SOURCE는 COMPLETE REFRESH 작업을 수행하지만, 영향을 받는 데이터를 통합의 데이터 소스와 연관된 데이터로만 제한합니다.

예: 데이터 소스별 전체 새로 고침

SIS에서 제공하는 데이터에는 Blackboard에 액세스해야 하는 PERSON에 대한 전체 스냅샷이 포함됩니다. 이 데이터에는 추가할 PERSON 레코드, 업데이트할 PERSON 레코드, 그리고 이전 REFRESH 작업 이후 제거된 레코드가 포함되며, 이러한 레코드는 구성에 따라 적절히 처리되어야 합니다(비활성화 또는 삭제). 또한 이 새로 고침에 포함된 모든 데이터는 통합에서 정의된 동일한 데이터 소스를 사용하여 대상이 지정되며, 이 데이터 소스 키와 관련된 데이터만 영향을 받도록 합니다.

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

해결 방법

마지막 저장 작업의 데이터를 사용하여 데이터 피드에서 gcarlin_test를 제거합니다.

사후 조건

aanderson_test에 대한 PERSON 레코드는 유지되며 영향을 받지 않습니다.

bbrown_test에 대한 PERSON 레코드는 유지되며 이메일 주소를 포함하도록 업데이트됩니다.

이전에 생성된 gcarlin_test에 대한 PERSON 레코드는 통합 구성에 따라 비활성화되었거나 삭제 준비 상태로 표시됩니다.

이 통합에서 관리되는 다른 PERSON 레코드는 통합에서 지정한 동일한 데이터 소스를 사용하는 경우가 아니라면, 위 데이터 피드에 포함되어 있지 않더라도 비활성화되거나 삭제되지 않습니다.

개인 계정 사용 가능 여부

PERSON 계정 가용성 설정은 Blackboard에서 계정이 로그인할 수 있는지(가용) 또는 로그인할 수 없는지(비가용)를 제어합니다. 이는 계정을 비활성화하는 것과는 다르며, 비활성화는 계정을 로그인할 수 없게 할 뿐만 아니라 구성원 관리와 같은 추가 작업에도 사용할 수 없음을 의미합니다. 이 데이터 피드 헤더를 추가하더라도 PERSON 레코드를 생성하기 위해 앞서 설명된 STORE, COMPLETE REFRESH, COMPLETE REFRESH BY DATA SOURCE의 사용 방식에는 영향을 미치지 않습니다.

개인 계정 사용 가능 여부

학생 정보 시스템은 사용자가 Blackboard에 접근할 수 있는지를 제어하고, 데이터 피드는 개별 사용자의 접근 가능 여부를 나타냅니다. 개별 사용자 액세스를 변경하기 위해 PERSON 생성/업데이트를 사용하려고 합니다.

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
AVAILABILE_IND

해결 방법

데이터 피드에 AVAILABLE_IND 헤더를 추가하고, 사용 가능 시 Y, 사용 불가 시 N을 입력합니다.

사후 조건

STORE

aanderson_test, bbrown_test 및 gcarlin_test에 대한 PERSON 레코드만 업데이트되며(이전 생성됨), ddarling_test에 대한 PERSON 레코드는 새로 생성됩니다.

COMPLETE REFRESH (전체 새로 고침)

aanderson_test, bbrown_test 및 gcarlin_test에 대한 PERSON 레코드는 업데이트되며(이전 생성됨), ddarling_test에 대한 PERSON 레코드는 새로 생성됩니다. 위 데이터 피드에 포함되어 있지 않은 다른 모든 레코드는 비활성화되거나 삭제 준비 상태로 표시됩니다.

COMPLETE REFRESH BY DATA SOURCE (데이터 소스별 전체 새로 고침)

aanderson_test, bbrown_test 및 gcarlin_test에 대한 PERSON 레코드는 업데이트되며(이전 생성됨), ddarling_test에 대한 PERSON 레코드는 새로 생성됩니다.

이 통합에서 관리되는 다른 PERSON 레코드는 통합에서 지정한 동일한 데이터 소스를 사용하는 경우가 아니라면, 위 데이터 피드에 포함되어 있지 않더라도 비활성화되거나 삭제되지 않습니다. COMPLETE REFRESH BY DATA SOURCE는 통합 데이터 소스의 레코드에만 적용됩니다.

개인기록을 사용하지 않음

Blackboard에서 PERSON 레코드를 비활성화하면 로그인할 수 없게 되며(비활성화 상태는 가용성 설정보다 우선 적용됨), UI 작업에서도 해당 레코드에 접근할 수 없게 됩니다. 예를 들어, 비활성화된 PERSON은 UI를 통해 강좌에 추가할 수 없습니다. 또한 Blackboard에서 레코드를 삭제하려면 해당 레코드를 먼저 비활성화해야 합니다.

레코드 비활성화는 REFRESH 작업으로 피드 데이터를 제외하거나 피드 헤더 ROW_STATUS를 사용하여 비활성화하는 두 가지 방식을 따를 수 있습니다.

위의 PERSON 작업에서 REFRESH 작업을 사용하는 예는 제외를 통해 비활성화되는 것을 보여주며, 다음 예시는 ROW_STATUS 사용을 통해 설명됩니다.

개인 기록 사용 안함

학생이 입학하거나 Blackboard에 더 이상 접근할 필요가 없을 때. Blackboard 접근성 및 존재감을 완전히 제거해야 합니다(로그인만을 제한하는 기록을 사용하지 못하게 설정하는 것과는 다릅니다). STORE 작업을 사용할 때 사용자를 비활성화하려면 ROW_STATUS 헤더를 사용하여 사용자를 명시적으로 비활성화해야 합니다. 학생 정보 시스템 피드 범위를 벗어난 수동 작업에서도 유용하다.

전제 조건

대상 기록은 Blackboard 시스템 내에 존재합니다.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
ROW_STATUS

해결 방법

데이터 피드에 'ROW_STATUS' 헤더를 추가하여 활성화 상태일 때는 'ENABLED', 비활성화 상태일 때는 'DISABLED' 항목을 제공합니다.

사후 조건

STORE

aanderson_test, bbrown_test, gcarlin_test 및 ddarling_test에 대한 PERSON 레코드만 생성되거나 업데이트되며, ROW_STATUS는 명시적으로 업데이트됩니다.

COMPLETE REFRESH (전체 새로 고침)

aanderson_test, bbrown_test, gcarlin_test 및 ddarling_test에 대한 PERSON 레코드는 생성되거나 업데이트됩니다. 위 데이터 피드에 포함되어 있지 않은 다른 모든 레코드는 비활성화되거나 삭제 준비 상태로 표시됩니다.

COMPLETE REFRESH BY DATA SOURCE (데이터 소스별 전체 새로 고침)

aanderson_test, bbrown_test, gcarlin_test 및 ddarling_test에 대한 PERSON 레코드는 생성되거나 업데이트되며, ROW_STATUS는 명시적으로 업데이트됩니다.

이 통합에서 관리되는 다른 PERSON 레코드는 통합에서 지정한 동일한 데이터 소스를 사용하는 경우가 아니라면, 위 데이터 피드에 포함되어 있지 않더라도 비활성화되거나 삭제되지 않습니다. COMPLETE REFRESH BY DATA SOURCE는 통합 데이터 소스의 레코드에만 적용됩니다.

사용자 지원 교육 기관의 역할 관리

커뮤니티 라이센스 사용자는 할당 가능한 추가 역할에 접근할 수 있으며, 이는 커뮤니티 포털의 자료와 탭 접근을 관리하는 데 유용하다.

보조 역할 관리는 사용자 생성이나 업데이트와는 별개의 활동이므로, PERSON 생성/업데이트 데이터 피드에 포함되지 않습니다.

예: 사용자 지원을 위한 교육기관의 역할 추가

공과대학 학생들과 교수진에게 관련된 포털 콘텐츠를 제공해야 합니다.

전제 조건

"ENGINEERING_STUDENT"라는 새 학생 역할을 시스템 관리자 UI(참조)를 통해 생성했습니다.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
ROLE_ID

해결 방법

교육기관_Role 피드를 생성하거나 업데이트할 레코드를 포함하여 만듭니다.

보조 역할 및 연결된 콘텐츠에 대한 PERSON의 액세스를 활성화하거나 비활성화하는 ROW_STATUS를 다른 데이터 개체와 마찬가지로 제공할 수 있습니다. 예:

사후 조건

STORE

aanderson_test, bbrown_test, gcarlin_test 및 d에 대한 보조 기관 역할 레코드만 보조 기관 역할로 생성되거나 업데이트됩니다.

COMPLETE REFRESH (전체 새로 고침)

aanderson_test, bbrown_test, gcarlin_test 및 d에 대한 보조 교육기관 역할 레코드가 생성되거나 업데이트됩니다. 다른 모든 레코드는 위의 데이터 피드에 없으므로 비활성화되거나 삭제될 것으로 표시됩니다.

COMPLETE REFRESH BY DATA SOURCE (데이터 소스별 전체 새로 고침)

aanderson_test, bbrown_test, gcarlin_test 및 d의 보조 교육기관 역할 레코드가 생성되거나 업데이트됩니다.

이 통합에서 관리되는 다른 PERSON 레코드는 통합에서 지정한 동일한 데이터 소스를 사용하는 경우가 아니라면, 위 데이터 피드에 포함되어 있지 않더라도 비활성화되거나 삭제되지 않습니다. COMPLETE REFRESH BY DATA SOURCE는 통합 데이터 소스의 레코드에만 적용됩니다.

참관인

관찰자는 계정이 감독이나 관찰 역할로 다른 사용자 계정과 연결된 특별한 경우입니다. 참관인은 로그인하여 연결된 사용자의 강좌와 활동을 볼 수 있습니다.

옵저버 계정을 생성하려면 사용자 계정 생성에 필요한 것과 동일한 정보가 필요하며, 추가로 ‘사용자 연결 관리’ 계층이 포함됩니다. 이 계층에서는 두 계정의 external_person_keys를 연결하여 옵저버 계정을 사용자 계정과 연관시킵니다.

교육기관의 데이터 처리 요구 사항에 맞춰 사용자 계정을 생성하는 것과 동일한 방식으로 참관인 계정도 생성됩니다.

예제 #1: 관찰자 연결 생성

학생의 활동을 관찰할 수 있도록 학부모(또는 기타 적절한 사용자) 계정과 연결하려고 합니다.

전제 조건

external_person_key로 식별되는 학생(예: test_student_100)과 external_person_key로 식별되는 관찰자(예: test_student_100_observer 및 test_student_200_observer)를 만들었습니다.

최소 데이터 요구사항

external_person_key: EXTERNAL_OBSERVER_KEY의 옵저버

학생의 external_person_key: EXTERNAL_USER_KEY 관찰됨

해결 방법

관찰자의 external_person_key 및 학생의 외부 사용자 키가 포함된 데이터 파일을 생성합니다.

Store 작업을 사용하는 UI를 통해 Observer Association 데이터 유형으로 이 파일을 업로드합니다. 참관인으로 로그인하면 학생의 수업 활동을 확인할 수 있는 연결이 생성됩니다.

예제 #2: 관찰자 연결 기록 업데이트

연결을 변경해야 합니다.

전제 조건

test_student_200_observer와 test_student_100 사이에 연결을 만들었지만 연결된 학생 계정은 test_student_200이어야 합니다.

해결 방법

파일에 개정 사항을 포함하여 작성합니다.

Store 작업을 이용한 UI를 통해 Observer 연결 데이터 유형으로 이 파일을 업로드합니다

사후 조건

업데이트된 연결을 통해 참관인으로 로그인하면 해당 학생의 수업 활동을 확인할 수 있습니다.

예제 #3: 관찰자 연결 기록 비활성화

옵저버 협회는 더 이상 필요하지 않아 비활성화할 예정입니다.

전제 조건

학생과 참관인 사이의 연관성을 만들었습니다.

해결 방법

(이 예제 스레드에 사용된 데이터 활용)

Store 메서드와 다음 파일을 사용하여 이전에 연결을 만들었습니다.

관찰자 연결을 비활성화해야 하는 요구 사항을 충족시키기 위한 두 가지 피드 관련 패턴이 있습니다.

서브세트에서 관찰자 연관 기능을 사용하지 않음

연결 피드를 생성하여 삭제 작업을 업로드함으로써 데이터의 하위 집합을 비활성화할 수 있습니다. 예:

작업 데이터 세트에서 test_student_100_observer|test_student_100 간의 연결을 삭제하려면, 아래 내용을 포함한 피드 파일을 생성한 후 Delete 작업을 사용하여 업로드해야 합니다.

새로운/기존 연결을 저장하는 중 관찰자 연결의 일부를 사용하지 않음

기존 연결을 업데이트하거나 새로운 연결을 저장할 수 있도록 하면서 데이터의 하위 집합을 비활성화하려면, 기존 연결과 새로 생성할 모든 연결을 포함한 연결 파일을 생성한 후 비활성화하려는 연결을 제거하고, 해당 파일을 Complete Refresh Operation을 사용하여 업로드하면 됩니다. 예를 들어, 다음과 같은 작업 집합을 사용하는 경우를 들 수 있습니다.

test_student_200_observer|test_student_200 연결을 비활성화하려고 하므로, 파일에는 test_student_100_observer|test_student_100 연결만 포함됩니다. 또한 두 개의 새 연결을 추가하려는 경우(사용자 계정이 이미 생성되었다는 전제 조건을 충족해야 함), 아래 내용을 업로드하면 됩니다.

사후 조건

test_student_200_observer|test_student_200의 레코드가 비활성화됩니다.

자세히 알아보기