1. Creative Exchangeの操作

CIサーバーからCreative Exchangeをトリガー

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

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

SXAサイトのスタイルをすばやく変更するには、継続的インテグレーション (CI) サーバーからCreative Exchangeをトリガーできます。継続的インテグレーションを使用すると、コードの変更をリポジトリのメイン ブランチに定期的に統合し、変更をできるだけ早期に、頻繁にテストできます。

メモ

Creative Exchangeデプロイメントの自動化に取り組む前に、 Sitecore PowerShell Extensions Web APIの使用方法を理解する必要があります。

トリガーのエクスポートとインポート

単純なWebリクエストを使用してエクスポートとインポートをトリガーするには:

  • Creative Exchangeのインポートとエクスポートのエンドポイントを作成します。例については、以下を参照してください。

    /sitecore/system/Modules/PowerShell/Script Library/SXA/SXA - Creative Exchange/Web API/ce-export
/sitecore/system/Modules/PowerShell/Script Library/SXA/SXA - Creative Exchange/Web API/ce-import
    Create endpoints
手記

Webリクエスト アイテムは、次のリリースで上書きされる可能性があるため、SXAルートの下に保存しないでください。

  1. importセクションで、コマンドレットをインポートします。

    Get-CreativeExchangeExportResponse

    Get-CreativeExchangeImportResponse

  2. パスを指定します。例えば：

    $item = Get-Item -Path "/sitecore/content/Tenant/Site/Home"

  3. コマンドレットとそのパラメーターを指定します。例えば：

    $exportArgs = Get-CreativeExchangeExportResponse -CurrentItem $item -DeviceId "{FE5D7FDF-89C0-4D99-9AA3-B5FBD009C9F3}"

    パラメータを変更して、 インポート/エクスポート ・オプションを変更できます。

  4. エクスポート/インポートが完了すると、結果として $exportArgs/$importArgsオブジェクトが取得されます。

    • $exportArgs (Sitecore.XA.Feature.CreativeExchange.Pipelines.Export.Export.ExportArgs)

    • $importArgs

    • (Sitecore.XA.Feature.CreativeExchange.Pipelines.Export.Export.ImportArgs)

  5. $responseObjectオブジェクトを使用して、パラメーターの内容を取得します。

    これを使用して必要な情報を取得し、Web API応答として返すことができます。次の例では、動的オブジェクトを作成し、指定したオブジェクトをJSON形式にシリアル化しました。

    Import-Function Get-CreativeExchangeExportResponse
$item = Get-Item -Path "/sitecore/content/Tenant/Site/Home"
$exportArgs = Get-CreativeExchangeExportResponse -CurrentItem $item -DeviceId "{FE5D7FDF-89C0-4D99-9AA3-B5FBD009C9F3}"
$responseObject = @{
    "Messages" = $exportArgs.Messages;
    "Result"   = $exportArgs.CreativeExchangeExportStorage.GetResult()
}
Set-HostProperty -HostWidth 9999
[Newtonsoft.Json.JsonConvert]::SerializeObject($responseObject)

Get-CreativeExchangeExportResponseコマンドレットを使用してエクスポート オプションを変更する

次の表では、使用可能なGet-CreativeExchangeExportResponseコマンドレット パラメーターについて説明します。

エクスポート オプションを変更するには:

  • Get-CreativeExchangeExportResponseコマンドレットのパラメーターを変更します。

    Type

    Name

    Mandatory

    Default

    Item

    現在のアイテム

    真

    Sitecore.XA.Feature.CreativeExchange.Storage.CreativeExchangeStorageDefinition

    ストレージ定義

    偽

    "Folder on server"

    Sitecore.XA.Feature.CreativeExchange.Enums.MarkupMode

    マークアップモード

    偽

    Sitecore.XA.Feature.CreativeExchange.Enums.MarkupMode::AgencyDrop

    Sitecore.XA.Feature.CreativeExchange.Enums.ExportScope

    エクスポートスコープ

    偽

    Sitecore.XA.Feature.CreativeExchange.Enums.ExportScope::Site

    Sitecore.XA.Feature.CreativeExchange.Enums.BucketExportMode

    バケットエクスポートモード

    偽

    Sitecore.XA.Feature.CreativeExchange.Enums.BucketExportMode::OneOfTemplate

    string

    言語

    偽

    "en"

    int

    ファイルサイズ制限

    偽

    0

    Sitecore.Data.ID

    デバイスID

    偽

    "{FE5D7FDF-89C0-4D99-9AA3-B5FBD009C9F3}"

    string

    ユーザー名

    偽

    "sitecore\\admin"

Get-CreativeExchangeImportResponseコマンドレットを使用してインポート オプションを変更する

次の表では、使用可能なGet-CreativeExchangeImportResponseコマンドレット パラメーターについて説明します。

インポート・オプションを変更するには:

  • Get-CreativeExchangeImportResponseコマンドレットのパラメーターを変更します。

    Type

    Name

    Mandatory

    Default

    Item

    現在のアイテム

    真

    Sitecore.XA.Feature.CreativeExchange.Storage.CreativeExchangeStorageDefinition

    ストレージ定義

    偽

    "Folder on server"

    int

    ファイルサイズ制限

    偽

    0

    Sitecore.Data.ID

    デバイスID

    偽

    "{FE5D7FDF-89C0-4D99-9AA3-B5FBD009C9F3}"

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