CLI purge contactsコマンド

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

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

xConnect DevEx CLIプラグインには、contactsサブコマンドを含むpurgeコマンドが含まれています。このコマンドは、指定されたCutoffDaysと条件に基づいてパージ プロセスを開始します。

使い

このコマンドは、次のように使用できます。

sitecore xconnect purge contacts [subcommand] [options]

サブコマンド

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

サブコマンド

形容

start

連絡先のパージ タスクを登録します。

オプション

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

オプション

必須。

形容

-c, --config

はい

sitecore.json設定ファイルへのパス (デフォルト: cwd)。DevEx CLI標準オプション。

-n, --environment-name

はい

使用するSitecore環境。デフォルト: default。DevEx CLI標準オプション。

-d, --cutoffdays

はい

コンタクトがブランドとやり取りしていない日数。たとえば、-d 190.

メモ

このオプションは、デフォルト値がない唯一の要件です。

cutoffdaysオプションには、次の制限のリストがあります。

--sp, --start-percentile

いいえ

データ抽出の範囲に縛られた開始パーセンタイル。たとえば、--sp 0.

start-percentileオプションには、次の制限のリストがあります。

  • 開始パーセンタイルと終了パーセンタイルの両方を指定するか、どちらも指定しないかする必要があります。

  • 両方の範囲バウンドは0から1の間です。

  • start-percentileend-percentileより低くなければなりません。

--ep, --end-percentile

いいえ

データ抽出の範囲に縛られた終了パーセンタイル。たとえば、--ep 1.

end-percentileオプションには、次の制限のリストがあります。

  • 開始パーセンタイルと終了パーセンタイルの両方を指定するか、どちらも指定しないかする必要があります。

  • 両方の範囲バウンドは0から1の間です。

  • end-percentilestart-percentileよりも高くなければなりません。

--cds, --conditions

いいえ

連絡先のパージのための追加のフィルター条件のコンマ区切りリスト。条件をカスタマイズして登録し、さらにデータをフィルタリングできます。たとえば、--cds AnonymousCondition.

存在しない条件が指定されている場合、タスクの登録は失敗します。見つからない条件のリストはCLI出力にあります。

手記

制限とカスタム条件の作成方法の詳細については、「 チュートリアル: 連絡先の削除条件のカスタマイズ 」を参照してください。

-b, --batch-size

はい

パージタスクが使用する連絡先データ抽出のバッチサイズ。たとえば、-b 200.

-v, --verbose

いいえ

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

-t, --trace

いいえ

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

--confirm

いいえ

すべてのプロンプトを自動的に確認します。

-?, -h, --help

いいえ

コマンドのヘルプ。

次に、purge contactsコマンドの使用例を示します。

sitecore xconnect purge contacts start -d 180

sitecore xconnect purge contacts start -d 180 --sp 0 --ep 1 -b 200 --cds AnonymousCondition --trace --verbose

タスク登録の確認またはキャンセル

purge contacts startコマンドは、このコマンドによってデータが削除されるという確認をエンド ユーザーに送信します。

ユーザーは、Yまたは次のように入力してタスクの登録を確認できますy

タスクの登録が成功すると、タスク のステータス の取得やタスク のキャンセル など、今後のアクションのために保持できるタスクIDが返されます。

ユーザーは、Nまたはnでタスク登録をキャンセルすることもできます。その他の文字を入力すると、タスク登録がキャンセルされ、確認応答が無効であることを示す通知が表示されます。

オプション --confirmを使用して、タスク登録のサイレント確認を行うことができます。その場合、プロンプトは表示されません。

タスクが正常に登録された結果、タスクIDと、パージ タスクの取り消しとステータスの取得のためのサンプル コマンドが生成されます。

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