Oracle® Fusion Middleware Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発 11gリリース1 (11.1.1.8.3) E49666-03 |
|
前 |
次 |
この章では、リストの概要と、リスト機能をWebCenter Portalアプリケーションに統合する方法を説明します。
この項では、リストの機能と要件の概要を説明します。次のサブセクションが含まれます:
WebCenter Portalでは、実行時にリストを作成し、それらを公開してポータル・ページ上に配置できます。実行時にリソース・カタログで使用可能なリスト・タスク・フローは設計時に作成できます。ポータルの管理者は、タスク・フローをカタログからページに追加し、そのタスク・フローを使用してリストを作成できます。
設計時にコード・スニペットをリソース・カタログに追加することによって、実行時に値が移入されたリストをカタログに追加し、ポータル・ページ上に配置できるようになります。
デフォルトでは、シード・ロールAdministrator
が割り当てられたユーザーにのみ、リストの管理権限が付与されます。つまり、これらのユーザーは、実行時にリストを作成、編集および削除したり、リスト・データを編集したりできます。デフォルトの権限は、デプロイ時にjazn-data.xml
内で変更するか、Fusion Middleware ControlまたはApplication Policy Managerを使用して変更できます。認可されたユーザーは、この権限を実行時にコンポーネント・レベルで変更できます(詳細は、第22章「コンポーザ・コンポーネントのデフォルトのセキュリティ動作の変更」を参照)。サポートされるのは、ロール・ベースの権限のみです。
実行時、リスト・タスク・フローによって、リストの作成とリスト・データの追加に使用できるコントロールが提供されます。これらのコントロールの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portalの使用』のリストの作成と管理に関する項およびリスト・データの追加と管理に関する項を参照してください。
ヒント: ユーザーが実行時にリストを使用できるようにするには、その操作を明示的にユーザーに許可する必要があります。詳細は、第49.2.3項「実行時のユーザーによるリストの使用の有効化」を参照してください。 |
この項では、ポータルにリスト機能を追加するために必要な手順について説明します。次のサブセクションが含まれます:
リストには、WEBCENTER
スキーマがインストールされているデータベースへの接続が必要です。すべてのリスト・データはデータベースに格納されます。WEBCENTER
スキーマがインストールされているデータベースへのデータベース接続の設定の詳細は、第4.2.2項「データベース接続の設定」を参照してください。
注意: データベースと |
この項では、リスト機能の基本的な統合について説明します。次のサブセクションが含まれます:
リスト・タスク・フローをFrameworkアプリケーションに追加するには:
第4.2項「ツールとサービスを利用するためのFrameworkアプリケーションの準備」の手順に従い、ポータルでセキュリティを実装し、カスタマイズ可能な新しいページを作成します。
リスト・タスク・フローの追加先となるJSFページを作成します。
ページのセキュリティを構成します。
リソース・パレットで、「カタログ」、「WebCenter Portal - サービス・カタログ」、「タスク・フロー」フォルダの順に開きます。
「リスト」タスク・フローをドラッグしてページ上にドロップし、コンテキスト・メニューから「リージョン」を選択します。
ページを保存し、ブラウザで実行します。
デフォルトでは、アプリケーション管理者のみがリストを使用できます。ユーザーが実行時にリストを表示して使用するには、それらのユーザーに最低でも権限ListPermission:view
が明示的に付与されている必要があります。アプリケーション管理者は、実行時にロール・マネージャ・タスク・フローを通じてこの権限を付与できます。
たとえば管理者が、認証されたすべてのユーザーにリストへの表示アクセス権を付与するには、ロール・マネージャ・タスク・フローでロールAllUsers
を作成し、authenticated-role
をメンバーとして追加した後、リストへの表示アクセス権を付与します。
リスト機能をアプリケーションに追加する場合は、ロール・マネージャ・タスク・フローも追加する必要があります。アプリケーションが「WebCenter Portal - Frameworkアプリケーション」テンプレートに基づいている場合、ロール・マネージャ・タスク・フローは「管理」ページの「セキュリティ」タブでデフォルトで使用可能です。実行時に次のURLを使用すると、このページに移動できます。
http://host:port/appcontxtroot/faces/admin
注意: 設計時にロール・マネージャを通じて作成および付与するロールと権限は、ポータルにパッケージ化されていないため、デプロイ後には提供されません。デプロイ後に、この項で説明したプロビジョニング手順を実行する必要があります。 |
適切に構成されている場合、リソース・カタログは実行時に移入されたリストを使用可能にするため、権限のあるユーザーは編集モードでそれらをページに追加できます。コンポーネントを既存のリソース・カタログに追加する手順またはカスタム・カタログを作成する手順は、第14章「リソース・カタログの開発」で説明されています。この項では、リソース・カタログにリストを追加するために使用するコード・スニペットの例を示します(例49-1)。
注意: 大文字の値は、翻訳された文字列用のメッセージ・キーです。 |
例49-1 リソース・カタログにリストを追加するためのコード
<customFolder id="groupLists" visible="#{true}" factoryClass="oracle.webcenter.list.view.rc.ListServiceContextFactory"> <attributes> <attribute value="LISTS_CUSTOM_FOLDER.TITLE" attributeId="Title" isKey="true"/> <attribute value="LISTS_CUSTOM_FOLDER.DESCRIPTION" attributeId="Description" isKey="true"/> <attribute value="LISTS_CUSTOM_FOLDER.KEYWORDS" attributeId="Subject" isKey="true"/> <attribute value="oracle.webcenter.list" attributeId="WEBCENTER_SERVICE_ID" isKey="false"/> <attribute value="/adf/webcenter/folderlists_qualifier.png" attributeId="IconURI"/> </attributes> </customFolder>
Oracle WebCenter Portalで提供されるREST APIを使用すると、提供されたタスク・フローを使用せずに、インタフェースを通じてリスト機能にアクセスできます。リストREST APIを使用すると、次のアクションを実行できます。
ポータル内でのリストの使用。リスト群からのリストの取得、新しいリストの追加などがあります
1つのリストの使用。リスト・メタデータの取得または更新、リストの削除などがあります
リスト内の行の使用
リスト行の使用。行の取得、更新、削除などがあります
列の使用。列の追加などがあります
リスト列の使用。列の取得、更新、削除などがあります
この項では、リストに関連付けられたREST APIメソッドについて説明します。次のサブセクションが含まれます:
WebCenter PortalのポータルでリストのRESTエントリ・ポイントを取得するには、特定のポータルを検索してリソース索引を取得します。対応するhref
またはtemplate
要素によって、ポータル内のリストを取得するURIエントリ・ポイントが提供されます。
リストを取得するポータルまたはサブポータルへ移動します。
次のリソース索引を取得します。
urn:oracle:webcenter:resourceindex
返されたhref
に移動します。
リソース・タイプを検索します。たとえば、ポータルのすべてのリストを取得するには、次のように検索します。
urn:oracle:webcenter:space:lists
クライアントがエントリ・ポイントを識別すると、リソース・タイプの分類によりナビゲートして、必要な操作を実行できます。リスト・リソース・タイプの分類は、次のとおりです。
urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list urn:oracle:webcenter:space:list:rows urn:oracle:webcenter:space:list:row urn:oracle:webcenter:space:list:columns urn:oracle:webcenter:space:list:column
どのリストREST APIメソッドにアクセスする場合でも、RESTサービスにログインする必要があります。その後、基礎となるサービスによって権限が確認されます。
この項では、各リソース・タイプについて知っておく必要があるすべての情報を提供します。次のサブセクションが含まれます:
lists
レスポンスでは、特定のポータル内のリストを取得する方法(GET
)およびリストをポータルに追加する方法(POST
)が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してlists
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists
lists
リソース・タイプでは、次のメソッドがサポートされます。
メソッド(lists): GET
このメソッドは、ポータル内のリストを取得します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists?q=name:equals:ProjectIssues&utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
リクエスト・パラメータ - startIndex
、itemsPerPage
、q
、projection
問合せ用のq
パラメータの形式は'q=attribute:operator:value'
です。例:
'q=name:equals:ProjectIssues'
Stringsでサポートされる演算子: equals
、not.equals
、contains
、starts.with
Datesでサポートされる演算子: equals
、not.equals
、greater.than
、greater.than.or.equals
、less.than
、less.than.or.equals
複数の条件をセミコロン(;)で区切って指定できます。
検索可能な属性(表49-1)
レスポンス・ステータス: 200
[OK]
レスポンス本文: <lists>
例:
<lists resourceType="urn:oracle:webcenter:space:lists"> <links> <link resourceType="urn:oracle:webcenter:list:lists" rel="self" href="opaque"/> <link template="opaque?startIndex={startIndex}& itemsPerPage={itemsPerPage}&q={searchTerms}& projection={projection} &stoken=FDgsOu7a2NTTM1cLJvnpkDXfihtHx5Q*" resourceType="urn:oracle:webcenter:list:lists"/> </links> <items> <list resourceType="urn:oracle:webcenter:space:list"> <links> <link resourceType="urn:oracle:webcenter:list" rel="self" href="opaque" capabilities="urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> <link resourceType="urn:oracle:webcenter:list:rows" href="opaque" capabilities="urn:oracle:webcenter:create"/> <link template="opaque? startIndex={startIndex}& itemsPerPage={itemsPerPage}&q={searchTerms}& stoken=FDgsOu7a2NTTM1cLJvnpkDXfihtHx5Q*" resourceType="urn:oracle:webcenter:list:rows"/> <link resourceType="urn:oracle:webcenter:list:columns" href="opaque" capabilities="urn:oracle:webcenter:create"/> </links> <id>/oracle/webcenter/list/scopedMD/ se0dea180_e2c1_45ac_b08b_ ba2c0b26aa72/lists/ProjectIssues.xml</id> <name>Project Issues</name> <description/> </list> </items> </lists>
メソッド(lists): POST
このメソッドは、ポータル内にリストを作成します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <list>
書込み可能要素(表49-2)
表49-2 リスト作成の書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
name脚注1 |
string |
- |
リストの名前 |
description |
string |
- |
リストの説明 |
columns脚注1 |
|
1から30 |
リストの列 |
脚注1 必須要素を示しています
例:
<list> <name>RestExample</name> <description>Created using rest api</description> <columns> <items> <metaColumn> <name>No.</name> <dataType>number</dataType> </metaColumn> <metaColumn> <name>Description</name> <dataType>string</dataType> </metaColumn> </items> </columns> </list>
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 201
[Created]
レスポンス本文: <list>
取得される要素(表49-3)
表49-3 listsから取得される要素
要素 | タイプ | 説明 |
---|---|---|
id |
string |
リストのID |
name |
string |
リストの名前 |
description |
string |
リストの説明 |
scope.guid |
string |
リストが属するポータルのGUID |
scope.name |
string |
リストが属するポータルの名前 |
creator |
string |
リストを作成したユーザーの名前 |
created |
date |
リストが作成された日付 |
modifier |
string |
最後にリストを変更したユーザーの名前 |
modified |
date |
最後にリストが変更された日付 |
columns |
|
リストの列 |
例:
<list resourceType="urn:oracle:webcenter:space:list"> <links> <link resourceType="urn:oracle:webcenter:space:list" rel="self" href="http://host:port/rest/api/spaces/vs1/ lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> <link template="http://host:port /rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_ 417b_a35f_fb03874979c0.xml)/rows? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_ w**&startIndex={startIndex}&itemsPerPage={itemsPerPage} &q={searchTerms}&utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" resourceType="urn:oracle:webcenter:space:list:rows" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/rows?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list:columns" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_ w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> </links> <id>/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_fb03874979c0.xml</id> <name>RestExample</name> <description>Created using rest api</description> <scope> <guid>s355923f0_2f04_4fd0_83ad_f7dac2a7ceed</guid> <name>vs1</name> </scope> <creator>weblogic</creator> <author> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/webcenter/ profilephoto/4539413335453830463042433131444642464245304645 333339453535423231/SMALL?_xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </author> <created>2010-11-18T06:10:32.250-08:00</created> <modifier>weblogic</modifier> <modifiedByUser> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </modifiedByUser> <modified>2010-11-18T06:10:32.250-08:00</modified> <columns resourceType="urn:oracle:webcenter:space:list:columns"> <links> <link resourceType="urn:oracle:webcenter:space:list:columns" rel="self" href="http://host:port/rest/api/spaces /vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns?utoken= FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list" rel="urn:oracle:webcenter:parent" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ ls_c9cecbc7_756b_417b_a35f_fb03874979c0.xml)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**"/> </links> <items> <metaColumn resourceType= "urn:oracle:webcenter:space:list:column"> <links> <link resourceType="urn:oracle:webcenter:space: list:column" rel="self "href="http://host:port/ rest/api/spaces/vs1/lists/ (/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/ lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns/ (lco_9bdd1418_6004_40ba_a052_04e8335b7ee8)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <dataType>number</dataType> <required>false</required> <displayLength>10</displayLength> <format>number</format> <allowLinks>false</allowLinks> </metaColumn> <metaColumn resourceType= "urn:oracle:webcenter:space:list:column"> <links> <link resourceType= "urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/ webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_ 417b_a35f_fb03874979c0.xml)/columns/ (lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <dataType>string</dataType> <required>false</required> <maxLength>500</maxLength> <displayLength>20</displayLength> <allowLinks>false</allowLinks> <editLines>1</editLines> </metaColumn> </items> </columns> </list>
表49-4は、クライアントがlists
リソースからリンクできるリソース・タイプをリストしています。
表49-4 listsからリンクされるリソース・タイプ
rel | リソース・タイプ |
---|---|
self |
|
|
list
レスポンスでは、個々のリストを取得、更新および削除する方法が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してlist
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list
listリソース・タイプでは、次のメソッドがサポートされます。
メソッド(list): GET
リストを取得するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_
5fb62dc3514d.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <list>
取得される要素(表49-5)
表49-5 listで取得される要素
要素 | タイプ | 説明 |
---|---|---|
id |
string |
リストのID |
name |
string |
リストの名前 |
description |
string |
リストの説明 |
scope.guid |
string |
リストが属するポータルのGUID |
scope.name |
string |
リストが属するポータルの名前 |
creator |
string |
リストを作成したユーザー |
created |
日付 |
リストが作成された日付 |
modifier |
string |
最後にリストを変更したユーザー |
modified |
日付 |
リストが最後に変更された日付 |
columns |
|
リストを構成する列 |
例:
<list resourceType="urn:oracle:webcenter:space:list"> <links> <link resourceType="urn:oracle:webcenter:space:list" rel="self" href="http://host:port/rest/api/spaces/vs1/ lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> <link template="http://host:port /rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_ 417b_a35f_fb03874979c0.xml)/rows? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**& startIndex={startIndex}&itemsPerPage={itemsPerPage}&q= {searchTerms}&utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" resourceType="urn:oracle:webcenter:space:list:rows" href="http://host:port/rest/api/ spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_ 2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/rows?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list:columns" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_ w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> </links> <id>/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_fb03874979c0.xml</id> <name>RestExample</name> <description>Created using rest api</description> <scope> <guid>s355923f0_2f04_4fd0_83ad_f7dac2a7ceed</guid> <name>vs1</name> </scope> <creator>weblogic</creator> <author> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/4539413335453830463042433131444 642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/ webcenter/profilephoto/4539413335453830463042433131444 642464245304645333339453535423231/SMALL? _xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </author> <created>2010-11-18T06:10:32.250-08:00</created> <modifier>weblogic</modifier> <modifiedByUser> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </modifiedByUser> <modified>2010-11-18T06:10:32.250-08:00</modified> <columns resourceType="urn:oracle:webcenter:space:list:columns"> <links> <link resourceType="urn:oracle:webcenter:space:list:columns" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_ 756b_417b_a35f_fb03874979c0.xml)/ columns?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list" rel="urn:oracle:webcenter:parent" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_ 4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)?utoken= FKld8lalI3QRdi8TgQkOCGEzxL5x_w**"/> </links> <items> <metaColumn resourceType= "urn:oracle:webcenter:space:list:column"> <links> <link resourceType= "urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/ list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_ 756b_417b_a35f_fb03874979c0.xml)/columns/(lco_ 9bdd1418_6004_40ba_a052_04e8335b7ee8)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <dataType>number</dataType> <required>false</required> <displayLength>10</displayLength> <format>number</format> <allowLinks>false</allowLinks> </metaColumn> <metaColumn resourceType= "urn:oracle:webcenter:space:list:column"> <links> <link resourceType= "urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port /rest/api/spaces/vs1/lists/(/oracle/webcenter/ list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns/(lco_3a31fd20_24f1_ 4422_99fd_c00d7bed4b24)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <dataType>string</dataType> <required>false</required> <maxLength>500</maxLength> <displayLength>20</displayLength> <allowLinks>false</allowLinks> <editLines>1</editLines> </metaColumn> </items> </columns> </list>
メソッド(list): PUT
リストの名前または説明を更新するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_
5fb62dc3514d.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <list>
listの書込み可能要素(表49-6)
表49-6 listの書込み可能要素
要素 | タイプ | 必須 | 制約 | 説明 |
---|---|---|---|---|
name脚注1 |
string |
はい |
1文字以上の文字 |
このリストの名前 |
description |
string |
いいえ |
なし |
このリストの説明 |
脚注1 必須要素を示しています
例:
<list> <name>RestExampleUpdate</name> <description>Updated using rest api</description> </list>
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <list>
メソッド(list): DELETE
リストを削除するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_
5fb62dc3514d.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
レスポンス・ステータス: 204
[No Content]
レスポンス本体: なし
表49-7は、クライアントがlist
リソースからリンクできるリソース・タイプを示しています。
表49-7 listからリンクされるリソース・タイプ
rel | リソース・タイプ |
---|---|
self |
|
|
|
|
rows
レスポンスでは、列をリストから取得またはリストに追加する方法が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してrows
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list urn:oracle:webcenter:space:list:rows
rowsリソース・タイプでは、次のメソッドがサポートされます。
メソッド(rows): GET
リスト行を取得するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_
5fb62dc3514d.xml)/rows?q=lco_9bdd1418_6004_40ba_a052_
04e8335b7ee8:equals:2&utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
リクエスト・パラメータ - startIndex
、itemsPerPage
、q
、projection
問合せ用のq
パラメータの形式は'q=columnId:operator:value'
です。例:
'q=lco_9bdd1418_6004_40ba_a052_04e8335b7ee8:equals:2'
Strings
でサポートされる演算子: equals
、not.equals
、contains
、starts.with
Numbers
とDates
でサポートされる演算子: equals
、not.equals
、greater.than
、greater.than.or.equals
、less.than
、less.than.or.equals
複数の条件をセミコロン(;)で区切って指定できます。
rowsで検索可能な属性: 行は列の値で検索可能です。
レスポンス・ステータス: 200
[OK]
レスポンス本文: <rows>
例:
<rows resourceType="urn:oracle:webcenter:space:list:rows"> <links> <link template="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/ scopedMD/s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_ c9cecbc7_756b_417b_a35f_fb03874979c0.xml)/rows? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**& startIndex={startIndex}&itemsPerPage={itemsPerPage}& q={searchTerms}&utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" resourceType="urn:oracle:webcenter:space:list:rows" rel="self" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/rows?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list" rel="urn:oracle:webcenter:parent" href="http://host:port/rest/api/spaces/ vs1/lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**"/> </links> <itemsPerPage>1</itemsPerPage> <startIndex>0</startIndex> <items> <row resourceType="urn:oracle:webcenter:space:list:row"> <links> <link resourceType="urn:oracle:webcenter:space:list:row" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/ scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/rows/(lr_a14d427f_8515_4c82_956f_ a60e6e08668c)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lr_a14d427f_8515_4c82_956f_a60e6e08668c</id> <listId>/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_ 83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml</listId> <scope>s355923f0_2f04_4fd0_83ad_f7dac2a7ceed</scope> <creator>weblogic</creator> <author> <links> <link resourceType= "urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/ lists/@self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_ w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/ {size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/SMALL? _xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces: profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/ view/pages/peopleconn/UserProfileGallery.jspx? wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </author> <created>2010-11-18T07:12:06.599-08:00</created> <modifier>weblogic</modifier> <modifiedByUser> <links> <link resourceType= "urn:oracle:webcenter:people:person" rel="via" href="http://host:port/rest/ api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists /@self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/ {size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/SMALL? _xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces: profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/ view/pages/peopleconn/UserProfileGallery.jspx? wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </modifiedByUser> <modified>2010-11-18T07:12:06.599-08:00</modified> <columns> <column> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <value>1.0</value> </column> <column> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <value>test</value> </column> </columns> </row> </items> </rows>
メソッド(rows): POST
リスト内に行を作成するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_
5fb62dc3514d.xml)/rows?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <row>
書込み可能要素(表49-8)
表49-8 rowの書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
columns.column.id脚注1 |
string |
- |
列のID |
columns.column.value脚注1 |
string |
列のデータ型として有効な値 |
列の値 |
脚注1 必須要素を示しています
例:
<row> <columns> <column> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <value>1</value> </column> <column> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <value>test</value> </column> </columns> </row>
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 201
[Created]
レスポンス本文: <row>
取得される要素(表49-9)
例:
<row resourceType="urn:oracle:webcenter:space:list:row"> <links> <link resourceType="urn:oracle:webcenter:space:list:row" rel="self" href="http://host:port/rest/api/spaces/vs1/ lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_ 5fb62dc3514d.xml)/rows/(lr_4cc07327_49cb_4cd5_a270_ 182ddcc8db4a)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lr_4cc07327_49cb_4cd5_a270_182ddcc8db4a</id> <listId>/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_ 5fb62dc3514d.xml</listId> <scope>s355923f0_2f04_4fd0_83ad_f7dac2a7ceed</scope> <creator>weblogic</creator> <author> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port /rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/4539413335453830463042433131 444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/SMALL?_xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </author> <created>2010-11-17T06:34:25.042-08:00</created> <modifier>weblogic</modifier> <modifiedByUser> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/ webcenter/profilephoto/4539413335453830463042433131 444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/SMALL?_xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </modifiedByUser> <modified>2010-11-17T06:34:25.042-08:00</modified> <columns> <column> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <value>1.0</value> </column> <column> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <value>test</value> </column> </columns> </row>
表49-10は、クライアントがrows
リソースからリンクできるリソース・タイプを示しています。
表49-10 rowsからリンクされるリソース・タイプ
rel | リソース・タイプ |
---|---|
self |
|
parent |
|
|
row
レスポンスでは、個々のリスト行を取得、追加および削除する方法が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してrow
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list urn:oracle:webcenter:space:list:rows urn:oracle:webcenter:space:list:row
rowリソース・タイプでは、次のメソッドがサポートされます。
メソッド(row): GET
リスト行からデータを取得するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/rows/(lr_a14d427f_8515_4c82_956f_
a60e6e08668c)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <row>
取得される要素(表49-11)
例:
<row resourceType="urn:oracle:webcenter:space:list:row"> <links> <link resourceType="urn:oracle:webcenter:space:list:row" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD /s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_bb806754_0652_ 4d49_9354_5fb62dc3514d.xml)/rows/(lr_4cc07327_49cb_4cd5_a270_ 182ddcc8db4a)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lr_4cc07327_49cb_4cd5_a270_182ddcc8db4a</id> <listId>/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_bb806754_0652_4d49_9354_ 5fb62dc3514d.xml</listId> <scope>s355923f0_2f04_4fd0_83ad_f7dac2a7ceed</scope> <creator>weblogic</creator> <author> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/{size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/SMALL?_xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </author> <created>2010-11-17T06:34:25.042-08:00</created> <modifier>weblogic</modifier> <modifiedByUser> <links> <link resourceType="urn:oracle:webcenter:people:person" rel="via" href="http://host:port/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/{size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://host:port/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/SMALL?_xResourceMethod=wsrp" capabilities="urn:oracle:webcenter:read"/> <link type="text/html" resourceType="urn:oracle:webcenter:spaces:profile" rel="alternate" href="http://host:port/ webcenter/faces/oracle/webcenter/webcenterapp/view/pages/ peopleconn/UserProfileGallery.jspx?wc.username=weblogic" capabilities="urn:oracle:webcenter:read"/> </links> <displayName>weblogic</displayName> <guid>E9A35E80F0BC11DFBFBE0FE339E55B21</guid> <id>weblogic</id> </modifiedByUser> <modified>2010-11-17T06:34:25.042-08:00</modified> <columns> <column> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <value>1.0</value> </column> <column> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <value>test</value> </column> </columns> </row>
メソッド(row): PUT
行のデータを更新するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/rows/(lr_a14d427f_8515_4c82_956f_
a60e6e08668c)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <row>
書込み可能要素(表49-12)
表49-12 rowの書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
columns.column.id脚注1 |
string |
- |
列のID |
columns.column.value脚注1 |
string |
列のデータ型として有効な値 |
列の値 |
脚注1 必須要素を示しています
例:
<row> <columns> <column> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <value>1</value> </column> <column> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <value>test</value> </column> </columns> </row>
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <row>
メソッド(row): DELETE
リスト行を削除するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/rows/(lr_a14d427f_8515_4c82_956f_
a60e6e08668c)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
レスポンス・ステータス: 204
[No Content]
レスポンス本体: なし
表49-13は、クライアントがrow
リソースからリンクできるリソース・タイプを示しています。
columns
レスポンスでは、リスト列を取得または追加する方法が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してcolumns
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list urn:oracle:webcenter:space:list:columns
columns
リソース・タイプでは、次のメソッドがサポートされます。
メソッド(columns): GET
リスト内の列を取得するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/columns?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
リクエスト・パラメータ: なし
レスポンス・ステータス: 200
[OK]
レスポンス本文: <metaColumns>
例:
<metaColumns resourceType="urn:oracle:webcenter:space:list:columns"> <links> <link resourceType="urn:oracle:webcenter:space:list:columns" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_ 417b_a35f_fb03874979c0.xml)/columns? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:create"/> <link resourceType="urn:oracle:webcenter:space:list" rel="urn:oracle:webcenter:parent" href="http://host:port/rest/api/spaces/vs1/ lists/(/oracle/webcenter/list/scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**"/> </links> <items> <metaColumn resourceType="urn:oracle:webcenter:space:list:column"> <links> <link resourceType="urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/ scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns/(lco_9bdd1418_6004_40ba_ a052_04e8335b7ee8)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_9bdd1418_6004_40ba_a052_04e8335b7ee8</id> <name>No.</name> <dataType>number</dataType> <required>false</required> <displayLength>10</displayLength> <format>number</format> <allowLinks>false</allowLinks> </metaColumn> <metaColumn resourceType="urn:oracle:webcenter:space:list:column"> <links> <link resourceType="urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/ scopedMD/s355923f0_2f04_4fd0_83ad_ f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_ fb03874979c0.xml)/columns/(lco_3a31fd20_24f1_4422_ 99fd_c00d7bed4b24)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_3a31fd20_24f1_4422_99fd_c00d7bed4b24</id> <name>Description</name> <dataType>string</dataType> <required>false</required> <maxLength>500</maxLength> <displayLength>20</displayLength> <allowLinks>false</allowLinks> <editLines>1</editLines> </metaColumn> </items> </metaColumns>
メソッド(columns): POST
リスト内に列を作成するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/columns?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <metaColumn>
書込み可能要素(表49-14)
表49-14 columnsの書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
name脚注1 |
string |
- |
列の名前 |
dataType脚注1 |
string |
|
列のデータ型 |
required |
boolean |
|
列の値が必須かどうか |
defaultValue |
列のデータ型 |
オブジェクトがデータ型と一致する必要がある |
列のデフォルト値 |
maxLength |
int |
|
文字列値の最大長 |
rangeLow |
int |
|
|
rangeHigh |
int |
|
|
format |
string |
次の
次の
|
列の形式 |
allowLinks |
boolean |
|
ハイパーリンクを列の値に指定できるかどうか |
linkTarget |
string |
|
|
editLines |
int |
|
列値を編集する際の行数(デフォルトは1) |
peopleScope |
string |
|
ディレクトリ内のすべてのユーザーを有効とするか、あるいはリストを含むポータルのメンバーを有効とするかどうか |
displayWidth |
int |
- |
列のピクセル単位での表示幅 |
hint |
string |
- |
列値を入力する際にユーザーに表示されるヒント |
脚注1 必須要素を示しています
例:
<metaColumn> <name>Notes</name> <dataType>richtext</dataType> </metaColumn
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 201
[Created]
レスポンス本文: <metaColumn>
取得される要素(表49-15)
表49-15 columnsから取得される要素
要素 | タイプ | 説明 |
---|---|---|
id |
string |
列のID |
name |
string |
列の名前 |
dataType |
string |
列のデータ型 |
required |
boolean |
列の値が必須かどうか |
defaultValue |
列のデータ型 |
列のデフォルト値 |
maxLength |
int |
文字列値の最大長 |
rangeLow |
int |
|
rangeHigh |
int |
|
format |
string |
列の形式 |
allowLinks |
boolean |
ハイパーリンクを列の値に指定できるかどうか |
linkTarget |
string |
|
editLines |
int |
列値を編集する際の行数(デフォルトは1) |
peopleScope |
string |
ディレクトリ内のすべてのユーザーを有効とするか、あるいはリストを含むポータルのメンバーを有効とするかどうか |
displayWidth |
int |
列のピクセル単位での表示幅 |
hint |
string |
列値を入力する際にユーザーに表示されるヒント |
例:
<metaColumn resourceType="urn:oracle:webcenter:space:list:column"> <links> <link resourceType="urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ ls_c9cecbc7_756b_417b_a35f_fb03874979c0.xml)/columns/ (lco_fe2b9856_32f3_449a_a277_18dc7f6a779e)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_fe2b9856_32f3_449a_a277_18dc7f6a779e</id> <name>Notes</name> <dataType>richtext</dataType> <required>false</required> <displayLength>20</displayLength> <allowLinks>false</allowLinks> </metaColumn>
表49-16は、クライアントがcolumns
リソースからリンクできるリソース・タイプを示しています。
表49-16 columnsからリンクされるリソース・タイプ
rel | リソース・タイプ |
---|---|
self |
|
parent |
|
|
column
レスポンスでは、個々のリスト列を取得、追加および削除する方法が提供されます。この項には次のサブセクションが含まれます:
この項では、クライアントがハイパーメディアを経由してcolumn
リソースにアクセスする方法を示します。
urn:oracle:webcenter:resourceindex urn:oracle:webcenter:spaces urn:oracle:webcenter:space:resourceindex urn:oracle:webcenter:space:lists urn:oracle:webcenter:space:list urn:oracle:webcenter:space:list:columns urn:oracle:webcenter:space:list:column
columnリソース・タイプでは、次のメソッドがサポートされます。
メソッド(column): GET
リスト列を取得するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/columns/(lco_fe2b9856_32f3_449a_a277_
18dc7f6a779e)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
リクエスト・ヘッダー: [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <metaColumn>
取得される要素(表49-17)
表49-17 columnで取得される要素
要素 | タイプ | 説明 |
---|---|---|
id |
string |
列のID |
name |
string |
列の名前 |
dataType |
string |
列のデータ型 |
required |
boolean |
列の値が必須かどうか |
defaultValue |
列のデータ型 |
列のデフォルト値 |
maxLength |
int |
文字列値の最大長 |
rangeLow |
int |
|
rangeHigh |
int |
|
format |
string |
列の形式 |
allowLinks |
boolean |
ハイパーリンクを列の値に指定できるかどうか |
linkTarget |
string |
|
editLines |
int |
列値を編集する際の行数(デフォルトは1) |
peopleScope |
string |
ディレクトリ内のすべてのユーザーを有効とするか、あるいはリストを含むポータルのメンバーを有効とするかどうか |
displayWidth |
int |
列のピクセル単位での表示幅 |
hint |
string |
列値を入力する際にユーザーに表示されるヒント |
例:
<metaColumn resourceType="urn:oracle:webcenter:space:list:column"> <links> <link resourceType="urn:oracle:webcenter:space:list:column" rel="self" href="http://host:port/ rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/ s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ ls_c9cecbc7_756b_417b_a35f_fb03874979c0.xml)/ columns/(lco_fe2b9856_32f3_449a_a277_18dc7f6a779e)? utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read urn:oracle:webcenter:update urn:oracle:webcenter:delete"/> </links> <id>lco_fe2b9856_32f3_449a_a277_18dc7f6a779e</id> <name>Notes</name> <dataType>richtext</dataType> <required>false</required> <displayLength>20</displayLength> <allowLinks>false</allowLinks> </metaColumn>
メソッド(column): PUT
列のデータを更新するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/columns/(lco_fe2b9856_32f3_449a_a277_
18dc7f6a779e)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <metacolumn>
書込み可能要素(表49-18)
表49-18 columnの書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
name脚注1 |
string |
- |
列の名前 |
dataType脚注1 |
string |
|
列のデータ型 |
required |
boolean |
|
列の値が必須かどうか |
defaultValue |
列のデータ型 |
オブジェクトがデータ型と一致する必要がある |
列のデフォルト値 |
maxLength |
int |
|
文字列値の最大長 |
rangeLow |
int |
|
|
rangeHigh |
int |
|
|
format |
string |
次の
次の
|
列の形式 |
allowLinks |
boolean |
|
ハイパーリンクを列の値に指定できるかどうか |
linkTarget |
string |
|
|
editLines |
int |
|
列値を編集する際の行数(デフォルトは1) |
peopleScope |
string |
|
ディレクトリ内のすべてのユーザーを有効とするか、あるいはリストを含むポータルのメンバーを有効とするかどうか |
displayWidth |
int |
- |
列のピクセル単位での表示幅 |
hint |
string |
- |
列値を入力する際にユーザーに表示されるヒント |
脚注1 必須要素を示しています
例:
<metaColumn> <name>Comments</name> <dataType>richtext</dataType> </metaColumn>
リクエスト・ヘッダー: Content-Type = application/xml
| application/json
, [Accept = application/xml
| application/json
]
レスポンス・ステータス: 200
[OK]
レスポンス本文: <metaColumn>
メソッド(column): DELETE
リスト列を削除するには、このメソッドを使用します。
リソースURI。例:
http://host:port/rest/api/spaces/vs1/lists/(/oracle/webcenter/list/scopedMD/
s355923f0_2f04_4fd0_83ad_f7dac2a7ceed/lists/ls_c9cecbc7_756b_417b_a35f_
fb03874979c0.xml)/columns/(lco_fe2b9856_32f3_449a_a277_
18dc7f6a779e)?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本体: なし
レスポンス・ステータス: 204
[No Content]
レスポンス本体: なし
表49-19は、クライアントがcolumn
リソースからリンクできるリソース・タイプを示しています。
問題
リスト・タスク・フローで、WebCenter Portalのリポジトリが使用できないことを示すエラーが発生します。
解決方法
データベース接続が構成されていない可能性があります。詳細は、第4.2.2項「データベース接続の設定」を参照してください。
問題
401 Unauthorizedエラーが発生します。
解決方法
ポータルのセキュリティが設定されていない可能性があります。また、試行されたタスクの実行に必要な権限が付与されていなかったことも考えられます。