58 RESTful APIを使用したOracle Content and Experience Cloudでのフォルダの作成

Oracle Content and Experience Cloudの一般的なユースケースは、JCS - SaaS Extensionアプリケーションなどの外部アプリケーションのファイルおよびフォルダを管理することです。

トピック

• RESTful APIを使用したOracle Content and Experience Cloudでのフォルダの作成

RESTful APIを使用したOracle Content and Experience Cloudでのフォルダの作成

このサンプル・コードは、Oracle Content and Experience Cloud RESTful APIを使用して既存のフォルダ・ディレクトリ内にサブフォルダを作成する方法を示しています。

この例では、cURLをテスト・ツールとして使用します。

cURLの公式Webサイトの「cURLのドキュメント概要」を参照してください。

1. 次のcURLコマンドを実行し、このユーザーがアクセス権を持つすべてのアイテム(フォルダおよびファイル)のコレクション(他のユーザーがこのユーザーと共有しているフォルダを含む)を取得します。

   curl -u username:password https://<content-experience-hostname>/documents/api/1.1/folders/items

   この場合:

   • usernameとpasswordは、新しいフォルダを作成するフォルダ・ディレクトリの所有者またはコントリビュータのものです。

   • <content-experience-hostname>は、Oracle Content and Experience Cloudインスタンスのホスト名です。

   次のJSON構造は、cURLコマンドのレスポンスの例です。

   { "count": "2", "errorCode": "0", "hasMore": "0", "ownerFolderID": "self", "totalResults": "10", "items": [ { "type": "folder", "id": "<parent_folder_id>", "parentID": "self", "name": "Folder test", "ownedBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "createdBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "modifiedBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "createdTime": "2016-05-24T21:37:33Z", "modifiedTime": "2016-05-24T21:37:33Z", "size": "0", "childItemsCount": "1" }, { "type": "folder", "id": "<parent_folder_id>", "parentID": "self", "name": "Test", "ownedBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "createdBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "modifiedBy": { "displayName": "User Name", "id": "user_id", "type": "user" }, "createdTime": "2016-03-07T10:39:48Z", "modifiedTime": "2016-03-07T10:39:48Z", "size": "10265", "childItemsCount": "2" } "createdTime": "2015-09-28T14:45:02Z", "modifiedTime": "2015-09-28T14:45:02Z", "version": "1", "mimeType": "application/vnd.openxmlformats-officedocument.presentationml.presentation", "size": "2026347" } }

2. 好みのテキスト・エディタを開き、次のペイロードのJSON構造を作成します。

   { "name": "folder_name", "description": "folder_description" }

   この場合:

   • nameは、新しいフォルダの名前です。* 必須

   • descriptionは、新しいフォルダの説明です。

3. 目的の場所にファイルを保存します。
4. 親フォルダID "<parent_folder_id>”を上記のサンプル・レスポンスからコピーし、次のcURLコマンドを実行し、新しいフォルダを作成します。

   curl -u username:password -H "Content_Type: application/json" -X POST -data filepath\file.json https://<content-experience-hostname>/documents/api/1.1/folders/<parent_folder_id>

   次のJSON構造は、レスポンスの例です。

   { "childItemsCount": "0", "createdBy": { "displayName": "user name", "id": "user_id", "type": "user" }, "createdTime": "2016-06-02T18:18:31Z", "description": "folder_name", "errorCode": "0", "id": "folder_id", "modifiedBy": { "displayName": "user_name", "id": "user_id", "type": "user" }, "modifiedTime": "2016-06-02T18:18:31Z", "name": "restFolder(3)", "ownedBy": { "displayName": "user_name", "id": "user_id", "type": "user" }, "parentID": "parent_folder_id", "type": "folder" }

   これで、選択したフォルダ構造内に新しいフォルダが表示されます。

   「Oracle Content and Experience Cloud用の開発」の「Oracle Content and Experience Cloud REST API」を参照してください。