阅读列表加载器

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

您可以使用阅读列表加载器从.txt文件批量导入阅读列表数据。

如果您是从Talis Aspire迁移的客户，请联系项目经理了解更多关于Talis Aspire迁移工具的信息。

文件规范

上传的数据必须为以下格式。您可以在此查看样本文件。

每个引文必须在文件中有一行。
主题行必需并会跳过。
类似的，一个阅读列表中的所有部分必须整合在一起，一个课程中的所有阅读列表必须整合在一起。
在读取同一阅读列表中的每一行时，会存储在内存中。当检测到新阅读列表时，创建阅读列表且内存中的所有行添加到列表。
输入文件必须为tab分隔。逗号分隔的文件不会起作用，因为逗号是输入文件的有效字符，可用于在由tab分隔的字段中分隔值。
所有字段必须存在于文件中，即使为空。以下标记为“必需”的字段为必需有值且不能留空的字段。
字段（所有字段为字符串，除非有说明；允许的值区分大小写）：
字段course_code、section_id、reading_list_code、reading_list_name、reading_list_description、reading_list_status和owner_user_name在阅读列表中唯一定义。处理行时，如果有内容与此前的行不一致，会假定为新阅读列表。如果创建新阅读列表的行含有与现有阅读列表相同的reading_list_code，忽略该行。

例如，如果有两行的reading_list_code相同但是reading_list_name不同，第二行代表新阅读列表，但是含有与现有行相同的代码，因此跳过该行。如果有两行的reading_list_code不同但是reading_list_name相同，第二行代表代码不同的新阅读列表（两个阅读列表的名称相同）。

字段 section_name、section_description、section_start_date和section_end_date在部分中唯一定义。处理行时，如果有内容与此前的行不一致，会假定为新部分。可以有多个部分有相同的名称。
- course_code - Alma中现有的课程代码。如果未提供或未找到代码，阅读列表不会与课程关联。无法使用该工具创建课程。
- section_id – 课程的部分ID。仅与Alma中定义的课程相关。
- searchable_id_1 – 与课程关联的其他ID。
- searchable_id_2
- searchable_id_3
- reading_list_code（必需） – 阅读列表代码。最多50个字符。
- reading_list_name（必需）
- reading_list_description
- reading_list_subject – 阅读列表主题代码，逗号分隔。无效主题代码忽略。主题在Alma文档的编辑阅读列表中列出。主题代码为大写字母的主题名称，使用下划线代替空格（例如，ECONOMIC_THEORY）。
- reading_list_status（必需） – 阅读列表状态：准备中、处理准备就绪、处理中、完成、无效或拒绝。需要有效的状态。请注意，该字段支持由机构定义的状态。
- RLStatus – 阅读列表发布状态：DRAFT（默认）、ARCHIVED、PUBLISHED。
- 可见度 – 阅读列表的可见度状态：
  - DRAFT – 如果RLStatus为DRAFT，设置为DRAFT。
  - RESTRICTED – 只有课程学生可以查看列表并访问课程资料。
  - PUBLIC – 所有认证的Leganto用户可以查看列表但只有课程学生可以访问受限的课程资料。
  - REGISTERED – 所有认证的Leganto用户可以查看列表并访问任何受限的课程资料。
  - OPEN_TO_WORLD – 任何人，包括访客，可以查看列表，但只有课程学生可以访问受限的课程资料。
  - PARTIAL – 任何人，包括访客，可以查看列表，但只有认证的Leganto用户可以访问受限的课程资料。
  - FULL – 任何人，包括访客，可以查看列表并访问受限的课程资料。
- reading_list_assigned_to – 列表分配给的图书馆员的用户ID。
- reading_list_library_note – 您可以对阅读列表添加一个类型为图书馆的备注。当前无法添加多个备注。
- reading_list_instructor_note – 您可以对阅读列表添加一个类型为教师的备注。当前无法添加多个备注。
- owner_user_name – 阅读列表的所有者，按逗号分隔；允许您的机构中定义的任何有效的Alma用户标识符。所有ID必须在Alma中存在，如果不存在则忽略。
- creative_commons – 整个阅读列表的知识共享代码。见为阅读列表配置知识共享默认值中可能的状态。
- section_name（必需）
- section_description
- section_start_date（dd-mm-yyyy） – 如果格式不正确，会作为空值处理。
- section_end_date （dd-mm-yyyy） – 如果格式不正确，会作为空值处理。
- section_tags – 逗号分隔的部门标签列表。不存在的标签会忽略。
  必须确保结束日期晚于开始日期。工具不会对此进行验证。如果结束日期早于开始日期，可能会在Leganto中引起显示问题。
- citation_secondary_type（必需） – 引文的资料类型。之一：
  - ABSTRACT
  - ANTHOLOGY
  - AR – 录音
  - ARCHIVE
  - AW – 艺术品
  - BK – 图书。BK为默认，用于空值或无效值。
  - BK_C – 图书章节
  - BL – 博客
  - CASE
  - CASE_STUDY
  - CD
  - CONFERENCE – 会议出版物
  - CP – 计算机程序
  - CR – 期刊或文章
  - DATABASE
  - 论述
  - DO – 文献
  - DVD
  - E_BK – 电子书
  - E_CR – 电子文章
  - EOFFPRINT
  - GOVERNMENT_DOCUMENT
  - GRANT
  - IM – 图像
  - INTERVIEW
  - JR – 期刊
  - LEGAL_DOCUMENT
  - LEGISLATION
  - LETTER
  - LIB_GUIDES
  - MANUSCRIPTS
  - MP – 地图
  - MU – 音乐
  - NEWSPAPER_ARTICLE
  - NOTE – 此类型引文由Leganto中的教师添加。用于提供哪些学生查看了阅读列表的信息，且不用由图书馆员工完成。
  - NP – 报纸
  - 其它
  - PAMPHLET
  - PATENT
  - POEM
  - PRESENTATION
  - REFERENCE_ENTRY
  - RESEARCH_DATASET
  - REVIEW
  - 分数
  - SERIES
  - STANDARDS
  - STATISTICAL_DATA_SET
  - TEC_REP – 技术报告
  - TEXT_RESOURCE
  - TH – 论文
  - TR – 誊本
  - VD – 视频
  - WORK_PAPER – 工作论文
  - WS – 网站
- citation_status（必需） – 引文状态：准备中、处理准备就绪、处理中、完成、无效或拒绝。需要有效的状态。请注意，该字段支持由机构定义的状态。
- citation_tags – 由逗号分隔的在配置区域中定义的标签（公开或读者服务）列表。无效标签被忽略。
- citation_mms_id – MMS ID。
- citation_originating_system_id – 用于追踪并启用资源定位匹配相关书目记录的来源系统ID。
- citation_title（必需） – 可以有多个引文的名称相同。对于文章，将此用于文章名称，citation_journal_title用于期刊名称。对于期刊，将此用于期刊名称并将citation_journal_title留空。对于图书章节，将此用于图书名称，citation_chapter_title用于图书章节名称。
- citation_journal_title – 文章引文的期刊名称。
- citation_author – 引文著者。字段为单一字符串，包含逗号（不会解析多个著者）。
- citation_publication_date
- citation_edition
- citation_isbn – 如果未提供ISBN/ISSN，不会在Leganto中显示缩略图。
- citation_issn – 用于期刊。如果未提供ISBN/ISSN，不会在Leganto中显示缩略图。
- citation_place_of_publication
- citation_publisher
- citation_volume
- citation_issue – 引文的期号或代码。
- citation_pages – 引文的页码范围。
- citation_start_page
- citation_end_page
- citation_doi – 引文的数字对象标识符：只是ID不是URL。
- citation_oclc – 引文的OCLC编号（或任何系统控制号）。
- citation_lccn – 引文的LCCN编号。
- citation_chapter – 引文的章节编号。与图书章节相关。
- citation_chapter_title – 引文的章节题名。与图书章节相关。
- citation_chapter_author – 引文的章节著者。与图书章节相关。
- citation_editor
- citation_source – 引文数据来源：MARC 21字段786或590，或任何来源URL链接或引文全文。
- citation_source1 – 任何其他来源。
- citation_source2
- citation_source3
- citation_source4
- citation_source5
- citation_source6
- citation_source7
- citation_source8
- citation_source9
- citation_source10
- citation_note – 关于引文的备注。该备注对在Leganto中对教师显示，并在引文页面对学生显示。
- additional_person_name – 其他著者和/或责任者。
- file_name – 上传引文文件（可选）。要上传的文件必须位于相同路径下的叫做files的文件夹中。如果读取/上传文件出现问题，进程会继续且只有该引文的文件会关联失败。
- citation_public_note – 在阅读列表页面对Leganto中的学生显示的备注。
- license_type – 引文的使用许可类型（如有）：SELFDECLARED用于自我声明的版权，或知识共享代码。见为阅读列表配置知识共享默认值中可能的状态。
- citation_instructor_note – 您可以对引文添加一个类型为教师的备注。当前无法添加多个备注。
- citation_library_note – 您可以对引文添加一个类型为图书馆的备注。当前无法添加多个备注。
- external_system_id – 可选用于转换CCC使用许可。值必须是CCC_<license number>_<funded|nonfunded>，其中<license number>是CCC使用许可密钥。示例：CCC_70193668_funded。如果剩余的引文元数据显示（包括起始和结束页码），Alma映射有效的CCC使用许可到引文。版权使用许可状态为需要续期。在界面中手动续期使用许可或通过运行使用许可续期作业续期。
  添加空格到该字段而不是留空，确保不会得到无效的行。

使用阅读列表加载器导入阅读列表

要通过阅读列表加载器导入阅读列表：

在集成配置文件列表页面（配置菜单 > 通用 > 外部系统 > 集成配置文件 > 选择添加集成配置文件）添加新集成配置文件。
在集成配置文件页面，从集成类型下拉列表选择“阅读列表加载器”。
在S/FTP连接类型下拉列表中选择连接类型。
填充余下的必填字段并选择下一步。

集成配置文件配置。

添加集成配置文件 - 阅读列表加载器

在阅读列表导入页面，输入传入文件路径。这是ftp服务器中.txt传入文件的路径。
在报告模式中选择运行作业。如果选定，作业不会创建阅读列表，但是会模拟创建并在阅读列表创建时生成作业报告。

阅读列表导入 - 选择传入文件路径
如果上传中有想要与引文关联的数据文件，需要将文件放置于名为files的文件夹，并将文件夹放在传入文件相同的位置。

files文件夹和传入文件
对于.txt传入文件中想要与来自files文件夹的数据文件关联的每个引文，.txt文件的file_name字段值必须与想要与引文关联的数据文件的名称一致。

File_name字段
如果读取/上传文件出现问题，进程会继续且只有该文件会关联失败。