跳转到主要内容

一个允许您将数据从旧型ILS(图书馆系统)迁移到FOLIO LSP的工具

项目描述

FOLIO迁移工具

example workflowcodecov readthedocs

一个工具包,使您能够将数据从旧型ILS系统迁移到FOLIO LSP

这个工具有什么好处?

FOLIO迁移工具使您能够将具有最常见ILS的图书馆迁移到FOLIO,而不会丢失数据或进行任何主要的数据转换任务。该工具转换并加载数据,同时为您提供和图书馆良好的可操作日志和数据清理任务列表,以及迁移后的数据。

它覆盖哪些数据?

FOLIO迁移工具目前覆盖以下数据集

  • 目录(在FOLIO术语中为库存和SRS)
  • 流通交易(开放贷款和请求)
  • 用户/读者(在FOLIO中,这些共享相同的应用程序/数据库)
  • 课程和预约(课程预约)
  • 组织(供应商记录)
  • 订单(有限支持)

路线图上还有什么额外的功能?

这是初步路线图,按最可能实施的顺序排列

  • ERM相关对象
  • 财务记录

我可以使用工具进行持续导入和集成吗?

这些工具主要用于执行初始数据迁移。我们建议在可能的情况下使用本机FOLIO功能进行持续加载。理论上,这些工具可以用于从Banner、Workday或PeopleSoft等系统持续加载读者数据。但我们在您选择这条路径之前建议您仔细权衡选项。

贡献

想贡献吗?请阅读CONTRIBUTING.MD

发现了问题?

Github Issue tracker上报告

脚本需要一个已正确设置参考数据的FOLIO租户。脚本将显示消息,说明缺少哪些参考数据。

安装

确保您正在运行Python 3.9或更高版本。

1. 使用pip和venv

2.1 创建并激活虚拟环境

python -m venv ./.venv     # Creates a virtual env in the current folder
source .venv/bin/activate  # Activates the venv    

2. 使用pip安装

python -m pip install folio_migration_tools

3. 通过显示帮助页面来测试安装

python -m folio_migration_tools -h

2. 使用pipenv

1. 运行

pipenv install folio-migration-tools

2. 通过显示帮助页面来测试安装

pipenv run python3 -m folio_migration_tools -h

FOLIO迁移过程

这个仓库在一系列工具的使用过程中扮演着主要角色。整个过程在这个模板仓库中进行了更详细的记录,包括示例配置文件。为了按照此过程进行迁移,您需要以下内容

国际化

这个仓库使用Python-i18n在不同的语言之间翻译报告,并处理模板中的长字符串。

任何最终将出现在报告中的英语字符串都应该用来自i18n.t函数包装

键/使用

i18n.t("Reports")+":"

使用%{[key]}块和国际化中的关键字参数实现模板化

i18n.t("Code '%{code}' not found in FOLIO",code=folio_code)

长字符串可以使用占位符键

i18n.t("blurbs.Introduction.description")

translations/en.json中的完整字符串中

"blurbs.Introduction.description": "<br/>Data errors preventing records from being migrated

翻译文件

翻译文件位于translations目录中,默认为en.json

使用extract_translations脚本来提取模板文件

python scripts/extract_translations.py

国际化

其他语言的翻译位于translations/[locale].json中。例如,西班牙语将是es.json

键必须与英语键匹配,但值应该是翻译的。

您可以使用以下方法更新语言文件的键

python scripts/update_language.py --target-lang [locale]

翻译所有以TRANSLATE开头的新字符串,然后提交。

提示

  • 国际化整个短语或段落,而不仅仅是构成这些短语或段落的单词。语法和语法在不同的语言之间有很大差异。
  • 尽可能通用地命名模板变量,并检查可重用的翻译。
  • 在包含句子和值的块的上下文中,例如表格,您只需要翻译句子。

运行脚本

有关语法、工具所需的文件以及生成的文件的信息,请参阅模板仓库中的文档和示例文件。我们也在这个仓库中构建文档部分:文档 ¨

项目详情


发布历史 发布通知 | RSS 源

下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分发

folio_migration_tools-1.8.13.tar.gz (175.6 kB 查看散列)

上传时间:

构建分发

folio_migration_tools-1.8.13-py3-none-any.whl (212.3 kB 查看散列)

上传时间: Python 3

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面