--- title: "SCCPL変換の構造" slug: "the-structure-of-an-sccpl-transformation" abstract: "この参照を使って、SCCPLパッケージの構造が正しいか確認してください。" --- # SCCPL変換の構造 Sitecore貨物ペイロード(SCCPL)パッケージは、以下の構造を持つZIPパッケージの拡張です。 指揮 概要 CopyToWebsite/\* ターゲットインストール内のWebsiteフォルダにファイルをコピーします。これを使って新しいファイルのデプロイや、リソースファイル、DLL、設定ファイルなどの既存ファイルを上書きできます。 CopyToRoot/\* Web Deployment Package(WDP)のルートにファイルをコピーします。通常、.dacpacや.sqlファイルを注入してデータベースの変更を行います。 Xdts/\* XMLファイルのXDT変換はウェブサイトのルートにあります。XDT変換を使って、WDPが展開する設定ファイルを調整し、新しい設定ファイルを追加せずに調整してください。ファイル名の規則は以下の通りです:{original file name}.xdt。 \> \[!注\] \> SCCPL変換はXMLファイルの変換に[XDT構文](https://docs.microsoft.com/en-us/previous-versions/aspnet/dd465326\(v=vs.110\))を使用し、Sitecore構成パッチ構文ではなく使用します。 IOActions/\*.ioxml WDPパッケージ内のファイルに対して行われるアクションを記述するXMLファイルです。以下の[IOアクションセクション](https://doc.sitecore.com/xp/ja/developers/sat/30/sitecore-azure-toolkit/the-structure-of-an-sccpl-transformation.html#UUID-0db37c77-158e-cc5e-5811-f6dab25c3f6c_section-idm45765716462176)の例を参照してください。 ## SCCPLパッケージの構造 以下の例はSCCPLパッケージの構造を示しています。 パッケージ 概要 CopyToWebsite\\App\_Config\\Include\\Component.config 新しいコンポーネントの設定ファイル、Sitecoreへの統合。 CopyToWebsite\\bin\\Component.dll コンポーネントのDLLファイルです。 CopyToWebsite/sitecore/shell/client/Applications/Component/page.cshtml リソースファイル - MVCページビュー。 Xdts\\App\_Config\\ConnectionStrings.config.xdt XDT変換:新しいコンポーネントに接続文字列を追加すること。 IOActions\\Component.ioxml 設定ファイルの有効化/無効化。 ## 基本的なSCCPLパッケージ SCCPLパッケージを使うことで、Sitecoreソリューションを自分のニーズに合わせて微調整できます。これを行うには2つの異なるアプローチがあります: - 現在のSCCPLを調整してください。 > !注このオプションを選ぶと、更新時にブランチとマージが必要です。 - 現在のSCCPLを基にCargoフォルダ(CargoフォルダにはSCCPLが含まれています)を基に新しいSCCPLを作成します。そして、関連するSKUファイルを追加します($SKU.packaging.config.jsonでは[SCCPLの処理方法を学](https://doc.sitecore.com/xp/ja/developers/sat/30/sitecore-azure-toolkit/packaging-a-sitecore-solution-for-the-microsoft-azure-app-service.html "Packaging a Sitecore solution for the Microsoft Azure App Service")べます)。 以下の表は基本的なSitecore SCCPLパッケージの概要です: パッケージ 概要 Sitecore.Cloud.Search.Azure.sccpl Azure Cognitive Searchプロバイダーを使ってweb.configファイルを変換します。また、cloud.searchの接続文字列にConnectionStrings.configファイルを追加するパッチでもあります。 Sitecore.Cloud.ApplicationInsights.sccpl Application Insightsの設定ファイルを\*/baseおよびApp\_Config/Sitecore/Azure/\*フォルダに、アセンブリファイルを\*/bin\*フォルダにコピーします。 ConnectionStrings.configファイルは変換されてappinsights.instrumentationkey接続を追加し、Application Insightsの設定でweb.configファイルを更新します。 Sitecore.Cloud.DisableAnalytics.sccpl XM WDPに対して現在のSCCPLを適用します。これにより、 ConnectionStrings.configファイルのAnalyticsおよびXConnectの接続文字列が無効になり、Sitecore.Xdb.configファイルのXdb.Enabled設定もオフになります。 Sitecore.Cloud.DisableExm.sccpl XM WDPに対して現在のSCCPLを適用します。これによりConnectionStrings.configファイルのEXM接続文字列が無効化され、Sitecore.EmailExperience.Core.configファイルのEXM.Enabled設定がオフになります。 Sitecore.Cloud.Common.sccpl すべてのWDPに共通するSCCPLです。このパッケージの主な動作は以下の通りです: - データフォルダをD:\\home\\site\\wwwroot\\App\_Data - Sitecoreライセンスのプレースホルダー作成 - Sitecore.Diagnostics.configファイルの無効化 - customErrors モード設定の値を「Off」に変更する(customErrors mode="Off") Sitecore.Cloud.HttpsRedirection.sccpl すべてのWDPに共通するSCCPLです。このパッケージはweb.configファイルを変換してhttpsリダイレクトを適用します。 Sitecore.Cloud.IPSecurity.sccpl CM、Processing、DDSの役割へのアクセスを制限するためにIPフィルタリングの例を付けてweb.configファイルを更新します。 Sitecore.Cloud.Redis\_CD.sccpl CD WDPのSCCPLをXMおよびXPトポロジーに適用し、Redisキャッシュの設定と接続文字列を有効にします。 Sitecore.Cloud.RoleSpecific\_CD.sccpl CD WDPのSCCPLをXMおよびXPトポロジーに適用します。 このパッケージの主な行動には以下が含まれます: - web.configファイルで*WDP*ロールをContentDelivery に設定しています。 - connectionstrings.configファイル内の*CD*ロールの正しい接続文字列リストを設定すること。 Sitecore.Cloud.RoleSpecific\_CM.sccpl CM WDPのSCCPLをXMおよびXPトポロジーに適用します。 このパッケージの主な行動には以下が含まれます: -  web.configファイルで*WDP*ロールをContentManagement に設定します。 - connectionstrings.configファイル内の*CM*役割の正しい接続文字列リストを設定する方法 Sitecore.Cloud.RoleSpecific\_DDS.sccpl DDSの役割に対するSCCPLをXPトポロジーに適用します。 このパッケージの主な動作は以下の通りです: - WDP ロールを web.config ファイルで ContentManagement、DedicatedDispatch に設定します。 Sitecore.Cloud.RoleSpecific\_PRC.sccpl DDSロールの正しい接続文字列リストを設定し、XPおよびxDBトポロジーにPRC WDPを適用します。 このパッケージの主な行動には以下が含まれます: - web.configファイルでWDPロールを*Processing*に設定します。 - connectionstrings.configファイル内の*PRC*ロールの正しい接続文字列リストを設定すること。 Sitecore.Cloud.RoleSpecific\_REP.sccpl CM WDPのSCCPLをXPおよびxDBトポロジーに適用します。 このパッケージの主な行動には以下が含まれます: - web.configファイルでWDPロールを*Reporting*に設定します。 - connectionstrings.configファイル内の*REP*ロールの正しい接続文字列リストを設定すること。 Sitecore.Cloud.RoleSpecific\_XDBSingle.sccpl Sitecore Single WDPのSCCPLをxDB Single Toologyに適用します。 このパッケージの主な行動には以下が含まれます: - WDPロールを処理、報告に設定web.config file。 - connectionstrings.configファイル内のシングル(PRC+REP)役割の正しい接続文字列リストを設定すること。 Sitecore.Cloud.RoleSpecific\_XMSingle.sccpl Sitecore Single WDPのSCCPLをXMシングルトポロジーに適用します。 このパッケージの主な行動には以下が含まれます: - web.configファイルで WDP ロールを*ContentManagement*に設定*ContentDelivery*。 - connectionstrings.configファイル内のSingle(CM+CD)役割の正しい接続文字列リストを設定すること。 Sitecore.Cloud.RoleSpecific\_XPSingle.sccpl Sitecore Single WDPのSCCPLをXP Single Toologyに適用します。 このパッケージの主な動作は以下の通りです: - connectionstrings.configファイル内のSingle(CM+CD+PRC+REP)役割の正しい接続文字列リストを設定すること。 Sitecore.Cloud.Security.sccpl データベースアカウント作成スクリプトをウェブサイトのrootにコピーし、セキュリティルールで web.config fileを変換します。 Sitecore.Cloud.Security\_CD.sccpl CDロールのセキュリティルールでweb.configファイルを変換します。 Sitecore.Cloud.SetCompatibilityLevel.sccpl SQLサーバーの互換性レベルのスクリプトをウェブサイトのルートにコピーします。 Sitecore.Cloud.Thundercracker.sccpl このパッケージの主な行動には以下が含まれます: - *UploadWatcher*フォルダ機能の削除(Azureには適用できないため)。 - *Media.CacheFolder*フォルダの場所を変更すること。 - PageStateStore とViewStateStore 設定を変更してDBに書き込みます。 ## IOActions IOActionsはパス属性とアクション属性を持つ.ioxmlファイルで記述されます。有効化、無効化、削除のアクション値、そして以下の構造です。 … 属性 概要 経路 変更したいファイルのパスを、*Website*フォルダに対して相対的に設定します。 値は単一のファイルへの正確なパスで、期待される拡張子も含めてなければなりません。ワイルドカードはサポートされていません。 作戦 ファイルレベルで実行される操作(有効化、無効化、削除)です。 輸入輸出アクション 概要 有効化 設定ファイルを\*.config.disabledまたは\*.config.exampleから にリネームして有効化\*.config。 無効化 設定ファイルを\*.configから\*.config.disabledにリネームして無効にしてください。 DELETE パッケージからファイルを削除してください。