다음 예에서는 다양한 사용 사례를 충족하는 사용자(개인) 데이터 피드의 구성을 보여줍니다. 이러한 예에서는 가장 간단한 데이터 피드를 활용합니다. 교육기관에서 더 많은 정보를 필요로 하는 경우 필요한 헤더와 데이터를 데이터 피드에 추가하면 됩니다. 교육기관의 정보 시스템과 학적 담당자의 요구 사항 및 계획을 분석하면 데이터 및 수명 주기 목표를 충족하며 Learn을 적절히 채우는 데 필요한 데이터의 상세 수준을 결정하는 데 도움이 됩니다.
해당 예는 통합 구성 UI에 표시되는 기본 Learn 설정을 기반으로 합니다. 이러한 구성 요소를 변경하면 예의 결과가 변경됩니다. 이러한 설정에 대한 설명은 학생 정보 시스템 프레임워크 개요에서 확인할 수 있습니다. 또한 달리 언급된 내용이 없는 한, 통합은 모든 수신 데이터에 동일한 데이터 소스를 사용하도록 구성되어 있다고 가정합니다.
사용자
사용자 데이터는 Learn에 대한 접근 권한, 교육기관 내 역할 및 Learn 시스템 내 역할을 설명하는 기본 정보 집합입니다. 학생 정보 시스템 데이터의 맥락에서는 사용자 객체를 보통 '개인'이라고 하며, 이는 기존 표준에 반영되어 있습니다. 이러한 여러 표준에 앞서, Learn에서는 '개인' 및 '사용자'를 사용하여 맥락에 따라 사용자 관련 기록을 참조합니다. 다음 예에서는 '개인'을 사용하여 기록을 참조하고 '사용자'를 사용하여 개인을 참조합니다.
스냅숏 플랫 파일의 데이터 관리
학생 정보 시스템 프레임워크에서는 Learn 시스템에서 제공하는 URL 집합 및 UI 피드 업로드를 통해 스냅숏 플랫 파일의 데이터 피드 업로드를 지원합니다.
학생 정보 시스템 통합 UI의 시스템 관리자 데이터 통합에서 사용할 수 있는 통합 메뉴를 통해 HTTP 정보에 접근하고 피드 파일을 업로드하십시오.
두 경우 모두 데이터 작업의 동작은 선택한 작업 유형 및 통합 구성에 따라 진행됩니다. 피드의 데이터가 '해석'되는 방식은 선택한 데이터 작업 유형에 따라 결정되며, 각 URL에서는 원하는 통합 목표를 충족하기 위해 서로 다른 결과를 제공합니다.
이 예에서는 스냅숏 프레임워크의 UI인 피드 파일 업로드 기능을 사용합니다. 명령줄/프로그래밍 작업을 자동화하거나 달리 사용하는 방법을 알아보려면 스냅숏 플랫 파일 자동화를 참조하십시오.
데이터는 Learn에 제공한 이후 업데이트, 제거 또는 수정할 수 있으므로 관리자는 가장 간단한 데이터 집합으로 시작한 뒤 교육기관의 데이터 요구 사항이 변경됨에 따라 데이터를 확대할 수 있습니다.
다음과 같은 작업은 UI 및 HTTP를 통해 사용할 수 있습니다.
| 작업 | 설명 |
|---|---|
| 저장 | 통합 구성에 따라 제공된 기록을 저장 또는 업데이트합니다. 이 작업 유형을 사용하면 피드 파일에 포함된 데이터가 통합에서 소유하는 모든 데이터 소스에서 저장 또는 업데이트됩니다(구성 설정에 따라). 데이터 '소유권', 데이터 소스 및 키에 대한 내용은 학생 정보 시스템 프레임워크 개요에서 참조하십시오. |
| 새로 고침 | 피드 및 Learn에서 제공된 기록을 저장, 업데이트 또는 비활성화합니다. 이 작업을 수행하면 데이터 피드에 포함된 데이터가 저장 또는 업데이트되는 동시에, 통합과 연결된 데이터 피드에 포함되어 있지 않은 데이터가 모든 데이터 소스에서 비활성화됩니다. |
| 삭제 | 제공된 기록을 비활성화합니다. 이 작업을 수행하면 통합과 연결된 데이터 피드에 포함된 기록이 통합 설정에 따라 모든 데이터 소스에서 비활성화됩니다. |
| 데이터 소스 기준 새로 고침 완료 | 제공된 기록을 비활성화합니다. SP12에 도입된 이 작업을 선택하면 통합이 구성된 데이터 소스하고만 연결된 데이터가 전체적으로 새로 고쳐집니다. 이 작업을 수행하면 데이터를 새로 고치기 위해 명령줄 스냅숏 프로세스가 더 면밀히 에뮬레이트됩니다. |
개인 작업과 연결된 객체는 다음과 같습니다.
| 개인 | 저장, 새로 고침 완료, 삭제, 데이터 소스 기준 새로 고침 완료 |
| 사용자의 교육기관 내 2차 역할 | 저장, 새로 고침 완료, 삭제, 데이터 소스 기준 새로 고침 완료 |
| 사용자 연결 | 저장, 새로 고침 완료, 삭제, 데이터 소스 기준 새로 고침 완료 |
사용자 연결 예시는 계층 예시 섹션에서 찾을 수 있습니다.
제공된 예에서는 스냅숏 프레임워크의 UI인 피드 파일 업로드 기능을 사용합니다. 명령줄/프로그래밍 작업을 자동화하거나 달리 활용하는 방법을 알아보려면 스냅숏 플랫 파일 자동화를 참조하십시오.
데이터 소스 키에 대한 미리 알림
모든 데이터 객체는 해당 데이터 집합을 그룹화하기 위해 데이터 소스 키를 변경하는 기능을 지원하며, 연결된 데이터 소스를 변경하는 데 사용될 수 있습니다. 참고: 이는 프레임워크 기반 데이터 피드에서 필수 필드가 아니며, 달리 언급된 내용이 없는 한 아래의 예에서는 통합이 단일 데이터 소스를 사용하도록 구성되었다고 가정합니다.
SP12에는 새 데이터 소스를 지정하는 것과 별개로 데이터 피드에서 데이터 소스를 지정하는 기능이 도입되었습니다.
자세히 알아보려면 데이터 소스 키 관리를 참조하십시오.
필드 매핑에 대한 참고 사항
필드 매핑을 사용하면 Learn에 저장되기 전에 수신 데이터를 변경할 수 있습니다. 이 기능을 사용하면 저장된 데이터를 완벽하게 제어할 수 있으며, 제공된 학생 정보 시스템 데이터가 충분하지 않은 경우 Learn용 규칙을 충족할 수 있습니다(예: 사용자 비밀번호를 생성하는 경우). 사용자 객체 필드에 적용되면 연결된 스크립트가 사용자별로 실행되어 Learn에 저장되기 전에 데이터를 변경하거나 제공합니다. 스냅숏 플랫 파일의 필드 매핑에 대한 자세한 설명은 스냅숏 플랫 파일의 필드 매핑에 나와 있습니다.
비밀번호에 대한 참고 사항
비밀번호는 Learn에 로그인하는 데 필요하지만 개인 데이터 피드의 필수 필드는 아닙니다. 비밀번호가 데이터 피드에서 제공되지 않은 경우 무작위 SHA512 비밀번호가 생성되어 Learn 데이터베이스에 저장됩니다. 이는 LDAP와 같은 외부 인증을 사용하는 경우에는 문제가 되지 않습니다. 그러나 사용자 로그인 비밀번호를 저장하는 데 Learn 데이터베이스를 사용하면 어떤 일이 발생할까요? 사용자가 로그인할 수 없게 되므로 사용자 생성 시 비밀번호를 제공해야 합니다.
피드를 실행하고 비밀번호를 나중에 변경하는 사용자를 위해 비밀번호를 설정하면 해당 사용자의 로그인이 중단됩니다. 예 및 아니요 - 업데이트 작업 시 비밀번호 필드를 업데이트하지 않도록 선택할 수 있습니다. 그러면 Learn이 업데이트 시 현재 비밀번호를 유지할 수 있습니다. 이 옵션을 선택하지 않으면 비밀번호가 변경되며 사용자에게 변경 사항을 통지해야 합니다.
개인 작업 예시
상위 수준에서 모든 사용자 데이터 작업에 세 가지 학생 정보 시스템 통합 데이터 피드 패턴을 적용할 수 있으며, 어떤 패턴을 선택할지는 제공할 수 있는 데이터와 통합 목표에 따라 달라집니다.
- 단일 피드 파일을 사용하여 파일에 있는 데이터를 통해 기록을 명시적으로 변경하면서 기록을 생성 또는 업데이트하거나 비활성화(저장)할 수 있습니다.
- 단일 피드 파일을 사용하여 데이터를 새로 고칠 수 있습니다. 즉, 파일에 데이터가 있는지(생성/업데이트), 아니면 없는지에 따라 기록을 변경하여 기록을 생성 또는 업데이트하거나 비활성화(새로 고침 완료)할 수 있습니다.
- 파일 조합을 사용하여 하나의 조합으로 저장하고, 또 다른 조합으로 '사용 가능성'을 설정하거나 비활성화할 수 있습니다.
마지막으로, 학생 정보 시스템 피드 패턴은 아니지만 알아두면 유용한 사항은 UI에서 사용할 수 있는 데이터 소스 관리 도구를 활용하면 DSK만을 기반으로 하여 비활성화 및 제거할 수도 있다는 점입니다. 이러한 방식으로 학생 정보 시스템에서 제공한 데이터를 관리할 때는 매우 신중해야 합니다. 이는 학생 정보 시스템을 통해 제공된 적이 없거나 더 이상 제공되지 않는 데이터(테스트 작업의 결과인 데이터 등)를 제거할 때 매우 유용합니다.
기본 사항: 개인
모든 사용자 계정에는 계정을 설정하기 위한 기본 정보 집합이 필요합니다. 이 정보 집합은 스냅숏 플랫 파일의 데이터 형식 및 스냅숏 플랫 파일의 헤더에 자세히 설명되어 있습니다.
현재 UI 배치 도구를 사용 중인 경우 학생 정보 시스템 프레임워크를 사용하고 학생 정보 시스템 프레임워크의 UI 업로드 기능 및 최소 사용자 데이터를 사용하도록 전환하면 데이터 수집 프로세스를 변경하지 않고도 데이터 업로드를 더 잘 기록 및 보고할 수 있습니다.
데이터 요약
Learn에서 사용자 계정을 생성하는 데 필요한 최소 데이터 집합 또는 헤더는 다음과 같이 구성됩니다.
- EXTERNAL_PERSON_KEY - 이 사용자 기록의 고유 식별자입니다.
- DATA_SOURCE_KEY - 이 기록의 데이터 집합에 대한 고유 식별자입니다. 참고: 이는 피드에서 또는 통합 구성을 통해 제공됩니다.
- USER_ID - 사용자의 ID입니다. 이는 사용자 ID로 로그인하는 데 사용되며, 외부 인증을 사용하는 경우 사용자의 LDAP CN, NET ID 또는 기타 외부 식별자와 연결되어야 합니다.
- FIRST_NAME - 사용자의 이름입니다.
- LAST_NAME - 사용자의 성입니다.
- PASSWD - 이 사용자의 비밀번호입니다.
데이터 피드에서 비밀번호를 제공할 수 없는 경우 비밀번호를 동적으로 할당하는 예를 살펴보려면 스냅샷 플랫 파일의 사용자 지정 필드 매핑을 참조하십시오.
통합 구성에 따라 학생 정보 시스템 프레임워크에서는 필수가 아닌 필드에 기본값을 제공하거나 그러한 필드를 무시합니다. 개인 피드에 대해 필수 항목이 아닌 두 가지 유용한 필드는 EMAIL 및 SYSTEM_ROLE입니다. EMAIL은 Learn 이메일을 통해 Learn 사용자와 서신을 주고받으며 이메일 통지를 제공하는 데 필요하므로 피드에서 이 데이터를 제공하는 것을 고려해야 합니다. SYSTEM_ROLE의 기본 설정은 NONE으로 구성됩니다.
이러한 헤더는 각각 스냅숏 플랫 파일의 데이터 형식에 자세히 설명되어 있습니다.
개인 정보 추가하기
개인 정보를 추가하는 사례로는 두 가지가 있습니다. 첫 번째는 개인 정보를 추가적으로 저장하여 데이터 피드에 표시되는 바와 같이 기록이 추가 또는 업데이트되도록 하는 것입니다. 두 번째는 Learn에 이미 있는 개인 정보를 새로 고쳐서 데이터 파일에 표시되는 바와 같이 기록이 생성되거나 기존 기록이 업데이트되는 동시에 데이터 파일에 표시되어 있지 않은 기존 기록이 비활성화되도록 하는 것입니다.
저장 작업 예시
예 1: 개인 계정 생성하기
기존 계정에 영향을 주지 않고 사용자를 Blackboard Learn에 추가하고자 합니다. 통합은 모든 수신 데이터에 동일한 데이터 소스를 사용하도록 구성되어 있습니다.
전제 조건
없음
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
해결책
시스템에 추가하려는 개인별 필수 헤더 및 연결된 데이터가 포함된 PERSONS.txt 데이터 파일을 생성하십시오. 예:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
testPerson3|gcarlin_test|changeme|Gamma|Carlin
저장 작업을 사용하여 개인 데이터 유형을 통해 UI로 이 파일을 업로드하십시오. 사용자 계정이 생성되고 해당 사용자로 로그인할 수 있습니다.
사후 조건
aanderson_test, bbrown_test, and ccarlin_test에 대한 개인 기록이 생성됩니다.
예 2: 사용자 계정 업데이트하기
사용자 계정을 생성했는데 이를 변경해야 합니다. 예를 들어 이전 예에는 모든 사용자의 이메일 주소가 포함되지 않았습니다. aanderson_test에 대한 이메일 주소를 보유하고 있습니다.
전제 조건
없음 - 업데이트는 이전에 생성한 기록에 대해 수행되며, Learn에 기록이 없는 경우 데이터가 포함되면 기록이 생성됩니다.
해결책
시스템에 추가하려는 개인별 필수 헤더 및 연결된 데이터가 포함된 PERSONS.txt 데이터 파일을 생성하십시오. 예:
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|EMAIL
testPerson1|aanderson_test|changeme|...owhere.erehwon
저장 작업은 파일에 포함된 데이터에 대해서만 작동하기 때문에 이전에 제출한 bbrown_test 및 ccarlin_test 기록은 영향을 받지 않습니다.
저장 작업을 사용하여 개인 데이터 유형을 통해 UI로 이 파일을 업로드하십시오. 사용자 계정이 업데이트됩니다.
사후 조건
aanderson_test에 대한 개인 기록이 제공된 이메일 주소를 포함하도록 업데이트됩니다.
bbrown_test 및 ccarlin_test에 대한 개인 기록은 영향을 받지 않습니다.
개인: 새로 고침 완료 작업
COMPLETE REFRESH 작업은 STORE 작업과 다르게 작동합니다. 새로 고침 완료 작업에서는 새 기록을 저장하거나 기존 기록을 업데이트하거나 데이터 파일에 없는 기록을 Learn에서 비활성화하는 등 통합에서 소유하는 Learn의 기록과 피드 파일의 데이터를 비교하는 것에 해당하는 두 가지 작업을 수행합니다.
예: 새로 고침 완료
Learn에 대한 접근 권한이 있어야 하는 개인의 전체 스냅숏이 학생 정보 시스템에서 제공하는 데이터에 포함됩니다. 이 데이터에는 추가할 개인 기록, 업데이트할 개인 기록 및 구성에 따라 적절히 처리되어야 하는 이전 새로 고침 완료 작업(비활성화 또는 제거)이 수행된 이후에 제거된 기록이 포함됩니다.
전제 조건
없음
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
해결책
마지막 저장 작업의 데이터를 사용하고 데이터 피드에서 gcarlin_test를 제거하십시오.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거됩니다.
사후 조건
aanderson_test에 대한 개인 기록은 유지되며 영향을 받지 않습니다.
bbrown_test에 대한 개인 기록은 유지되며 이메일 주소를 포함하도록 업데이트됩니다.
ccarlin_test에 대한 개인 기록은 통합 구성에 따라 비활성화된 것으로 표시되거나 제거를 위해 준비됩니다.
개인: 데이터 소스 기준 새로 고침 완료 작업
데이터 소스 기준 새로 고침 완료 작업에서는 통합의 데이터 소스하고만 연결된 데이터에만 새로 고침 완료 작업을 수행합니다.
예: 데이터 소스 기준 새로 고침 완료
Learn에 대한 접근 권한이 있어야 하는 개인의 전체 스냅숏이 학생 정보 시스템에서 제공하는 데이터에 포함됩니다. 이 데이터에는 추가할 PERSON 기록, 업데이트할 PERSON 기록 및 구성에 따라 적절히 처리되어야 하는 이전 REFRESH 작업(비활성화 또는 제거)이 수행된 이후에 제거된 기록이 포함됩니다. 또한 이 새로 고침에 포함되는 모든 데이터는 통합에 정의된 것과 동일한 데이터 소스를 사용하여 지정되며, 이 데이터 소스 키와 관련된 데이터만 영향을 받도록 하려고 합니다.
전제 조건
없음
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
해결책
마지막 저장 작업의 데이터를 사용하고 데이터 피드에서 gcarlin_test를 제거하십시오.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|firstname|lastname
testPerson1|aanderson_test|changeme|Alpha|Anderson
testPerson2|bbrown_test|changeme|Beta|Brown
사후 조건
aanderson_test에 대한 개인 기록은 유지되며 영향을 받지 않습니다.
bbrown_test에 대한 개인 기록은 유지되며 이메일 주소를 포함하도록 업데이트됩니다.
ccarlin_test에 대해 이전에 생성한 개인 기록은 통합 구성에 따라 비활성화된 것으로 표시되거나 제거를 위해 준비됩니다.
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 통합에서 지정한 것과 동일한 데이터 소스를 갖고 있지 않는 한, 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거되지 않습니다.
개인 계정 사용 가능성
개인 계정 사용 가능성 설정을 사용하면 Learn의 계정에 로그인(사용 가능) 또는 로그인할 수 없도록(사용 불가능) 설정할 수 있습니다. 이는 계정을 비활성화하는 것과는 다릅니다. 즉, 계정을 사용할 수 없게 설정할 뿐만 아니라 멤버십 관리와 같은 추가 작업에도 사용할 수 없음을 의미합니다. 이 데이터 피드 헤더를 추가해도 개인 기록을 생성하기 위해 위에서 설명한 저장, 새로 고침 완료, 데이터 소스 기준 새로 고침 완료 작업을 사용하는 데는 영향이 가지 않습니다.
사용 가능성 설정이 제공되지 않은 경우에는 기본 통합 설정에 따라 객체가 생성/업데이트 작업에서 사용할 수 있도록 설정됩니다.
예: 개인 계정 사용 가능성
학생 정보 시스템에서는 사용자의 Learn 접근 사용 가능성을 제어하며, 데이터 피드는 사용자가 개별적으로 Learn에 접근할 수 있는지 여부를 나타냅니다. 관리자는 개인 생성/업데이트를 사용하여 개별 사용자 접근 권한을 변경할 수 있습니다.
전제 조건
없음
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
AVAILABILITY_IND
해결책
AVAILABLE_IND 헤더를 데이터 피드에 추가하고 사용 가능한 경우 단일 문자 Y를, 사용 불가능한 경우 단일 문자 N을 입력하십시오.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|AVAILABLE_IND
testPerson1|aanderson_test|changeme|Alpha|Anderson|Y
testPerson2|bbrown_test|changeme|Beta|Brown|Y
testPerson3|gcarlin_test|changeme|Gamma|Carlin|N
testPerson4|ddarling_test|changeme|Delta|Darling|Y
사후 조건
저장
이전에 생성한 aanderson_test, bbrown_test 및 ccarlin_test에 대한 개인 기록만 업데이트되고 ddarling_test가 생성됩니다.
새로 고침 완료
이전에 생성한 aanderson_test, bbrown_test 및 ccarlin_test에 대한 개인 기록이 업데이트되고 ddarling_test가 생성됩니다. 다른 모든 기록은 위의 데이터 피드에 없기 때문에 비활성화되거나 제거를 위해 표시됩니다.
데이터 소스 기준 새로 고침 완료
이전에 생성한 aanderson_test, bbrown_test 및 ccarlin_test에 대한 개인 기록이 업데이트되고 ddarling_test가 생성됩니다.
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 통합에서 지정한 것과 동일한 데이터 소스를 갖고 있지 않는 한, 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거되지 않습니다. 데이터 소스 기준 새로 고침 완료 작업은 통합 데이터 소스의 기록에 대해서만 작동합니다.
개인 기록 비활성화하기
Learn에서 개인 기록을 비활성화하면 로그인을 위해 코스 기록에 접근할 수 없게 되며(비활성화된 상태는 사용 가능성 설정을 재정의함) UI 작업을 수행할 때도 기록에 접근할 수 없게 됩니다(예: UI를 통해 코스에 비활성화된 개인을 추가할 수 없음). 또한 Learn에서 기록을 제거하려면 먼저 해당 기록을 비활성화해야 합니다.
기록을 비활성화하고 후속 제거를 수행하면 Learn에서 해당 기록에 대한 모든 참조가 제거됩니다. 비활성화된 기록을 제거하는 작업은 업무 및 법적 관례에 따라 지정된 기간 이후에만 수행하는 것이 좋습니다. 그렇지 않으면 활동을 기록해야 할 수 있습니다.
기록을 비활성화할 때는 새로 고침 작업에서 피드 데이터 제외를 통해 비활성화하거나 피드 헤더인 ROW_STATUS를 사용하여 비활성화할 수 있습니다.
새로 고침 작업을 사용하는 위의 개인 작업에서는 제외를 통해 비활성화하는 경우를 보여주며, 다음 사례 및 예에서는 ROW_STATUS를 사용하여 비활성화하는 경우를 보여줍니다.
예: 개인 기록 비활성화하기
학생들이 대학교에 입학하거나 더 이상 Learn에 접근할 필요가 없습니다. 그들의 Learn에 대한 접근 권한 및 Learn 내 존재감을 완전히 제거해야 합니다(기록을 사용할 수 없게 만들어 로그인만 제한하는 것과는 다름). 저장 작업을 사용 중인 경우 사용자를 비활성화하려면 ROW_STATUS 헤더를 사용하여 사용자를 명시적으로 비활성화해야 합니다. 이는 학생 정보 시스템 피드의 범위를 벗어나는 수동 작업에도 유용합니다.
전제 조건
대상 기록이 Learn 시스템 내에 있습니다.
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
USER_ID
PASSWD
FIRSTNAME
LASTNAME
ROW_STATUS
해결책
ROW_STATUS 헤더를 데이터 피드에 추가하고 활성화된 경우 ENABLED를, 비활성화된 경우 DISABLED를 입력하십시오.
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|FIRSTNAME|LASTNAME|ROW_STATUS
testPerson1|aanderson_test|changeme|Alpha|Anderson|enabled
testPerson2|bbrown_test|changeme|Beta|Brown|enabled
testPerson3|gcarlin_test|changeme|Gamma|Carlin|disabled
testPerson4|ddarling_test|changeme|Delta|Darling|enabled
사후 조건
저장
aanderson_test, bbrown_test, ccarlin_test 및 ddarling_test에 대한 개인 기록만 ROW_STATUS가 명시적으로 업데이트된 상태로 생성되거나 업데이트됩니다.
새로 고침 완료
aanderson_test, bbrown_test, ccarlin_test, 및 ddarling_test에 대한 개인 기록이 생성되거나 업데이트됩니다. 다른 모든 기록은 위의 데이터 피드에 없기 때문에 비활성화되거나 제거를 위해 표시됩니다.
데이터 소스 기준 새로 고침 완료
이전에 생성한 aanderson_test, bbrown_test 및 ccarlin_test에 대한 개인 기록이 업데이트되고 ddarling_test가 생성됩니다.
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 통합에서 지정한 것과 동일한 데이터 소스를 갖고 있지 않는 한, 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거되지 않습니다. 데이터 소스 기준 새로 고침 완료 작업은 통합 데이터 소스의 기록에 대해서만 작동합니다.
데이터 소스 기준 새로 고침 완료
aanderson_test, bbrown_test, ccarlin_test 및 ddarling_test에 대한 개인 기록이 ROW_STATUS가 명시적으로 업데이트된 상태로 생성되거나 업데이트됩니다.
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 통합에서 지정한 것과 동일한 데이터 소스를 갖고 있지 않는 한, 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거되지 않습니다. 데이터 소스 기준 새로 고침 완료 작업은 통합 데이터 소스의 기록에 대해서만 작동합니다.
사용자의 교육기관 내 2차 역할 관리하기
커뮤니티의 정식 사용자는 사용자에게 할당할 수 있는 추가 역할에 접근할 수 있으며, 이는 커뮤니티 포털의 자료 및 탭에 대한 접근을 관리하는 데 유용합니다.
2차 역할의 관리는 사용자를 생성하거나 업데이트하는 작업과 별개의 작업이므로 데이터 피드에 대한 개인 생성/업데이트 작업에는 포함되지 않습니다.
예: 사용자의 교육기관 내 2차 역할 추가하기
공과 대학의 학생 및 교직원 전용의 포털 콘텐츠를 제공해야 합니다.
전제 조건
'ENGINEERING_STUDENT'라고 하는 시스템 관리자 UI(....참조)를 사용하여 새로운 교육기관 내 역할을 생성했습니다.
최소 데이터 피드 요구 사항
EXTERNAL_PERSON_KEY
ROLE_ID
해결책
생성/업데이트할 기록이 포함된 Institutional_Role 피드를 생성하십시오.
EXTERNAL_PERSON_KEY|ROLE_ID
testPerson1|engineering_student
testPerson2|engineering_faculty
testPerson3|engineering_faculty
testPerson4|engineering_student
다른 데이터 객체와 마찬가지로 ROW_STATUS를 제공하여 2차 역할과 연결된 콘텐츠에 대한 개인 접근 권한을 활성화하거나 비활성화할 수도 있습니다. 예:
EXTERNAL_PERSON_KEY|ROLE_ID|ROW_STATUS
testPerson1|engineering_student|enabled
testPerson2|engineering_faculty|enabled
testPerson3|engineering_student|disabled
사후 조건
저장
aanderson_test, bbrown_test, ccarlin_test 및 d에 대한 교육기관 내 2차 역할 기록만 교육기관 내 2차 역할로 생성되거나 업데이트됩니다.
새로 고침 완료
aanderson_test, bbrown_test, ccarlin_test 및 d에 대한 교육기관 내 2차 역할 기록이 생성되거나 업데이트됩니다. 다른 모든 기록은 위의 데이터 피드에 없기 때문에 비활성화되거나 제거를 위해 표시됩니다.
데이터 소스 기준 새로 고침 완료
aanderson_test, bbrown_test, ccarlin_test 및 d에 대한 교육기관 내 2차 역할 기록이 생성되거나 업데이트됩니다.
이 통합을 통해 다른 개인 기록이 관리되는 경우 해당 기록은 통합에서 지정한 것과 동일한 데이터 소스를 갖고 있지 않는 한, 위의 데이터 피드에 없다는 이유로 비활성화 또는 제거되지 않습니다. 데이터 소스 기준 새로 고침 완료 작업은 통합 데이터 소스의 기록에 대해서만 작동합니다.
참관인
참관인은 감독 또는 참관 기능으로 계정이 다른 사용자 계정에 연결된 특수한 사례의 사용자입니다. 참관인은 로그인하여 연결된 사용자의 코스 및 활동을 볼 수 있습니다.
참관인 계정의 경우 계정을 생성하려면 사용자와 동일한 정보가 필요하며 '사용자 연결 관리'라는 추가 계층이 있습니다. 여기에서 참관인은 두 개의 계정의 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와 학생의 외부 개인 키가 포함된 데이터 파일을 생성하십시오.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_100
저장 작업을 사용하여 참관인 연결 데이터 유형을 통해 UI로 이 파일을 업로드하십시오. 연결이 생성되며 참관인으로 로그인하여 학생의 코스 활동을 볼 수 있습니다.
예 2: 참관인 연결 기록 업데이트하기
연결을 변경해야 합니다.
전제 조건
test_student_200_observer 및 test_student_100 간에 연결을 생성했습니다. 단, 연결된 학생 계정이 test_student_200이어야 합니다.
해결책
수정 내용이 포함된 파일을 생성하십시오.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_200_observer|test_student_200
저장 작업을 사용하여 참관인 연결 데이터 유형을 통해 UI로 이 파일을 업로드하십시오.
사후 조건
연결이 업데이트되며 참관인으로 로그인하여 올바른 학생의 코스 활동을 볼 수 있습니다.
예 3: 참관인 연결 기록 비활성화하기
참관인 연결이 더 이상 필요하지 않아 해당 연결을 비활성화하고자 합니다.
전제 조건
학생과 참관인 간에 연결을 생성했습니다.
해결책
(이 예시 토론 글에서 사용된 데이터 활용)
이전에 저장 방법과 다음 파일을 사용하여 연결을 생성했습니다.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_200
요구 사항에 따라 참관인 연결을 비활성화하기 위해 요구 사항을 충족하는 데는 두 가지 피드 관련 패턴이 있습니다.
- 현재 통합/데이터 소스와 연결된 참관인 연결의 하위 집합을 비활성화하고자 합니다.
- 추가 기록을 저장하거나 업데이트하면서 참관인 연결의 하위 집합을 비활성화하고자 합니다.
참관인 연결의 하위 집합 비활성화하기
데이터의 하위 집합을 비활성화하려면 연결 피드를 생성하고 삭제 작업에 업로드하십시오. 예:
작업 중인 데이터 집합에서 test_student_100_observer|test_student_100 간의 연결을 삭제하려면 다음이 포함된 피드 파일을 생성하고 삭제 작업을 사용하여 업로드하십시오.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_200_observer|test_student_200
신규/기존 연결을 저장하면서 참관인 연결의 하위 집합 비활성화하기
기존 연결을 업데이트하거나 신규 연결을 저장하면서 데이터의 하위 집합을 비활성화하려면 기존 및 신규 연결이 포함된 연결 파일을 생성하고 비활성화하려는 연결을 제거한 뒤 새로 고침 완료 작업을 사용하여 업로드하십시오. 다음과 같은 작업 집합을 사용하는 경우를 예로 들 수 있습니다.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_200_observer|test_student_200
test_student_200_observer|test_student_200 연결을 비활성화하고자 하므로 파일에는 test_student_100_observer|test_student_100 연결만 포함됩니다. 또한 두 개의 새 연결(사용자 계정이 생성되어 있어야 하는 전제 조건 충족)을 추가하려고 했으므로 다음을 업로드합니다.
EXTERNAL_OBSERVER_KEY|EXTERNAL_USER_KEY
test_student_100_observer|test_student_100
test_student_300_observer|test_student_300
test_student_400_observer|test_student_400
사후 조건
test_student_200_observer|test_student_200에 대한 기록이 비활성화됩니다.
