使用AEM Forms存放庫

快速入門（SOAP模式）:使用Java API建立資料夾

使用Java API建立資料夾

使用儲存庫服務API(Java)建立資料夾：

包含項目檔案

在Java項目的類路徑中包含項目檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
建立資料夾

要建立資源集合，必須首先建立com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean對象。

叫用repositoryInfomodelFactoryBean物件的newResourceCollection方法，並傳入下列參數：
- 要指派給資源的com.adobe.repository.infomodel.Id UUID識別碼。
- 要指派給資源的com.adobe.repository.infomodel.Lid UUID識別碼。
- 包含資源集合名稱的java.lang.String。例如， FormsFolder。
此方法會傳回代表新資料夾的com.adobe.repository.infomodel.bean.ResourceCollection物件。

使用setDescription方法設定資料夾的說明，並傳入下列參數：
- 描述資源集合的String。在此範例中，使用"test Folder" .
將資料夾寫入儲存庫

調用ResourceRepositoryClient對象的writeResource方法，並傳入資料夾和ResourceCollection對象的URI。例如，資料夾的URI可以是以下值/Applications/FormsApplication/1.0/。

此方法會傳回新建立的com.adobe.repository.infomodel.bean.Resource物件的例項。例如，可以通過調用com.adobe.repository.infomodel.bean.Resource對象的getId方法來檢索新資源的標識符值。

另請參閱

建立資料夾

使用Web服務API建立資料夾

使用存放庫服務API（Web服務）建立資料夾：

包含項目檔案
- 建立一個使用base64使用儲存庫WSDL的Microsoft .NET客戶端程式集。
- 參考Microsoft .NET客戶端程式集。
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
建立資料夾

使用ResourceCollection類的預設建構子建立資料夾，並傳入下列參數：
- Id對象，通過調用Id類的預設建構子來建立，並分配給Resource對象的id欄位。
- Lid對象，通過調用Lid類的預設建構子來建立，並分配給Resource對象的lid欄位。
- 包含資源集合名稱的字串，該名稱被分配給Resource對象的name欄位。此範例中使用的名稱為"testfolder"。
- 包含資源集合說明的字串，該資源集合已分配給Resource對象的description欄位。此範例中使用的說明為"test folder"。
將資料夾寫入儲存庫

叫用RepositoryServiceService物件的writeResource方法並傳入下列參數：
- 要建立資料夾的路徑。
- 代表資料夾的ResourceCollection物件。
- 傳遞null以取得其他兩個參數。

另請參閱

建立資料夾

寫入資源

您可以在存放庫的指定位置中建立資源。自然檔案大小受資料庫限制和工作階段逾時限制。對於預設配置，檔案限制為25 MB。要提高或降低最大檔案大小，必須更改資料庫配置。

寫入資源等同於將資料儲存在儲存庫中。將資源寫入儲存庫後，儲存庫生態系統中的所有客戶端都可以訪問該資源。將資源（如XML架構、XDP檔案和XSD檔案）寫入儲存庫時，內容會根據MIME類型進行剖析。如果支援MIME類型，則解析器確定是否與其他內容存在默示關係。例如，如果階層式樣式表(CSS)有參考通用CSS的相對URL，您也應將通用CSS提交至存放庫。兩個資源之間的關係被儲存為30天不可調整的待處理關係。在30天內將通用CSS提交至存放庫時，會形成關係。

建立資源時，訪問控制清單(ACL)繼承自父資料夾。根資料夾具有系統級權限，直到建立初始資源或資料夾為止，此時該資源或資料夾將獲得預設ACL權限。

您可以使用存放庫服務Java API或網站服務API，以程式設計方式撰寫資源。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

要編寫資源，請執行以下步驟：

包含專案檔案。
建立儲存庫服務客戶端。
指定要讀取的資源的URI。
閱讀資源。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定資源的目標資料夾的URI

建立包含要讀取之資源的URI的字串。語法包含正斜線，如以下範例所示："/path/資料夾"

建立資源

叫用存放庫服務方法以建立資源，並使用識別資訊（包括其UUID、資源名稱和說明）填入資源。

指定資源內容

調用Repository服務方法以建立資源內容，並將該內容儲存在資源中。

將資源寫入目標資料夾

調用Repository服務方法以寫入資源，指定目標資料夾的URI。

另請參閱

使用Java API寫入資源

使用網站服務API寫入資源

快速入門（SOAP模式）:使用Java API編寫資源

使用Java API寫入資源

使用存放庫服務API(Java)編寫資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定資源的目標資料夾的URI

指定資源的目標資料夾的URI。在這種情況下，由於名為testResource的資源將儲存在名為testFolder的資料夾中，因此該資料夾的URI為"/testFolder"。 URI儲存為java.lang.String對象。
建立資源

要建立資源，必須首先建立com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean對象。

調用RepositoryInfomodelFactoryBean對象的newResource方法，該方法建立com.adobe.repository.infomodel.bean.Resource對象。在此範例中，提供下列參數：
- com.adobe.repository.infomodel.Id對象，通過調用Id類的預設建構子來建立。
- com.adobe.repository.infomodel.Lid對象，通過調用Lid類的預設建構子來建立。
- 包含資源檔案名的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對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定資源的目標資料夾的URI

指定資源的目標資料夾的URI。在這種情況下，由於名為testResource的資源將儲存在名為testFolder的資料夾中，因此該資料夾的URI為"/testFolder"。使用與Microsoft .NET Framework（如C#）相容的語言時，將URI儲存在System.String對象中。
建立資源

要建立資源，請調用Resource類的預設建構子。在此示例中，以下資訊儲存在Resource對象中：
- com.adobe.repository.infomodel.Id對象，通過調用Id類的預設建構子來建立，並分配給Resource對象的id欄位。
- 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以取得其他兩個參數。

另請參閱

編寫資源

列出資源

您可以列出資源，以探索資源。系統會對儲存庫執行查詢，以尋找與指定資源集合相關的所有資源。

整理資源後，您就可以透過查看結構的特定分支來檢查您建立的結構，就像在作業系統中一樣。

上市資源按關係運作：資源是資料夾的成員。成員由「成員」類型的關係表示。在給定資料夾中列出資源時，將按「成員」關係查詢與給定資料夾相關的資源。關係是方向的：關係的成員具有作為目標成員的源。來源是資源；目標是父資料夾。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要列出資源，請遵循下列步驟：

包含專案檔案。
建立服務客戶端。
指定資料夾路徑。
擷取資源清單。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式建立資源集合之前，必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定資料夾路徑

建立包含資源之資料夾路徑的字串。語法包含正斜線，如以下範例所示："/path/資料夾"

擷取資源清單

調用Repository服務方法以檢索資源清單，指定目標資料夾的路徑。

另請參閱

使用Java API列出資源

使用網站服務API列出資源

快速入門（SOAP模式）:使用Java API列出資源

使用Java API列出資源

使用儲存庫服務API(Java)列出資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定資料夾路徑

指定要查詢的資源集合的URI。在這種情況下，其URI為"/testFolder"。 URI儲存為java.lang.String對象。
擷取資源清單

調用ResourceRepositoryClient對象的listMembers方法，並傳入資料夾的URI。

該方法返回com.adobe.repository.infomodel.bean.Resource對象的java.util.List，這些對象是Relation.TYPE_MEMBER_OF類型com.adobe.repository.infomodel.bean.Relation的源，並且以資源收集URI為目標。您可以逐一查閱此List以擷取每個資源。在此範例中，會顯示每個資源的名稱和說明。

另請參閱

列出資源。

使用Web服務API列出資源

使用存放庫服務API（Web服務）列出資源：

包含項目檔案
- 建立一個Microsoft .NET客戶端程式集，該程式集會使用儲存庫WSDL。
- 參考Microsoft .NET客戶端程式集。
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定資料夾路徑

指定包含要查詢的資料夾URI的字串。在這種情況下，其URI為"/testFolder"。使用與Microsoft .NET Framework（如C#）相容的語言時，將URI儲存在System.String對象中。
擷取資源清單

調用RepositoryServiceService對象的listMembers方法，並作為第一個參數傳入資料夾的URI中。傳遞null以取得其他兩個參數。

該方法返回可轉換為Resource對象的對象陣列。您可以逐一查看物件陣列，以擷取每個相關資源。在此範例中，會顯示每個資源的名稱和說明。

另請參閱

列出資源。

讀取資源

您可以從存放庫中的指定位置擷取資源，以讀取其內容和中繼資料。工作流程由初始化表單前端。此程式具有讀取表單所需的所有權限。系統會擷取資料表單，並從存放庫讀取內容。存放庫會授予內容和中繼資料的存取權（即使知道資源存在的能力）。

存放庫有下列四種權限類型：

traverse:可讓您列出資源；即，讀取資源元資料，但不讀取資源內容
閱讀:可讓您讀取資源內容
寫入:允許您寫入資源內容
管理訪問控制清單(ACL):允許您操作資源上的ACL

只有當用戶有權運行進程時，才能運行進程。 IDE用戶需要遍歷和讀取權限才能與儲存庫同步。 ACL僅在設計時應用，因為運行時發生在系統上下文中。

您可以使用存放庫服務Java API或網站服務API，以程式設計方式讀取資源。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要讀取資源，請遵循下列步驟：

包含專案檔案。
建立儲存庫服務客戶端。
指定要讀取的資源的URI。
閱讀資源。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定要讀取的資源的URI

建立包含要讀取之資源的URI的字串。語法包含正斜線，如以下範例所示："/path/resource"。

讀取資源

調用儲存庫服務方法以讀取資源，指定URI。

另請參閱

使用Java API讀取資源

使用網站服務API讀取資源

快速入門（SOAP模式）:使用Java API讀取資源

使用Java API讀取資源

使用存放庫服務API(Java)讀取資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定要讀取的資源的URI

指定表示要檢索的資源的URI的字串值。例如，假設資源名為testResource（位於名為testFolder的資料夾中），請指定/testFolder/testResource。
讀取資源

調用ResourceRepositoryClient對象的readResource方法，並將資源的URI作為參數傳遞。此方法會傳回代表資源的Resource例項。

另請參閱

讀取資源

使用Web服務API讀取資源

使用存放庫服務API（Web服務）讀取資源：

包含項目檔案
- 建立一個Microsoft .NET客戶端程式集，該程式集會使用儲存庫WSDL。（請參閱建立使用Base64編碼的.NET客戶端程式集。）
- 參考Microsoft .NET客戶端程式集。（請參閱建立使用Base64編碼的.NET客戶端程式集。）
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定要讀取的資源的URI

指定包含要檢索之資源URI的字串。在此情況下，由於名為testResource的資源位於名為testFolder的資料夾中，因此其URI為"/testFolder/testResource"。使用與Microsoft .NET Framework（如C#）相容的語言時，將URI儲存在System.String對象中。
讀取資源

叫用RepositoryServiceService物件的readResource方法，並將資源的URI傳遞為第一個參數。傳遞null以取得其他兩個參數。

另請參閱

讀取資源

更新資源

您可以擷取和更新存放庫中的資源內容。更新資源時，版本之間對這些資源的存取控制保持不變。執行更新時，您可以選擇增加主要版本。如果您不選擇增加主版本，則會自動更新次版本。

更新資源時，會根據指定的資源屬性建立新版本。更新資源時，您需指定兩個重要參數：目標URI和包含所有更新元資料的資源實例。請務必注意，如果您未變更指定屬性（例如名稱），在您傳入的例項中仍需要該屬性。剖析內容時建立的關係會新增至特定版本，除非另有指定，否則不會轉送。

例如，如果您更新XDP檔案，且該檔案包含其他資源的參考，則這些額外的參考也會記錄下來。假設form.xdp 1.0版有兩個外部參考：徽標和樣式表，然後您隨後更新form.xdp，因此它現在有三個引用：徽標、樣式表和方案檔案。在更新期間，儲存庫會將第三個關係（到架構檔案）添加到其掛起關係表中。一旦儲存庫中存在架構檔案，該關係就會自動形成。不過，如果form.xdp 2.0版不再使用標誌，form.xdp 2.0版將不會與標誌有任何關係。

所有更新操作都是原子操作和事務操作。例如，如果兩個用戶閱讀了相同的資源，並且兩個用戶都決定將1.0版更新為2.0版，則其中一個將成功，其中一個將失敗，則儲存庫的完整性將得到維護，並且兩個用戶都會收到確認成功或失敗的消息。如果事務未提交，則在資料庫出現故障時將回滾，並且將根據應用程式伺服器超時或回滾。

您可以使用存放庫服務Java API或網站服務API，以程式設計方式更新資源。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要更新資源，請執行下列步驟：

包含專案檔案。
建立儲存庫服務客戶端。
擷取要更新的資源。
更新資源。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

擷取要更新的資源

閱讀資源。如需詳細資訊，請參閱讀取資源。

更新資源

在資源中設定新資訊並調用Repository服務方法以更新資源，指定URI、更新的資源以及如何更新版本資訊。

另請參閱

使用Java API更新資源

使用網站服務API更新資源

快速入門（SOAP模式）:使用Java API更新資源

使用Java API更新資源

使用存放庫服務API(Java)更新資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
擷取要更新的資源

指定要檢索和讀取資源的資源的URI。在此示例中，資源的URI為"/testFolder/testResource"。
更新資源

更新Resource對象的資訊。在此示例中，要更新說明，請調用Resource對象的setDescription方法，並將新的說明字串作為參數傳遞。

然後叫用ServiceClientFactory物件的updateResource方法，並傳入下列參數：
- 包含資源URI的java.lang.String對象。
- Resource對象包含更新的資源資訊。
- 一個boolean值，指示是更新主版還是次版。在此範例中，傳入true值，表示主要版本將增加。

另請參閱

更新資源

使用Web服務API更新資源

使用存放庫API（Web服務）更新資源：

包含項目檔案
- 建立一個Microsoft .NET客戶端程式集，該程式集會使用儲存庫WSDL。
- 參考Microsoft .NET客戶端程式集。
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
擷取要更新的資源

指定要檢索的資源的URI並讀取資源。在此示例中，資源的URI為"/testFolder/testResource"。如需詳細資訊，請參閱讀取資源。
更新資源

更新Resource對象的資訊。在此示例中，要更新說明，請為Resource對象的description欄位指派新值。
叫用RepositoryServiceService物件的updateResource方法，並傳入下列參數：
- 包含資源URI的System.String對象。
- Resource對象包含更新的資源資訊。
- 一個boolean值，指示是更新主版還是次版。在此範例中，傳入true值，表示主要版本將增加。
- 對其餘兩個參數傳遞null。

另請參閱

更新資源

搜索資源

您可以建構查詢，用於搜尋存放庫中的資源，包括歷史記錄、相關資源和屬性。

您可以擷取相關資源，以判斷表單及其片段之間的相依性。例如，如果您有表單，便可判斷其使用的片段或外部資源。如果您有影像，您也可以找出使用影像的表單。您也可以使用根據屬性進行篩選來搜尋相關資源。例如，您可以搜尋所有使用具有指定名稱的影像的表單，或尋找具有指定名稱的表單所使用的任何影像。您也可以使用資源屬性進行搜尋。例如，您可以執行查詢以尋找其名稱以指定字串開頭的所有表單或資源，該字串可能包含「%」和「_」萬用字元。請記住，基於屬性的搜索不基於關係；這些搜尋是基於您對特定資源有特定知識的假設。

查詢語句

query包含一或多個以條件邏輯連結的陳述式。語句由左操作數、運算子和右操作陣列成。此外，還可以指定用於搜索結果的排序順序。 排序順序包含與SQL ORDER BY子句等效的資訊，並且由包含搜索所基於的屬性的元素以及指示使用升序還是降序的值組成。

您可以使用Repository service Java API以程式設計方式搜尋資源。目前無法使用網站服務API來搜尋資源。

排序行為

調用ResourceRepositoryClient對象的searchProperties方法並指定排序順序時，排序順序不受影響。例如，假設您建立了具有三個自訂屬性的資源，其中屬性名稱為name、secondName和asecondName。接下來，在屬性名稱上建立排序順序元素，並將ascending值設定為true。

然後，調用ResourceRepositoryClient對象的searchProperties方法，並按排序順序傳遞。搜尋會傳回正確的資源，並包含三個屬性。但是，屬性不會依屬性名稱排序。系統會依新增順序傳回：name、secondName和asecondName。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要搜尋資源，請依照下列步驟操作：

包含專案檔案。
建立儲存庫服務客戶端。
指定搜索的目標資料夾。
指定搜索中使用的屬性。
建立搜索中使用的查詢。
建立搜尋結果的排序順序。
搜尋資源。
從搜尋結果中擷取資源。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定搜索的目標資料夾

建立一個字串，其中包含要從中執行搜索的基本路徑。語法包含正斜線，如以下範例所示："/path/資料夾"

指定搜索中使用的屬性

您可以根據資源中包含的屬性進行搜尋。指定要對其執行搜索的屬性值。

建立搜索中使用的查詢

使用陳述式和條件來建構查詢。每個語句將指定搜索的基礎屬性、要使用的條件以及要在搜索中使用的屬性值。

建立搜索結果的排序順序

排序順序由元素組成，每個元素都包含搜索中使用的一個屬性和一個值，該值指示是升序還是降序。

搜尋資源

使用資料夾、查詢和排序順序來搜尋資源。此外，指示搜索的深度以及要返回的結果數的上限。

從搜尋結果中擷取資源

逐一查看返回的資源清單，並提取資訊以供進一步處理。

另請參閱

使用Java API搜尋資源

快速入門（SOAP模式）:使用Java API搜尋資源

使用Java API搜尋資源

使用Repository service API(Java)搜索資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定搜索的目標資料夾

指定要從中執行搜索的基本路徑的URI。在此示例中，資源的URI為/testFolder。
指定搜索中使用的屬性

指定要對其執行搜索的屬性的值。屬性存在於com.adobe.repository.infomodel.bean.Resource對象中。在此範例中，將對name屬性進行搜尋；因此，會使用包含Resource物件名稱的java.lang.String，在此例中為testResource。
建立搜索中使用的查詢

要建立查詢，請通過調用Query類的預設建構子並向查詢添加語句來建立com.adobe.repository.query.Query對象。

要建立語句，請調用com.adobe.repository.query.Query.Statement類的建構子並傳入以下參數：
- 包含資源屬性常數的左操作數。在此範例中，由於資源的名稱是搜尋的基礎，因此會使用靜態值Resource.ATTRIBUTE_NAME。
- 包含用於搜尋屬性之條件的運算子。運算子必須是Query.Statement類別中的其中一個靜態常數。在此範例中，使用靜態值Query.Statement.OPERATOR_BEGINS_WITH。
- 包含要在其上執行搜索的屬性值的右操作數。在此示例中，使用名稱屬性String（包含值"testResource"）。
調用Query.Statement對象的setNamespace方法並傳遞com.adobe.repository.infomodel.bean.ResourceProperty類中包含的一個靜態值，以指定左操作數的命名空間。在此範例中，使用ResourceProperty.RESERVED_NAMESPACE_REPOSITORY。

調用Query對象的addStatement方法並傳入Query.Statement對象，將每個語句添加到查詢中。
建立搜索結果的排序順序

要指定搜索結果中使用的排序順序，請通過調用SortOrder類的預設建構子來建立com.adobe.repository.query.sort.SortOrder對象，並將元素添加到排序順序。

要為排序順序建立元素，請調用com.adobe.repository.query.sort.SortOrder.Element類的建構子之一。在此範例中，由於資源的名稱是搜尋的基礎，因此靜態值Resource.ATTRIBUTE_NAME是第一個參數，且遞增順序（boolean值true）是指定為第二個參數。

叫用SortOrder物件的addSortElement方法並傳入SortOrder.Element物件，將每個元素新增至排序順序。
搜尋資源

要根據屬性屬性搜索resources，請調用ResourceRepositoryClient對象的searchProperties方法，並傳入以下參數：
- String包含要執行搜索的基本路徑。在這種情況下，會使用"/testFolder"。
- 搜索中使用的查詢。
- 搜尋的深度。在這種情況下，com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE用於指示要使用基本路徑及其所有資料夾。
- 一個int值，指示要從中選擇未分頁結果集的第一行。在此示例中，指定了0。
- 一個int值，表示要返回的最大結果數。在此示例中，指定了10。
- 搜索中使用的排序順序。
此方法會以指定的排序順序傳回Resource物件的java.util.List。
從搜尋結果中擷取資源

要檢索搜索結果中包含的資源，請逐一查看List，並將每個對象轉換為Resource以提取其資訊。在此範例中，會顯示每個資源的名稱。

另請參閱

搜尋資源

建立資源關係

您可以指定儲存庫中資源之間的關係。有三種關係：

相依性:資源依賴其他資源的關係，這表示儲存庫中需要所有相關資源。
成員資格（檔案系統）:資源位於指定資料夾中的關係。
自訂:您在資源之間指定的關係。例如，如果某個資源已被取代，而另一個資源引入儲存庫中，則您可以指定自己的取代關係。

您可以建立自己的自訂關係。例如，如果將HTML檔案儲存在儲存庫中，並且該檔案使用影像，則可以指定自定義關係以將HTML檔案與影像相關（因為通常只有XML檔案與使用儲存庫定義的依賴關係的影像相關聯）。自訂關係的另一個範例是，如果您想要以循環圖形結構（而非樹狀結構）建立存放庫的不同檢視。您可以定義圓形圖和檢視器以周遊這些關係。最後，您可以指出資源會取代另一個資源，即使這兩個資源完全不同。在這種情況下，您可以在保留範圍之外定義關係類型，並在這兩個資源之間建立關係。您的應用程式將是唯一能夠檢測和處理關係的客戶端，並且它可用於對該關係進行搜索。

您可以使用存放庫服務Java API或網站服務API，以程式設計方式指定資源之間的關係。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要指定兩個資源之間的關係，請執行下列步驟：

包含專案檔案。
建立儲存庫服務客戶端。
指定要關聯的資源的URI。
建立關係。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定要關聯的資源的URI

建立包含要相關資源的URI的字串。語法包含正斜線，如以下範例所示："/path/resource"。

建立關係

調用儲存庫服務方法以建立並指定關係類型。

另請參閱

使用Java API建立關係資源

使用Web服務API建立關係資源

快速入門（SOAP模式）:使用Java API建立資源之間的關係

使用Java API建立關係資源

使用Repository service Java API建立關係資源，執行下列任務：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定要關聯的資源的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來建立依賴關係。
- 一個boolean值，指示是否將目標資源自動更新為基於com.adobe.repository.infomodel.Id的新頭資源的標識符。在此示例中，由於依賴關係，指定了值true。
您也可以調用ResourceRepositoryClient對象的getRelated方法並傳入以下參數，以檢索給定資源的相關資源清單：
- 要為其檢索相關資源的資源的URI。在此示例中，指定了源資源("/testFolder/testResource1")。
- boolean值，指示指定的資源是否為關係中的源資源。在此示例中，指定值true，因為此情況。
- 關係類型，是Relation類中的靜態常數之一。在此示例中，通過使用先前使用的相同值來指定依賴關係：Relation.TYPE_DEPENDANT_OF。
getRelated方法返回Resource對象的java.util.List，通過該對象可以迭代檢索每個相關資源，並將List中包含的對象轉換為Resource。在此範例中，testResource2應位於傳回資源的清單中。

另請參閱

建立資源關係

使用Web服務API建立關係資源

使用存放庫API（Web服務）建立關係資源：

包含項目檔案
- 建立一個Microsoft .NET客戶端程式集，該程式集會使用儲存庫WSDL。
- 參考Microsoft .NET客戶端程式集。
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定要關聯的資源的URI

指定要關聯的資源的URI。在這種情況下，由於資源名為testResource1和testResource2，並位於名為testFolder的資料夾中，因此其URI為"/testFolder/testResource1"和"/testFolder/testResource2"。使用與Microsoft .NET Framework（如C#）相容的語言時，URI儲存為System.String對象。在此示例中，資源首先寫入儲存庫，並且檢索其URI。有關寫入資源的詳細資訊，請參閱寫入資源。
建立關係

叫用RepositoryServiceService物件的createRelationship方法並傳入下列參數：
- 源資源的URI。
- 目標資源的URI。
- 關係的類型。在此示例中，通過指定值3來建立依賴關係。
- 一個boolean值，指示是否指定了關係類型。在此示例中，指定了值true。
- 一個boolean值，指示是否將目標資源自動更新為基於Id的新頭資源的標識符。在此示例中，由於依賴關係，指定了值true。
- boolean值，指示是否指定了目標頭。在此示例中，指定了值true。
- 傳遞null作為最後一個參數。
您也可以調用RepositoryServiceService對象的getRelated方法並傳入以下參數，以檢索給定資源的相關資源清單：
- 要為其檢索相關資源的資源的URI。在此示例中，指定了源資源("/testFolder/testResource1")。
- boolean值，指示指定的資源是否為關係中的源資源。在此示例中，指定值true，因為此情況。
- 一個boolean值，指示是否指定了源資源。在此範例中，提供值true。
- 包含關係類型的整數陣列。在此示例中，通過在陣列中使用與先前使用相同的值來指定依賴關係：3。
- 對其餘兩個參數傳遞null。
getRelated方法返回可轉換為Resource對象的對象陣列，通過該陣列可以迭代檢索每個相關資源。在此範例中，testResource2應位於傳回資源的清單中。

另請參閱

建立資源關係

鎖定資源

您可以鎖定資源或一組資源，供特定使用者專用或供多個使用者共用。共用鎖定表示資源會發生什麼事，但不會阻止其他任何人對該資源採取行動。共用鎖應視為信令機制。專用鎖定表示鎖定資源的用戶將更改資源，而鎖定將確保在用戶不再需要訪問資源並釋放鎖定之前，其他人都不能更改。如果儲存庫管理員解除了資源的鎖定，則該資源上的所有獨佔鎖定和共用鎖定將自動刪除。此類型的動作適用於使用者不再可用且未解除鎖定資源的情況。

當資源鎖定時，當您檢視位於Workbench中的「資源」標籤時，會顯示鎖定圖示，如下圖所示。

lr_lr_lockrepository

您可以使用存放庫服務Java API或網站服務API，以程式設計方式控制對資源的存取。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要鎖定和解除鎖定資源，請執行下列步驟：

包含專案檔案。
建立儲存庫服務客戶端。
指定要鎖定的資源的URI。
鎖定資源。
檢索資源的鎖。
解除鎖定資源

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定要鎖定的資源的URI

建立包含要鎖定之資源URI的字串。語法包含正斜線，如以下範例所示："/path/resource"。

鎖定資源

調用儲存庫服務方法以鎖定資源，指定URI、鎖定類型和鎖定深度。

檢索資源的鎖

調用Repository服務方法以檢索資源的鎖，指定URI。

解除鎖定資源

調用儲存庫服務方法以解鎖資源，指定URI。

另請參閱

使用Java API鎖定資源

使用Web服務API鎖定資源

快速入門（SOAP模式）:使用Java API鎖定資源

使用Java API鎖定資源

使用存放庫服務API(Java)鎖定資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定要鎖定的資源的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作為參數傳遞。該方法返回可迭代的鎖定對象清單。在本示例中，通過分別調用每個鎖定對象的getOwnerUserId、getDepth和getType方法，為每個對象打印鎖所有者、深度和範圍。
解除鎖定資源

調用ResourceRepositoryClient對象的unlockResource方法，並將資源的URI作為參數傳遞。如需詳細資訊，請參閱AEM Forms API參考。

另請參閱

鎖定資源

使用Web服務API鎖定資源

使用存放庫服務API（Web服務）鎖定資源：

包含項目檔案
- 建立使用Base64的儲存庫WSDL的Microsoft .NET客戶端程式集。
- 參考Microsoft .NET客戶端程式集。
建立服務客戶端

使用Microsoft .NET客戶端程式集，通過調用其預設建構子來建立RepositoryServiceService對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定要鎖定的資源的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作為第二個參數。此方法會傳回包含Lock物件的object陣列，您可透過這些物件迭代。在此示例中，通過分別訪問每個Lock對象的ownerUserId、depth和type欄位，為每個對象打印鎖所有者、深度和範圍。
解除鎖定資源

調用RepositoryServiceService對象的unlockResource方法，並傳遞資源的URI作為第一個參數，傳遞null作為第二個參數。

另請參閱

鎖定資源

刪除資源

您可以使用存放庫服務Java API(SOAP)，以程式設計方式從存放庫中的指定位置刪除資源。

刪除資源時，刪除通常是永久的，但在某些情況下，ECM儲存庫可能會根據其歷史機制來儲存資源的版本。因此，刪除資源時，務必確保您不再需要該資源。刪除資源的常見原因包括需要增加資料庫中的可用空間。您可以刪除資源的版本，但是，如果刪除，則必須指定資源標識符，而不是其邏輯標識符(LID)或路徑。如果刪除資料夾，該資料夾中的所有內容（包括子資料夾和資源）都將自動刪除。

未刪除相關資源。例如，如果您的表單使用logo.gif檔案，而您刪除logo.gif，則關係將儲存在掛起的關係表中。另外，若要停用版本，請將最新版本的物件狀態設為停用。

刪除操作在ECM系統中不安全於事務。例如，如果您嘗試刪除100個資源，而第50個資源的操作失敗，則前49個執行個體將被刪除，其餘的則不會刪除。否則，預設行為為回退（非承諾）。

注意

將com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources()方法與ECM儲存庫（EMC Documentum Content Server和IBM FileNet P8 Content Manager）一起使用時，如果某個指定資源的刪除失敗，則不會回退事務，這意味著無法刪除那些已刪除的檔案。

注意

有關儲存庫服務的詳細資訊，請參閱AEM Forms的服務參考。

步驟的摘要

若要刪除資源，請執行下列步驟：

包含專案檔案。
建立儲存庫服務客戶端。
指定要刪除的資源的URI。
刪除資源。

包含項目檔案

在您的開發專案中加入必要的檔案。如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。如果您使用Web服務，請包含代理檔案。

建立服務客戶端

在以寫程式方式讀取資源之前，您必須建立連接並提供憑據。這可以通過建立服務客戶端來實現。

指定要刪除的資源的URI

建立包含要刪除之資源的URI的字串。語法包含正斜線，如以下範例所示："/path/resource"。如果要刪除的資源是資料夾，刪除將是遞歸的。

刪除資源

調用Repository服務方法以刪除資源，指定URI。

另請參閱

使用Java API刪除資源

使用網站服務API刪除資源

快速入門（SOAP模式）:使用Java API搜尋資源

使用Java API(SOAP)刪除資源

使用存放庫API(Java)刪除資源：

包含項目檔案

在Java項目的類路徑中包含客戶端JAR檔案。
建立服務客戶端

使用其建構子並傳遞包含連線屬性的ServiceClientFactory物件，以建立ResourceRepositoryClient物件。
指定要刪除的資源的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對象。使用包含用戶名和密碼的System.Net.NetworkCredential對象設定其Credentials屬性。
指定要刪除的資源的URI

指定要檢索的資源的URI。在此情況下，由於名為testResourceToBeDeleted的資源位於名為testFolder的資料夾中，因此其URI為"/testFolder/testResourceToBeDeleted"。在此示例中，資源首先寫入儲存庫，並且檢索其URI。有關寫入資源的詳細資訊，請參閱寫入資源。
刪除資源

調用RepositoryServiceService對象的deleteResources方法，並傳遞包含資源URI作為第一個參數的System.String陣列。傳遞null作為第二個參數。

另請參閱

刪除資源