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

オブジェクトイベントの監査

Liferay 7.4 U72+/GA72+

Liferayの監査フレームワークを使用すると、カスタムオブジェクト定義とそのエントリに関するイベントを追跡できます。 エントリーイベントを追跡するには、オブジェクト定義のエントリー履歴を有効にする必要があります。 有効になっている間は、 監査アプリケーション または REST APIを介してエントリの履歴を表示できます。

監査アプリケーションの使用

変更通知を受け取る(購読する)

監査アプリケーションにアクセスするには、 グローバルメニュー (Global Menu) → コントロールパネル を開き、 監査 をクリックします。

[コントロールパネル]の[監査]をクリックすると、オブジェクト定義に関連するイベントが表示されます。

イベントは表形式で表示されます。

Description
ユーザーID代理ユーザーのID。
ユーザー名代理ユーザーのID。
リソースID影響を受けるリソースのID。
リソース名影響を受けるリソースの名前とそのID(例:ObjectDefinition#44168)。
リソースアクション実行されたアクション (ADDUPDATE、または DELETE)。
クライアントIPアクションの役割を担うIPアドレス。
作成日時イベントレコードが作成された日時。

イベントフィールドをクリックすると、具体的なアクションの詳細を含む、より完全な記録が表示されます。 キーワードやその他の用語を使って検索結果を検索・絞り込むことができます。

オブジェクトエントリイベントでは、 ObjectDefinition#[ObjectID] という命名パターンが使用されます。

イベントフィールドをクリックすると、詳細が表示されます。

追跡対象エンティティとイベント

監査アプリケーションは、以下のオブジェクト関連エンティティのイベントを追跡します。

  • ObjectDefinitionObjectFieldObjectFieldSettingObjectRelationshipObjectValidationRule、および ObjectAction のスキーマ変更。

  • ObjectLayout (ボックス、列、行、タブを含む) および ObjectView (列とソート列を含む) の UI 構成変更。

  • ObjectEntry および ObjectEntryVersion のエントリが変更されます(イベントのみ削除)。

オブジェクトエントリを監査するには、エントリ履歴を有効にする必要があります。 エントリー・バージョンの削除を監査するには、オブジェクト定義のオブジェクト・エントリーのバージョニングも有効にする必要があります。

REST APIの使用

nestedFields パラメーターと auditEvents 値を使用すると、GET API 呼び出しでエントリの履歴を返すことができます (例: http://localhost:8080/o/c/tickets/?nestedFields=auditEvents)。 基本的なチュートリアルについては、 nestedFields を使用してエントリ履歴を監査する を参照してください。

重要

REST API を使用してエントリの履歴を表示するには、エントリに対して ViewObject Entry History の両方の権限が必要です。 詳細については、 権限フレームワーク統合 を参照してください。

エントリー履歴を有効にする

デフォルトでは、カスタムオブジェクトのエントリー履歴は無効になっています。 7.4 U72+/GA72+の場合、この設定はいつでも変更できます。 以前のバージョンでは、この設定はオブジェクト定義をパブリッシュする前にしか構成できませんでした。

エントリ履歴を有効にするには、

  1. グローバルメニューGlobal Menu)を開き、[コントロールパネル]タブに移動し、[オブジェクト]をクリックします。

  2. 目的のオブジェクト定義の編集を開始します。

  3. 詳細タブで、 エントリ履歴を有効にする を切り替えます。

    エントリー履歴を有効にします。

  4. [保存]をクリックします。

有効にすると、Liferayはエントリイベントの履歴を保持し、監査アプリケーションまたはREST API呼び出しを介してその履歴を表示できます。