ウォークスルー

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

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

Document Publisherのユーザーが文書内のテキストおよび画像フレームの内容を変更できるようにするために、オブジェクトレンダリングはSitecore.Odg.configファイル(Website/App_Config/Include/PXM/Sitecore)で設定されています。Odg.config。デフォルトでは、Sitecore.Odg.configファイルにはテキストおよび画像フレームの内容を変更するキーが含まれています。

このウォークスルーでは、ODGのDocument Publisherモジュールで編集機能を追加する方法を説明します。このウォークスルーの例では、図形のZインデックスを編集できる機能を追加する方法が示されており、これによりDocument Publisherユーザーがページ上の図形の位置を配置できます。Zインデックスでは、各コンテンツ項目に番号を割り当てることができます。数字の大きいアイテムは、数字の小さいアイテムと重なります。以下のスクリーンショットでは、Document Publisherのユーザーが長方形の幅、高さ、x/y位置、Zインデックスを調整できます。

333C5D00E234414F98409D2812B40002.png

このウォークスルーでは、以下の方法を説明します:

オブジェクトを追加してください

デフォルトでは、Document Publisherユーザーはテキストや画像フレームの内容を編集できます。例えば、Sitecore.Odg.configファイルにオブジェクトレンダリングを追加することで、Document Publisherの編集オプションをカスタマイズできます。例えば、形状のオブジェクトレンダリングを追加して。

オブジェクトを追加するには:

  • 例えば、Print Studioのオブジェクトの中から、shape(P_Rectangle(sitecore\Templates\Print Studio Templates\Publishing Engine)を選びます。

    008F3249EC9D4B14B6E6CF1029E213FB.png

!注このウォークスルーの例には、Sitecore Rocks Visual Studioプラグインが必要です。

  • Sitecore.Odg.configファイルで新しいオブジェクト用の線を追加します。デフォルトの線の一つをコピーして変更できます。形状に対して適切な既存レンダリングは、アイテムID {CC74880A-49B7-474F-9E2B-69A05413FA87}.

    633721F63AA24AB689EF43B54C8FA0BE.png

    形状にはデータが含まれていないため、dataRenderingIdは空のままにしておいても構いません。今のところ、type key="P_Rectangle"行をSitecoreに追加できます。Odg,configファイル:

    これで3次元、つまり奥行きの追加レンダリングを設定できます。

新しいテンプレートを作成する

新しいアイテムは既存のデータテンプレートに定義されていない追加のレンダリングが必要なため、新しいテンプレートを作成する必要があります。

新しいZ-Indexレンダリング用のテンプレートを作成するには:

  • テンプレートを追加したいフォルダを右クリックし、「 追加、新しいアイテム」をクリックします。

    02AFE69DAD9244A0B4352D3FC3489FEA.png

!注新しいテンプレートをODGフォルダに保存しないでください。なぜなら、ODGを更新する際にテンプレートが失われるからです。

  1. 新しい アイテムを追加 ダイアログボックスの/sitecore/templates/System/Templatesの下、「 Template 」をクリックしてアイテム名を入力し、「 **OK」**をクリックします。

    1815A04CCB2947FBAF7748208F2F2D37.png
  2. 標準フィールド項目を作成するには、新しいテンプレートを右クリックして「 標準値を作成」をクリックします。

  3. これでコントロール用のスピークレイアウトの編集を始められます。ZIndexEditテンプレートの 標準値 項目を右クリックし、「 タスク、デザインレイアウト」をクリックしてください。

  4. Speak-EmptyLayoutをブラウズして選択し、OKをクリックします。

    D4B61370294048A296E77C952DC759CB.png
  5. 「レンダリングを追加」をクリックし、SubPageCodeレンダリングを選択し、「**OK」**をクリックします。

    53A8D00406CD4213A077AD9291666A45.png
  6. SubPageCodeレンダリングをダブルクリックしてレンダリングのプロパティダイアログを開き、必要なJavaScriptファイルへのパスを入力します。この例では:/sitecore/shell/client/Your Apps/Samples/Z-index Rendering/ZIndexEdit.js。

    D1FE06F0882245CEBC188431D7CEED12.png
  7. 次にラベルとテキストボックスのレンダリングを追加してください。見た目を改善するために追加のレンダリングも追加できます。

    1578C177D8194EDA88DDE3C3A2AFA420.png

コントロールを追加

これで、Document Publisherユーザーがコンテンツ項目のZ-Indexフィールドを変更できるコントロールを追加できます。レンダリングテンプレートはSitecore/client/Your Apps/...に保存されています。コアデータベースに。コントロールを追加し、以前作成したテンプレートを添付して、設定ファイルに必要なItem IDを取得します。

コントロールを追加すると:

  • 新しいアイテムをZIndexEditRenderingで作成した場所を右クリックし、先ほど作成したZIndexEditテンプレートを選択して新しいアイテムを追加してください。

    0E8D22CBF42D4D45865B6DF84C5D70E1.png

    ZIndexEditRenderingのItem IDは、設定ファイルでrenderingIdやadditionalRenderingsに使えるIDです。

    25D77EC9879747ECA128769090E41F1C.png

コードを書いてください

以下はテンプレートで参照されているJavaScriptコードの例です。テンプレートを作成する前にこのコードを書く必要があります。

  1. /sitecore/shell/client/Your Apps/Samples/Z-IndexRenderingにアクセスし、フォルダ(例

    )とファイル(例: ZIndexEdit.js
    )を作成します。このコントロールは、編集コントロールに渡されるアイテムのZ-Indexフィールドを変更する責任を負います。

    472801C232224D299713FDD08BB5813C.png
  2. Z-Indexフィールド値の表示および変更を可能にするコードを書きます。スクリプトには以下のメソッドが含まれなければなりません:

    • isValid - 入力の検証。
    • hasChanges - 変更がないか確認するため。
    • acceptChanges - 保存後の追加操作を行うこと。

例えば:

define("sitecore", function (_sc) { var zIndexEdit = _sc.Definitions.App.extend({ initialized: function () { this.set("item", null); this.on("change

", this.loadItem, this); this.ZIndexTextBox.on("change
", this.changeValue, this); }, loadItem: function () { var item = this.get("item"); if (item != null) { this.originalZIndex = item"Z-Index"; this.ZIndexTextBox.set("text", item"Z-Index"); } }, changeValue: function () { if (!this.isValidInteger(this.ZIndexTextBox.get("text"))) { $("data-sc-id=ZIndexTextBox").css("border-color", "red"); } else { $("data-sc-id=ZIndexTextBox").css("border-color", ""); } var item = this.get("item"); if (item"Z-Index" != this.ZIndexTextBox.get("text")) { item"Z-Index" = this.ZIndexTextBox.get("text"); } }, isValidInteger: function (value) { var regEx = /^\d+$/; return (regEx.test(value)); }, hasChanges: function () { var item = this.get("item"); if (this.originalZIndex != item"Z-Index") { return true; } return false; }, isValid: function () { var item = this.get("item"); if (!this.isValidInteger(item"Z-Index")) { return false; } return true; }, acceptChanges: function () { var item = this.get("item"); this.originalZIndex = item"Z-Index"; }, }); return zIndexEdit; });

設定ファイルを変更してください

これでSitecore.Odg.configファイルを変更するために必要な情報はすべて集まりました。形状P_RectangleのZインデックス編集のみを可能にしたい場合は、P_RectangleキーのadditionalRenderings属性にZIndexRendering id ({23DEAD5B-8A42-4432-A9F6-FBE28BF14980}) を追加します:

ご覧の通り、Document Publisherのユーザーはページ上の長方形のサイズ、位置、深さを変更することができます。

333C5D00E234414F98409D2812B40002.png

追加のレンダリングも他のキーに追加できます。additionalRenderings属性には好きなだけレンダリングを追加できます。レンダリングIDのリストは「|」で区切られていることを確認してください。以下の例では、テキストフレームに対してAttributes EditとZ-Indexレンダリングが追加されています。

これらの追加レンダリングにより、Document Publisherユーザーはコンテンツ(dataRenderingID)だけでなく、テキストフレームのサイズや位置(最初の追加レンダリング)、深さ(2回目の追加レンダリング)も変更できます。

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