ポータルでの Customer Engagement アプリからデータを取得する
Power Apps ポータルにはレンダリングする機能があり—、内部向けまたは外部向けのポータル Web サイト上でデーターの操作を許可します—。 このセクションでは、この機能の基盤を提供するテーブルをプロファイルし、それを達成するために必要な手順について説明します。
基本フォーム
基本フォーム レコードを使用すると、管理者はポータルに Power Apps フォームをレンダリングして、ユーザーからのカスタマイズ可能なデータ セットを編集、表示、またはキャプチャすることができます。 これは比較的簡単且つ単純なプロセスであるため、ポータルを展開する前にそのような結果を得るために必要とされていたコードのカスタマイズの必要がなくなります。
この機能は、さまざまな理由およびユース ケースで活用することができますが、これの活用方法の一般的な例としては、システムのカスタマイズ インターフェイスの潜在客テーブルの下に新しいフォームを作成し、それから取引先担当者ページまたは何らかのタイプの情報要求ページを介して潜在顧客データをキャプチャするためにポータル上に表示させることができる基本フォーム レコードを作成します。 実際、この特定の例は、規定ではポータル内の お問い合わせ ページのために使用されます。 他の例には、プロファイル管理または単一ページ調査のための基本フォームの使用が含まれます。
基本フォームには、Web ページとの関連付け、およびポータル内のフォームの初期化を制御する追加プロパティが含まれています。 Web ページへの関連付けにより、ポータル Web サイト内の特定のページ ノードのフォーム定義を動的に取得できます。
新しい基本フォームを作成する場合は、最初の手順として、モード: 挿入、編集、または読み取り専用、および表示するテーブルとフォーム名を決めます。 選択したモードは、ポータルから新しいレコードを作成するか、既存のレコードを編集するか、ポータルのレコードに関する情報を表示するだけかを決定します。
このデモンストレーションでは、Contoso、Inc. が 顧客セルフサービス ポータル に表示されるフォームにリンクされている Power Apps でカスタム テーブルを作成し、ユーザーが会社へ希望する改善の提案を提出できるようにするシナリオを考えます。 Contoso、Inc. の管理者がこれを達成するために実行する手順は、次のとおりです。
Power Apps を使用してカスタム テーブルを作成します。 詳細情報: テーブルの作成。
この例では、テーブルを 「提案」 と呼びます。フォーム上にキャプチャする必要がある情報に関連する提案テーブルの下に 2 つのカスタム フィールドを作成します。 この例では、SuggestionOrigin (オプション セット) と SuggestionSummary (複数行のテキスト) フィールドを作成します。 両方のフィールドが 必須項目 に設定されます。
提案テーブルの下に新しいメイン フォームを作成 します。
1 列のタブを挿入し、セクションのプロパティを 2 列に変更します。
既存の 名前 フィールドに加えてカスタム フィールドを追加します。
タブに 提案 と名前を付けます。
フォーム プロパティ で、フォームに 提案フォーム と名前を付けます。
変更を保存して公開します。
ポータル管理アプリ > 基本フォーム を開き、新しい基本フォーム レコードを作成します。 それに 提案 と名前をつけ、テーブル名 フィールドを 提案 (new_suggestion)、フォーム名 を 提案フォーム、タブ名 を 提案 と設定し、フォームの種類 を 挿入 として、必要に応じて他のオプションを変更します。
ポータル Studio を使用して、提案 という名前の新しい子ページを作成します。 ページ テンプレート 値を 詳細フォーム に設定し、その 基本フォーム の値を 提案 と設定し、そのフォームに概要を追加します。
注意
子ページは、ユーザーの希望に応じて作成することもできます。
ユーザーがフォームに簡単に移動できるようにするには、ポータルでプライマリ ナビゲーションを編集し、+ アイコンを選択してフォームへの新しい Web リンクを追加します。 Web リンクを 提案 と名前を付け、それを 提案 ページに割り当てます。
ユーザーが Contoso ポータルにアクセスし、このフォームに移動し、関連するデータを入力して送信すると、送信された情報で新しいレコードが自動的に生成されます。
基本フォーム メタデータ
基本フォーム メタデータ レコードには、ネイティブな基本フォームの編集機能を使用して変更できなかったフォーム フィールドの機能を拡張または上書きする追加の動作変更ロジックが含まれます。
これらのレコードは、フィールド、サブグリッド、またはセクションやタブ全体を含む、フォーム上の特定の要素をさらに構成し、操作することが可能になります。 何らかの種類の変更を必要とするフォームの各要素には、基本フォーム レコードと関連付けられた個別のメタデータ レコードが必要です。
基本フォームにメタデータ レコードを追加するには、ナビゲーション メニューから 基本フォーム メタデータ関連ビュー に移動するか、または基本フォーム メタデータ サブグリッドをレコード フォームの最下部に向かって使用して、基本フォーム自体から直接作成することもできます。
基本フォーム メタデータ レコードは、フィールドのスタイルの制御、特定の値でのフィールドの事前入力、保存時のフォーム上の値の設定、ユーザー入力値の検証など、さまざまなシナリオで使用できます。
リスト
基本フォーム レコードでポータル管理者は Power Apps フォームをポータル ユーザーに公開できる一方で、一覧は開発者がカスタム コードを使用してポータル上のビューを表示する必要なく、レコードのリストを表示する Web ページをポータルに追加する機能を管理者に提供します。
リストでは並べ替えとフィルター処理がサポートされており、レコード数がリスト レコードで指定された ページ サイズ 値よりも大きい場合はページ番号が付けられます。 また、詳細ビューの Web ページ も指定されている場合は、各レコードには、ページ、および ID クエリ文字列パラメーター名が付いたクエリ文字列に追加されるレコードの ID へのリンクが含まれます。
また、リストでは、複数のビューとアクションもサポートされています。 複数のビューが指定されている場合、ドロップダウン メニューがエンド ユーザに表示され、さまざまなビューを切り替えることができます。 同様に、編集 や 削除 などのアクションがアクション ボタンとして追加された場合、適切な権限を持つユーザーには、これらのオプションがビューに表示されます。
ユーザー提案を収集する基本フォームを作成する前の Contoso, Inc. の管理者の例をもとに、ここで、管理者が (非常に単純化して) 他のユーザーがレビューし、新しいものを提出するために簡単にアクセスできるように、提出されたレコードをポータルに公開する手順を説明します。
提案 テーブルの アクティブな提案 という名前のビューを編集 し、このビューにポータルで公開する列を追加します。
ポータル管理アプリ > リスト を開き、新しいリスト レコードを作成します。
提案リスト の名前を入力し、テーブル名 を 提案 (new_suggestion) に設定します。
デフォルトの アクティブな提案 ビューまたはカスタム作成ビューを ビュー リストに追加します。
作成する Web ページ を 提案 に設定し、必要に応じて作成ボタンまたは空のリスト テキストを追加します。
ポータル Studio を使用して、提案リスト という名前の新しい子ページを作成します。 ページ テンプレート を フル ページ に、リスト を 提案リスト に設定し、公開ビューに概要を追加します。
必要に応じて、ポータルで プライマリ ナビゲーション を編集し、リストに新しい Web リンクを追加するには 追加 ボタン (+) を選択します。 Web リンクを 提案リスト と名前を付け、それを 提案リスト ページに割り当てます。 新しいリスト リンクの下に以前に作成された 提案 フォームのリンクをドラッグすると、子供になることができます。
前に説明した単純化された設定以外にも、リストは次のような多くのオプションをサポートしています (ただしこれのみに限定されません)。
- ユーザーがポータルのそれぞれのテーブル内のレコードをフィルター処理して検索できるようにします。
- ユーザーがレコードを作成、編集、または削除し、レコードを Excel ワークシートにダウンロードできるようにする。
- ユーザーがリストで選択したレコードに対してオンデマンドのワーク フローを実行できるようにする。
- データの Bing Map ビューを使用して、リストからレコードを表示する。
- データのカレンダー ビューを使用して、リストからレコードを表示する。
詳細フォーム
詳細フォームを使用すると、基本フォームとカスタム ロジックを定義して、カスタム コードを必要とせずにポータルにデータ入力フォームを表示できます。 詳細フォームは、分岐ロジックに加えて、シングル ステップおよびマルチ ステップ ナビゲーションをサポートします。 詳細フォームは通常、標準の 「サポート案件の満足度調査」 詳細フォームなどのアンケートを作成するため、または標準の 「新しいサポート要求のオープン」 詳細フォームなどの要求を処理するために使用されます。
詳細フォームには基本フォームとは異なり、管理者が単一のフォームを作成するために読み込まれる 1 つ以上のフォーム、または条件分岐ロジックを備えたウィザード スタイルの複数のステップ プロセスを指定するための機能があります。 また、詳細フォームには、一部の既定の動作をオーバーライドしたり、テーブル メタデータおよびフォーム デザイナーの一部の制限を解決するために指定できる追加のプロパティがあります。
ポータル内で詳細フォームがどのように使用されるかを完全に把握するには、ユース ケース シナリオの例を提供し、フォームとその基礎となるすべての部分を構築するプロセスを実行することが最善の方法です。 このドキュメントの前半では、ユーザーが提案を提出するためのカスタム基本フォームを作成するプロセスと、ポータルのビュー内にこれらの提案を公開するためのカスタム リストを作成するプロセスを説明しました。 ここでは、提出された提案のうちどれを実装するのが望ましいか、それと同時にユーザー ベースに関する他の情報について、Contoso がユーザーを対象にアンケートを行うことを前提とします。 管理者がポータルでこのようなアンケートを設定する手順は、次のとおりです。
Power Apps を使用してカスタム テーブルを作成します。 詳細情報: テーブルの作成
を参照してください。 この例では、テーブルを 調査 と呼びます。調査 テーブルの下にいくつかのカスタム フィールドを作成して、ユーザーが調査で選択できる回答を表示します。
管理者が用意した「Contoso の改善を今後図る上でどのような提案をされますか」という複数選択の質問に対して、サポート時間の延長、新製品、および 店舗の拡大 という 3 つのカスタム フィールドが用意されています。 各フィールドには、2 つのオプション のデータ タイプが設定されています。
管理者が「Contoso Ltd. についてどこで知りましたか」という複数選択の質問に対して、小売店、検索エンジン、Web 広告、口コミ の 4 つのカスタム フィールドが用意されています。 各フィールドには、2 つのオプション のデータ タイプが設定されています。
データ タイプ オプション セット の Contoso Ltd. 評価 というカスタム フィールド。 既存のオプション セットの使用 については、はい を選択し、ドロップダウン リストでは リッカート尺度の質 を選択します。
アンケートに記入している現在のポータル ユーザーを追跡するには、データ タイプ Lookup の 関連の取引先担当者 というカスタム フィールドと 取引先担当者 のターゲット レコードを使用します。
調査 テーブルの下にある主要な 情報 フォームを開き、全般 タブを選択し、プロパティの変更 を選択します。 書式設定 タブで、1 列 を選択し、OK を選択します。 詳細情報: フォームの作成または編集
情報 フォームの 挿入 タブに切り替え、セクション を選択し、2 列 を選択します。 既定の名前と所有者フィールドをこのセクションに移動し、古いフィールドを削除します。 名前フィールドのプロパティを開き、表示 タブの 既定で表示する をオフにします。
フォームを保存して、アンケート手順 2 という名前のフォームのコピーを作成するためにリボンで 名前を付けて保存する を選択します。 アンケート手順 1 という名前のフォームのコピーを作成するために 名前を付けて保存する をもう一度選択します。
アンケート手順 1 フォームを開き、挿入 タブに切り替え、セクション > 2 列 を選択します。
新しいセクションのプロパティを 開き、"Contoso の将来の改善を図る上であなたの好きな提案は何ですか?" というラベルに変更し、このセクションのラベルをフォーム上に表示 オプションのチェック ボックスをオンにします。
サポート時間の延長、新製品、および 店舗の拡大 フィールドをこのセクションにドラッグします。
新しい 2 列セクションを追加する手順を繰り返します。しかし、ここでは、「Contoso Corporation Ltd. についてどこで知りましたか」というラベルに変更します。 そして、小売店、検索エンジン、Web 広告、および 口コミ フィールドをこのセクションにドラッグします。
各フィールドのプロパティを開きます。 書式設定 タブで、書式の制御 を チェック ボックス に設定します。 フォームを保存して閉じます。
アンケート手順 2 フォームを 開き、挿入 タブに切り替え、セクション > 1 列 を選択します。
Contoso Ltd. 評価 フィールドを新しいセクションにドラッグし、フォームのフィールドのプロパティを開き、そのラベルを「弊社のパフォーマンスを評価をしてください。 Contoso LTd. のさまざまな一連製品の品質を評価してください に変更します。 フォームを保存して閉じます。
調査フォーム 領域で、受注を構築する > メイン フォーム設定 の順に選択します。 これにより、情報 > 調査ステップ 1 > 調査ステップ 2 の順番で作業するフォームの順序を設定することができます。
主要な 情報 フォームと 挿入 タブで セクション > 2 列 の順に選択します。
新しいセクションのプロパティを開き、「Contoso の将来の改善を図る上であなたの好きな提案は何ですか」というラベルに変更し、このセクションのラベルをフォーム上に表示 チェック ボックスをオンにします。 サポート時間の延長、新製品、および 店舗の拡大 フィールドをこのセクションにドラッグします。
新しい 2 列セクションを追加する手順を繰り返します。しかし、ここでは、「Contoso Corporation Ltd. についてどこで知りましたか」というラベルに変更します。 そして、小売店、検索エンジン、Web 広告、および 口コミ フィールドをこのセクションにドラッグします。 この時点までにフォームに追加された 7 つの各フィールドのプロパティを開き、書式 タブを選択し、[書式の制御] を [チェック ボックス] に設定します。
セクションを追加する手順を繰り返しますが、今回は 1 列セクションを選択します。 Contoso Ltd. 評価 フィールドをこのセクションにドラッグし、フォームのフィールドのプロパティを開き、そのラベルを「弊社のパフォーマンスを評価をしてください。 Contoso LTd. のさまざまな一連製品の品質を評価してください」に変更します。
最後に、関連の取引先担当者 フィールドを 一般 タブの最初のセクションにドラッグして、どのユーザーが調査に記入したかを追跡します。 フォームを保存し、閉じてから、すべてのカスタマイズの公開 を選択します。
ポータル管理アプリ > 高度なフォーム の順に開いて、Contoso Ltd. 調査 という名前の新しい高度なフォームを作成します。 認証必須 フィールドを はい に設定し、複数のレコードを 1 人のユーザーに許可する フィールドを いいえ に設定します。 フォームを保存しますが、開いたままにします。
「Contoso Ltd. 調査」高度なフォーム レコード:
- ステップの開始 の検索フィールドを開き、新規 を選択し、新しい詳細フォーム ステップを作成します。
- その手順に 調査ステップ 1 と名前を付けます。
- ターゲット テーブルの論理名 を 調査 (new_survey) に設定します。
- フォーム名 を 調査ステップ 1 と設定します。
- 現在のポータル ユーザーを関連付ける チェック ボックスを選択します。
- 関連の取引先担当者 (new_regardingcontact) に ポータル ユーザー検索列 を設定します。
- フォームを保存しますが、開いたままにします。
「調査ステップ 1」 の詳細フォーム ステップのレコードで:
- 次のステップ の検索フィールドを開き、新規 を選択し、新しい詳細フォーム ステップを作成します。
- その手順に 調査ステップ 2 と名前を付けます。
- 高度なフォームを Contoso Ltd. 調査 に設定します。
- ターゲット テーブルの論理名 を 調査 (new_survey) に設定します。
- モード を 編集 に設定します。
- フォーム名 を 調査ステップ 2 と設定します。
- ソースの種類 を 前の手順によって起こる に設定します。
- 成功したことを示すメッセージ 調査にご協力いただき、ありがとうございます」に設定します。
- 次のステップ フィールドが空であり、フォームを保存しますが、開いたままにします。
「調査ステップ 2」 の詳細フォーム ステップのレコードで:
- メインのナビゲーションで右端のシェブロンを選択し、メタデータ を選択して、「調査ステップ 2」 レコードの下にある詳細フォーム メタデータ関連ビューを開きます。
- 新しい高度なフォーム メタデータを追加 を選択し、この新しいレコードで 属性論理名 を Contoso Ltd. 評価 (new_contosoltdrating) に設定して、スタイル を 横ラジオ ボタン リストとして設定されるオプション に設定します。
- 開いたフォームのすべてを保存して閉じます。
ポータル管理アプリ で、Web ページ に移動し、Contoso Ltd. 調査 という新しい Web ページを作成します。 Web サイト を Contoso Ltd. に、親ページ を ホーム に、部分 URL を contoso-ltd-survey に、PageTemplate を フル ページ に、公開国 を 公開済み に、高度なフォームを先に作成した「Contoso Ltd. 調査」に設定します。 レコードを保存します。
確かに、これらのステップは非常に複雑であり、結果を達成するためには、複数のレコードが互いに連携して動作する必要があります。 ただし、プロセスが完了した後、ユーザーはポータルで作成したページに移動し、意図したとおりに調査に記入することができます。
入力が完了した各調査は、 ポータル > 調査 テーブルでレコードになり、このレコードには、詳細フォームの入力とその集計に対するすべての回答の入力を完了した取引先担当者が含まれます。
フォーム要素のレンダリング
ほとんどのフォームはポータルで正しく表示されますが、一部の機能は実際の基本フォームでの表示を処理する BasicFormView コントロールではサポートされていません。
| サポートされているフォーム要素 | サポートされているが、注意事項にフォーム要素がサポートされている | サポートされていないフォーム要素 |
|---|---|---|
| すべてのフィールド検証ルール | 関係者リスト フィールドを除く、すべてのフィールドの種類 | フォームのヘッダーおよびフッターは、ポータルには表示されない |
| 単一および複数列のレイアウト両方 | 「Web ページ (HTML)」や画像関連の Web リソースの種類のみサポートされている | iFrame |
| ラベル言語の翻訳 | 検索フィールドでのレコードのフィルター処理は N:1 の関連付けのみでサポートされている | フォーム スクリプト |
| メモ (フォームに挿入済み) | 検索フィールドはサポートされているが、フォームの検索ビューで新しいレコードを作成することはサポートされていない | |
| サブグリッド (フォームに挿入済み) |
最後に、特筆すべきは、基本フォーム レコードには、添付ファイル オプションのセクションを含め、必要に応じて微調整できるオプションが用意されていることです。 フォームにファイルの添付が必要な場合、ファイルの添付 チェック ボックスを選択し、添付ファイル注記 と Azure BLOB ストレージ のどちらかから ファイルの記憶域の場所を添付 オプションを構成します。 詳細情報: メモを添付ファイルとして構成する
関連項目
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示