CLI itemresコマンド

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

このページの翻訳は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).

この記事を改善するための提案がある場合は、 お知らせください!