README

此模块提供了一种文件字段，可以接受 CSV 文件上传，并使用 Recline.js 可视化其内容

安装

• 从 https://github.com/okfn/recline 下载 Recline.js 库（zip 文件），并将其安装到 'sites/all/libraries/'。
• 启用 recline 模块。

支持的数据库和文件类型

根据以下机制创建 CSV 和 XLS 文件的网格、图形和地图数据预览。

它首先检查是否安装了 DKAN Datastore 模块，以及是否已为文件创建了数据存储。如果数据存储可用，它将使用该数据存储来可视化数据。由于它只查询数据库中表的第一个 50 行，因此这具有极高的可伸缩性。它已测试过高达 500 GB 的文件和百万行以上的文件。

如果数据存储不可用，它将检查文件是否为 CSV。如果是 CSV，它将尝试将文件加载到内存中。如果加载文件超过一秒钟，它将指示用户该文件太大无法预览。这可以防止大型文件使页面冻结。

如果文件是 XLS，它将使用 DataProxy 服务来预览文件，因为 Recline 目前还没有 CSV 后端。DataProxy 解析文件并返回数据对象进行预览。

贡献

我们只接受在 dkan 问题线程中的问题 -> https://github.com/NuCivic/dkan/issues -> 请在提交问题后将其标记为 "component: recline"，以便我们更快地识别问题和功能请求。

如果您能，请将此存储库中的提交与 dkan 问题线程中的相应问题交叉引用。您可以通过在提交消息或评论中添加以下文本来完成此操作

NuCivic/dkan#issue_id

，将 issue_id 替换为相应的 issue id。

Recline.js 库工作流程

makefile 中有明确的指示说明如何/引用什么

# This should be pointing to the HEAD of the "dkan_integration" branch at the time of
# each release. The commit should have all the branches for PR's that we send against
# the okfn repo and the builded version matching the code(use ./make cat to build).
libraries[recline][download][revision] = "aa5eeac080099584792e70dff839f0e85ae7380a"

设置以在 recline.js 上工作

• 在本地上克隆 recline.js 存储库
• 将 okfn 添加为远程
• 获取所有标签和分支

git clone [email protected]:NuCivic/recline.js.git
cd recline.js
git remote add okfn [email protected]:okfn/recline.git 
git fetch --all

对 okfn 创建 PR

我们提供的所有修复都应该是针对 okfn 存储库的 PR。基于最新的 okfn/master 设置工作

git checkout -b "branch_name_after_fix"
git reset --hard okfn/master

完成后，构建不进行压缩并推送分支到 NuCivic/recline.js

./make cat
git add .
git commit -m "Describe your commit"
git push origin branch_name_after_fix

针对 okfn/recline:master 创建 PR

更新 dkan_integration 分支以包含您的修复

git checkout dkan_integration
git merge origin branch_name_after_fix

使用此存储库创建 QA 站点

• 为此存储库创建分支
• 更新 recline.make 以引用 NuCivic/recline.js:dkan_integration 上的最后一个提交
• 提交更改，推送并构建 QA 站点