| Oracle® Fusion Middleware Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発 11gリリース1 (11.1.1.8.3) E49666-03 |
|
 前 |
 次 |
| 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エラーが発生します。
解決方法
ポータルのセキュリティが設定されていない可能性があります。また、試行されたタスクの実行に必要な権限が付与されていなかったことも考えられます。
