スクリプトによる拡張

完了

Power Pages Web サイトでは、クライアント側のビジネス ルールやモデル駆動型のフォームで使用できる JavaScript のカスタム プロセスはサポートされていません。

リストフォームマルチステップ フォームにはカスタムの JavaScript 用の列が含まれており、特定のリストまたはフォームが読み込まれるときに開発者がスクリプトを追加して必要な機能を実装することができます。

Power Pages Management アプリでフォームに追加されたカスタム JavaScript のスクリーンショット。

Visual Studio Code エディターを使用すると、Web サイト ページにカスタム JavaScript を直接追加できます。 Power Pages Management アプリを使用して、スクリプトを Web テンプレートの一部として含めることもできます。これにより、そのテンプレートに基づいて任意のページでこれらの機能を利用できるようになります。

これらは、コントロールを非表示にし、入力コントロールをユーザーにわかりやすい情報に置き換える機能から、外部 Web サービスを呼び出し、高度な統合シナリオを実装する機能まで、多岐にわたります。

Power Pages Web サイトには、ページのコンテンツと外観の操作を単純にするための jQuery ライブラリが初めから含まれています。

コントロールと列

既定のお問い合わせフォームでは、Microsoft Dataverse のフィードバック テーブル内に行が作成されます。 この行には、件名というラベルでフォームに表示される、必須のタイトル列が含まれます。 この列は、サイト訪問者の混乱を招く可能性があります。 CSS スタイルを使用してコントロールを非表示にすると、その列が必須であることを示す赤いアスタリスクが残ってしまうため使用できません。 JavaScript を使用すると、列を比較的簡単に非表示にできます。 この列を定義済みの値に設定してから、非表示にする場合は、次の手順に従います。

  1. Power Pages デザイン スタジオのお問い合わせページを開きます。

  2. コードの編集を選択し、Visual Studio Code が開くのを待ちます。

  3. Contact us.en-US.customjs.js ファイルを選択します。

    重要

    ファイルの名前には、環境によって異なる可能性がある言語コードが含まれています。

  4. 次のスクリプトをファイルに追加します。

    $(document).ready
    (
     function()
     {
     $("#title").val('Submitted from contact us form'); // sets the value
     $("#title").closest('tr').hide(); // hide the row containing the column
     }
    );
    

    一部の Power Pages テンプレートでは、フィードバック テーブルとタイトル列が使用されます。 一部の Microsoft Dynamics 365 テンプレートでは、異なるテーブル (リードなど) や異なる列 (件名など) が使用される場合があります。 Web サイトで使用されているお問い合わせページとフォームを確認し、必要に応じてスクリプトを変更します。

    ページのソース コードに追加されたスクリプトのスクリーンショット。

  5. キーボード ショートカット Ctrl + S (Mac では ⌘ + S) を使用して、ファイルを保存します。

  6. Visual Studio Code エディターでブラウザー タブを閉じ、デザイン スタジオで同期を選択して変更を同期します。

  7. プレビュー > デスクトップを選択します。

    新しいウィンドウが開き、お問い合わせフォームが表示されます。トピック列 (件名ラベル) は非表示になっています。

JavaScript は、Power Pages Web サイトに動作や機能を簡単に追加するための手段です。 スコープの要件に応じて、ページに直接追加したり、Power Pages Management アプリを使用してフォーム構成に追加したり、Web テンプレートの一部として追加したりできます。 さらに、フォームでスクリプトを使用して次のアクションを実行できます。

  • ビジネス ルールを実装する。

  • 依存選択肢列など、要素間に依存関係を追加する。

  • その他のフォーム検証を実行する。

  • ポータル Web API または外部サービスを呼び出す。

これらのオプションは、モデル駆動型フォームのクライアント側のビジネス ルールやスクリプトに対して、適切な代替物を提供します。

詳細については、カスタム JavaScript をフォームに追加するを参照してください。