コマンド デザイナーを使用して、コマンド バーをカスタマイズする

この記事では、コマンド デザイナーと Power Fx を使用してモダン コマンドを作成および編集する方法について説明します。

アプリ デザイナーを開く

最新のアプリ デザイナーを使用して、新しいモデル駆動型アプリを作成する、またはアプリ デザイナーを使用して、既存のモデル駆動型アプリを開きます。

最新のアプリ デザイナーを使用して新しいモデル駆動型アプリを作成する

  1. Power Apps にサインインします。

  2. 左側のナビゲーション ペインで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。

  3. 新しいモデル駆動型アプリを含めるソリューションを開くか、作成します。

  4. 新規>アプリ>モデル駆動型アプリを選択します。

  5. アプリに名前を入力し、作成を選択します。 詳細: 初めてのモデル駆動型アプリを作成する

    新しいモデル駆動型アプリの名前プロンプト

アプリ デザイナーを使用して既存のモデル駆動型アプリを開く

  1. Power Apps にサインイン
  2. 左のナビゲーション ウィンドウで、ソリューション を選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
  3. 既存のモデル駆動型アプリを含むソリューションを開きます。
  4. モデル駆動型アプリを選択し、...>編集を選択して、最新のアプリ デザイナーを開きます。

モダンなコマンドを作成または編集

アプリ デザイナーに入ったら、コマンド デザイナーを使用してコマンド バーをカスタマイズします。

注

  • 現在、コマンド デザイナーは、最新のアプリ デザイナーから、または既存のコマンドのソリューション内でのみアクセスできます。
  • 現在、クラシック コマンドは、コマンド デザイナー内で編集できません。

コマンド バーを編集

コマンド デザイナーを開いてコマンド バーを編集

  1. アプリ デザイナーの ページ 領域内の任意のテーブル ビューの横で、... を選択して、その後 コマンド バーの編集 を選択します。

    アプリ デザイナーのエントリ ポイント

  2. メイン グリッド (ビュー) やメイン フォームなど、目的のコマンド バーの場所を選択し、編集 を選択します。 詳細情報: コマンド バーの表示場所

    場所の選択

新しいコマンドを作成

従来のコマンドとは異なり、モダン コマンドは編集中のアプリ内にのみ表示されます。 これにより、不要なコマンドが他のアプリに転送されるのを防ぎ、実行時のパフォーマンスも向上します。

アプリのコマンド デザイナーを初めて開くと、JavaScript のみを使用するか、Power Fx を使用するかのプロンプトが表示されます。 Power Fx を選択すると、必要に応じて JavaScript を使用することもできます。 ダイアログで Power Fx を選択すると、Power Fx の数式を格納するコマンド コンポーネント ライブラリが作成されます。

  1. コマンド デザイナーを開いてコマンド バーを編集し、新規>コマンド を選択します。 新しいコマンドを作成

  2. 右側のペインで、次のオプションを入力または選択します。

    • ラベル(オプション)。 コマンド ボタンに表示されるラベルを入力します。

    • アイコン。 コマンド ボタンのアイコンを選択します。 任意のシステム アイコンまたは Web リソース SVG ファイルから選択できます。 独自のアイコンをアップロードするには、Web リソースを選択し、その後 SVG フォーマット ファイルをアップロードします。 次に、Web リソースの 保存 と 公開 を選択します。 必要なアイコン画像用の Web リソースを作成する方法の詳細については、モデル駆動型アプリの Web リソースを作成または編集してアプリを拡張する を参照してください。

    • アクション。 以下より選択:

    • 表示。 コマンドボタンを表示するか、数式の条件で表示するかを選択します。

    • ツールチップのタイトル。 必要に応じて、ツールヒントのタイトルを入力します。 ユーザーがコマンド上にマウスを置くと、タイトルが表示されます。

    • ヒントの説明。 必要に応じて、ツールチップの説明を入力します。 ヒント タイトルの下でユーザーがコマンド上にマウスを置くと、説明が表示されます。

      コマンドのヒント タイトルと説明の例。

    • アクセシビリティ テキスト。 オプションで、スクリーン リーダーで読み上げるテキストを入力します。

    • 注文番号。 同じコマンドバー内の他のコマンドに関連して、実行時にコマンドが表示される順序。

  3. コマンドをドラッグ アンド ドロップして目的の位置にドロップします。 古典的なコマンドの間で、現代的なコマンドを配置することができます。

  4. 保存して公開 を選択して、アプリのユーザーがコマンドを利用できるようにします。

  5. Play を選択してアプリを実行し、変更をテストします。

注

Power Fx 式の公開には、コマンド コンポーネント ライブラリの公開に数分かかる場合があります。 このバック グラウンド操作は、コマンド デザイナーがリクエストを完了し、デザイナーのロックが解除された後も進行中となっている場合があります。

アクションと可視性に Power Fx を使用する

Power Fx は、アクション (コマンド ボタンが選択されたときに何が起こるか) と可視性 (ボタンがいつ表示されるかを制御するロジック) の両方に使用できます。 従来のコマンドでは Power Fx はサポートされません。

モデル駆動型アプリ コマンドには、キャンバス アプリと同様の数式バー エクスペリエンスがありますのでご注意ください。 Dataverse データを操作する場合、キャンバス アプリの場合と同じように Power Fx 式を使用できます。 詳細情報: コマンドで Power Fx を使用する

注

  • 現在、Dataverse だけがモデル駆動型アプリのコマンドでサポートされいるデータ ソースです。
  • 現在、コマンド デザイナーから直接データ ソースとして追加のテーブルを追加できません。 ただし、キャンバス スタジオでコマンド コンポーネント ライブラリを開き、データ ソースとして追加のテーブルを追加し、コマンド デザイナー内でそれらを使用します。
  • 現在、キャンバス アプリ内で使用できるすべての機能が、モデル駆動型アプリ コマンドでサポートされているわけではありません。 さらに、モデル駆動型アプリ コマンド向けのいくつかの新しい機能を導入しました。
  • モダン コマンドの制限の詳細については、モダン コマンドの既知の制限事項 を参照してください。

アクションに JavaScript を使用する

JavaScript は、クラシック コマンドとモダン コマンドの両方でサポートされています。 ただし、最新のコマンド デザイナーを使用してコマンドを作成し、JavaScript を関連付ける方が簡単です。

  1. アクション で、JavaScript を実行 を選択します。

  2. ライブラリを追加またはリストから別のものを選択します。 リストには、現在のコマンド バーで使用されているライブラリが表示されます。

    JavaScript ライブラリの追加

  3. 追加を選び、既存の JavaScript Web リソースを検索するか、または独自のリソースを追加できます。

    JavaScript Web リソースの追加

  4. 関数名を入力します。 たとえば、Main_system_library.js ライブラリを選び、この関数を呼び出します: XrmCore.Commands.Open.opennewrecord。

  5. 関数に渡すパラメーターを追加します。 使用可能なパラメーターの詳細については、「グリッド値をリボン アクションに渡す」を参照してください。

    パラメータを追加

注

1 つのコマンドから複数の JavaScript ライブラリを呼び出したり、複数の関数を呼び出したりすることはサポートされていません。

関連項目

現代的で見晴らしの良い眺望