CLI itemres コマンド

Version: 10.2
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

Sitecore のリソースとしてのアイテム プラグインには itemres コマンドが含まれます。このコマンドは、設定可能なオプションを使用してリソース ファイルにアイテム パッケージを作成します。

リソースとしてのアイテム プラグインをインストールするには、次のコードを実行します。

RequestResponse
dotnet sitecore plugin add -n Sitecore.DevEx.Extensibility.ResourcePackage --version 4.0.0
注記

このコマンドは、CLI 4.0 以降から使用できます。

使用方法

次のコマンドを使用できます。

RequestResponse
dotnet sitecore itemres [subcommand] [options]

サブコマンド

次のサブコマンドを使用できます。

  • create サブコマンド - リソース パッケージを作成します。

  • unicorn サブコマンド - Unicorn リソース パッケージを作成します。

  • cleanup サブコマンド - 両方のエントリのアイテム データが等しい場合、.dat ファイルに含まれるデータベース アイテムをクリーンアップします。このサブコマンドは、CLI 4.1 以降で使用できます。

create サブコマンド

create サブコマンドは新しいアイテムおよびリソース パッケージを作成します。CLI は、命名規則 items.{databaseName}.{providedName}.dat に基づいてパッケージに名前を付けます。

create サブコマンドでは、次のオプションを使用できます。

オプション

必須?

説明

-o, --output <OUTPUT>

はい

出力へのパッケージ パス (提供されていない場合は拡張子が追加されます)。

--overwrite <OVERWRITE>

いいえ

既存のパッケージを上書きします。

-i, --include <INCLUDE>

いいえ

モジュール設定を含めます。ワイルドカードと複数の値を使用できます。

-e, --exclude <EXCLUDE>

いいえ

モジュール設定を明示的に除外します。ワイルドカードと複数の値を使用できます。

-c, --config <CONFIG>

いいえ

ルート sitecore.config ディレクトリへのパス。デフォルト: 現在の作業ディレクトリ。

-v, --verbose

いいえ

追加の診断およびパフォーマンス データを報告します。

-t, --trace

いいえ

追加の診断およびパフォーマンス データを報告します。

-?, -h, --help

いいえ

コマンドのヘルプ。

create サブコマンドの使用例は、次のとおりです。

コマンド

結果

dotnet sitecore itemres create -o TestPackage

items.{databaseName}.TestPackage.dat ファイルを作成します。このファイルにはすべてのモジュールが含まれます。

dotnet sitecore itemres create -o test/TestPackage

test フォルダーに items.{databaseName}.TestPackage.dat ファイルを作成します。このファイルにはすべてのモジュールが含まれます。

重複する名前で TestPackage を作成しようとします。

dotnet sitecore itemres create -o TestPackage

パッケージを作成せず、次のメッセージを返します。

RequestResponse
"The output path items.{databaseName}.TestPackage.dat already existed, but Overwrite was false."

重複する名前で TestPackage を作成しようとします。

dotnet sitecore itemres create -o TestPackage --overwrite

パッケージを作成して上書きします。

dotnet sitecore itemres create -o TestPackage -i Project.Content.Test

パッケージを作成し、Project.Content.Test モジュールのみを含めます。

dotnet sitecore itemres create -o TestPackage -i Project.Content.Test, Project.Content

パッケージを作成し、Project.Content.Test モジュールおよび Project.Content モジュールのみを含めます。

dotnet sitecore itemres create -o TestPackage -i *Test

パッケージを作成し、Project.Content.Test モジュールのみを含めます。ワイルドカード プレフィックスで検索します。

dotnet sitecore itemres create -o TestPackage -i *Test*

パッケージを作成し、Project.Content.Test モジュールおよび Project.Content.Test1 モジュールのみを含めます。周囲のワイルドカードで検索します。

dotnet sitecore itemres create -o TestPackage -i Project*

パッケージを作成し、Project.Content モジュール、Project.Content.Test モジュール、および Project.Content.Test1 モジュールのみを含めます。ワイルドカード サフィックスで検索します。

dotnet sitecore itemres create -o TestPackage -e Project.Content.Test

パッケージを作成し、Project.Content モジュールおよび Project.Content.Test1 モジュールのみを含めて、Project.Content.Test モジュールは除外します。

dotnet sitecore itemres create -o TestPackage -e Project.Content.Test, Project.Content

パッケージを作成し、Project.Content.Test1 モジュールのみを含めて、Project.Content モジュールおよび Project.Content.Test モジュールは除外します。

dotnet sitecore itemres create -o TestPackage -e *Test

パッケージを作成し、Project.Content モジュールおよび Project.Content.Test1 モジュールのみを含めて、ワイルドカード プレフィックスで Project.Content.Test モジュールを除外します。

dotnet sitecore itemres create -o TestPackage -e *Test*

パッケージを作成し、Project.Content モジュールのみを含めて、周囲のワイルドカードで Project.Content.Test モジュールおよび Project.Content.Test1 モジュールを除外します。

dotnet sitecore itemres create -o TestPackage -e Project*

パッケージを作成し、ワイルドカード サフィックスで Project.Content モジュール、Project.Content.Test モジュール、および Project.Content.Test1 モジュールを除外します。

dotnet sitecore itemres create -o TestPackage -i Project* -e Project.Content.Test

パッケージを作成し、ワイルドカード サフィックスで Project.Content モジュールおよび Project.Content.Test1 モジュールを含めて、Project.Content.Test モジュールを除外します。

dotnet sitecore itemres create -o TestPackage -i Project.Content.Test -e Project.Content.Test

パッケージを作成せず、次のメッセージを返します。

RequestResponse
The include and exclude options contain same modules at the same time

samples フォルダーから TestPackage を作成しようとします。

dotnet sitecore itemres create -o TestPackage

パッケージを作成せず、次のメッセージを返します。

RequestResponse
error: Couldn't resolve a root configuration file (sitecore.json) in the current or any parent directory. Looks like the command may have been executed outside a Sitecore project?

samples フォルダーから TestPackage を作成しようとします。

dotnet sitecore itemres create -o TestPackage -c Prototype/

samples フォルダーにパッケージを作成します。

dotnet sitecore itemres create -o TestPackage -v

ルート設定パスやパフォーマンスのあるノードの数 (例: 73ms (8.1ms/ノード)) など、追加の診断およびパフォーマンス データを作成します。

dotnet sitecore itemres create -o TestPackage -t

FSIndex などの追加の診断およびパフォーマンス データを作成します。たとえば 70ms (9 メタデータ) でファイルシステム インデックスを読み込んだり、たとえば 1983ms (9 アイテム、220.3ms/ノード) で 1 つのツリーのパッケージを作成したりします。

unicorn サブコマンド

unicorn サブコマンドは、特定の名前形式 items.{databaseName}.{providedName}.dat で Unicorn シリアル化から新しいアイテムおよびリソース パッケージを作成します。

unicorn サブコマンドでは、次のオプションを使用できます。

オプション

必須?

説明

-p, --path <INCLUDE>

はい

unicorn シリアル化へのパス。

-o, --output <OUTPUT>

はい

出力へのパッケージ パス (提供されていない場合は拡張子が追加されます)。複数の値を使用できます。

--overwrite <OVERWRITE>

いいえ

既存のパッケージを上書きします。

-c, --config <CONFIG>

いいえ

ルート sitecore.config ディレクトリへのパス。デフォルト: 現在の作業ディレクトリ。

-v, --verbose

いいえ

追加の診断およびパフォーマンス データを報告します。

-t, --trace

いいえ

追加の診断およびパフォーマンス データを報告します。

-?, -h, --help

いいえ

コマンドのヘルプ。

unicorn サブコマンドの使用例は、次のとおりです。

コマンド

結果

dotnet sitecore itemres unicorn -p "testItem" -o "TestPackage

items.{databaseName}.TestPackage.dat ファイルを作成します。

cleanup サブコマンド

cleanup サブコマンドは、両方のエントリのアイテム データが等しい場合、.dat ファイルに含まれるデータベース アイテムをクリーンアップします。

注記

このサブコマンドは、CLI 4.1 以降で使用できます。

cleanup サブコマンドでは、次のオプションを使用できます。

オプション

必須?

説明

-c, --config <CONFIG>

いいえ

sitecore.json 設定ファイルへのパス。デフォルト: cwd。

-n, --environment-name <ENVIRONMENT_NAME>

いいえ

使用する名前付き Sitecore 環境。デフォルト: 'default'。

-v, --verbose

いいえ

追加の診断およびパフォーマンス データを報告します。

-t, --trace

いいえ

追加の診断およびパフォーマンス データを報告します。

-?, -h, --help

いいえ

コマンドのヘルプ。

cleanup サブコマンドでは、次のオプションを使用できます。

コマンド

結果

dotnet sitecore itemres cleanup

出力:

RequestResponse
Starting cleaning up databases. 
Processing...
Cleaning up databases is finished:
Cleanup of resource items is finished for 'master' database. Removed: 13 item(s).
Cleanup of resource items is finished for 'web' database. Removed: 19 item(s).
Cleanup of resource items is finished for 'webpreview' database. Removed: 17 item(s).
Cleanup of resource items is finished for 'core' database. Removed: 3 item(s).

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、