通用 XML Digital Data Connector 插件

可以使用 IBM® Digital Data Connector (DDC) for WebSphere® Portal Express® 插件直接集成远程 XML 数据而无需编写代码。通过支持列表呈示概要文件概念，此插件可以实现对使用任意 XML 文档格式提供的 XML 数据进行集成。

列表呈示概要文件描述了特定 XML 文档格式与此 DDC 插件生成的通用 Bean 列表数据结构之间的变换。您可以通过名称 ibm.portal.ddc.xml 来标识通用 XML DDC 插件。可以使用 [Plugin:ListRenderingContext extension-id="ibm.portal.ddc.xml"] 标记对其进行寻址。通用 XML DDC 插件支持以下列表中显示的属性。使用 IBM Web Content Manager 提供的 ListRenderingContext 标记设置列表呈示上下文时，您可以指定这些属性。

source

您可以设置此属性以标识提供 XML 数据的源 URI。必须可以通过门户网站资源可寻址框架来访问该 URI。受支持的 URI 方案包括 http、https 和 dav。如果您使用 http 或 https URL 访问外部 XML 数据，请确保调整出站 HTTP 连接以允许对这些 URL 进行出站访问。有关更多信息，请阅读 IBM WebSphere Portal Express 文档中关于代理配置的信息。有关更多信息，请阅读“出站 HTTP 连接”。示例：

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.ibm.com/connections/communities/service/atom/catalog/public" 
   compute="always"

sortCriteria

设置此属性以根据特定属性对 Bean 列表的内容进行排序。必须在当前列表呈示上下文所使用的列表呈示概要文件中定义此排序属性。此内置排序功能仅对当前 Bean 列表中包含的数据进行排序。因此，如果 Bean 列表仅表示较大结果集的片段，请不要使用此属性。在这种情况下，请通过后端服务提供排序过程。如果未指定此属性，那么 Bean 列表将保持外部数据源提供的项顺序。要指定排序顺序，请使用 sortOrder 属性。

sortOrder

将此属性与 sortCriteria 属性结合使用以指定排序顺序。受支持的值为 asc 和 desc，分别表示按升序排序或按降序排序。示例：

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.ibm.com/connections/communities/service/atom/catalog/public" 
   attribute="sortCriteria=title" attribute="sortOrder=asc"]

cacheScope

设置此属性以确定特定列表呈示上下文所生成的 Bean 列表的高速缓存作用域。受支持的值如下所示：

public: 此值为缺省值。如果您将此属性设置为 public，那么已高速缓存的 Bean 列表值将在用户之间共享。
private: 如果将此属性设置为 private，那么将根据用户对各个 Bean 列表对象进行高速缓存。如果 Bean 列表包含特定于用户的信息，请指定 private。

示例：

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.ibm.com/connections/communities/service/atom/catalog/my" 
   attribute="cacheScope=private" compute="always"]

cacheType

设置此属性以确定要用于特定列表呈示上下文所生成的 Bean 列表的高速缓存类型。受支持的值如下所示：

invalidateOnLogin: 如果使用此设置，那么为其计算了 Bean 列表的用户登录门户网站时，已高速缓存的 Bean 列表对象将失效。仅将此值与 cacheScope=private 设置结合使用。
default: 如果使用此设置，那么在用户登录过程中，生成的已高速缓存的 Bean 列表不会失效。

invalidateCache

使用此属性可以使 Bean 列表失效。如果将此属性设置为值 always，那么 Bean 列表将始终在设置新的列表呈示上下文之前失效。换而言之，将针对每次呈示重新计算 Bean 列表。要实现条件失效，您可以将此属性设置为其他值。在这种情况下，仅当具有指定值的 Portlet 会话属性或请求属性在当前执行上下文中可用时，高速缓存才会失效。

clearCache

使用此属性可以清除 Bean 列表高速缓存。如果将此属性设置为值 always，那么将始终在设置新的列表呈示上下文之前清除高速缓存。要完成条件清除操作，您可以将此属性设置为其他值。在这种情况下，仅当具有指定值的 Portlet 会话属性或请求属性在当前执行上下文中可用时，才会清除高速缓存。