ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

データセットアクションの使用

Liferay DXP 2024.Q1/ポータル GA112

重要

現在、この機能はリリース機能フラグ (LPS-164563) によって保護されています。

データセットアクションを使用してさまざまなタスクを実行する方法の例をいくつか示します。

ユースケース: アクションを使用してドキュメントを編集する

背景: サイトのドキュメントとメディアアプリケーションにパフォーマンスレビュードキュメントがあり、パフォーマンスレビューの一覧、その ID、タイトル、外部参照コード、および作成日を表示したいと考えています。また、データセットを表示できるユーザーがドキュメントを編集できるようにする必要があります。

環境の設定: アクションを作成する前に、次のパラメータを使用してデータセットを作成します。

項目	値
名前	ドキュメントデータセット
REST アプリケーション	`/headless-delivery/v1.0`
REST スキーマ	ドキュメント
REST エンドポイント	`/v1.0/sites/{siteId}/documents`

Documents Data Set の編集を開始し、 id、 externalReferenceCode、 title、および dateCreated フィールドを追加します。

次に、ドキュメントをドキュメントとメディアアプリケーションにアップロードします。

編集アクションの作成

「新しいアイテムアクション」ページで、以下の表の情報を使用してフィールドに入力します。

項目	値
ラベル	ドキュメントの編集
アイコン	鉛筆（）
種類	リンク

URLを入力するには、

新しいタブで、ドキュメントとメディアアプリケーション (サイトメニュー → コンテンツ & データ → ドキュメントとメディア) でパフォーマンスレビュードキュメントを探します。
ドキュメントの アクション メニュー () を開き、編集オプションを右クリックして、 リンクアドレスのコピーを選択します。

URL は次のようになります http://localhost:8080/group/guest/~/control_panel/manage?(...)_com_liferay_document_library_web_portlet_DLAdminPortlet_fileEntryId=32813&(...)state%3Dmaximized%26p_p_mode%3Dview%26p_p_auth%3DYH1QvqK9&p_p_auth=YH1QvqK9
「新しいアイテムアクション」ウィンドウに戻り、そのフィールドに URL を貼り付けます。

このアクションを現状のまま使用すると、ユーザーは、編集しようとしているエントリに関係なく、同じドキュメントを参照する同じ編集ページに送信されます。

それを望んでいないので、URL をできるだけ汎用的にし、値をパラメーター化して、各アクションが特定のエントリの URL を指すようにする必要があります。
URL をより汎用的にするには、まず最初のアドレス (http://localhost:8080) を見つけて削除することから始めます。

これにより、サイトのアドレスが変更された場合でもアクションが機能することが保証されます。
認証トークン p_p_auth%3DYH1QvqK9&p_p_auth=YH1QvqK9を検索して削除することもできます。

これにより、ログインするたびに p_p_auth 認証トークンが変更されるため、認証の競合を防ぐことができます。
URL をパラメーター化するには、URL 内の fileEntryId 値を見つけます。ドキュメントを参照するためにヘッドレス API で使用されるパラメータに置き換えます。この場合、 はを ID とします。

fileEntryId の値がインスタンス内で異なります。

どの値を使用すべきかわからない場合は、 API エクスプローラーにアクセスし、REST アプリケーションで使用されているパラメータを探してください。
32813 を {id}に置き換えます。

パラメータ値を中括弧 ({}) 内に入力します。
URL を設定したら、ヘッドレスアクティベーションキーを追加します。 API エクスプローラーを使用して見つけることができます。使用している REST アプリケーションを見つけて、GET コマンドを実行します。キーはレスポンス本文に次のように記載されています。
```
(...)
   "actions": {
   "get": {
      "method": "GET",
      "href": "http://localhost:8080/o/c/performancereviews/32647"
   },
   "replace": {
      "method": "PUT",
      "href": "http://localhost:8080/o/c/performancereviews/32647"
   },
   "update": {
      "method": "PATCH",
      "href": "http://localhost:8080/o/c/performancereviews/32647"
   },
   "delete": {
      "method": "DELETE",
      "href": "http://localhost:8080/o/c/performancereviews/32647"
   }
}
```
この場合、アクションキーは 取得、 置換、 更新、 削除です。

ユーザーがドキュメントを編集するため、PUT メソッドとそのアクティベーションキーを使用する必要があります (をに置き換えます)。キーをヘッドレスアクションキーフィールドに追加し、ユーザーにそのアクションに必要な権限があることを確認します。
この場合、確認メッセージは必要ないので、 「保存」をクリックします。

コンテンツページでデータセットフラグメントを使用する

アクションが設定されました。データセットフラグメントを使用して、データセットをコンテンツページに表示します。

新しいページを作成または編集を開始します。
左側のフラグメントとウィジェットメニューで、フラグメントの下のデータセットを検索します。フラグメントを編集領域にドラッグアンドドロップします。
フラグメントをクリックします。右側の「全般」タブには、データセットを選択できるフィールドがあります。追加 () をクリックし、 ドキュメントデータセットを選択します。
ページを公開します。