---
title: "エンティティジャーナリング"
slug: "entity-journaling"
abstract: "事業体に加えられたすべての変更を完全なログで保存するための商務関連の事業体ジャーナリングの概要。"
---
# エンティティジャーナリング

Commerce Engineは、商務機能をカスタマイズできる拡張可能なサービスを包含しています。

> !注標準のポリシーを拡張したり継承したりしないでください。代わりに、自分で作成した方が良いです。ポリシーの値を変更するには、ポリシーの定義先に応じてPolicySet JSONやEnvironment JSONを変更し、その後Bootstrapを再実行できます。

エンティティタイプが有効になると、エンティティジャーナリングはエンティティが変更されるたびにジャーナルを更新するフラグを設定します。ジャーナリングプロセスは変更されたエンティティの前バージョンの完全なコピーを保存し、すべての変更のログを提供します。

> !注ジャーナリングのエントリは、変更されたエンティティのフィールドやプロパティだけでなく、エンティティ全体のコピーを作成するため、共有環境データベースのサイズを大幅に増加させることができます。例えば、注文ステータスが変わるたびに、注文エンティティの完全なコピーがデータベースに保存されます。
> 
> Sitecore 10.1以降は、Commerce Engineを注文 [ジャーナリングのエントリ](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/entity-archiving.html "Entity archiving") ーをアーカイブする設定ができ、共有環境データベース内の注文ジャーナリングエントリの数を減らすことができます。
> 
> あるいは、監査義務のない商務法人に対して [エンティティジャーナル機能を無効](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/entity-journaling.html#UUID-8f1dde43-838b-133b-6b55-45da1280e93b_section-idm231984773860149 "Change Commerce Entity journaling configuration") にすることも検討できます。

以下のポリシーはJournalingプラグインを通じて設定できます。

方針

概要

プロパティ/デフォルト値

EntityJournalingPolicy

ジャーナルリストの名前とエンティティタイプを定義します。

ジャーナル \\ 「エンティティジャーナル」  
  
EntityFullName\\ 文字列。空

以下はEntityJournalingPolicyの例です:

{
 EntityFullName = "Sitecore.Commerce.Plugin.Orders.Order",
 Journal = "OrdersJournal"
 }

EntityPersistenceJournalingBlockはエンティティのジャーナル化に関するルールを調査するためにEntityJournalingPolicyをチェックします。

## Commerceエンティティのジャーナル構成を変更する

Commerce Entityのジャーナリングは、Commerce環境の設定ファイルでEntityJournalingPolicyポリシーを変更することで有効または無効にできます。例えば、サンプルのHabitat Authoring環境でジャーナルリングの動作を変更するには、wwwroot\\CommerceAuthoring\_Sc\\wwwroot\\data\\EnvironmentsPlugIn.Habitat.CommerceAuthoring-\*.\*.\*.jsonファイルを修正します。

例えば、サンプルのHabitat Authoring環境における顧客エンティティの変更をジャーナル作成可能にするために:

1.  wwwroot\\CommerceAuthoring\_Sc\\wwwroot\\data\\EnvironmentsPlugIn.Habitat.CommerceAuthoring-\*.\*.\*.jsonファイルを開け。
    
2.  ファイル内にEntityJournalingPolicyポリシーを追加し、エンティティ名(EntityFullName)とジャーナル名を指定します。
    
    "$type": "Sitecore.Commerce.Plugin.Journaling.EntityJournalingPolicy, Sitecore.Commerce.Plugin.Journaling",
     "EntityFullName": "Sitecore.Commerce.Plugin.Customers.Customer",
     "Journal": "CustomersJournal"
    
3.  変更を保存して [、Commerce Engineをブートストラップしてください](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/bootstrap-the-commerce-engine.html "Bootstrap the Commerce Engine")。
    
    > !注特定のCommerceエンティティタイプのジャーナリングを無効にするには、環境設定ファイルから対応するEntityJournalingPolicyポリシーブロックを削除してください。
    > 
    > 以前に有効だったエンティティでジャーナルが無効になった場合、その仕訳は削除されません。単に新しいエントリーが作成されなくなるだけです。