iw.fss 2.7.6

4.1 从FSS 2.5.x及更早版本

我们配置存储和备份路径以及存储策略的方式已经发生了深刻的改变。本版本没有自动迁移。请根据 FSS 主配置 中所示创建一个配置文件，以克隆您的旧配置偏好。

4.2 从iw.fss 2.7.1

从本版本开始以及以后的版本，iw.fss 在 GenericSetup 中注册升级步骤。当升级到 iw.fss 的新版本时，只需查看您的 Plone 网站中 portal_setup 工具的“升级”选项卡。

警告，由于移除了 portal_fss 工具，从 2.7.1 版本升级将不会保留 RDF 选项（已激活和特定脚本）。如果您在 2.7.1 中使用了 RDF，您需要在 FileSystemStorage 配置面板中重新进行相同的 RDF 设置。

6.1 使用buildout

本示例自述

[buildout]
...
eggs =
  ...
  iw.fss
  ...

[instance]
...
zcml =
  ...
  iw.fss
  iw.fss-meta
  ...

您还可以使用 iw.recipe.fss 食谱 egg 来配置实例。

6.2 从SVN仓库

• 将 iw.fss 软件包膨胀到您的 zope 实例的 lib/python 目录。我相信这已经完成了。

• 添加 $INSTANCE_HOME/etc/package-includes/iw.fss-meta.zcml 文件，并包含以下行

  <include package="iw.fss" file="meta.zcml"/>

• 添加 $INSTANCE_HOME/etc/package-includes/iw.fss-configure.zcml 文件，并包含以下行

  <include package="iw.fss" />

6.3 配置您的Plone站点

• 仔细阅读 下面的 存储策略 和 FSS 主配置，并根据 plone-filesystemstorage.conf 配置您的实例。您可以在 buildout.cfg 中使用 iw.recipe.fss 食谱来完成此操作。

• 启动您的 Zope 实例

• 在 ZMI 中，进入您的 plone 网站，并使用 portal_quickinstaller 安装产品

• 可选地，在您的 Plone 网站的 FileSystemStorage 配置面板中调整一些 - 自解释 - 偏好。

7.1 策略概述

FSS 随附 4 种存储策略。每种策略需要两个目录

• 存储目录根据所选策略在文件中存储相关字段的值。

• 备份目录保留已删除内容的字段的值，以用于“撤销”目的。

• 在给定的 Plone 网站上只能选择一个存储策略，但同一 Zope 实例中的不同 Plone 网站可以有不同的存储策略。

• 您需要最佳性能：请选择 平面存储策略 或 目录存储策略。

• 您需要一个看起来像您的Plone网站的存储（例如，在只读的Samba或NFS共享中发布存储目录）：选择站点存储策略1或站点存储策略2。

• 如果您关心CMFEdition支持（这意味着使用FSS的一个内容类型与CMFEditions进行版本控制），您不应使用站点存储策略1或站点存储策略2。

查看FSS主要配置以在您的Zope实例和Plone网站上配置最佳策略。

7.2 平面存储策略

所有字段值都存储在平面结构中。这是默认策略。

• 存储值的文件名：<内容uid>_<字段名称>

• rdf文件的文件名：<内容uid>_<字段名称>.rdf

• 备份值的文件名：<内容uid>_<字段名称>.bak

rdf文件不进行备份。它们将自动生成。

存储示例

fssDirectory
|
|- f42ad00adb7d4580f929d734bf1ed3ab_image
|
|- f42ad00adb7d4580f929d734bf1ed3ab_image.rdf
|
|- f42ad00adb7d4580f929d734bf1ed3ab_file
|
|- f42ad00adb7d4580f929d734bf1ed3ab_file.rdf

fssBackupDirectory
|
|- 9efeb7638fb35f5f9b9955da3e2dbfec_file.bak

7.3 目录存储策略

所有字段值都存储在目录结构中。子目录在两个级别上定义。目录的第一级使用内容uid的前两个字符。目录的第二级使用内容uid的前四个字符。备份文件存储在平面结构中。

• 存储值的文件名：<内容uid>_<字段名称>

• rdf文件的文件名：<内容uid>_<字段名称>.rdf

• 备份值的文件名：<内容uid>_<字段名称>.bak

rdf文件不进行备份。它们将自动生成。

存储示例

fssDirectory
|
|- f42
   |
   |- f42ad
      |
      |- f42ad00adb7d4580f929d734bf1ed3ab_image
      |
      |- f42ad00adb7d4580f929d734bf1ed3ab_image.rdf
      |
      |- f42ad00adb7d4580f929d734bf1ed3ab_file
      |
      |- f42ad00adb7d4580f929d734bf1ed3ab_file.rdf

fssBackupDirectory
|
|- 9efeb7638fb35f5f9b9955da3e2dbfec_file.bak

一方面取决于您面对大量文件在同一目录中的文件系统性能，另一方面取决于依赖FSS的内容数量，您可能选择此策略或平面存储策略。

7.4 站点存储策略1

所有字段值都存储在目录结构中，该结构反映了PloneSite的结构。备份文件存储在平面结构中。

• 存储值的文件名：字段值或未定义的字段名称

• rdf文件的文件名：<字段名称>.rdf

• 备份值的文件名：<内容uid>_<字段名称>.bak

rdf文件不进行备份。它们将自动生成。

存储示例

fssDirectory
|
|- members
   |
   |- john
      |
      |- dummy-document
         |
         |- image
         |  |
         |  |- moutain.jpg
         |  |
         |  |- image.rdf
         |
         |- file
            |
            |- diary.odt
            |
            |- file.rdf

fssBackupDirectory
|
|- 9efeb7638fb35f5f9b9955da3e2dbfec_file.bak

7.5 站点存储策略2

所有字段值都存储在目录结构中，该结构反映了PloneSite的结构。备份文件存储在平面结构中。

• 存储值的文件名：字段值或未定义的字段名称

• rdf文件的文件名：<字段文件名>.rdf

• 备份值的文件名：<内容uid>_<字段名称>.bak

rdf文件不进行备份。它们将自动生成。

存储示例

fssDirectory
|
|- members
   |
   |- john
      |
      |- dummy-document
         |
         |- fss.cfg
         |
         |- moutain.jpg
         |
         |- mountain.jpg.rdf
         |
         |- diary.odt
         |
         |- diary.odt.rdf

fssBackupDirectory
|
|- 9efeb7638fb35f5f9b9955da3e2dbfec_file.bak

9.1 FSS和RDF

如上所述在存储策略中提到，FSS可以可选地在后端存储中存储RDF文件。这些RDF文件符合DCMES-XML标准，该标准是DublinCore元素XML表达的标准。

如果您选择平面存储策略，可以使用build_fs_tree.py实用程序使用RDF文件构建尽可能接近Plone树结构的文件树。

$ cd /path/to/iw/fss/bin
$ python build_fs_tree.py --help

9.2 FSS维护

FSS配置面板的“维护”选项卡显示了FSS管理的文件数量的一些统计信息。

此外还提供了两个额外的按钮

• 更新FSS文件：清理后端存储目录。未从内容对象引用的文件将被删除。

• 更新RDF文件：构建所有RDF文件，如果您在插入相关内容后选择生成RDF文件。

12.1 在您的内容类型中使用FSS

我们假设创建基于AT的内容类型是一项熟悉的活动。

在创建内容类型的模式时，您通常不会提到字段的存储，因为AT提供默认的ZODB存储。您可以选择另一个存储，无论是Archetypes捆绑包中提供的另一个存储，还是FSS等第三方存储。

以下是一个不需要太多注释的小示例

# Usual Zope/CMF/Plone/Archetypes imports
...
from iw.fss.FileSystemStorage import FileSystemStorage
...
my_schema = Schema((
    FileField('file',
              ...
              storage=FileSystemStorage(),
              widget=FileWidget(...)
              ),
    ...
    ))
 ...

您可以通过查看examples/FSSItem.py来查看使用FSS的演示内容类型。如果您想玩这个内容类型

$ $INSTANCE_HOME/bin/zopectl stop
$ export FSS_INSTALL_EXAMPLE_TYPES=1
$ $INSTANCE_HOME/bin/zopectl start

12.2 修改第三方内容类型

...
from iw.fss import zcml as fss_utils
from Products.ATContentTypes import atct
...
fss_utils.patchATType(atct.ATFile, ['file'])
...

<configure
  ...
  xmlns:zcml="http://namespaces.zope.org/zcml"
  xmlns:fss="http://namespaces.ingeniweb.com/filesystemstorage"
  ...>
  ...
  <fss:typeWithFSS
    zcml:condition="installed iw.fss"
    class="Products.ATContentTypes.atct.ATFile"
    fields="file" />
  ...
</configure>

12.3 使用FSS存储Plone标准内容类型

将此ZCML元素包含在实例的package-includes目录中，或包含在任何个人实例包中的任何configure.zcml中

<include package="iw.fss" file="atct.zcml" />

此ZCML文件将FSS与Plone捆绑包中包含的相关内容类型连接起来

• 文件

• 图像

• 新闻条目

12.4 自定义RDF信息集

您可以通过FSS的专用（可选）钩子向RDF信息集中添加数据。

打开FSS配置面板，并给出您的个人RDF数据脚本名称，例如本例中的fss_custom_rdf。此脚本将添加或更改RDF默认数据集。

<fss:rdf_date>2007-05-13 13:21:00</fss:rdf_date>

## Script (Python) "fss_custom_rdf"
##bind container=container
##bind context=context
##bind namespace=
##bind script=script
##bind subpath=traverse_subpath
##parameters=name, instance, properties, default_rdf
##title=
##
"""We add the date of RDF file generation"""

rdf_args = default_rdf.copy()

# Add the date of RDF generation
new_props = []
new_props.extend(rdf_args['field_props'])
new_props.append({'id': 'fss:rdf_date', 'value': DateTime().ISO()})
rdf_args['field_props'] = new_props

return rdf_args

## Script (Python) "fss_custom_rdf"
##bind container=container
##bind context=context
##bind namespace=
##bind script=script
##bind subpath=traverse_subpath
##parameters=name, instance, properties, default_rdf
##title=
##
from Products.CMFCore.utils import getToolByName

rdf_args = {}

# Set RDF charset
ptool = getToolByName(instance, 'portal_properties')
rdf_args['charset'] = ptool.site_properties.default_charset

# Set RDF namespaces
rdf_args['namespaces'] = (
    {'id': 'xmlns:rdf', 'value': 'http://www.w3.org/1999/02/22-rdf-syntax-ns#'},
    {'id': 'xmlns:dc', 'value': 'http://purl.org/dc/elements/1.1/'},
    {'id': 'xmlns:fss', 'value': 'http://namespace.ingeniweb.com/fss'},)

# Set field url
utool = getToolByName(instance, 'portal_url')
portal_path = utool.getPortalObject().getPhysicalPath()
portal_path_len = len(portal_path)
rel_path = '/'.join(instance.getPhysicalPath()[portal_path_len:])
fss_path = '%s/%s' % (rel_path, name)
rdf_args['field_url'] = fss_path

# Set RDF properties
props = (
   {'id': 'dc:title', 'value': instance.title_or_id()},
   {'id': 'dc:description', 'value': instance.Description()},
   {'id': 'dc:language', 'value': instance.Language()},
   {'id': 'dc:creator', 'value': instance.Creator()},
   {'id': 'dc:date', 'value': instance.modified()},
   {'id': 'dc:format', 'value': properties.get('mimetype', 'text/plain')},
   )
rdf_args['field_props'] = props

# Returns the RDF structure
return rdf_args