CLI itemresコマンド
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore Items as Resourcesプラグインにはitemresコマンドが含まれています。このコマンドは、設定可能なオプションを持つリソースファイル内にアイテムパッケージを作成します。
Items as Resourcesプラグインをインストールするには、以下のコードを実行します。
dotnet sitecore plugin add -n Sitecore.DevEx.Extensibility.ResourcePackage --version 4.0.0
!注このコマンドはCLI 4.0以降から利用可能です。
使用例
コマンドの使い方は以下の通りです:
dotnet sitecore itemres subcommand options
サブコマンド
以下のサブコマンドを使用できます:
- createサブコマンド - リソースパッケージを作成します。
- unicornサブコマンド - ユニコーンリソースパッケージを作成します。
- cleanupサブコマンド - .datファイル内のデータベース項目を、両方のエントリのアイテムデータが等しい場合にクリーンアップします。このサブコマンドはCLI 4.1以降で利用可能です。
createサブコマンド
createサブコマンドは新しいアイテムおよびリソースパッケージを作成します。CLIは慣例items.{databaseName}.{providedName}.datに基づいてパッケージ名を付けます。
createサブコマンドで以下のオプションを使用できます:
オプション
必須ですか?
概要
-o, --output
はい
パッケージから出力へのパス(提供されていない場合は拡張を追加します)。
--overwrite
いいえ
既存のパッケージを上書きします。
-i, --include
いいえ
モジュール構成を含めること。ワイルドカードや複数の値を許可しています。
-e, --exclude
いいえ
モジュール構成は明示的に除外してください。ワイルドカードや複数の値は許可されています。
-c, --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 を作成しようとすると sitecore itemres create -o TestPackage: パッケージが作成されず、以下のメッセージが表示されます:
"The output path items.{databaseName}.TestPackage.dat already existed, but Overwrite was false."
- 重複名で TestPackage を作成しようとします 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.Testモジュールを除くProject.ContentとProject.Content.Test1モジュールのみを含みます。
- dotnet sitecore itemres create -o TestPackage -e Project.Content.Test, Project.Contentパッケージを作成し、Project.ContentおよびProject.Content.Testモジュールを除きProject.Content.Test1モジュールのみを含みます。
- dotnet sitecore itemres create -o TestPackage -e *Testパッケージを作成し、ワイルドカード接頭辞の Project.Content.Test モジュールを除き、Project.Content と Project.Content.Test1 モジュールのみを含みます。
- 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: はパッケージを作成せず、以下のメッセージで返されます:
The include and exclude options contain same modules at the same time
- samplesフォルダからTestPackageを作成しようとします sitecore itemres create -o TestPackage: パッケージを作成できず、以下のメッセージが表示されます:
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を作成しようとします sitecore itemres create -o TestPackage -c Prototype/: samplesフォルダにパッケージを作成します。
- dotnet sitecore itemres create -o TestPackage -v: ルート設定パスやパフォーマンスを持つノード数(例、8.1ms/node)などの追加の診断および性能データを作成します。
- dotnet sitecore itemres create -o TestPackage -t: FSIndex のような追加の診断およびパフォーマンスデータを作成します。例えば、ファイルシステムのインデックスを70ms(9メタデータ)で読み込み、1983ms(9項目、220.3ms/node)で1ツリーのパッケージを作成した場合などです。
ユニコーン副司令部
unicornサブコマンドはUnicornシリアライズから特定の名前フォーマットitems.{databaseName}.{providedName}.datで新しいアイテムおよびリソースパッケージを作成します。
unicornサブコマンドで以下のオプションを使用できます:
オプション
必須ですか?
概要
-p, --path
はい
ユニコーン・シリアライズへの道。
-o, --output
はい
パッケージの出力パス(提供されていない場合は拡張を追加します)。複数の値を許可しています。
--overwrite
いいえ
既存のパッケージを上書きします。
-c, --config
いいえ
ルート sitecore.config ディレクトリへのパス。デフォルト
。-v, --verbose
いいえ
追加の診断およびパフォーマンスデータを報告してください。
-t, --trace
いいえ
追加の診断およびパフォーマンスデータを報告してください。
-?, -h, --help
いいえ
コマンドの助けを。
以下はunicornサブコマンドの使用例です。
指揮
結果
dotnet sitecore itemres unicorn -p "testItem" -o "TestPackage
items.{databaseName}.TestPackage.datファイルを作成します。
清掃小隊
cleanupサブコマンドは、.datファイルに含まれるデータベース項目を、両方のエントリの項目データが等しい場合にクリーンアップします。
!注このサブコマンドはCLI 4.1以降で利用可能です。
cleanupサブコマンドで以下のオプションを使用できます:
オプション
必須ですか?
概要
-c, --config
いいえ
sitecore.json設定ファイルへのパス。デフォルト
。-n, --environment-name <ENVIRONMENT_NAME>
いいえ
使用Sitecore環境の名前付き。デフォルト: 'default'。
-v, --verbose
いいえ
追加の診断およびパフォーマンスデータを報告してください。
-t, --trace
いいえ
追加の診断およびパフォーマンスデータを報告してください。
-?, -h, --help
いいえ
コマンドの助けを。
cleanupサブコマンドで以下のオプションを使用できます:
- コマンド
- dotnet sitecore itemres cleanup:出力:
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).