Skip to main content

LIS 2.0 人员

LIS 支持的黑板人物元素

“学习用户”字段

插入所需

独特

LIS 源字段

添加了节点批处理 UID

否

否

个人机构层次结构协会

可用

否

否

批处理 Uid

是

是

人员来源 ID

生日

否

否

人出生日期

城市

否

否

人 城市

公司

否

否

国家

否

否

个人国家/地区

数据源密钥

是

否

人员数据源

部门

否

否

教育程度

否

否

电子邮件

否

否

个人电子邮件

名字

是

否

人名

性

否

否

人 性别

家庭传真

否

否

家庭电话

否

否

个人主页主要电话号码

住宅电话 (次要)

否

否

个人主页辅助电话号码

职位名称

否

否

姓氏

是

否

人姓氏

中间名

否

否

人中间名

移动电话

否

否

个人手机号码

其他名称

否

否

人员粒子名称（Person Particle Name）

密码

是

否

人员角色密码

密码加密类型

否

否

人员角色密码加密类型

主要机构角色

否

否

个人主要机构角色

代词

否

否

人称代词

替换批处理 Uid

否

是

人员来源 ID

替换数据源批处理 Uid

否

否

行状态

否

否

中学机构角色

否

否

个人中学机构角色

州/省

否

否

人员地址 州/省

街道 1

否

否

地址 街道 1

街道 2

否

否

人地址 街道 2

学生 ID

否

否

个人角色用户 ID

后缀

否

否

人员后缀名称

系统角色

否

否

人员系统角色

称谓

否

否

人员前缀名称

用户名

是

是

个人角色用户 ID

网站

否

否

人员网址

工作传真

否

否

人员工作传真

工作电话

否

否

人员工作主要电话号码

工作电话 (次要)

否

否

人员工作辅助电话号码

邮政编码

否

否

个人邮政编码

LIS 人员对象

支持的学习对象在以下说明中为粗体，相关值为粗体斜体。

LIS SOAP 消息元素

评论

学习对象关系

<SOAP-ENV:Body>

<replacePersonRequest xmlns:pms="http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0">

<sourcedId>AA0011</sourcedId>

SOAP-ENV 定义请求作的正文元素和元素

此 sourcedId 是消息的源 ID

无

xmlns:pms= "http://www.imsglobal.org/services/lis/pms2p0/wsdl11/sync/imspms_v2p0">

开始人员记录块

无

<sourcedGUID>

<refAgentInstanceID>SIS</refAgentInstanceID>

<sourcedId>55555</sourcedId>

</sourcedGUID>

SourcedGUID 提供此人员记录的唯一标识符和标识符的源

BATCH UID :: Person SourcedId

<person>

开始人员数据

无

<formname>

<formnameType>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http://www.imsglobal.org/lis/pmsv2p0/formatnmetypevocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>Full</textString>

</instanceValue>

</formnameType>

<formattedName>

<language>en</language>

<textString> Dr. First Middle Last, Jr. </textString>

</formattedName>

</formname>

一个组件 LIS 格式样式是在支持定义元素之间阻塞元素及其属性。在本例中，正式名称 （formname）、全名在提供用于数据的语言的标识符之间被阻止 - 在本例中为 en，textString - 在本例中为 Full，以及包含 formattedName 实际数据的 textString - 在本例中为 Dr. First Middle Last， Jr.

请注意，instanceVocabulary 提供相关对象的 IMS 词汇表。

无

<name>

<nameType>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary> http://www.imsglobal.org/lis/pmsv2p0...vocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>Full</textString>

</instanceValue>

</nameType>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Nickname</textString>

</instanceIdentifier>

<instanceVocabulary> Nickname not used </instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Nickname</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString> nickname </textString>

</instanceValue>

</partName>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Family</textString>

</instanceIdentifier>

<instanceVocabulary> Family </instanceVocabulary>

<instanceName>

<language>en</language>

<textString> Family </textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>King</textString>

</instanceValue>

</partName>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Given</textString>

</instanceIdentifier>

<instanceVocabulary> Given </instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Given</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Martin</textString>

</instanceValue>

</partName>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Prefix</textString>

</instanceIdentifier>

<instanceVocabulary> Prefix </instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Prefix</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString> Dr. </textString>

</instanceValue>

</partName>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Suffix</textString>

</instanceIdentifier>

<instanceVocabulary> Suffix </instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Suffix</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Jr.</textString>

</instanceValue>

</partName>

<partName>

<instanceIdentifier>

<language>en</language>

<textString>Middle</textString>

</instanceIdentifier>

<instanceVocabulary> Middle </instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Middle</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Luther</textString>

</instanceValue>

</partName>

</name>

另一种 LIS 样式是对多部分对象的组件的支持，例如可以从前缀、首、中间、最后一部分和后缀部分构建的名称。这是通过添加“零件”来处理的。与实例元素相结合，这些多部分对象易于描述，并包含在描述性 partName 元素中。

学习职称 ：： 人：姓名：前缀

学习名字 ：： 人：姓名：给定

学习中间名 ：： 人：姓名：中间人

学习姓氏 ：： 人：姓名：姓氏

学习职称 ：： 人：姓名：后缀

Learn 不支持：

人物：姓名：昵称

<address>

<addressType>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/... </instanceVocabulary>

<instanceValue>

<language>en</language>

<textString></textString>

</instanceValue>

</addressType>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary> http:00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>NonfieldedStreetAddress1</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>1234 Street</textString>

</instanceValue>

</addressPart>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http：00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>NonfieldedStreetAddress2</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Apt. 122</textString>

</instanceValue>

</addressPart>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http：00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>City</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Atlanta</textString>

</instanceValue>

</addressPart>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http：00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>StatePr</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>GA</textString>

</instanceValue>

</addressPart>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http：00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Postcode</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>12345</textString>

</instanceValue>

</addressPart>

<addressPart>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary> http:00www.imsglobal.org/lis/pmsv2p0/addresspartvocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Country</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>USA</textString>

</instanceValue>

</addressPart>

</address>

人员地址块遵循与上述名称块相同的模式。

学习街道1 ：：

Person:Address: NonFieldedStreetAddress1

Learn Street2 ::

人：地址：NonFieldedStreetAddress2

学习城市 ：：

人员：地址：城市

学习州/省：：

人员：地址：StatePr

学习邮政编码：：

人：地址：邮政编码

了解国家 ：：

人员：地址：国家

<contactinfo>

<contactinfoType>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/contactinfotypevocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>EmailPrimary</textString>

</instanceValue>

</contactinfoType>

<contactinfoValue>

<language>en</language>

<textString>[email protected]</textString><!--E-Mail Address VALUE -->

</contactinfoValue>

</contactinfo>

联系信息提供与此人员记录关联的电子邮件地址。

Learn email :: Person:ContactInfo:EmailPrimary

<demographics>

<demographicsType>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/demographicsinfovocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>Primary</textString>

</instanceValue>

</demographicsType>

<eventDate>

<instanceIdentifier>

<language>en</language>

<textString>Birth</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/eventdatevocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Birth</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>1972-03-05</textString><!-- Date of Birth VALUE (YYYY-MM-DD) -->

</instanceValue>

</eventDate>

<eventDate>

<instanceIdentifier>

<language>en</language>

<textString>Death</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/eventdatevocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Death</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString></textString><!-- Date of Death IGNORED by Learn -->

</instanceValue>

</eventDate>

<gender>male</gender><!-- Gender VALUE (male/female) -->

<demographicInfo>

<instanceIdentifier>

<language>en</language>

<textString>PlaceofBirth</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/demographicsinfovocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>PlaceofBirth</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>Silver Spring</textString>

</instanceValue>

</demographicInfo>

<demographicInfo>

<instanceIdentifier>

<language>en</language>

<textString>MaritalStatus</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/demographicsinfovocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>MaritalStatus</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>S</textString>

</instanceValue>

</demographicInfo>

<demographicInfo>

<instanceIdentifier>

<language>en</language>

<textString>Ethnicity</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/demographicsinfovocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>Ethnicity</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>4</textString>

</instanceValue>

</demographicInfo>

</demographics>

本节提供人口统计信息，例如性别、出生日期等。

学习出生日期 ：： 人：人口统计信息：出生

学习性别 ：： 人：人口统计信息：性别

Learn 不支持

人：人口统计：死亡

人：人口统计：婚姻状况

人物：人口统计：种族

<roles>

<enterpriserolesType>

<instanceIdentifier>

<language>en</language>

<textString>StudentInformationSystem</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/epriserolestypevocabularyv1p0

</instanceVocabulary>

<instanceName>

<language>en</language>

<textString>StudentInformationSystem</textString>

</instanceName>

<instanceValue>

<language>en</language>

<textString>role</textString>

</instanceValue>

</enterpriserolesType>

<institutionRole>

<institutionroletype>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/systemrolevocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>none</textString><!-- System Role VALUE -->

</instanceValue>

</institutionroletype>

<primaryroletype>false</primaryroletype>

</institutionRole>

<institutionRole>

<institutionroletype>

<instanceIdentifier>

<language>en</language>

<textString>unknown</textString>

</instanceIdentifier>

<instanceVocabulary>

http:00www.imsglobal.org/lis/pmsv2p0/systemrolevocabularyv1p0

</instanceVocabulary>

<instanceValue>

<language>en</language>

<textString>Student</textString><!-- Institution Role VALUE -->

</instanceValue>

</institutionroletype>

<primaryroletype>false</primaryroletype>

</institutionRole>

<userId>

<userIdValue>

<language>en</language>

<textString>loginidblah</textString>

</userIdValue>

<userIdType>

<language>en</language>

<textString>Logon ID</textString>

</userIdType>

<password>

<language>en</language>

<textString> {SSHA}JCkADpIzxrezO7Y9H0Swprn6veJNUEMxTENRVg== </textString>

</password>

<pwEncryptionType>

<language>en</language>

<textString>SSHA</textString>

</pwEncryptionType>

<authenticationType>

<language>en</language>

<textString></textString>

</authenticationType>

</userId>

<userId>

<userIdValue>

<language>en</language>

<textString>A00001154</textString><!-- ID IGNORED by Learn -->

</userIdValue>

<userIdType>

<language>en</language>

<textString>SISID</textString>

</userIdType>

<password>

<language>en</language>

<textString>

{SSHA}JCkADpIzxrezO7Y9H0Swprn6veJNUEMxTENRVg==

</textString>

</password>

<pwEncryptionType>

<language>en</language>

<textString>SSHA</textString>

</pwEncryptionType>

<authenticationType>

<language>en</language>

<textString></textString>

</authenticationType>

</userId>

<userId>

<userIdValue>

<language>en</language>

<textString>

user_firstlastname<!-- User_ID and Student_ID VALUE -->

</textString>

</userIdValue>

<userIdType>

<language>en</language>

<textString>Email ID</textString>

</userIdType>

<password>

<language>en</language>

<textString>change_me</textString><!-- User Password VALUE -->

</password>

<pwEncryptionType>

<language>en</language>

<textString></textString><!-- Encryption value (if applicable) -->

</pwEncryptionType>

<authenticationType>

<language>en</language>

<textString></textString>

</authenticationType>

</userId>

</roles>

角色部分提供此人员记录的机构角色和帐户登录信息（用户名和密码）。

学习主要机构角色 ：： 人员：角色：角色：机构角色

学习系统角色 ：： 人员：角色：角色：机构角色

有关有效机构和系统角色的列表，请参阅系统管理面板中的“机构角色”或“系统角色”。

学习用户名和学生 ID：：

人员：角色：角色：用户ID

学习密码：

人：角色：角色：密码

学习密码加密类型：

人员：角色：角色：PwEncryptionType

重要！

Blackboard 仅使用最后一条 userId 记录 - 如果提供了多个 userId 记录，请确保登录信息（用户名和密码）位于最后一条 userId 记录中。因此，此示例人员将使用

用户名：user_firstlastname

密码：change_me

Blackboard 不支持

身份验证类型

</person>

</personRecord>

</replacePersonRequest>

</SOAP-ENV:Body>

结束元素标签。

LIS 的黑板扩展

除了标准中定义的数据元素外，Blackboard 还支持数据元素。

LIS SOAP 消息元素

评论

<extension>
       <extensionNameVocabulary>unknown</extensionNameVocabulary>
       <extensionValueType>unknown</extensionValueType> 
       <extensionField> 
              <fieldName>inst_email</fieldName> 
              <fieldType>unknown</fieldType> 
              <fieldValue>someone@somewhere.edu</fieldValue> 
       </extensionField> 
</extension>
<extension>
   <extensionNameVocabulary>unknown</extensionNameVocabulary>.
   <extensionValueType>unknown</extensionValueType>
   <extensionField>
       <fieldName>pronouns</fieldName>
       <fieldType>unknown</fieldType
       <fieldValue>they/them,she/her,ze/zir</fieldValue>
   </extensionField>
</extension>

机构电子邮件与个人电子邮件不同，用于需要使用官方地址的集成，例如 Microsoft Teams 集成。管理员可以通过学生信息系统框架编辑机构，但最终用户没有编辑选项。

有 2 种情况需要考虑：

一个。当个人电子邮件是机构电子邮件时

B.当个人电子邮件不是机构电子邮件时

人员电子邮件是机构电子邮件

对于方案 A，机构电子邮件 （inst_email） 默认设置为 学生信息系统 集成规范中的个人电子邮件，因此无需执行其他作即可代表管理员更改此设置。

个人电子邮件不是机构电子邮件

对于方案 B，当人员电子邮件字段不是机构电子邮件地址并且需要更新/更改此地址时，可以使用脚本使用字段映射填充机构电子邮件字段值，而不是直接向此字段添加数据。

这是一个示例脚本，用于使用使用自定义脚本文本框填充机构电子邮件字段：

(function() {
     var v = data.person.extensions.get('inst_email'); 
     return v ? v.value : null;
}());

请务必注意，如果需要，管理员可以将字段映射恢复为“个人电子邮件”。如果已使用自定义脚本，则将保留此脚本。

一个人的多个代词值

可以为每个学生发送多个代词值。这将作为单个 fieldValue 条目发送，不同的值用逗号分隔。

<extension>
       <extensionNameVocabulary>unknown</extensionNameVocabulary>
       <extensionValueType>unknown</extensionValueType>
       <extensionField>
              <fieldName>pronunciation</fieldName>
              <fieldType>unknown</fieldType>
              <fieldValue>kris-chun</fieldValue>
       </extensionField>
</extension>

名称发音

名称发音字段为文本（Unicode），以支持拼音或发音指南。学生信息系统 集成框架不支持交换录音文件。