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

다음 예제에서는 사용자 데이터 피드를 구성하는 다양한 사용 사례를 보여줍니다. 이 예제들은 가능한 가장 간단한 데이터 피드를 활용합니다. 기관에서 추가 정보를 요구하는 경우가 있으며, 필요한 헤더와 데이터를 데이터 피드에 추가함으로써 이를 충족시킬 수 있습니다. 교육 기관의 정보 시스템과 등록 기관의 요구 사항 및 계획을 분석하면 데이터와 수명 주기 목표를 충족하기 위해 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 로그인에 필요하지만 개인 데이터 피드에서 필수 필드는 아닙니다. 데이터 피드에 비밀번호를 제공하지 않으면 임의로 생성된 SHA512 비밀번호가 Blackboard 데이터베이스에 저장됩니다. 외부(예: LDAP) 인증을 사용할 때는 문제가 없으나, Blackboard 데이터베이스에 사용자 로그인 비밀번호를 저장할 경우 어떻게 되는지 궁금하신가요? 사용자를 생성할 때 로그인이 불가능하므로 비밀번호를 제공해야 합니다.

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

인간 조작 예

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

마지막으로, 이는 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의 개인 기록이 작성됩니다.

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

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

전제 조건

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

해결 방법

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

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

사후 조건

aanderson_test에 대한 개인 기록에 제공된 이메일 주소가 포함되도록 업데이트됩니다.

bbrown_test 및 gcarlin_test의 개인 기록은 영향을 받지 않습니다.

사람: 새로고침 작업 완료

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

예: 새로 고침 완료

SIS에서 제공한 데이터에는 Blackboard 접근이 필요한 사용자 전체 스냅샷이 포함됩니다. 이 데이터에는 추가해야 할 개인 기록, 업데이트해야 할 개인 기록 및 구성(사용하지 않거나 삭제된 경우)에 따라 적절히 처리해야 하는 이전 COMPLETE REFRESH 작업 이후 제거된 레코드가 포함되어 있습니다.

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

해결 방법

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

사후 조건

aanderson_test의 개인 기록은 유지되며 영향을 받지 않습니다.

bbrown_test의 사용자 기록은 유지되며 이메일 주소로 업데이트됩니다.

gcarlin_test에 대한 개인 기록은 통합 구성에 따라 사용할 수 없거나 삭제할 준비가 되었다고 표시됩니다.

사람: 데이터 원본별 작업 새로고침 완료

데이터 소스별 새로 고침은 새로 고침 완료 작업을 수행하되, 영향을 받는 데이터를 해당 통합의 데이터 소스와 연결된 데이터로만 제한합니다.

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

SIS에서 제공한 데이터에는 Blackboard 접근이 필요한 사용자 전체 스냅샷이 포함됩니다. 이 데이터에는 추가해야 할 개인 기록, 업데이트해야 할 개인 기록 및 구성(비활성화 또는 삭제)에 따라 적절히 처리해야 하는 이전 REFRESH 작업 후 제거된 레코드가 포함되어 있습니다. 새로 고침에 사용되는 모든 데이터는 통합에 정의된 동일한 데이터 소스를 사용하여 타깃팅되며, 관련 데이터 소스 키와 연관된 데이터에만 영향을 미치기를 원한다.

전제 조건

없음.

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME

해결 방법

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

사후 조건

aanderson_test의 개인 기록은 유지되며 영향을 받지 않습니다.

bbrown_test의 사용자 기록은 유지되며 이메일 주소로 업데이트됩니다.

이전에 작성된 gcarlin_test의 개인 기록은 사용할 수 없는 것으로 표시되었거나 통합 구성에 따라 삭제될 예정입니다.

해당 통합에서 관리되는 다른 사용자 기록이 있더라도, 통합에서 지정한 데이터 소스가 아닐 경우 데이터 피드에 없어도 비활성화되거나 삭제되지 않습니다.

개인 계정 사용 가능 여부

Blackboard 계정의 가용성 설정을 통해 로그인(사용 가능) 혹은 로그인하지 않음(사용 불가) 상태를 조정할 수 있습니다. 계정을 비활성화한다는 것은 사용할 수 없게 만드는 것뿐만 아니라 멤버십 관리 등 추가 작업에도 사용할 수 없게 됨을 의미하며, 이는 단순히 계정 사용을 중지하는 것과는 다릅니다. 이 데이터 피드 헤더를 추가해도 앞서 설명한 개인 기록 생성을 위한 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의 개인 기록만 업데이트되었으며(이전에 작성됨), ddarling_test는 새로 작성됩니다.

완전한 새로고침

aanderson_test, bbrown_test 및 gcarlin_test의 개인 기록이 업데이트되었으며 ddarling_test가 작성되었습니다. 위 데이터 피드에 없는 다른 모든 레코드는 비활성화되거나 삭제될 것으로 표시됩니다.

데이터 소스별 새로고침 완료

aanderson_test, bbrown_test 및 gcarlin_test의 개인 기록이 업데이트되었으며 ddarling_test가 작성되었습니다.

해당 통합에서 관리되는 다른 사용자 기록이 있더라도, 통합에서 지정한 데이터 소스가 아닐 경우 데이터 피드에 없어도 비활성화되거나 삭제되지 않습니다. 데이터 소스별 새로 고침은 해당 통합의 데이터 소스 레코드에만 적용됩니다.

개인기록을 사용하지 않음

Blackboard에서 개인 기록을 비활성화하면 로그인 목적으로 접근할 수 없게 되며(비활성화 상태가 가용성 설정을 재정의함), UI 작업 시 해당 기록에 접근할 수 없습니다. 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에 대한 개인 기록만 작성되거나 명시적으로 업데이트되는 ROW_STATUS가 있습니다.

완전한 새로고침

aanderson_test, bbrown_test, gcarlin_test 및 ddarling_test에 대한 개인 기록이 작성되거나 업데이트됩니다. 다른 모든 기록은 위 데이터 피드에 없으므로 비활성화되거나 삭제될 것으로 표시됩니다.

데이터 소스별 새로고침 완료

aanderson_test, bbrown_test, gcarlin_test 및 ddarling_test의 개인 기록이 작성되거나 업데이트되며, ROW_STATUS가 명시적으로 업데이트됩니다.

해당 통합에서 관리되는 다른 사용자 기록이 있더라도, 통합에서 지정한 데이터 소스가 아닐 경우 데이터 피드에 없어도 비활성화되거나 삭제되지 않습니다. 데이터 소스별 새로 고침은 해당 통합의 데이터 소스 레코드에만 적용됩니다.

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

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

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

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

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

전제 조건

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

최소 데이터 피드 요건

EXTERNAL_PERSON_KEY
ROLE_ID

해결 방법

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

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

사후 조건

STORE

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

완전한 새로고침

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

데이터 소스별 새로고침 완료

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

해당 통합에서 관리되는 다른 사용자 기록이 있더라도, 통합에서 지정한 데이터 소스가 아닐 경우 데이터 피드에 없어도 비활성화되거나 삭제되지 않습니다. 데이터 소스별 새로 고침은 해당 통합의 데이터 소스 레코드에만 적용됩니다.

참관인

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

옵저버 계정 생성에는 사용자 계정과 동일한 정보가 필요하고, 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_학생_100_observer|test_학생_100 간 연결을 작업 데이터 세트에서 삭제하려면 삭제 작업이 포함된 피드 파일을 생성하여 업로드하세요.

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

기존 연결을 업데이트하거나 새 연결을 저장할 수 있는 데이터의 하위 집합을 비활성화하려면, 연결 파일을 생성하여 기존 연결과 새 연결을 포함시키고, 비활성화할 연결을 제거한 후 새로 고침 작업 완료로 업로드하십시오. 예를 들어, 다음과 같은 작업 세트를 사용합니다.

test_student_200_observer|test_student_200 연결을 비활성화하고 파일에 test_student_100_observer|test_student_100 연결만 포함되도록 조정하겠습니다. 새로운 연결 두 개를 추가하려면(사용자 계정 생성이 전제되는 경우) 다음 사항을 업로드하세요.

사후 조건

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

자세히 알아보기