Oracle® Fusion Middleware Oracle WebCenter Portal開発者ガイド 11g リリース1 (11.1.1.6.0) B72084-01 |
|
![]() 前 |
![]() 次 |
この章では、リスト・サービスの概要と、リスト・サービスをFrameworkアプリケーションに統合する方法を説明します。この章の内容は、次のとおりです。
この項では、リスト・サービスの機能と要件の概要を説明します。この項の内容は、次のとおりです。
リスト・サービスを使用すると、実行時にリストを作成し、それらを公開してアプリケーション・ページ上に配置できます。実行時にリソース・カタログで使用可能なリスト・タスク・フローは設計時に作成できます。実行時、ユーザーはタスク・フローをカタログからページに追加し、そのタスク・フローを使用してリストを作成できます。
設計時にコード・スニペットをリソース・カタログに追加することによって、実行時に値が移入されたリストをカタログに追加し、アプリケーション・ページ上に配置できるようになります。
デフォルトでは、シード・ロールAdministrator
が割り当てられたユーザーにのみ、リストの管理権限が付与されます。つまり、これらのユーザーは、実行時にリストを作成、編集および削除したり、リスト・データを編集したりできます。デフォルトの権限は、デプロイ時にjazn-data.xml
内で変更するか、Enterprise ManagerまたはApplication Policy Managerを使用して変更できます。認可されたユーザーは、この権限を実行時にコンポーネント・レベルで変更できます(詳細は、第24章「コンポーザ・コンポーネントのデフォルトのセキュリティ動作の変更」を参照)。サポートされるのは、ロール・ベースの権限のみです。
実行時、リスト・タスク・フローによって、リストの作成とリスト・データの追加に使用できるコントロールが提供されます。これらのコントロールの詳細は、Oracle Fusion Middleware Oracle WebCenter Portal: Spacesユーザーズ・ガイドのリストの作成と管理に関する項およびリスト・データの追加と作成に関する項を参照してください。
ヒント: ユーザーが実行時にリストを使用できるようにするには、その操作を明示的にユーザーに許可する必要があります。詳細は、第48.2.3項「実行時のユーザーによるリストの使用の有効化」を参照してください。 |
この項では、アプリケーションにリスト・サービスを追加するために必要な手順について説明します。この項の内容は、次のとおりです。
リスト・サービスは、WEBCENTER
がインストールされているデータベースへの接続を必要とします。リスト・サービスは、すべてのリスト・データをデータベースに格納します。WEBCENTER
がインストールされているデータベースへのデータベース接続の設定の詳細は、第7.2.2項「データベース接続の設定」を参照してください。
注意: データベースと |
この項では、リスト・サービスの基本的な統合について説明します。この項の内容は、次のとおりです。
リスト・サービスには、「リスト」という1つのタスク・フローが含まれます(図48-1を参照)。
リスト・タスク・フローの詳細は、第48.1.2項「リスト・サービスの実行時の処理」を参照してください。
リスト・タスク・フローをFrameworkアプリケーションに追加するには:
第7.2項「サービスを利用するためのフレームワーク・アプリケーションの準備」の手順に従い、アプリケーションでセキュリティを実装し、カスタマイズ可能な新しいページを作成します。
リスト・タスク・フローの追加先となるJSFページを作成します。
ページのセキュリティを構成します。
リソース・パレットで「カタログ」、「WebCenter Portal - サービス・カタログ」、「タスク・フロー」フォルダと開きます。
「リスト」タスク・フローをドラッグしてページ上にドロップし、コンテキスト・メニューから「リージョン」を選択します。
ページを保存し、ブラウザで実行します。
デフォルトでは、アプリケーション管理者のみがリストを使用できます。ユーザーが実行時にリストを表示して使用するには、それらのユーザーに最低でも権限ListPermission:view
が明示的に付与されている必要があります。アプリケーション管理者は、実行時にロール・マネージャ・タスク・フローを通じてこの権限を付与できます。
たとえば管理者が、認証されたすべてのユーザーにリストへの表示アクセス権を付与するには、ロール・マネージャ・タスク・フローでロールAllUsers
を作成し、authenticated-role
をメンバーとして追加した後、リストへの表示アクセス権を付与します。
リスト・サービスをアプリケーションに追加する場合は、ロール・マネージャ・タスク・フローも追加する必要があります。アプリケーションがWebCenterに基づいている場合、ロール・マネージャ・タスク・フローは、デフォルトで「管理」ページの「セキュリティ」タブから使用できます。実行時に次のURLを使用すると、このページに移動できます。
http://host:port/appcontxtroot/faces/admin
注意: 実行時にロール・マネージャを通じて作成および付与するロールと権限は、アプリケーションにパッケージ化されていないため、デプロイ後には提供されません。デプロイ後に、この項で説明したプロビジョニング手順を実行する必要があります。 |
リソース・カタログを適切に構成すると、データが移入されたリストを実行時に使用できるため、認可されたユーザーはそれらを編集モードでページに追加できます。コンポーネントを既存のリソース・カタログに追加する手順、またはカスタム・カタログを作成する手順については、第16章「リソース・カタログの作成と管理」を参照してください。この項では、リストをリソース・カタログに追加するために使用するコード・スニペットの例を示します(例48-1)。
注意: 大文字の値は、翻訳された文字列用のメッセージ・キーです。 |
例48-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つのリストの使用。リスト・メタデータの取得または更新、リストの削除などがあります。
リスト内の行の使用。
リスト行の使用。行の取得、更新、削除などがあります。
列の使用。列の追加などがあります。
リスト列の使用。列の取得、更新、削除などがあります。
この項では、リスト・サービスの関連項目について説明します。この項の内容は、次のとおりです。
Spacesアプリケーションのスペースに含まれるリストのRESTエントリ・ポイントにアクセスするには、特定のスペースに移動して、そのスペース内のリストへのリンクを表示する必要があります。スペース内のどのリストに対しても、次のresourceType
を持つリンク要素を探します。
urn:oracle:webcenter:space:lists
対応するhref
またはtemplate
要素によって、スペース内のリンクを取得するURIエントリ・ポイントが提供されます。
クライアントがエントリ・ポイントを識別すると、リソース・タイプの分類によりナビゲートして、必要な操作を実行できます。リスト・リソース・タイプの分類は、次のとおりです。
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://example.com:8889/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
複数の条件をセミコロン(;)で区切って指定できます。
検索可能な属性(表48-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://example.com:8889/rest/api/spaces/vs1/lists?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**
リクエスト本文: <list>
書込み可能要素(表48-2)
表48-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>
取得される要素(表48-3)
表48-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://example.com:8889/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://example.com:8889 /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://example.com:8889/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://example.com:8889/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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/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://example.com:8889/ 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://example.com:8889/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://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/ 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>
表48-4は、クライアントがlists
リソースからリンクできるリソース・タイプを示しています。
表48-4 listsからリンクされるリソース・タイプ
rel | resourceType |
---|---|
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://dexample.com:8889/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>
取得される要素(表48-5)
表48-5 listで取得される要素
要素 | タイプ | 説明 |
---|---|---|
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://example.com:8889/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://example.com:8889 /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://example.com:8889/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://example.com:8889/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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/4539413335453830463042433131444 642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/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://example.com:8889/ 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://example.com:8889 /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://example.com:8889/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の書込み可能要素(表48-6)
表48-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://example.com:8889/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]
レスポンス本体: なし
表48-7は、クライアントがlist
リソースからリンクできるリソース・タイプを示しています。
表48-7 listからリンクされるリソース・タイプ
rel | resourceType |
---|---|
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://example.com:8889/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://example.com:8889/ 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://example.com:8889/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://example.com:8889/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://example.com:8889/ 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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/ lists/@self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_ w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/ {size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/rest/ api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists /@self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/45394133354538304630424 33131444642464245304645333339453535423231/ {size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/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>
書込み可能要素(表48-8)
表48-8 rowsの書込み可能要素
要素 | タイプ | 制約 | 説明 |
---|---|---|---|
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>
取得される要素(表48-9)
次に例を示します。
<row resourceType="urn:oracle:webcenter:space:list:row"> <links> <link resourceType="urn:oracle:webcenter:space:list:row" rel="self" href="http://example.com:8889/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://example.com:8889 /rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/4539413335453830463042433131 444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/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://example.com:8889/ 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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/ webcenter/profilephoto/4539413335453830463042433131 444642464245304645333339453535423231/{size}? _xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/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://example.com:8889/ 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>
表48-10は、クライアントがrows
リソースからリンクできるリソース・タイプを示しています。
表48-10 rowsからリンクされるリソース・タイプ
rel | resourceType |
---|---|
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://example.com:8889/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>
取得される要素(表48-11)
次に例を示します。
<row resourceType="urn:oracle:webcenter:space:list:row"> <links> <link resourceType="urn:oracle:webcenter:space:list:row" rel="self" href="http://example.com:8889/ 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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/{size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/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://example.com:8889/ 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://example.com:8889/ rest/api/people/E9A35E80F0BC11DFBFBE0FE339E55B21/lists/ @self?utoken=FKld8lalI3QRdi8TgQkOCGEzxL5x_w**" capabilities="urn:oracle:webcenter:read"/> <link type="image/png" template="http://example.com:8889/webcenter/ profilephoto/453941333545383046304243313144464246424530 4645333339453535423231/{size}?_xResourceMethod=wsrp" resourceType="urn:oracle:webcenter:people:person" rel="urn:oracle:webcenter:people:icon" href="http://example.com:8889/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://example.com:8889/ 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://example.com:8889/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>
書込み可能要素(表48-12)
表48-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://example.com:8889/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]
レスポンス本体: なし
表48-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://example.com:8889/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://example.com:8889/ 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://example.com:8889/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://example.com:8889/ 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://example.com:8889/ 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://example.com:8889/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>
書込み可能要素(表48-14)
表48-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>
取得される要素(表48-15)
表48-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://example.com:8889/ 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>
表48-16は、クライアントがcolumns
リソースからリンクできるリソース・タイプを示しています。
表48-16 columnsからリンクされるリソース・タイプ
rel | resourceType |
---|---|
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://example.com:8889/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>
取得される要素(表48-17)
表48-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://example.com:8889/ 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://example.com:8889/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>
書込み可能要素(表48-18)
表48-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://example.com:8889/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]
レスポンス本体: なし
表48-19は、クライアントがcolumn
リソースからリンクできるリソース・タイプを示しています。
問題
リスト・タスク・フローで、WebCenter Portalのリポジトリが使用できないことを示すエラーが発生します。
解決方法
データベース接続が構成されていない可能性があります。詳細は、第7.2.2項「データベース接続の設定」を参照してください。
問題
401 Unauthorizedエラーが発生します。
解決方法
アプリケーションのセキュリティが設定されていない可能性があります。また、試行されたタスクの実行に必要な権限が付与されていなかったことも考えられます。