JSモジュールを作成する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
技術ユーザーはプログラム可能な決定内で再利用可能なJavaScript関数を作成できます。JSモジュールが公開されると、プログラム可能な決定にインポート可能です。モジュールが公開された後は編集できません。モジュールがプログラム可能にインポートされた後は編集や削除ができません。
作業中は頻繁にモジュールをドラフト状態で保存することをお勧めします。これにより検証チェックが実行され、誤りを迅速に修正できます。構文やフォーマットの検証に加え、システムは次のセクションで述べる制限点もチェックします。
JavaScriptにタイムスタンプを入れる際に誤りを避けるために、moment.jsライブラリをご利用ください。このライブラリでは、日付や時間のフォーマットをJavaScriptで解析、検証、操作、表示できます。さらに、タイムゾーンライブラリを読み込んで特定のタイムゾーンに日付をフォーマットすることも可能です。
load("classpath
.js"); load("classpath.js");制限事項
- 単一モジュールの最大サイズは100KBです。
- JavaScriptはES5互換でなければなりません。
- 外部サービスへの通話は許可されていません。
モジュール作成の任意の段階で変更を保存できます。モジュールはドラフト状態のままで、公開するまで編集可能です。
User、Developer、またはAdminの役割を持つチームメンバーは、JSモジュールを作成Sitecore Cloud Portalできます。
JSモジュールを作成するには:
-
ナビゲーションメニューで、JSモジュール>開発者センターをクリックします。
-
JSモジュールのページで**「作成**」をクリックします。
-
「 新しいモジュールに名前を付け る」フィールドに、JSモジュールの直感的な名前を入力してください。IDに許可されている文字はラテンアルファベット、数字、下線です。入力すると、モジュール名がIDフィールドに表示されます。
!ヒントモジュールに意味のある名前を付け、ユーザーがモジュールの位置を特定し、インポート時にその機能を理解しやすくしましょう。
-
「作成」をクリックします。
-
オプションでモジュールエディターの 詳細 ペインで、以下をクリックしてください:
- 仮説 - JSモジュールの説明を入力します。この方法を推奨します。これは、他のユーザーがモジュールを使用する際にその機能を理解できるようにするためです。
- タグを追加 - モジュールのタグを入力してください。これらは JSモジュール のページでモジュールのリストをフィルタリングするために使われます。
-
コードセクションで「コーディング開始」をクリックします。コードエディターのJavaScriptタブでJavaScriptモジュールを入力してください。コードを自動的にフォーマットしインデンJavaScriptトするには、
をクリックしてください。以下の例は、ゲストタイプが顧客の場合に返す簡単な関数で、true応答を返します。
function isCustomer(guest) { return guest.guestType === 'customer'; }
!注 サポートされているJavaScript関数と サポートされていない 関数に慣れておくことをお勧めします。
-
右ペインの 「Data 」タブをクリックしてゲストデータモデルの属性やパスをコピーし、JavaScriptエディターに貼り付けてください。
をクリックして、以下のいずれかを選択します:-
ゲストタイプに基づくランダムなゲストの属性を見るには、検索ボックスをクリックし、「 クイックセレクトカスタマー」または「クイックセレクトビジター」を選択します。システムは最近アクティブだったゲストを選択します。
-
特定のゲストからフィールドを選択するには、検索ボックスにそのゲストの固有の識別子を入力します。例えば、セグメントメンバーシップを動的データとして使いたい場合は、そのセグメントのメンバーであるゲストを検索してください。例えば、メールアドレス、他のユニークな識別子、ブラウザIDを使ってゲストを検索できます。
!ヒントコードの設定やテスト時によく使うゲストがいる場合は、スター アイコンをクリックしてゲストをブックマークし、検索しなくて済むようにしましょう。
-
-
モジュールをテストすることをお勧めします。JSモジュールを保存するには、「保存」をクリックしてください。
-
JSモジュールを公開するには、戻る矢印をクリックし、「 **公開」**をクリックしてください。
-
確認ダイアログで「 公開」をクリックします。JSモジュールはユーザーがプログラム可能な決定にインポートできます。
!警告モジュールを公開すると、編集やアンパブリッシュはできません。