サイトとテナントのスキャフォールディングにモジュールを追加する

テナント アイテムを追加する

場所

テナントの下に新しいアイテムを追加します。

テンプレート

新しいテナント アイテムの作成に使用されるテンプレート。

名前

アイテム名。

フィールド

作成後に新しいアイテムのフィールドを設定するためのフィールドと値のマッピング。

テナント テンプレートを編集する

テンプレート

テナント テンプレートにコピーするテンプレートを選択します。定義された設定に従ってテンプレートが編集されます。

アクションのタイプ

アクション タイプを選択します。

ベース テンプレートまたは挿入オプション テンプレート

前のフィールドで選択したアクションの引数として使用するアイテムを選択します。

テナント スクリプトの実行

スクリプト

実行する PowerShell スクリプトを選択します。スキャフォールディング スクリプトを使用して、サイトまたはテナントの作成プロセスの一部を自動化できます。以下に例を示します。

function Invoke-ModuleScriptBody {
[CmdletBinding()]
    param(
        # Depending on context could be a Tenant or Site item
    [Parameter(Mandatory=$true, Position=0 )]
[Item]$Root,
[Parameter(Mandatory=$true, Position=1 )]        
        [Item[]]$TenantTemplates                
    )
begin {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Begin"
}
process {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Process"
        # Script body
        # Put your custom logic here
}
end {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - End"
}
}

サイト アイテムを追加する

場所

サイトの下に新しいアイテムを追加します。

テンプレート

新しいサイト アイテムの作成に使用されるテンプレート。

名前

新しいサイト アイテムの名前。

フィールド

作成後に新しいアイテムのフィールドを設定するためのフィールドと値のマッピング。

サイト アイテムを編集する

テンプレート

追加の挿入オプションを追加してサイト アイテムを編集します。

アクションのタイプ

アクション タイプを選択します。

挿入オプション

アイテムの挿入オプションを定義します。

サイト スクリプトを実行する

スクリプト

実行する PowerShell スクリプトを選択します。スキャフォールディング スクリプトを使用して、サイトまたはテナントの作成プロセスの一部を自動化できます。以下に例を示します。

function Invoke-ModuleScriptBody {
[CmdletBinding()]
    param(
        # Depending on context could be a Tenant or Site item
    [Parameter(Mandatory=$true, Position=0 )]
[Item]$Root,
[Parameter(Mandatory=$true, Position=1 )]        
        [Item[]]$TenantTemplates                
    )
begin {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Begin"
}
process {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - Process"
        # Script body
        # Put your custom logic here
}
end {
Write-Verbose "Cmdlet Invoke-ModuleScriptBody - End"
}
}

編集テーマを編集する

ベース テーマ

編集テーマ インスタンスに追加するベース テーマのリスト。

サイトのテーマを編集する

ベース テーマ

編集テーマ インスタンスに追加するベース テーマのリスト。

設定後のステップ

スクリプト

実行する PowerShell スクリプトを選択します。サイトが作成されたら、スキャフォールディング スクリプトを使用してアクションを実行できます。

function Invoke-Step {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Sitecore.XA.Foundation.Scaffolding.Models.CreateNewSiteModel]$Model
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }
}

入力検証ステップ

スクリプト

実行する PowerShell スクリプトを選択します。サイトを作成する前に、スキャフォールディング スクリプトを使用してモデルを検証できます。いずれかの検証スクリプトによって返された結果が false の場合、[新しいサイト] ダイアログ ボックスが再度表示され、以前に選択した値の一部を修正できます。

function Invoke-Validation {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Sitecore.XA.Foundation.Scaffolding.Models.CreateNewSiteModel]$Model
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"    
        # Return $true or $false as a result of validation
        $true
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }

設定後のステップ

スクリプト

実行する PowerShell スクリプトを選択します。テナントが作成されたら、スキャフォールディング スクリプトを使用してアクションを実行できます。

function Invoke-Step {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Sitecore.XA.Foundation.Scaffolding.Models.CreateNewTenantModel]$Model
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }
}

入力検証ステップ

スクリプト

実行する PowerShell スクリプトを選択します。テナントを作成する前に、スキャフォールディング スクリプトを使用してモデルを検証できます。いずれかの検証スクリプトによって返された結果が false の場合、[新しいテナント] ダイアログ ボックスが再度表示され、以前に選択した値の一部を修正できます。

function Invoke-Validation {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Sitecore.XA.Foundation.Scaffolding.Models.CreateNewTenantModel]$Model
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"
        # Return $true or $false as a result of validation
        $true
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }
}

削除前のステップ

スクリプト

実行する PowerShell スクリプトを選択します。スキャフォールディング スクリプトを使用して、サイトまたはテナントの削除プロセスの一部を自動化できます。このアクションは、Remove-Tenant または Remove-Site コマンドレットが呼び出されたときに実行されます。カスタム モジュールによって作成されたアイテムは、デフォルトの削除プロセスでは削除されないため (アイテムが異なるフォルダーにある場合など)、このスクリプトを使用して削除できます。

function Invoke-Step {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Item]$Root
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }
}

削除後のステップ

スクリプト

実行する PowerShell スクリプトを選択します。スキャフォールディング スクリプトを使用して、サイトまたはテナントの削除プロセスの一部を自動化できます。このアクションは、Remove-Tenant または Remove-Siteコマンドレットが呼び出されたときに実行されます。このスクリプトを使用して、標準の削除では削除されない、カスタム モジュールによって作成されたアイテムを削除できます (テナント/サイト ルート アイテム、テナント/サイト メディア ライブラリ、テナント テンプレートなどの一般的なフォルダー外にアイテムを保存した場合など)。

function Invoke-Step {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Item]$Root
    )
    begin {
        Write-Verbose "Cmdlet Invoke-PostDeleteStep - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-PostDeleteStep - Process"
    }
    end {
        Write-Verbose "Cmdlet Invoke-PostDeleteStep - End"
    }
}

削除前の検証ステップ

実行する PowerShell スクリプトを選択します。スキャフォールディング スクリプトを使用して、サイトまたはテナントの削除プロセスの一部を自動化できます。以下に例を示します。

テナントまたはサイトを削除する前に、スキャフォールディング スクリプトを使用して状態を検証できます。いずれかの検証スクリプトによって返された結果が false の場合、削除操作はキャンセルされます。

function Invoke-Validation {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true, Position = 0 )]
        [Item]$Root
    )
    begin {
        Write-Verbose "Cmdlet Invoke-Validation - Begin"
    }
    process {
        Write-Verbose "Cmdlet Invoke-Validation - Process"
        # Return $true or $false as a result of validation
        $true
    }
    end {
        Write-Verbose "Cmdlet Invoke-Validation - End"
    }
}