Products.ZSPARQLMethod的包装器
项目描述
EEA Sparql是一个用于从链接开放数据服务器（SPARQL端点）获取数据的Plone产品。
简介
使用简单，您只需指定SPARQL端点URL和SPARQL查询。结果将被转换为展品JSON，这可以很容易地重用（例如，通过eea.daviz）。
主要功能
主要功能包括
创建SPARQL查询
创建SPARQL书签文件夹，SPARQL查询会自动创建，可以手动或自动（通过cron作业）同步。如果查询被更改，将创建对象的新的版本，这样就不会丢失旧的版本。
结果可以以下列格式下载：JSON、Exhibit JSON、HTML、XML、带模式的XML、CSV、TSV
安装
要安装eea.sparql到全局Python环境（或一个工作环境），使用传统的Zope 2实例，您可以这样做：
当您阅读此内容时，您可能已经运行了 easy_install eea.sparql。有关安装setuptools（和EasyInstall）的详细信息，请参阅：http://peak.telecommunity.com/DevCenter/EasyInstall
如果您使用的是Zope 2.9（不是2.10），请获取pythonproducts并通过以下方式安装它：
python setup.py install --home /path/to/instance
到您的Zope实例中。
在/path/to/instance/etc/package-includes目录中创建一个名为eea.sparql-configure.zcml的文件。该文件应仅包含以下内容：
<include package="eea.sparql" />
或者，如果您正在使用zc.buildout和plone.recipe.zope2instance配方来管理您的项目，您可以这样做：
将eea.sparql添加到要安装的egg列表中，例如：
[buildout] eggs = eea.sparql
告诉plone.recipe.zope2instance配方安装ZCML slug
[instance] recipe = plone.recipe.zope2instance zcml = eea.sparql
如果您将从另一个包的configure.zcml文件中显式包含该包，则可以跳过ZCML slug。
您还需要设置一个工作实例。这是为了异步更新最新工作结果所必需的。
对于正常实例和工作实例，应在EGG slug中添加plone.app.async
eggs = ... plone.app.async
对于正常实例，应在ZCML slug中添加plone.app.async-single_db_instance
zcml = ... plone.app.async-single_db_instance
对于工作实例，应在ZCML slug中添加plone.app.async-single_db_worker
zcml = ... plone.app.async-single_db_worker
重新运行buildout，例如使用
$ ./bin/buildout
依赖项
Products.ZSPARQLMethod
eea.versions
plone.app.async
eea.cache 7.0+（可选）
源代码
最新源代码（兼容Plone 4）：- Plone Collective on Github - EEA on Github
版权和许可证
原始代码的初始所有者是欧洲环境局（EEA）。版权所有。
EEA Sparql（原始代码）是免费软件；您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发它和/或修改它；许可证的第2版，或者（根据您的选择）任何较新版本。
有关更多信息，请参阅docs/License.txt
链接
资助
EEA - 欧洲环境局（EU）
变更日志
7.4 - (2020-02-28)
更改：在设置input标签的值时，使用prop而不是attr以实现与jquery 1.9+的兼容性 [ichim-david [refs #105112]
7.3 - (2019-12-02)
错误修复：修复了当结果包含大量文本时sparql结果的固定高度 [ichim-david refs #111794]
7.2 - (2019-08-05)
更改：修复了MANIFEST.in文件 [valentinab25]
7.1 - (2019-08-01)
错误修复：修复了setup.py元数据 [alecghica refs #108090]
错误修复：避免在获取Sparql信息时ContentHistoryView的内存泄漏 [avoinea refs #108090]
7.0 - (2019-01-28)
Jenkins：添加sonarqube步骤 [avoinea refs #101552]
6.9 - (2018-12-11)
更改：更新了指向eea.europa.eu的URL，使用https:// [alecghica refs #95849]
错误修复：修复了运行SPARQL查询时的错误显示 [alecghica refs #100666]
6.8 - (2018-05-30)
错误修复：仅将getBRefs限制为相关项目 [avoinea refs #95796]
6.7 - (2018-04-04)
错误修复：修复了在previest egg版本中引入的回归错误。删除了对Sparql browserView的调用方法，因为我们有代码在eeadaviz和eeagooglecharts中调用sparql，这会破坏，并且模板本身也调用了检查导出数据的完整性 [ichim-david refs #94465]
6.6 - (2018-03-21)
升级步骤：添加了升级步骤，以设置Sparql对象的exportWorks属性
变更：增加了日志记录器，检查html/csv/tsv导出状态，并在导出失败时显示警告消息 [petchesi-iulian 参考 #89670]
6.5 - (2017-12-12)
变更：将eeacms/zptlint替换为eeacms/plone-test:4 zptlint [avoinea 参考 #90415]
6.4 - (2017-11-07)
变更：移除由Sphinx生成的文档 [petchesi-iulian 参考 #88212]
6.3 - (2017-09-11)
错误修复：修复了没有接收到结果时的下载错误 [alecghica 参考 #87576]
6.2 - (2017-08-16)
变更：增加了Sparql导出方法格式（xml、xmlschema、json），以便从缓存中存储和检索 [zoltan_andras 参考 #86464]
6.1 - (2017-07-03)
错误修复：将download.json更改为从缓存结果中获取数据，而不是每次都从 http://semantic.eea.europa.eu/sparql 查询结果 [zoltan_andras 参考 #85891]
6.0 - (2017-06-26)
升级步骤：调用 /www/@@sparql-schedule-controlpanel/schedule_check 并检查通过网站设置 > 异步管理每日运行计划的任务 [avoinea 参考 #85379]
变更：将sparql_check_sendmail cron移至zc.async [avoinea 参考 #85379]
5.9 - (2017-05-22)
变更：为Sparql作业添加专门的异步配额 [avoinea 参考 #84915]
变更：移除对plone.app.async的硬依赖 [avoinea 参考 #84915]
变更：修复了PyLint警告和错误 [valipod 参考 #84949]
5.8 - (2017-05-15)
变更：修复了PyLint警告和错误 [eduard-fironda 参考 #84949]
5.7 - (2017-04-24)
变更：更新了包信息 [eduard-fironda]
5.6 - (2016-10-03)
错误修复：修改SPARQL查询后更新缓存结果 [chiridra 参考 #74166]
错误修复：修复了损坏的控制面板页面模板 [tiberich]
5.5 - (2016-05-19)
错误修复：修复了pylint警告 [ichim-david 参考 #71940]
5.4 - (2016-05-04)
变更：更改了控制面板条目名称 [alecghica 参考 #70987]
升级步骤：重新导入控制面板配置文件 [alecghica 参考 #70987]
5.3 - (2016-03-01)
错误修复：考虑sparql_results可能缺少blob文件 [ichimdav 参考 #69841]
错误修复：在更新sparql结果时避免‘索引超出范围’错误 [danielm-gh 参考 #69841]
5.2 - (2016-02-15)
特性：将cached_result sparql缓存移动到blob字段，以减小对象大小，在版本控制和历史差异中特别有用 [ichimdav 参考 #17334]
升级步骤：在“Plone > 网站设置 > 添加组件”中，点击eeasparql的www8服务实例可用的升级按钮 [ichimdav 参考 #17334]
5.1 - (2016-01-19)
特性：将新Sparql对象的默认刷新率从“每日”更改为“每周” [danielm-gh 参考 #31723]
特性：改进了“SPARQL计划状态”控制面板视图 - 在关于未入队的Sparql查询的电子邮件通知之后，重新启动停止的查询 [danielm-gh 参考 #31723]
5.0 - (2016-01-04)
特性：改进了“SPARQL计划状态”控制面板视图 - 只显示未计划的Sparql，并且可以一次性重新启动（而不仅仅是单独的）。还添加了一个可以用于通过电子邮件通知开发团队关于未入队Sparql查询的方法 [danielm-gh 参考 #31031]
4.9 - (2015-12-08)
错误修复：修复了pylint警告。修复了HISTORY.txt标记 [ghicaale 参考 #30813]
4.8 - (2015-12-07)
特性：添加一个控制面板条目以显示Sparql查询的异步队列状态 [danielm-gh 参考 #30665]
4.7 - (2015-11-16)
错误修复：修复了eeasparql的升级步骤4400，以启动所有sparal方法的异步作业 [szabozo0 参考 #30673]
4.6 - (2015-11-03)
错误修复：为Products.DataGridField添加了配置文件依赖关系 [szabozo0]
错误修复：使用“code/pre”标签而不是“blockquote”标签来显示Sparql查询和错误 [danielm-gh 参考 #29992]
4.5 - (2015-08-18)
变更：自动将zcml包含在plone上下文中，以便使此包能够在不将其添加到buildout zcml指令中的情况下正常工作 [avoinea]
4.4 - (2015-07-06)
错误修复：添加了升级步骤以重新启动sparql同步作业 [szabozo0 参考 #25448]
4.3 - (2015-05-15)
错误修复：修复了sparql和sparql查询参数之间的来源信息冲突 [szabozo0 参考 #25341]
4.2 - (2015-05-05)
错误修复：updateLastWorkingResults现在检查Querytimeout异常，以避免async_updateLastWorkingResults崩溃 [ichimdav 参考 #25018]
错误修复：当用户尝试下载数据集时引用查询 [szabozo0]
变更：endpoint_url现在使用isURL验证器以确保端点URL是正确的链接 [ichimdav 参考 #24130]
变更：当没有传递参数时，数据集的下载链接不再包含问号 [ichimdav 参考 #18753]
4.1 - (2015-04-02)
变更：更新了多个数据源架构扩展适配器，以与 eea.daviz 中的更改相对应 [olimpiurob 参考 #24121]
4.0 - (2015-03-17)
变更：在 Jenkins 构建安装脚本中切换到 curl [olimpiurob 参考 #22402]
变更：将 Jenkins 构建安装脚本的获取 URL 更改为主 EEA CPB 仓库中的安装脚本 [olimpiurob 参考 #22402]
3.9 - (2015-02-03)
特性：优化了结果的历史消息 [szabozo0 参考 #22240]
3.8 - (2014-11-20)
错误修复：修复了“添加新参数”的 CSS [ghicaale 参考 #20945]
3.7 - (2014-10-15)
特性：添加了构建带有参数的 Sparql 的 howto [pasoviul 参考 #19537]
特性：将下拉值改为标签而不是 URI [pasoviul 参考 #19537]
错误修复：修复了“测试和预览查询”中的错误 [pasoviul 参考 #19537]
错误修复：修复了 sparq 和 ZSPARQL 之间的参数处理错误 [pasoviul 参考 #19537]
变更：更新 sparqls 以提供查询参数，除了名称和类型 [pasoviul 参考 #19537]
错误修复：修复了 Jenkins 生成的文档 [ghicaale 参考 #19537]
3.6 - (2014-10-01)
特性：移除了“缓存”动作。我们现在使用由 eea.cache 注册的更复杂的“缓存”动作 [ghicaale 参考 #21143]
特性：添加了升级步骤以移除过时的“缓存”动作 [ghicaale 参考 #21143]
3.5 - (2014-09-15)
错误修复：修复了 html、csv、tsv 和 exhibit json 的导出 [pasoviul 参考 #19537]
3.4 - (2014-08-27)
变更：清理 memcache 无效化代码，因为它已经由 eea.cache 处理（7.0+） [voineali 参考 #20678]
3.3 - (2014-01-21)
错误修复：从 README.rst 中移除了错误添加的块引用 [ichim-david 参考 #18064]
特性：添加了以页面模板格式生成的 Sphinx 文档 [batradav 参考 #9502]
3.2 - (2013-12-10)
错误修复：修复了 HISTORY.txt 中的 ReST 标记 [ghicaale 参考 #17716]
3.1 - (2013-12-10)
变更：移除了版本宏；现在使用视图 [simiamih 参考 #17321]
3.0 - (2013-11-20)
错误修复：修复了 sparql 书签文件夹的同步 [szabozo0 参考 #17260]
2.9 - (2013-08-08)
变更：使用 plone.app.async 更新最新有效结果 [szabozo0 #14826]
2.8 - (2013-07-08)
变更：在预览时使用 LIMIT 10 以获得更快的响应。当新结果集太大时，不要存储其文本版本以进行比较，因为它会花费很多时间，并阻塞实例 [szabozo0 #14826]
2.7 - (2013-06-17)
特性：将数据来源修改为允许多个数据来源 [szabozo0 #9561]
2.6 - (2013-05-24)
错误修复：更新以支持 eea.versions v6.0 [szabozo0 参考 #14627]
2.5 - (2013-05-20)
特性：移除了 lovely.memcached 依赖项 [voineali 参考 #14343]
错误修复：修复了缺少参数的 sparql 查询的预览 [szabozo0 #14349]
错误修复：符合最新的 eea.versions API 变更 [tiberich #14008]
2.4 - (2013-02-05)
特性：添加了贡献者信息 [ciobabog 参考 #13892]
升级步骤：在“Plone > 网站设置 > 扩展”中，点击 eea.sparql 可用的升级按钮。
错误修复：修复了 eea.sparql 的测试 [szabozo0 参考 #9424]
特性：处理数据值的具体注释 [voineali 参考 #9558]
错误修复：修复了返回空字段的查询的预览 [szabozo0 参考 #9608]
特性：为 sparql 查询添加了快速预览 [szabozo0 参考 #9608]
特性：数据持久性和版本控制 - 添加了 sparql 结果的版本控制 - 可以选择静态和实时查询 [szabozo0 参考 #9424]
2.3 - (2013-01-18)
错误修复：修复了与 jquery 1.7.2 的兼容性 [szabozo0]
2.2 - (2013-01-10)
变更：将 olderVersions 移动到显示 eea.sparql 模板旧版本链接的 portalMessage div 中 [ichimdav #10182]
2.1 - (2012-11-09)
特性：添加了 i18n 翻译 [avoinea]
2.0 - (2012-10-08)
特性：为 Sparql 对象添加了可视化数据来源来源适配器 [voineali 参考 #5490]
错误修复：更新了包含异常的结果的转换器 [szabozo0 参考 #5515]
变更：将 daviz-view.json 和 daviz-relateditems.json 合并到一个名为 daviz.json 的单个 JSON 文件中 [voineali 参考 #5449]
错误修复：允许在 daviz-view.json 中强制 Sparql 列数据类型 [voineali 参考 #5511]
错误修复：修复了 SPARQL 书签文件夹的默认视图 [szabozo0 #5512]
错误修复：当端点不起作用时，不要破坏书签视图页面 [tiberich #5534]
1.8 - (2012-08-27)
特性：为匿名用户添加了“创建可视化”动作。这使得可以清楚地知道哪些功能可用，并“召唤新用户”。 [demarant]
错误修复：即使图像瓦片不可用，现有的SPARQL可视化现在也会显示（valentine.imagescales）。表格使用网格样式。[demarant修复#5458]
错误修复：修复了以“label”结尾的列名JSON转换问题。现在它使用simile exhibit显式类型格式化。[demarant]
1.7 - (2012-08-10)
错误修复：修复了列顺序问题。[szabozo0参考#5137]
功能：为创建可视化添加了SPARQL书签快捷键。[szabozo0参考#5347]
1.6 - (2012-07-23)
错误修复：修复了SPARQL书签视图。[szabozo0 #5388]
1.5 - (2012-07-13)
错误修复：修复了作为jQuery覆盖层使用时的SPARQL表格预览CSS。[voineali]
错误修复：改进了SPARQL书签文件夹的布局。专注于数据集。对于匿名用户不显示管理操作。删除了不必要的代码。改进了i18n和标签。[demarant参考#5151]
更改：调整视图页面布局以专注于数据集下载，明确格式和链接数据信息。更好的标签和描述。[demarant修复#5317]
错误修复：修复了.pt文件中缺失的i18n标签和重复键。[prospchr参考#5162]
1.4 - (2012-06-13)
错误修复：修复了HISTORY.txt文件的标记。[ciobabog参考#5231]
功能：在SPARQL文件夹列表视图中添加了可视化列。[voineali参考#5005]
错误修复：在zcml和配置文件元数据中包含依赖项。[voineali]
1.3 - (2012-04-26)
错误修复：将@@sparql-download拆分为多个视图（download.tsv，download.csv等），以便轻松使用plone.app.caching进行缓存和清除。[voineali #5074]
错误修复：在下载视图中将默认格式设置为HTML。[szabozo0 #5089]
1.2 - (2012-04-11)
错误修复：对于Sparql实例和相关项无效化memcache和varnish。[voineali #5074]
功能：强制执行超时，并将默认值设置为10秒。[szabozo0 #5079]
错误修复：修复了SPARQL书签文件夹的同步问题。[szabozo0 #5078]
错误修复：从查询中删除注释，因此sparql-query不应失败。[szabozo0 #5073]
错误修复：显式关闭与远程服务器的连接，并在sparql到JSON/XML导出时以小段提供文件。[voineali #5073]
升级步骤：手动从前端服务器删除apache快速修复
1.1 - (2012-03-30)
更改：添加了默认的工作流程映射。[demarant #5002]
升级步骤：在ZMI > 网站设置 > 导入类型。如果有旧内容要迁移，请更改工作流程：Plone > 类型 > 更改工作流程：- Sparql -> one_state_workflow；- SparqlBookmarksFolder -> folder_workflow。按您的喜好定义状态映射。
升级步骤：在“Plone > 网站设置 > 扩展”中，单击可用的升级按钮eeasparql [voineali #4968]
功能：在与其他eearelations和eeafacetednavigation一起使用时，为SPARQL对象添加了表格预览。[voineali #4968]
更改：将sparql.css移动到portal_css [szabozo0 #4968]
功能：添加了同步所有SPARQL书签文件夹的页面 [szabozo0 #5004]
更改：为SPARQL和SPARQL书签文件夹添加了默认图标 [demarant]
更改：改进了表格预览的溶解设计和模板标题 [demarant]
错误修复：修复了SPARQL的默认视图，因此现在显示工作流程下拉列表 [szabozo0 #5002]
错误修复：修复了exhibit json中列属性的格式 [szabozo0 #4992]
1.0 - (2012-03-05)
初始发布 [Zoltan Szabo]
