Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Alma

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Alma
    3. Product Documentation
    4. Alma Online Help (Alma中文在线手册)
    5. 和外部系统集成
    6. 读者服务
    7. 阅读列表加载器

    阅读列表加载器

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. 文件规范
    2. 使用阅读列表加载器导入阅读列表
    3. 验证
    可译的
    您可以使用阅读列表加载器从.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使用许可到引文。版权使用许可状态为需要续期。在界面中手动续期使用许可或通过运行使用许可续期作业续期。
        添加空格到该字段而不是留空,确保不会得到无效的行。

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

    要通过阅读列表加载器导入阅读列表:
    1. 在集成配置文件列表页面(配置菜单 > 通用 > 外部系统 > 集成配置文件 > 选择添加集成配置文件)添加新集成配置文件。

    2. 在集成配置文件页面,从集成类型下拉列表选择“阅读列表加载器”。
    3. 在S/FTP连接类型下拉列表中选择连接类型。
    4. 填充余下的必填字段并选择下一步。

    集成配置文件配置。

    添加集成配置文件 - 阅读列表加载器
    1. 在阅读列表导入页面,输入传入文件路径。这是ftp服务器中.txt传入文件的路径。  
    2. 在报告模式中选择运行作业。如果选定,作业不会创建阅读列表,但是会模拟创建并在阅读列表创建时生成作业报告。
      输入文件路径。
      阅读列表导入 - 选择传入文件路径
    3. 如果上传中有想要与引文关联的数据文件,需要将文件放置于名为files的文件夹,并将文件夹放在传入文件相同的位置。

      Input File and Files Folder.png

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

      Reading List Loader_File Name.png

      File_name字段
      如果读取/上传文件出现问题,进程会继续且只有该文件会关联失败。
    1. 选择保存保存集成配置文件。
    2. 在集成配置文件列表页面,选择创建的集成配置文件并选择操作选项卡。选择运行运行作业。

    作业运行时,创建含有所有创建的列表ID的阅读列表结果集。结果集将会可见(类型“公开”)。结果集名称会为ReadingListLoader_<JOB_ID>。

    阅读列表加载器作业可以在Alma中通过监控作业页面中止。作业中止时,任何已加载的阅读列表会保留在系统中。

    要对创建的结果集执行更新:

    一旦作业运行,您也可以使用阅读列表批量更新作业对创建的结果集执行更新(见阅读列表批量更新)。

    验证

    在运行作业前,系统验证传入文件中的数据,检查以下错误:

    • 缺失栏
    • 长度不符合要求的行(短于所需长度)
    • 已经存在的阅读列表代码
    • 列表不在一个区中。
    • 部分不在一个区中。
    • 任何以下必需字段的缺失:
    • 阅读列表代码
    • 阅读列表名称
    • 部分名称
    • 引文次级类型
    • 引文状态
    • 引文题名。如果类型为图书章节,则章节题名为必需。
    • 相同的列表代码在文件的行中多次出现。

    空列表视为有效。因此,如果有阅读列表名称和代码但是没有部分或引文,这会视为有效列表。此外,如果有阅读列表名称和代码以及部分名称,没有引文,也会视为有效列表。

    以下为创建了带有警告的列表的事件报告示例。

    ents Report_Warnings.png

    事件报告--列表创建带有警告/错误

    对于作业产生的每个警告/错误,会有关于传入文件中的列表和行编号的说明。

    View article in the Exlibris Knowledge Center
    1. Back to top
      • 配置WPM教育电子支付系统
      • 用户管理
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Community Content Type
      How To
      Content Type
      Documentation
      Language
      简体中文
      Product
      Alma
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved