使用AEM Forms存放庫 working-with-aem-forms-repository

包含項目檔案

在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" 已使用 .

將資料夾寫入儲存庫

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

方法會傳回新建立的例項 com.adobe.repository.infomodel.bean.Resource 物件。 例如，您可以借由叫用 com.adobe.repository.infomodel.bean.Resource 物件 getId 方法。

包含項目檔案

• 建立使用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 的其他兩個參數。

包含項目檔案

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

建立服務客戶端

建立 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 物件。

包含項目檔案

• 建立使用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 的其他兩個參數。

包含項目檔案

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

建立服務客戶端

建立 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 來擷取每個資源。 在此範例中，會顯示每個資源的名稱和說明。

包含項目檔案

• 建立會使用儲存庫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 對象。 您可以逐一查看物件陣列，以擷取每個相關資源。 在此範例中，會顯示每個資源的名稱和說明。

包含項目檔案

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

建立服務客戶端

建立 ResourceRepositoryClient 對象，使用其建構子並傳遞 ServiceClientFactory 包含連接屬性的對象。

指定要讀取的資源的URI

指定表示要檢索的資源的URI的字串值。 例如，假設資源名為 testResource 位於名為 testFolder，指定 /testFolder/testResource.

讀取資源

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

包含項目檔案

• 建立會使用儲存庫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 的其他兩個參數。

包含項目檔案

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

建立服務客戶端

建立 ResourceRepositoryClient 對象，使用其建構子並傳遞 ServiceClientFactory 包含連接屬性的對象。

擷取要更新的資源

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

更新資源

更新 Resource 對象資訊。 在此範例中，若要更新說明，請叫用 Resource 物件 setDescription 方法，並將新說明字串作為參數傳遞。

然後叫用 ServiceClientFactory 物件 updateResource 方法，並傳遞下列參數：

• A java.lang.String 包含資源URI的對象。
• 此 Resource 包含更新的資源資訊的對象。
• A boolean 值指示是更新主版本還是次版本。 在此範例中，值為 true 會傳入，以指出主要版本將會增加。

包含項目檔案

• 建立會使用儲存庫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 ，取其餘兩個參數。

包含項目檔案

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

建立服務客戶端

建立 ResourceRepositoryClient 對象，使用其建構子並傳遞 ServiceClientFactory 包含連接屬性的對象。

指定搜索的目標資料夾

指定要從中執行搜索的基本路徑的URI。 在此範例中，資源的URI為 /testFolder.

指定搜索中使用的屬性

指定要對其執行搜索的屬性的值。 屬性存在於 com.adobe.repository.infomodel.bean.Resource 物件。 在此範例中，將對name屬性進行搜尋；因此，a java.lang.String 包含 Resource 會使用物件的名稱，即 testResource 在這個情況下。

建立搜索中使用的查詢

若要建立查詢，請建立 com.adobe.repository.query.Query 對象，方法是調用 Query 類和向查詢添加語句。

要建立語句，請調用 com.adobe.repository.query.Query.Statement 類別，並傳入下列參數：

• 包含資源屬性常數的左操作數。 在此範例中，由於資源的名稱是作為搜尋的基礎，因此會使用靜態值 Resource.ATTRIBUTE_NAME 中所有規則的URL區段。
• 包含用於搜尋屬性之條件的運算子。 運算子必須是 Query.Statement 類別。 在此範例中，靜態值 Query.Statement.OPERATOR_BEGINS_WITH 中所有規則的URL區段。
• 包含要在其上執行搜索的屬性值的右操作數。 在此範例中，name屬性， String 包含值 "testResource"，則會使用。

通過調用 Query.Statement 物件 setNamespace 方法，並傳遞 com.adobe.repository.infomodel.bean.ResourceProperty 類別。 在此範例中， ResourceProperty.RESERVED_NAMESPACE_REPOSITORY 中所有規則的URL區段。

叫用 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" 中所有規則的URL區段。
• 搜索中使用的查詢。
• 搜尋的深度。 在這種情況下， com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE 用於指示要使用基本路徑及其所有資料夾。
• 安 int 值指示要從中選擇未分頁結果集的第一行。 在此範例中， 0 已指定。
• 安 int 值表示要傳回的結果數上限。 在此範例中， 10 已指定。
• 搜索中使用的排序順序。

方法會傳回 java.util.List of Resource 對象按指定的排序順序。

從搜尋結果中擷取資源

若要擷取搜尋結果中包含的資源，請逐一瀏覽 List 並將每個物件 Resource 以便提取其資訊。 在此範例中，會顯示每個資源的名稱。

包含項目檔案

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

建立服務客戶端

建立 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 預計會位於傳回資源清單中。

包含項目檔案

• 建立會使用儲存庫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 中所有規則的URL區段。
• 包含關係類型的整數陣列。 在此示例中，通過在陣列中使用與先前使用相同的值來指定依賴關係： 3.
• 通過 null ，取其餘兩個參數。

此 getRelated 方法會傳回可轉換為的物件陣列 Resource 物件，您可以透過物件反覆擷取每個相關資源。 在此範例中， testResource2 預計會位於傳回資源清單中。

包含項目檔案

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

建立服務客戶端

建立 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.

檢索資源的鎖

叫用 ResourceRepositoryClient 物件 getLocks 方法，並將資源的URI作為參數傳遞。 該方法返回可迭代的鎖定對象清單。 在本示例中，通過調用每個鎖對象的 getOwnerUserId, getDepth，和 getType 方法。

解除鎖定資源

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

包含項目檔案

• 建立使用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 中所有規則的URL區段。
• 通過 null ，以取得最後一個參數。

檢索資源的鎖

叫用 RepositoryServiceService 物件 getLocks 方法，並將資源的URI作為第一個參數傳遞，並 null 的第二個參數。 方法會傳回 object 包含陣列 Lock 可迭代的對象。 在本示例中，通過訪問每個對象來打印每個對象的鎖所有者、深度和範圍 Lock 物件 ownerUserId, depth，和 type 欄位。

解除鎖定資源

叫用 RepositoryServiceService 物件 unlockResource 方法，並將資源的URI作為第一個參數傳遞，並 null 的第二個參數。

包含項目檔案

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

建立服務客戶端

建立 ResourceRepositoryClient 對象，使用其建構子並傳遞 ServiceClientFactory 包含連接屬性的對象。

指定要刪除的資源的URI

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

刪除資源

叫用 ResourceRepositoryClient 物件 deleteResource 方法，並將資源的URI作為參數傳遞。

包含項目檔案

• 建立使用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 的第二個參數。