使用AEM Forms存储库

使用Web服务API创建文件夹

使用存储库服务API（Web服务）创建文件夹：

包含项目文件
- 使用base64创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
创建文件夹

使用 ResourceCollection 类，并传入以下参数：
- 安 Id 对象，通过为 Id 类并分配给 Resource 对象 id 字段。
- 安 Lid 对象，通过为 Lid 类并分配给 Resource 对象 lid 字段。
- 包含资源集合名称的字符串，该名称已分配给 Resource 对象 name 字段。此示例中使用的名称为 "testfolder".
- 包含资源集合描述的字符串，该描述已分配给 Resource 对象 description 字段。此示例中使用的描述是 "test folder".
将文件夹写入存储库

调用 RepositoryServiceService 对象 writeResource 方法并传递以下参数：
- 创建文件夹的路径。
- 的 ResourceCollection 表示文件夹的对象。
- 通过 null 的值。

另请参阅

创建文件夹

快速入门（SOAP模式）：使用Java API编写资源

编写资源

您可以在存储库的给定位置创建资源。自然文件大小受数据库限制和会话超时的限制。对于默认配置，文件长度限制为25 MB。要提高或降低最大文件大小，必须更改数据库配置。

写入资源等同于在存储库中存储数据。将资源写入存储库后，存储库生态系统中的所有客户端都可以访问该资源。将资源（如XML架构、XDP文件和XSD文件）写入存储库时，将根据MIME类型分析内容。如果支持MIME类型，则解析器会确定是否与其他内容存在隐含关系。例如，如果级联样式表(CSS)具有引用通用CSS的相对URL，则您也应将通用CSS提交到存储库。两个资源之间的关系被存储为30天的不可调整期间的挂起关系。在30天内将通用CSS提交到存储库时，将形成关系。

创建资源时，访问控制列表(ACL)将继承自父文件夹。在创建初始资源或文件夹之前，根文件夹具有系统级别的权限，此时该资源或文件夹会获得默认的ACL权限。

您可以使用存储库服务Java API或Web服务API以编程方式写入资源。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要编写资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定要读取的资源的URI。
读取资源。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

为资源指定目标文件夹的URI

创建包含要读取的资源URI的字符串。语法包括正斜杠，如以下示例所示："/路径/文件夹"

创建资源

调用存储库服务方法以创建资源，并使用标识信息（包括其UUID、资源名称和描述）填充资源。

指定资源内容

调用存储库服务方法以创建资源内容，并将该内容存储在资源中。

将资源写入目标文件夹

调用存储库服务方法以写入资源，并指定目标文件夹的URI。

另请参阅

使用Java API写入资源

使用存储库服务API(Java)编写资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
为资源指定目标文件夹的URI

为资源指定目标文件夹的URI。在本例中，因为资源名为 testResource 将存储在名为 testFolder，文件夹的URI为 "/testFolder". URI将存储为 java.lang.String 对象。
创建资源

要创建资源，必须先创建 com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean 对象。

调用 RepositoryInfomodelFactoryBean 对象 newResource 方法，创建 com.adobe.repository.infomodel.bean.Resource 对象。在本例中，提供了以下参数：
- A com.adobe.repository.infomodel.Id 对象，通过为 Id 类。
- A com.adobe.repository.infomodel.Lid 对象，通过为 Lid 类。
- A java.lang.String 包含资源的文件名。
要指定资源的描述，请调用 Resource 对象 setDescription 方法，并传递包含描述的字符串。在本例中，描述为 "test resource".
指定资源内容

要为资源创建内容，请调用 RepositoryInfomodelFactoryBean 对象 newResourceContent 方法，返回 com.adobe.repository.infomodel.bean.ResourceContent 对象。将内容添加到 ResourceContent 对象。在本例中，可通过执行以下任务来完成此操作：
- 调用 ResourceContent 对象 setDataDocument 方法和传递 com.adobe.idp.Document 对象
- 调用 ResourceContent 对象 setSize 方法和传入的大小（以字节为单位） Document 对象
通过调用 Resource 对象 setContent 方法和传入 ResourceContent 对象。有关更多信息，请参阅 AEM Forms API参考.
将资源写入目标文件夹

调用 ResourceRepositoryClient 对象 writeResource 方法和传入文件夹的URI，以及 Resource 对象。

另请参阅

编写资源

使用Web服务API写入资源

使用存储库服务API（Web服务）写入资源：

包含项目文件
- 使用base64创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
为资源指定目标文件夹的URI

为资源指定目标文件夹的URI。在本例中，因为资源名为 testResource 将存储在名为 testFolder，文件夹的URI为 "/testFolder". 使用与Microsoft .NET Framework（例如C#）兼容的语言时，将URI存储在 System.String 对象。
创建资源

要创建资源，请为 Resource 类。在本例中，以下信息存储在 Resource 对象：
- A com.adobe.repository.infomodel.Id 对象，通过为 Id 类并分配给 Resource 对象 id 字段。
- A com.adobe.repository.infomodel.Lid 对象，通过为 Lid 类并分配给 Resource 对象 lid 字段。
- 包含资源文件名(分配给 Resource 对象 name 字段。此示例中使用的名称为 "testResource".
- 包含资源描述的字符串，该描述已分配给 Resource 对象 description 字段。此示例中使用的描述是 "test resource".
指定资源内容

要为资源创建内容，请调用的默认构造函数 ResourceContent 类。然后，将内容添加到 ResourceContent 对象。在本例中，可通过执行以下任务来完成此操作：
- 分配 BLOB 包含文档的对象 ResourceContent 对象 dataDocument 字段。
- 以字节为单位分配 BLOB 对象 ResourceContent 对象 size 字段。
通过将 ResourceContent 对象 Resource 对象 content 字段。
将资源写入目标文件夹

调用 RepositoryServiceService 对象 writeResource 方法和传入文件夹的URI，以及 Resource 对象。通过 null 的值。

另请参阅

编写资源

快速入门（SOAP模式）：使用Java API列出资源

列出资源

您可以通过列出资源来发现资源。将对存储库执行查询，以查找与给定资源集合相关的所有资源。

整理资源后，您可以检查通过查看结构的特定分支创建的结构，就像在操作系统中一样。

上市资源按关系运作：资源是文件夹的成员。会员资格由“会员”类型的关系表示。在给定文件夹中列出资源时，您正在查询与给定文件夹相关的资源，其关系为“成员”。关系是方向性的：关系成员具有作为目标成员的源。来源是资源；目标是父文件夹。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要列出资源，请执行以下步骤：

包括项目文件。
创建服务客户端。
指定文件夹路径。
检索资源列表。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式创建资源集合之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定文件夹路径

创建包含资源文件夹路径的字符串。语法包括正斜杠，如以下示例所示："/路径/文件夹"

检索资源列表

调用存储库服务方法以检索资源列表，并指定目标文件夹的路径。

另请参阅

使用Java API列出资源

使用存储库服务API(Java)列出资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定文件夹路径

指定要查询的资源集合的URI。在这种情况下，其URI为 "/testFolder". URI将存储为 java.lang.String 对象。
检索资源列表

调用 ResourceRepositoryClient 对象 listMembers 方法和传入文件夹的URI。

方法会返回 java.util.List of com.adobe.repository.infomodel.bean.Resource 作为 com.adobe.repository.infomodel.bean.Relation 类型 Relation.TYPE_MEMBER_OF 并将资源集合URI作为目标。您可以重复执行此操作 List 来检索每个资源。在此示例中，将显示每个资源的名称和描述。

另请参阅

列出资源.

使用Web服务API列出资源

使用存储库服务API（Web服务）列出资源：

包含项目文件
- 创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
指定文件夹路径

指定包含要查询的文件夹URI的字符串。在这种情况下，其URI为 "/testFolder". 使用与Microsoft .NET Framework（例如C#）兼容的语言时，将URI存储在 System.String 对象。
检索资源列表

调用 RepositoryServiceService 对象 listMembers 方法并将文件夹的URI作为第一个参数进行传递。通过 null 的值。

方法会返回可转换为 Resource 对象。您可以遍历对象数组以检索每个相关资源。在此示例中，将显示每个资源的名称和描述。

另请参阅

列出资源.

快速入门（SOAP模式）：使用Java API读取资源

读取资源

您可以从存储库中的给定位置检索资源，以读取其内容和元数据。该工作流由初始化表单前端。该流程具有读取表单所需的所有权限。系统检索数据表单并从存储库中读取内容。存储库授予对内容和元数据的访问权限（甚至能够知道资源存在）。

存储库具有以下四种权限类型：

横移:允许您列出资源；即，读取资源元数据，但不读取资源内容
读取:用于读取资源内容
写入:允许您编写资源内容
管理访问控制列表(ACL):允许您处理资源上的ACL

用户只有在有权运行进程时才能运行进程。 IDE用户需要遍历和读取权限才能与存储库同步。 ACL仅在设计时应用，因为运行时在系统上下文中发生。

您可以使用存储库服务Java API或Web服务API以编程方式读取资源。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要读取资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定要读取的资源的URI。
读取资源。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定要读取的资源的URI

创建包含要读取的资源URI的字符串。语法包括正斜杠，如以下示例所示："/路径/资源"

读取资源

调用存储库服务方法以读取资源，并指定URI。

另请参阅

使用Java API读取资源

使用存储库服务API(Java)读取资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定要读取的资源的URI

指定表示要检索的资源的URI的字符串值。例如，假定资源名为 testResource 它位于名为 testFolder，指定 /testFolder/testResource.
读取资源

调用 ResourceRepositoryClient 对象 readResource 方法并将资源的URI作为参数进行传递。此方法将返回 Resource 表示资源的实例。

另请参阅

读取资源

使用Web服务API读取资源

使用存储库服务API（Web服务）读取资源：

包含项目文件
- 创建使用存储库WSDL的Microsoft .NET客户端程序集。 (请参阅创建使用Base64编码的.NET客户端程序集.)
- 引用Microsoft .NET客户端程序集。 (请参阅创建使用Base64编码的.NET客户端程序集.)
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
指定要读取的资源的URI

指定包含要检索的资源URI的字符串。在本例中，因为资源名为 testResource 位于名为的文件夹中 testFolder，其URI为 "/testFolder/testResource". 使用与Microsoft .NET Framework（例如C#）兼容的语言时，将URI存储在 System.String 对象。
读取资源

调用 RepositoryServiceService 对象 readResource 方法，并将资源的URI作为第一个参数进行传递。通过 null 的值。

另请参阅

读取资源

快速入门（SOAP模式）：使用Java API更新资源

更新资源

您可以检索和更新存储库中资源的内容。在更新资源时，这些资源的访问控制在不同版本之间保持不变。执行更新时，您可以选择增加主版本。如果不选择递增主版本，则会自动更新次版本。

更新资源时，将根据指定的资源属性创建新版本。在更新资源时，可指定两个重要参数：目标URI和包含所有更新元数据的资源实例。请务必注意，如果您没有更改给定属性（例如，名称），则在您传入的实例中仍需要该属性。解析内容时创建的关系将添加到特定版本，除非另外指定，否则不会推出。

例如，如果您更新了XDP文件，并且该文件包含对其他资源的引用，则还会记录这些附加引用。假定form.xdp版本1.0具有两个外部引用：徽标和样式表，然后您随后更新了form.xdp，以便它现在有三个引用：徽标、样式表和模式文件。在更新期间，存储库会将第三种关系（到架构文件）添加到其挂起关系表。当架构文件存在于存储库中后，将自动形成关系。但是，如果form.xdp版本2.0不再使用徽标，则form.xdp版本2.0将与徽标不相关。

所有更新操作都是原子操作和事务操作。例如，如果两个用户读取同一资源并同时决定将版本1.0更新到版本2.0，则其中一个用户将成功，其中一个用户将失败，则存储库的完整性将得到维护，并且两用户都将收到一条消息，确认成功或失败。如果事务未提交，则在出现数据库故障时将回滚，并且会超时或回滚，具体取决于应用程序服务器。

您可以使用存储库服务Java API或Web服务API以编程方式更新资源。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要更新资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
检索要更新的资源。
更新资源。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

检索要更新的资源

读取资源。有关更多信息，请参阅读取资源.

更新资源

在资源中设置新信息并调用Repository服务方法来更新资源、指定URI、更新的资源以及应如何更新版本信息。

另请参阅

使用Java API更新资源

使用存储库服务API(Java)更新资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
检索要更新的资源

指定要检索和读取资源的资源的URI。在此示例中，资源的URI为 "/testFolder/testResource".
更新资源

更新 Resource 对象信息。在本例中，要更新描述，请调用 Resource 对象 setDescription 方法并将新描述字符串作为参数进行传递。

然后调用 ServiceClientFactory 对象 updateResource 方法中，并传递以下参数：
- A java.lang.String 包含资源URI的对象。
- 的 Resource 包含更新的资源信息的对象。
- A boolean 值指示是更新主版本还是次版本。在本例中，值为 true 传入，以指示主要版本将递增。

另请参阅

更新资源

使用Web服务API更新资源

使用存储库API（Web服务）更新资源：

包含项目文件
- 创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
检索要更新的资源

指定要检索并读取资源的资源的URI。在此示例中，资源的URI为 "/testFolder/testResource". 有关更多信息，请参阅读取资源.
更新资源

更新 Resource 对象信息。在本例中，要更新描述，请为 Resource 对象 description 字段。
调用 RepositoryServiceService 对象 updateResource 方法中，并传递以下参数：
- A System.String 包含资源URI的对象。
- 的 Resource 包含更新的资源信息的对象。
- A boolean 值指示是更新主版本还是次版本。在本例中，值为 true 传入，以指示主要版本将递增。
- 通过 null 对于其余两个参数。

另请参阅

更新资源

快速入门（SOAP模式）：使用Java API搜索资源

搜索资源

您可以构建查询，用于在存储库中搜索资源，包括历史记录、相关资源和属性。

您可以检索相关资源以确定表单及其片段之间的依赖关系。例如，如果您有表单，则可以确定它使用的片段或外部资源。如果您有图像，则还可以查找使用该图像的表单。您还可以使用基于属性的筛选来搜索相关资源。例如，您可以搜索所有使用指定名称的图像的表单，或查找具有指定名称的表单使用的任何图像。您还可以使用资源属性进行搜索。例如，您可以执行查询以查找名称以给定字符串开头的所有表单或资源，该字符串可能包含“%”和“_”通配符。请记住，基于属性的搜索不基于关系；此类搜索基于您对给定资源具有特定知识的假设。

查询语句

A 查询包含一个或多个从逻辑上与条件联接的语句。 A 语句由左操作数、运算符和右操作数组成。此外，您还可以指定用于搜索结果的排序顺序。的 排序顺序 包含与SQL等效的信息 ORDER BY 子句和由元素组成，这些元素包含搜索所依据的属性以及指示使用升序还是降序的值。

您可以使用存储库服务Java API以编程方式搜索资源。目前，无法使用Web服务API来搜索资源。

排序行为

调用时，未遵循排序顺序 ResourceRepositoryClient 对象 searchProperties 方法和指定排序顺序。例如，假定您创建了一个具有三个自定义属性的资源，其中属性名称为 name, secondName和 asecondName. 接下来，在属性名称中创建排序顺序元素，并设置 ascending 值 true.

然后，调用 ResourceRepositoryClient 对象 searchProperties 方法和按排序顺序传递。搜索会返回具有三个属性的正确资源。但是，属性不会按属性名称排序。系统会按添加顺序返回它们： name, secondName和 asecondName.

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要搜索资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定搜索的目标文件夹。
指定搜索中使用的属性。
创建搜索中使用的查询。
为搜索结果创建排序顺序。
搜索资源。
从搜索结果中检索资源。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定搜索的目标文件夹

创建一个字符串，其中包含用于执行搜索的基本路径。语法包括正斜杠，如以下示例所示："/路径/文件夹"

指定搜索中使用的属性

您可以根据资源中包含的属性进行搜索。指定用于执行搜索的属性值。

创建搜索中使用的查询

使用语句和条件构建查询。每个语句都将指定搜索所依据的属性、要使用的条件以及要在搜索中使用的属性值。

为搜索结果创建排序顺序

排序顺序由元素组成，每个元素都包含搜索中使用的一个属性和一个值，该值指示是使用升序还是降序。

搜索资源

使用文件夹、查询和排序顺序搜索资源。此外，还指示搜索的深度和返回结果数的上限。

从搜索结果中检索资源

遍历返回的资源列表并提取信息以供进一步处理。

另请参阅

使用Java API搜索资源

使用存储库服务API(Java)搜索资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定搜索的目标文件夹

指定要从中执行搜索的基本路径的URI。在此示例中，资源的URI为 /testFolder.
指定搜索中使用的属性

指定用于执行搜索的属性的值。属性存在于 com.adobe.repository.infomodel.bean.Resource 对象。在本例中，将对名称属性进行搜索；因此，a java.lang.String 包含 Resource 使用对象的名称，即 testResource 在这种情况下。
创建搜索中使用的查询

要创建查询，请创建 com.adobe.repository.query.Query 对象，方法是为 Query 类和向查询添加语句。

要创建语句，请为 com.adobe.repository.query.Query.Statement 类，并传入以下参数：
- 包含资源属性常量的左操作数。在本例中，由于资源的名称用作搜索的基础，因此该静态值 Resource.ATTRIBUTE_NAME 中，将使用。
- 包含搜索属性时所用条件的运算符。运算符必须是 Query.Statement 类。在本例中，静态值 Query.Statement.OPERATOR_BEGINS_WITH 中，将使用。
- 右操作数，其中包含用于执行搜索的属性值。在本例中， name属性 String 包含值 "testResource"，则使用。
通过调用 Query.Statement 对象 setNamespace 方法，并传入 com.adobe.repository.infomodel.bean.ResourceProperty 类。在此示例中，使用 ResourceProperty.RESERVED_NAMESPACE_REPOSITORY。

通过调用 Query 对象 addStatement 方法和传入 Query.Statement 对象。
为搜索结果创建排序顺序

要指定搜索结果中使用的排序顺序，请创建 com.adobe.repository.query.sort.SortOrder 对象，方法是为 SortOrder 类，并向排序顺序中添加元素。

要为排序顺序创建元素，请为 com.adobe.repository.query.sort.SortOrder.Element 类。在本例中，由于资源的名称用作搜索的基础，因此该静态值 Resource.ATTRIBUTE_NAME 用作第一个参数，并按升序( boolean 值 true)指定为第二个参数。

通过调用 SortOrder 对象 addSortElement 方法和传入 SortOrder.Element 对象。
搜索资源

搜索 resources 根据属性属性，调用 ResourceRepositoryClient 对象 searchProperties 方法并传递以下参数：
- A String 包含执行搜索的基本路径。在这种情况下， "/testFolder" 中，将使用。
- 搜索中使用的查询。
- 搜索的深度。在这种情况下， com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE 用于指示将使用基本路径及其所有文件夹。
- 安 int 值，指示从中选择未分页结果集的第一行。在本例中， 0 指定。
- 安 int 表示要返回的结果最大数的值。在本例中， 10 指定。
- 搜索中使用的排序顺序。
方法会返回 java.util.List of Resource 按指定排序顺序排列的对象。
从搜索结果中检索资源

要检索搜索结果中包含的资源，请在 List 并将每个对象转换为 Resource 以提取其信息。在此示例中，将显示每个资源的名称。

另请参阅

搜索资源

快速入门（SOAP模式）：使用Java API创建资源之间的关系

创建资源关系

您可以指定存储库中资源之间的关系。有三种关系：

依赖:资源依赖于其他资源的关系，这意味着存储库中需要所有相关资源。
会员资格（文件系统）:资源位于给定文件夹中的关系。
自定义:您在资源之间指定的关系。例如，如果一个资源已被弃用，而另一个资源被引入到存储库中，则可以指定您自己的替换关系。

您可以创建自己的自定义关系。例如，如果将HTML文件存储在存储库中，并且该文件使用图像，则可以指定一个自定义关系，以将HTML文件与图像关联（因为通常只有XML文件与图像关联时使用存储库定义的依赖关系）。自定义关系的另一个示例是，如果您希望使用循环图结构而不是树结构来构建存储库的不同视图。您可以定义一个与查看器一起的圆形图来遍历这些关系。最后，您可以指示某个资源替换了另一个资源，即使这两个资源完全不同。在这种情况下，您可以在保留范围之外定义一种关系类型，并在这两种资源之间创建一种关系。您的应用程序将是唯一能够检测和处理关系的客户端，并且可用于对该关系进行搜索。

您可以使用存储库服务Java API或Web服务API以编程方式指定资源之间的关系。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要指定两个资源之间的关系，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定要关联的资源的URI。
创建关系。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定要关联的资源的URI

创建包含要关联的资源URI的字符串。语法包括正斜杠，如以下示例所示："/路径/资源"

创建关系

调用存储库服务方法以创建和指定关系类型。

另请参阅

使用Java API创建关系资源

使用存储库服务Java API创建关系资源，然后执行以下任务：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定要关联的资源的URI

指定要关联的资源的URI。在本例中，由于资源名为 testResource1 和 testResource2 和位于名为 testFolder，其URI为 "/testFolder/testResource1" 和 "/testFolder/testResource2". URI将存储为 java.lang.String 对象。在本例中，首先将资源写入存储库，并检索其URI。有关编写资源的更多信息，请参阅编写资源.
创建关系

调用 ResourceRepositoryClient 对象 createRelationship 方法并传递以下参数：
- 源资源的URI。
- 目标资源的URI。
- 关系的类型，它是 com.adobe.repository.infomodel.bean.Relation 类。在本例中，通过指定值来建立依赖关系 Relation.TYPE_DEPENDANT_OF.
- A boolean 指示目标资源是否自动更新为 com.adobe.repository.infomodel.Id基于的新头资源的标识符。在本例中，由于依赖关系，因此 true 指定。
您还可以通过调用 ResourceRepositoryClient 对象 getRelated 方法和传递以下参数：
- 要为其检索相关资源的资源的URI。在本例中，源资源( "/testFolder/testResource1")。
- A boolean 值指示指定的资源是否是关系中的源资源。在本例中，值 true 已指定，因为这种情况出现。
- 关系类型，它是 Relation 类。在本例中，依赖关系通过使用之前使用的相同值来指定： Relation.TYPE_DEPENDANT_OF.
的 getRelated 方法返回 java.util.List of Resource 可迭代以检索每个相关资源的对象，并铸造 List to Resource 就象你这样。在本例中， testResource2 预计将在返回的资源列表中。

另请参阅

创建资源关系

使用Web服务API创建关系资源

使用存储库API（Web服务）创建关系资源：

包含项目文件
- 创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
指定要关联的资源的URI

指定要关联的资源的URI。在本例中，由于资源名为 testResource1 和 testResource2 和位于名为 testFolder，其URI为 "/testFolder/testResource1" 和 "/testFolder/testResource2". 使用与Microsoft .NET Framework（例如C#）兼容的语言时，URI将存储为 System.String 对象。在本例中，首先将资源写入存储库，并检索其URI。有关编写资源的更多信息，请参阅编写资源.
创建关系

调用 RepositoryServiceService 对象 createRelationship 方法并传递以下参数：
- 源资源的URI。
- 目标资源的URI。
- 关系的类型。在本例中，通过指定值来建立依赖关系 3.
- A boolean 表示是否指定了关系类型的值。在本例中，值 true 指定。
- A boolean 指示目标资源是否自动更新为 Id基于的新头资源的标识符。在本例中，由于依赖关系，因此 true 指定。
- A boolean 指示是否指定了目标头的值。在本例中，值 true 指定。
- 通过 null ，用于最后一个参数。
您还可以通过调用 RepositoryServiceService 对象 getRelated 方法和传递以下参数：
- 要为其检索相关资源的资源的URI。在本例中，源资源( "/testFolder/testResource1")。
- A boolean 值指示指定的资源是否是关系中的源资源。在本例中，值 true 已指定，因为这种情况出现。
- A boolean 表示是否指定了源资源的值。在本例中，值 true 中的“隐藏主体”。
- 包含关系类型的整数数组。在此示例中，依赖关系是使用数组中与之前使用的值相同的值指定的： 3.
- 通过 null 对于其余两个参数。
的 getRelated 方法返回可转换为 Resource 可通过其进行迭代以检索每个相关资源的对象。在本例中， testResource2 预计将在返回的资源列表中。

另请参阅

创建资源关系

快速入门（SOAP模式）：使用Java API锁定资源

锁定资源

您可以锁定某个资源或一组资源，以供特定用户专用或在多个用户之间共享使用。共享锁表示资源将发生某些情况，但不会阻止其他任何人使用该资源执行操作。共享锁应被视为信令机制。独占锁表示锁定资源的用户将更改资源，而锁则确保在用户不再需要访问该资源并释放锁之前，其他任何人都不能这样做。如果存储库管理员解锁某个资源，则该资源上的所有独占和共享锁定将自动删除。此类操作适用于用户不再可用且未解锁资源的情况。

资源被锁定后，当您查看位于Workbench中的“资源”选项卡时，会显示一个锁图标，如下图所示。

lr_lr_lockrepository

您可以使用存储库服务Java API或Web服务API以编程方式控制对资源的访问。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要锁定和解锁资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定要锁定的资源的URI。
锁定资源。
检索资源的锁。
解锁资源

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定要锁定的资源的URI

创建包含要锁定的资源URI的字符串。语法包括正斜杠，如以下示例所示："/路径/资源"

锁定资源

调用存储库服务方法以锁定资源，指定URI、锁定类型和锁定深度。

检索资源的锁

调用Repository服务方法以检索资源的锁，并指定URI。

解锁资源

调用存储库服务方法以解锁资源，并指定URI。

另请参阅

使用Java API锁定资源

使用存储库服务API(Java)锁定资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定要锁定的资源的URI

指定要锁定的资源的URI。在本例中，因为资源名为 testResource 位于名为的文件夹中 testFolder，其URI为 "/testFolder/testResource". URI将存储为 java.lang.String 对象。
锁定资源

调用 ResourceRepositoryClient 对象 lockResource 方法并传递以下参数：
- 资源的URI。
- 锁定范围。在本例中，由于资源将被锁定以供独占使用，因此锁定范围指定为 com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE.
- 锁的深度。在此示例中，由于锁定将仅应用于特定资源，且不应用其成员或子资源，因此锁定深度指定为 Lock.DEPTH_ZERO.
注意

的重载版本 lockResource 需要四个参数的方法会引发异常。确保使用 lockResource 方法需要三个参数，如本演练中所示。
检索资源的锁

调用 ResourceRepositoryClient 对象 getLocks 方法并将资源的URI作为参数进行传递。该方法会返回一个Lock对象列表，您可以通过该列表进行迭代。在此示例中，通过调用每个锁定对象的 getOwnerUserId, getDepth和 getType 方法。
解锁资源

调用 ResourceRepositoryClient 对象 unlockResource 方法并将资源的URI作为参数进行传递。有关更多信息，请参阅 AEM Forms API参考.

另请参阅

锁定资源

使用Web服务API锁定资源

使用存储库服务API（Web服务）锁定资源：

包含项目文件
- 使用Base64创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
指定要锁定的资源的URI

指定包含要锁定的资源URI的字符串。在本例中，因为资源名为 testResource 在文件夹中 testFolder，其URI为 "/testFolder/testResource". 使用与Microsoft .NET Framework（例如C#）兼容的语言时，将URI存储在 System.String 对象。
锁定资源

调用 RepositoryServiceService 对象 lockResource 方法并传递以下参数：
- 资源的URI。
- 锁定范围。在本例中，由于资源将被锁定以供独占使用，因此锁定范围指定为 11.
- 锁的深度。在此示例中，由于锁定将仅应用于特定资源，且不应用其成员或子资源，因此锁定深度指定为 2.
- 安 int 值，指示锁定过期的秒数。在本例中， 1000 中，将使用。
- 通过 null ，用于最后一个参数。
检索资源的锁

调用 RepositoryServiceService 对象 getLocks 方法，并将资源的URI作为第一个参数和 null 的值。方法会返回 object 包含数组 Lock 可通过其进行迭代的对象。在本例中，通过访问每个对象，为每个对象打印锁所有者、深度和范围 Lock 对象 ownerUserId, depth和 type 字段。
解锁资源

调用 RepositoryServiceService 对象 unlockResource 方法，并将资源的URI作为第一个参数和 null 的值。

另请参阅

锁定资源

快速入门（SOAP模式）：使用Java API搜索资源

删除资源

您可以使用存储库服务Java API(SOAP)以编程方式从存储库中的给定位置删除资源。

删除资源时，该删除操作通常是永久性的，但在某些情况下，ECM存储库可能会根据其历史机制存储资源的版本。因此，在删除资源时，务必确保不再需要该资源。删除资源的常见原因包括需要增加数据库中的可用空间。您可以删除资源的某个版本，但是如果删除了该版本，则必须指定资源标识符，而不是其逻辑标识符(LID)或路径。如果删除文件夹，则该文件夹中的所有内容（包括子文件夹和资源）都将被自动删除。

不会删除相关资源。例如，如果您有一个使用logo.gif文件的表单，并删除logo.gif，则关系将存储在挂起的关系表中。作为替代方法，对于弃用的版本，请将最新版本的对象状态设置为已弃用。

在ECM系统中，删除操作不是事务安全的。例如，如果您尝试删除100个资源，并且该操作在第50个资源上失败，则将删除前49个实例，但其余实例将不会删除。否则，默认行为为回滚（非承诺）。

注意

使用 com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources() 方法(EMC Documentum Content Server和IBM FileNet P8 Content Manager)，如果某个指定资源的删除失败，则不会回滚事务，这意味着无法删除那些已删除的文件。

注意

有关存储库服务的详细信息，请参阅 AEM Forms服务参考.

步骤摘要

要删除资源，请执行以下步骤：

包括项目文件。
创建存储库服务客户端。
指定要删除的资源的URI。
删除资源。

包含项目文件

在开发项目中包含必需的文件。如果您使用Java创建客户端应用程序，请包含必需的JAR文件。如果您使用的是Web服务，请包含代理文件。

创建服务客户端

在以编程方式读取资源之前，必须建立连接并提供凭据。这是通过创建服务客户端来完成的。

指定要删除的资源的URI

创建包含要删除的资源URI的字符串。语法包括正斜杠，如以下示例所示："/路径/资源" 如果要删除的资源是文件夹，则删除将递归。

删除资源

调用存储库服务方法以删除资源，并指定URI。

另请参阅

使用Java API(SOAP)删除资源

使用存储库API(Java)删除资源：

包含项目文件

将客户端JAR文件包含在您Java项目的类路径中。
创建服务客户端

创建 ResourceRepositoryClient 对象，并使用其构造函数进行传递 ServiceClientFactory 包含连接属性的对象。
指定要删除的资源的URI

指定要检索的资源的URI。在这种情况下，由于名为testResourceToBeDeleted的资源位于名为testFolder的文件夹中，因此其URI为 /testFolder/testResourceToBeDeleted. URI将存储为 java.lang.String 对象。在此示例中，资源首先写入存储库，并检索其URI。有关编写资源的更多信息，请参阅编写资源.
删除资源

调用 ResourceRepositoryClient 对象 deleteResource 方法并将资源的URI作为参数进行传递。

另请参阅

删除资源

使用Web服务API删除资源

使用存储库API（Web服务）删除资源：

包含项目文件
- 使用Base64创建使用存储库WSDL的Microsoft .NET客户端程序集。
- 引用Microsoft .NET客户端程序集。
创建服务客户端

使用Microsoft .NET客户端程序集，创建 RepositoryServiceService 对象。设置 Credentials 属性 System.Net.NetworkCredential 包含用户名和密码的对象。
指定要删除的资源的URI

指定要检索的资源的URI。在本例中，因为资源名为 testResourceToBeDeleted 位于名为的文件夹中 testFolder，其URI为 "/testFolder/testResourceToBeDeleted". 在此示例中，资源首先写入存储库，并检索其URI。有关编写资源的更多信息，请参阅编写资源.
删除资源

调用 RepositoryServiceService 对象 deleteResources 方法和通过 System.String 包含资源URI作为第一个参数的数组。通过 null 的值。

另请参阅

删除资源