從 Oracle Content and Experience 擷取文件

從Oracle Content and Experience擷取文件

Oracle Content and Experience 's REST API for Documents 提供各種端點，可讓您從Oracle Visual Builder 應用程式管理Oracle Content and Experience 中的文件和資料夾。

例如，除了您在Oracle Visual Builder 應用程式的頁面中建立的所有資料夾之外，您也可以顯示您已上傳至Oracle Content and Experience的文件與相片清單。在下面的內容中，我們將描述如何新增呼叫 REST API for Documents 所顯示之 Get Home Folder Contents 端點的端點，並在Oracle Visual Builder 應用程式的「清單檢視」元件中顯示回應。「取得本位目錄資料夾內容」端點可以取得使用者可存取之所有項目 (資料夾和檔案) 的集合，包括他人與該使用者共用的資料夾。

若要實行描述的功能，您需要：

此服務連線會顯示「取得本位目錄資料夾內容」端點，以取得使用者可從Oracle Content and Experience文件儲存體存取的檔案和資料夾清單。
Oracle Visual Builder 應用程式中的一個頁面，可顯示 UI 元件 (例如「清單檢視」元件)，此頁面會顯示您使用透過服務連線公開的端點所擷取的文件和資料夾清單。

建立端點以擷取文件

您可以建立端點，以使用您連線之Oracle Content and Experience 執行處理的基礎 URI 和查詢參數，從Oracle Content and Experience 擷取檔案和資料夾，以存取 REST API 針對文件所顯示的取得本位目錄資料夾內容端點。

例如，如果 https://cec-instance-url.com 是您所連線之Oracle Content and Experience 執行處理的基本 URI，則在建立端點時，請使用適當的 HTTP 方法 (GET) 和動作提示 (多數) 來輸入下列 URI。

https://cec-instance-url.com/documents/api/1.2/folders/{folderId}/items

此外，您還需要提供連線Oracle Content and Experience 以使用端點的認證詳細資訊。基本認證足夠用於開發，但不建議用於實際環境執行。

注意：

如果您先前已經建立Oracle Content and Experience REST API for Documents 的服務連線以使用其他端點 (例如上傳檔案端點)，則不需要建立新的服務連線。而是，您要將「取得本位目錄資料夾內容」端點新增至先前在服務連線的「端點」頁籤中使用+端點按鈕建立的服務連線。下列內容假設您尚未建立服務連線，並描述逐步如何建立服務連線以及新增「取得本位目錄資料夾內容」端點。如果您已建立服務連線，請使用「+端點」按鈕與下列內容的相關詳細資訊 (例如方法、動作提示和範例回應內文)。

建立端點以從Oracle Content and Experience擷取檔案和資料夾：

在「導覽器」中開啟「服務連線」，然後按一下建立服務連線 ()。
在「建立服務連線」精靈的「選取來源」窗格中，按一下「依端點定義」。

Service-connections-create-byendpoint.png 圖解描述
從方法下拉式清單中，選取 GET，在 URL 輸入欄位中輸入 https://cec-instance-url.com/documents/api/1.2/folders/{folderId}/items，從動作提示下拉式清單中選擇許多取得，然後按一下下一步。

Vb-cec-extraction e-home-folder-endpoint.png 圖解描述
在「服務」頁籤中，複查「服務基礎 URL」、「服務名稱」和「服務 ID」值。
Oracle Visual Builder 會根據您先前在精靈輸入的值，自動在這些欄位中填入值。
開啟認證頁籤，然後選取啟用認證/代理主機來輸入認證詳細資訊。
從「認證機制」下拉式清單中選取基本，然後輸入用來存取Oracle Content and Experience 執行處理的使用者名稱和密碼。
開啟要求和 URL 參數頁籤，針對 folderId 路徑參數輸入 self 的預設值。

Vb- cec_set -url-param-retrieve.png 圖解描述

開啟「回應」頁籤，然後輸入端點的回應主體。

「回應」頁籤中有一個文字區域，可供您貼入回應主體的範例。「回應」中的範例是傳回之物件結構的定義。輸入下列物件範例來回應 Get Home Folder Contents API 呼叫。

{
    "count":"3",
    "totalResults":"3",
    "ownerFolderID":"self",
    "hasMore":"0",
    "errorCode":"0",
    "items":[
        {
            "id":"FF4729683CD68C1AFB1AE87DT0000000000100000001",
            "parentID":"self",
            "name":"foldera",
            "type":"folder",
            "size":"39",
            "childItemsCount":"2",
            "createdTime":"2014-02-21T20:52:37Z",
            "modifiedTime":"2014-02-21T20:52:37Z",
            "createdBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "ownedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "modifiedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            }
        },
        {
            "id":"F4A669A2B7B69F2376C640A9T0000000000100000001",
            "parentID":"self",
            "name":"folderb",
            "type":"folder",
            "size":"0",
            "childItemsCount":"0",
            "createdTime":"2014-02-21T21:38:44Z",
            "modifiedTime":"2014-02-21T21:38:44Z",
            "createdBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "ownedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "modifiedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            }
        },
        {
            "id":"DBFDB0B6543FB5B68107423AT0000000000100000001",
            "parentID":"self",
            "name":"test cases.txt",
            "type":"file",
            "size":"37786",
            "version":"1",
            "createdTime":"2014-02-21T21:38:52Z",
            "modifiedTime":"2014-02-21T21:38:52Z",
            "createdBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "ownedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "modifiedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            }
        }
    ]
}

Vb-cec-example-body-capture e.png 的描述請參見下方

Vb-cec-example-body-capture e.png 圖解描述

按一下建立。

新增 UI 元件以顯示文件

您可以在Oracle Visual Builder 應用程式中將「清單檢視」元件新增至頁面，然後使用新增資料快速開始對應清單至您建立「文件」服務連線時所顯示的「取得首頁資料夾內容」端點，以及使用REST API。

顯示資料夾和文件內容和體驗清單：

在您的Oracle Visual Builder 應用程式頁面中，新增「清單檢視」元件。
選取您剛才新增的「清單檢視」元件，然後在「清單檢視」特性檢查器的「快速開始」區段中按一下新增資料。
在顯示的「新增資料」對話方塊中，瀏覽至您先前新增的「取得本位目錄資料夾內容 REST 端點 API」(/documents/api/1.2/folders/items)。

Vb-cec-listview-quickbeginning .png 圖解描述
在「選取樣板」頁面中，將預設選取的樣板保持不變，然後按一下下一步。
在連結資料頁面中，選取名稱，然後按下一步。

Vb-cec-add-data-bind.png 圖解描述
在定義查詢欄位中，按一下完成。
「清單檢視」元件現在會顯示您有權存取的文件和資料夾清單。 vb-cec-listview-render.png
圖解描述