使用AEM Forms存储库 working-with-aem-forms-repository
关于存储库服务
存储库服务向AEM Forms提供资源存储和管理服务。 当开发人员创建 AEM Forms 应用程序时,他们可以在存储库中部署资产,而不是文件系统。 资产可以包含任何类型的宣传资料,包括XML表单、PDF forms(包括Acrobat表单)、表单片段、图像、配置文件、策略、SWF文件、DDX文件、XML架构、WSDL文件和测试数据。
例如,请考虑以下名为的Forms应用程序 应用程序/表单应用程序:
请注意, FormsFolder中有一个名为Loan.xdp的文件。 要访问此表单设计,请指定完整路径(包括版本): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.
位于AEM Forms存储库中的资源的路径是:
Applications/Application-name/Application-version/Folder.../Filename
以下值显示一些URI值示例:
- Applications/AppraisalReport/1.0/Forms/FullForm.xdp
- Applications/AnotherApp/1.1/Assets/picture.jpg
- Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
存储库API提供了许多操作,可用于存储和检索来自存储库的信息。 例如,在处理应用程序时需要某个资源时,您可以获取资源列表或检索存储在存储库中的特定资源。
使用存储库服务API,您可以完成以下任务:
创建文件夹 creating-folders
文件夹(资源集合)用于按有组织的分组存储对象(文件或资源)。 文件夹可以包含资源和其他文件夹,也称为子文件夹。 资源一次只能存储在一个文件夹中。
文件会从文件夹继承访问控制列表(ACL),子文件夹会从其父文件夹继承ACL。 因此,在创建子文件夹之前,父文件夹必须存在。 IDE仅允许您逐个文件夹进行交互,而不允许逐个文件进行交互。 无法对文件夹进行版本更改,因此无需这样做;文件夹本身不包含数据。 相反,它只是包含数据的资源容器。 默认ACL是系统级权限,这意味着用户必须具有系统级权限(读取、写入、遍历、管理ACL),直到有人授予他们对特定文件夹的权限。 ACL仅在IDE中工作。
步骤摘要 summary-of-steps
要创建文件夹,请执行以下步骤:
- 包括项目文件。
- 创建服务客户端。
- 创建文件夹。
- 将文件夹写入存储库。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式创建资源集合之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
创建文件夹
调用存储库服务方法以创建资源集合,并使用标识信息(包括其UUID、文件夹名称和描述)填充资源集合。
将文件夹写入存储库
调用存储库服务方法以写入资源集合,并指定目标文件夹的URI。
另请参阅
使用Java API创建文件夹 create-folders-using-the-java-api
使用存储库服务API(Java)创建文件夹:
-
包含项目文件
将项目文件包含在您Java项目的类路径中。
-
创建服务客户端
创建
ResourceRepositoryClient
对象,并使用其构造函数进行传递ServiceClientFactory
包含连接属性的对象。 -
创建文件夹
要创建资源集合,您必须先创建
com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean
对象。调用
repositoryInfomodelFactoryBean
对象newResourceCollection
方法中,并传递以下参数:- A
com.adobe.repository.infomodel.Id
要分配给资源的UUID标识符。 - A
com.adobe.repository.infomodel.Lid
要分配给资源的UUID标识符。 - A
java.lang.String
包含资源集合的名称。 例如:FormsFolder
。
方法会返回
com.adobe.repository.infomodel.bean.ResourceCollection
表示新文件夹的对象。使用
setDescription
方法并传递以下参数:- A
String
描述资源集合的。 在本例中,"test Folder"
使用.
- A
-
将文件夹写入存储库
调用
ResourceRepositoryClient
对象writeResource
方法和传入文件夹的URI,以及ResourceCollection
对象。 例如,文件夹的URI可以是以下值/Applications/FormsApplication/1.0/
.方法会返回新创建的实例
com.adobe.repository.infomodel.bean.Resource
对象。 例如,您可以通过调用com.adobe.repository.infomodel.bean.Resource
对象getId
方法。
另请参阅
使用Web服务API创建文件夹 create-folders-using-the-web-service-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
的值。
另请参阅
编写资源 writing-resources
您可以在存储库的给定位置创建资源。 自然文件大小受数据库限制和会话超时的限制。 对于默认配置,文件长度限制为25 MB。 要提高或降低最大文件大小,必须更改数据库配置。
写入资源等同于在存储库中存储数据。 将资源写入存储库后,存储库生态系统中的所有客户端都可以访问该资源。 将资源(如XML架构、XDP文件和XSD文件)写入存储库时,将根据MIME类型分析内容。 如果支持MIME类型,则解析器会确定是否与其他内容存在隐含关系。 例如,如果级联样式表(CSS)具有引用通用CSS的相对URL,则您也应将通用CSS提交到存储库。 两个资源之间的关系被存储为30天的不可调整期间的挂起关系。 在30天内将通用CSS提交到存储库时,将形成关系。
创建资源时,访问控制列表(ACL)将继承自父文件夹。 在创建初始资源或文件夹之前,根文件夹具有系统级别的权限,此时该资源或文件夹会获得默认的ACL权限。
您可以使用存储库服务Java API或Web服务API以编程方式写入资源。
步骤摘要 summary_of_steps-1
要编写资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定要读取的资源的URI。
- 读取资源。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
为资源指定目标文件夹的URI
创建包含要读取的资源URI的字符串。 语法包括正斜杠,如以下示例所示:"/路径/文件夹"
创建资源
调用存储库服务方法以创建资源,并使用标识信息(包括其UUID、资源名称和描述)填充资源。
指定资源内容
调用存储库服务方法以创建资源内容,并将该内容存储在资源中。
将资源写入目标文件夹
调用存储库服务方法以写入资源,并指定目标文件夹的URI。
另请参阅
使用Java API写入资源 write-resources-using-the-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"
. - A
-
指定资源内容
要为资源创建内容,请调用
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写入资源 write-resources-using-the-web-service-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"
.
- A
-
指定资源内容
要为资源创建内容,请调用的默认构造函数
ResourceContent
类。 然后,将内容添加到ResourceContent
对象。 在本例中,可通过执行以下任务来完成此操作:- 分配
BLOB
包含文档的对象ResourceContent
对象dataDocument
字段。 - 以字节为单位分配
BLOB
对象ResourceContent
对象size
字段。
通过将
ResourceContent
对象Resource
对象content
字段。 - 分配
-
将资源写入目标文件夹
调用
RepositoryServiceService
对象writeResource
方法和传入文件夹的URI,以及Resource
对象。 通过null
的值。
另请参阅
列出资源 listing-resources
您可以通过列出资源来发现资源。 将对存储库执行查询,以查找与给定资源集合相关的所有资源。
整理资源后,您可以检查通过查看结构的特定分支创建的结构,就像在操作系统中一样。
上市资源按关系运作:资源是文件夹的成员。 会员资格由“会员”类型的关系表示。 在给定文件夹中列出资源时,您正在查询与给定文件夹相关的资源,其关系为“成员”。 关系是方向性的:关系成员具有作为目标成员的源。 来源是资源;目标是父文件夹。
步骤摘要 summary_of_steps-2
要列出资源,请执行以下步骤:
- 包括项目文件。
- 创建服务客户端。
- 指定文件夹路径。
- 检索资源列表。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式创建资源集合之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定文件夹路径
创建包含资源文件夹路径的字符串。 语法包括正斜杠,如以下示例所示:"/路径/文件夹"
检索资源列表
调用存储库服务方法以检索资源列表,并指定目标文件夹的路径。
另请参阅
使用Java API列出资源 list-resources-using-the-java-api
使用存储库服务API(Java)列出资源:
-
包含项目文件
将客户端JAR文件包含在您Java项目的类路径中。
-
创建服务客户端
创建
ResourceRepositoryClient
对象,并使用其构造函数进行传递ServiceClientFactory
包含连接属性的对象。 -
指定文件夹路径
指定要查询的资源集合的URI。 在这种情况下,其URI为
"/testFolder"
. URI将存储为java.lang.String
对象。 -
检索资源列表
调用
ResourceRepositoryClient
对象listMembers
方法和传入文件夹的URI。方法会返回
java.util.List
ofcom.adobe.repository.infomodel.bean.Resource
作为com.adobe.repository.infomodel.bean.Relation
类型Relation.TYPE_MEMBER_OF
并将资源集合URI作为目标。 您可以重复执行此操作List
来检索每个资源。 在此示例中,将显示每个资源的名称和描述。
另请参阅
列出资源.
使用Web服务API列出资源 list-resources-using-the-web-service-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
对象。 您可以遍历对象数组以检索每个相关资源。 在此示例中,将显示每个资源的名称和描述。
另请参阅
列出资源.
读取资源 reading-resources
您可以从存储库中的给定位置检索资源,以读取其内容和元数据。 该工作流由初始化表单前端。 该流程具有读取表单所需的所有权限。 系统检索数据表单并从存储库中读取内容。 存储库授予对内容和元数据的访问权限(甚至能够知道资源存在)。
存储库具有以下四种权限类型:
- 横移:允许您列出资源;即,读取资源元数据,但不读取资源内容
- 读取:用于读取资源内容
- 写入:允许您编写资源内容
- 管理访问控制列表(ACL):允许您处理资源上的ACL
用户只有在有权运行进程时才能运行进程。 IDE用户需要遍历和读取权限才能与存储库同步。 ACL仅在设计时应用,因为运行时在系统上下文中发生。
您可以使用存储库服务Java API或Web服务API以编程方式读取资源。
步骤摘要 summary_of_steps-3
要读取资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定要读取的资源的URI。
- 读取资源。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定要读取的资源的URI
创建包含要读取的资源URI的字符串。 语法包括正斜杠,如以下示例所示:"/路径/资源"
读取资源
调用存储库服务方法以读取资源,并指定URI。
另请参阅
使用Java API读取资源 read-resources-using-the-java-api
使用存储库服务API(Java)读取资源:
-
包含项目文件
将客户端JAR文件包含在您Java项目的类路径中。
-
创建服务客户端
创建
ResourceRepositoryClient
对象,并使用其构造函数进行传递ServiceClientFactory
包含连接属性的对象。 -
指定要读取的资源的URI
指定表示要检索的资源的URI的字符串值。 例如,假定资源名为 testResource 它位于名为 testFolder,指定
/testFolder/testResource
. -
读取资源
调用
ResourceRepositoryClient
对象readResource
方法并将资源的URI作为参数进行传递。 此方法将返回Resource
表示资源的实例。
另请参阅
使用Web服务API读取资源 reading-resources-using-the-web-service-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
的值。
另请参阅
更新资源 updating-resources
您可以检索和更新存储库中资源的内容。 在更新资源时,这些资源的访问控制在不同版本之间保持不变。 执行更新时,您可以选择增加主版本。 如果不选择递增主版本,则会自动更新次版本。
更新资源时,将根据指定的资源属性创建新版本。 在更新资源时,可指定两个重要参数:目标URI和包含所有更新元数据的资源实例。 请务必注意,如果您没有更改给定属性(例如,名称),则在您传入的实例中仍需要该属性。 解析内容时创建的关系将添加到特定版本,除非另外指定,否则不会推出。
例如,如果您更新了XDP文件,并且该文件包含对其他资源的引用,则还会记录这些附加引用。 假定form.xdp版本1.0具有两个外部引用:徽标和样式表,然后您随后更新了form.xdp,以便它现在有三个引用:徽标、样式表和模式文件。 在更新期间,存储库会将第三种关系(到架构文件)添加到其挂起关系表。 当架构文件存在于存储库中后,将自动形成关系。 但是,如果form.xdp版本2.0不再使用徽标,则form.xdp版本2.0将与徽标不相关。
所有更新操作都是原子操作和事务操作。 例如,如果两个用户读取同一资源并同时决定将版本1.0更新到版本2.0,则其中一个用户将成功,其中一个用户将失败,则存储库的完整性将得到维护,并且两用户都将收到一条消息,确认成功或失败。 如果事务未提交,则在出现数据库故障时将回滚,并且会超时或回滚,具体取决于应用程序服务器。
您可以使用存储库服务Java API或Web服务API以编程方式更新资源。
步骤摘要 summary_of_steps-4
要更新资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 检索要更新的资源。
- 更新资源。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
检索要更新的资源
读取资源。 有关更多信息,请参阅 读取资源.
更新资源
在资源中设置新信息并调用Repository服务方法来更新资源、指定URI、更新的资源以及应如何更新版本信息。
另请参阅
使用Java API更新资源 update-resources-using-the-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
传入,以指示主要版本将递增。
- A
另请参阅
使用Web服务API更新资源 update-resources-using-the-web-service-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
对于其余两个参数。
- A
另请参阅
搜索资源 searching-for-resources
您可以构建查询,用于在存储库中搜索资源,包括历史记录、相关资源和属性。
您可以检索相关资源以确定表单及其片段之间的依赖关系。 例如,如果您有表单,则可以确定它使用的片段或外部资源。 如果您有图像,则还可以查找使用该图像的表单。 您还可以使用基于属性的筛选来搜索相关资源。 例如,您可以搜索所有使用指定名称的图像的表单,或查找具有指定名称的表单使用的任何图像。 您还可以使用资源属性进行搜索。 例如,您可以执行查询以查找名称以给定字符串开头的所有表单或资源,该字符串可能包含“%”和“_”通配符。 请记住,基于属性的搜索不基于关系;此类搜索基于您对给定资源具有特定知识的假设。
查询语句
A 查询 包含一个或多个从逻辑上与条件联接的语句。 A 语句 由左操作数、运算符和右操作数组成。 此外,您还可以指定用于搜索结果的排序顺序。 的 排序顺序 包含与SQL等效的信息 ORDER BY
子句和由元素组成,这些元素包含搜索所依据的属性以及指示使用升序还是降序的值。
您可以使用存储库服务Java API以编程方式搜索资源。 目前,无法使用Web服务API来搜索资源。
排序行为
调用时,未遵循排序顺序 ResourceRepositoryClient
对象 searchProperties
方法和指定排序顺序。 例如,假定您创建了一个具有三个自定义属性的资源,其中属性名称为 name
, secondName
和 asecondName
. 接下来,在属性名称中创建排序顺序元素,并设置 ascending
值 true
.
然后,调用 ResourceRepositoryClient
对象 searchProperties
方法和按排序顺序传递。 搜索会返回具有三个属性的正确资源。 但是,属性不会按属性名称排序。 系统会按添加顺序返回它们: name
, secondName
和 asecondName
.
步骤摘要 summary_of_steps-5
要搜索资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定搜索的目标文件夹。
- 指定搜索中使用的属性。
- 创建搜索中使用的查询。
- 为搜索结果创建排序顺序。
- 搜索资源。
- 从搜索结果中检索资源。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定搜索的目标文件夹
创建一个字符串,其中包含用于执行搜索的基本路径。 语法包括正斜杠,如以下示例所示:"/路径/文件夹"
指定搜索中使用的属性
您可以根据资源中包含的属性进行搜索。 指定用于执行搜索的属性值。
创建搜索中使用的查询
使用语句和条件构建查询。 每个语句都将指定搜索所依据的属性、要使用的条件以及要在搜索中使用的属性值。
为搜索结果创建排序顺序
排序顺序由元素组成,每个元素都包含搜索中使用的一个属性和一个值,该值指示是使用升序还是降序。
搜索资源
使用文件夹、查询和排序顺序搜索资源。 此外,还指示搜索的深度和返回结果数的上限。
从搜索结果中检索资源
遍历返回的资源列表并提取信息以供进一步处理。
另请参阅
使用Java API搜索资源 search-for-resources-using-the-java-api
使用存储库服务API(Java)搜索资源:
-
包含项目文件
将客户端JAR文件包含在您Java项目的类路径中。
-
创建服务客户端
创建
ResourceRepositoryClient
对象,并使用其构造函数进行传递ServiceClientFactory
包含连接属性的对象。 -
指定搜索的目标文件夹
指定要从中执行搜索的基本路径的URI。 在此示例中,资源的URI为
/testFolder
. -
指定搜索中使用的属性
指定用于执行搜索的属性的值。 属性存在于
com.adobe.repository.infomodel.bean.Resource
对象。 在本例中,将对名称属性进行搜索;因此,ajava.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
ofResource
按指定排序顺序排列的对象。 - A
-
从搜索结果中检索资源
要检索搜索结果中包含的资源,请在
List
并将每个对象转换为Resource
以提取其信息。 在此示例中,将显示每个资源的名称。
另请参阅
创建资源关系 creating-resource-relationships
您可以指定存储库中资源之间的关系。 有三种关系:
- 依赖:资源依赖于其他资源的关系,这意味着存储库中需要所有相关资源。
- 会员资格(文件系统):资源位于给定文件夹中的关系。
- 自定义:您在资源之间指定的关系。 例如,如果一个资源已被弃用,而另一个资源被引入到存储库中,则可以指定您自己的替换关系。
您可以创建自己的自定义关系。 例如,如果将HTML文件存储在存储库中,并且该文件使用图像,则可以指定一个自定义关系,以将HTML文件与图像关联(因为通常只有XML文件与图像关联时使用存储库定义的依赖关系)。 自定义关系的另一个示例是,如果您希望使用循环图结构而不是树结构来构建存储库的不同视图。 您可以定义一个与查看器一起的圆形图来遍历这些关系。 最后,您可以指示某个资源替换了另一个资源,即使这两个资源完全不同。 在这种情况下,您可以在保留范围之外定义一种关系类型,并在这两种资源之间创建一种关系。 您的应用程序将是唯一能够检测和处理关系的客户端,并且可用于对该关系进行搜索。
您可以使用存储库服务Java API或Web服务API以编程方式指定资源之间的关系。
步骤摘要 summary_of_steps-6
要指定两个资源之间的关系,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定要关联的资源的URI。
- 创建关系。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定要关联的资源的URI
创建包含要关联的资源URI的字符串。 语法包括正斜杠,如以下示例所示:"/路径/资源"
创建关系
调用存储库服务方法以创建和指定关系类型。
另请参阅
使用Java API创建关系资源 create-relationship-resources-using-the-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
ofResource
可迭代以检索每个相关资源的对象,并铸造List
toResource
就象你这样。 在本例中,testResource2
预计将在返回的资源列表中。
另请参阅
使用Web服务API创建关系资源 create-relationship-resources-using-the-web-service-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
预计将在返回的资源列表中。
另请参阅
锁定资源 locking-resources
您可以锁定某个资源或一组资源,以供特定用户专用或在多个用户之间共享使用。 共享锁表示资源将发生某些情况,但不会阻止其他任何人使用该资源执行操作。 共享锁应被视为信令机制。 独占锁表示锁定资源的用户将更改资源,而锁则确保在用户不再需要访问该资源并释放锁之前,其他任何人都不能这样做。 如果存储库管理员解锁某个资源,则该资源上的所有独占和共享锁定将自动删除。 此类操作适用于用户不再可用且未解锁资源的情况。
资源被锁定后,当您查看位于Workbench中的“资源”选项卡时,会显示一个锁图标,如下图所示。
您可以使用存储库服务Java API或Web服务API以编程方式控制对资源的访问。
步骤摘要 summary_of_steps-7
要锁定和解锁资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定要锁定的资源的URI。
- 锁定资源。
- 检索资源的锁。
- 解锁资源
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定要锁定的资源的URI
创建包含要锁定的资源URI的字符串。 语法包括正斜杠,如以下示例所示:"/路径/资源"
锁定资源
调用存储库服务方法以锁定资源,指定URI、锁定类型和锁定深度。
检索资源的锁
调用Repository服务方法以检索资源的锁,并指定URI。
解锁资源
调用存储库服务方法以解锁资源,并指定URI。
另请参阅
使用Java API锁定资源 lock-resources-using-the-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
.
note note NOTE 的重载版本 lockResource
需要四个参数的方法会引发异常。 确保使用lockResource
方法需要三个参数,如本演练中所示。 -
检索资源的锁
调用
ResourceRepositoryClient
对象getLocks
方法并将资源的URI作为参数进行传递。 该方法会返回一个Lock对象列表,您可以通过该列表进行迭代。 在此示例中,通过调用每个锁定对象的getOwnerUserId
,getDepth
和getType
方法。 -
解锁资源
调用
ResourceRepositoryClient
对象unlockResource
方法并将资源的URI作为参数进行传递。 有关更多信息,请参阅 AEM Forms API参考.
另请参阅
使用Web服务API锁定资源 lock-resources-using-the-web-service-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
的值。
另请参阅
删除资源 deleting-resources
您可以使用存储库服务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),如果某个指定资源的删除失败,则不会回滚事务,这意味着无法删除那些已删除的文件。步骤摘要 summary_of_steps-8
要删除资源,请执行以下步骤:
- 包括项目文件。
- 创建存储库服务客户端。
- 指定要删除的资源的URI。
- 删除资源。
包含项目文件
在开发项目中包含必需的文件。 如果您使用Java创建客户端应用程序,请包含必需的JAR文件。 如果您使用的是Web服务,请包含代理文件。
创建服务客户端
在以编程方式读取资源之前,必须建立连接并提供凭据。 这是通过创建服务客户端来完成的。
指定要删除的资源的URI
创建包含要删除的资源URI的字符串。 语法包括正斜杠,如以下示例所示:"/路径/资源" 如果要删除的资源是文件夹,则删除将递归。
删除资源
调用存储库服务方法以删除资源,并指定URI。
另请参阅
使用Java API(SOAP)删除资源 delete-resources-using-the-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删除资源 delete-resources-using-the-web-service-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
的值。
另请参阅