Web リソースを作成または編集してアプリを拡張
このトピックは、Dynamics 365 Customer Engagement (on-premises) に適用されます。 このトピックの Power Apps バージョンについては、以下を参照してください。 モデル駆動型アプリ Web リソースを作成または編集してアプリを拡張する
Web リソースは、通常、Web 開発で使用されるファイルを使用してアプリを拡張するために、開発者によって使用されます。 アプリ ユーザーとして、開発者またはデザイナーによって提供される Web リソースを管理する必要がある場合があります。
チップ
Web リソースの包括的な説明については、Customer Engagement の Web リソース を参照してください。
Web リソースとは。
Web リソースは、システムに格納される仮想ファイルです。 各 Web リソースは、ファイルを取得するために URL で使用できる一意の名前を持ちます。 このように考えてください。Web アプリを実行する実際の Web サーバーにアクセスした場合、その Web サイトにファイルをコピーできます。 しかし、ほとんどのオンライン サービスでは、そうすることはできません。 代わりに、Web リソースを使用してシステムにファイルをアップロードし、ファイルとして Web サーバーにコピーしたかのように、名前によって参照することができます。
たとえば、"new_myWebResource.htm" という名前の Web リソースとして HTML ページを作成する場合は、次のような URL を使用して、ブラウザーでそのページを開くことができます。
<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm
ここで、<アプリ URL> はアプリを開くために通常使用する URL です。 Web リソースはシステムにあるデータなので、組織でのライセンスを受けたユーザーのみが、この方法でアクセスできます。 通常、Web リソースは、直接参照されるのではなく、フォームに含まれています。 最も一般的な使用方法は、フォーム スクリプトの JavaScript ライブラリを提供することです。
Web リソースはシステム内のデータであり、ソリューションに対応しているため、ソリューションの一部としてエクスポートして、別の組織にソリューションをインポートすることによって、別の組織に移動させることができます。
Web リソースの作成と編集
ソリューション エクスプローラーを開き、Web リソースを選択します。
コンポーネントで Web リソースを選択します。
新しい Web リソースを作成するには、新規を選択します。
Web リソースを編集するには、編集する Web リソースをダブルクリックします。
Web リソース フォームには、以下のフィールドと機能があります。
ラベル 内容 名前 必須。 これは、Web リソースの一意の名前です。 いったん Web リソースを保存したら、これを変更することはできません。
この名前には、文字、数字、ピリオド、および連続していないスラッシュ (“/”) のみを含めることができます。
Web リソース名の先頭に、ソリューション発行者のカスタマイズ接頭辞が追加されます。表示名 Web リソースの一覧を表示すると、この名前が表示されます。 説明 Web リソースの説明です。 種類 必須。 これは、Web リソースの種類です。 いったん Web リソースを保存したら、これを変更することはできません。 テキスト エディター Web リソースの種類が一種のテキスト ファイルを表す場合は、このボタンを選択してページを開き、テキスト エディターを使用してコンテンツを編集します。 言語 言語を選択できます。 このオプションは、Web リソースのデータが格納されているレコードをタグ付けするだけです。 Web リソースの動作は変更されません。 ファイルのアップロード 参照... ボタンを選択して、Web リソースとしてアップロードするファイルを選択します。
新しい Web リソースを作成する場合、または、既存の Web リソースを上書きする場合に、ファイルをアップロードすることができます。
ファイル名の拡張子は、許可されている拡張子と一致していなければなりません。
デフォルトでは、Web リソースとしてアップロードできるファイルの最大サイズは 5 MB です。 この値は、Dynamics 365 Customer Engagement (on-premises) でシステムの設定>電子メールタブ>添付ファイルのサイズ制限の設定設定を使用して変更することができます。 詳細: [システムの設定] ダイアログ ボックス - [メール] タブURL Web リソースを保存した後、Web リソースへの URL がここに表示されます。 ブラウザーで Web リソースを表示するには、このリンクを選択します。 変更を追加した後、保存、公開を順に選択します。
Note
カスタマイズを公開すると、標準のシステム操作と干渉する可能性があります。 カスタマイズは、ユーザーへの影響が最小限に留まるように公開することを推奨します。
テキスト エディターの適切な使用
Web リソース用のアプリケーションで提供されているテキスト エディターは、テキスト ファイルの簡単な編集のみに使用する必要があります。 HTML Web リソースの作成と編集に使用することができますが、テキスト エディターを使って作成された HTML Web リソース以外は編集しないでください。 テキスト エディターは、非常に単純な HTML コンテンツ用に設計されています。 テキスト エディターを使用して作成された HTML Web リソース コンテンツでない場合は、編集にテキスト エディターを使用しないでください。
テキスト エディターでは、編集することができるように HTML のソースを変更するコントロールが使用されます。 これらの変更は、ブラウザーでのページの動作を変え、より高度なコードの動作を停止させる場合があります。 テキスト エディターで HTML Web リソースを開き、変更を加えずに保存すると、いくつかの HTML Web リソースが壊れる可能性があります。
外部エディターを使用してテキスト ファイルを編集し、それらをアップロードする前に、ファイルのアップロードボタンを使ってローカルで保存することをお勧めします。 このようにすると、以前のバージョンに戻す必要がある場合に、Web リソースのコピーを保持することができます。 メモ帳のような単純なエディターを使用することもできますが、より高度な機能を備えたテキスト エディターを使用することを強くお勧めします。 Visual Studio Express エディション は無料で、テキストベースのWebリソースが使用するファイルを編集するための強力な機能を提供します。
Web リソースはフォーム上で作成および編集します。
ユーザーにとってさらに魅力的で便利になるように、フォーム上の Web リソースを追加または編集できます。 システム管理者セキュリティ ロールまたは同等の権限を持っている必要があります。
Note
web リソースはフォーム ヘッダーまたはフッターに含めることができません。
ソリューション エクスプローラーを開きます。
コンポーネントで、エンティティを展開し、作業するエンティティを展開します。
フォームを選択し、一覧内で種類がメインのフォームを探し、オープンするエントリをダブルクリックまたはタップし、フォームを編集します。
Web リソースを追加するには、挿入する場所のタブ (たとえば、全般またはメモ) を選択し、挿入タブ上で Web リソースを選択します。
-または-
Web リソースを編集するには、フォーム タブと編集する Web リソースを選択し、ホームタブでプロパティの変更を選択します。Web リソースの追加ダイアログ ボックスまたは Web リソースのプロパティダイアログ ボックスの全般タブで、必須フィールドに適切な情報を入力します。 具体的には、以下に注意します。
- Web リソースボックスで、使用するイメージ、HTML、または Silverlight Web リソースを選択します。
Note
Web リソースを指定したら、Web リソースのプロパティセクションがタブの最下部に表示されます。表示されるオプションは、追加する Web リソースの種類により異なります。 これらのオプションには、カスタム パラメーターの指定、レコードのオブジェクトの種類コードをパラメーターとして渡すこと、リソースを説明する代替テキストの指定が含まれます。画像に代替テキストを指定すると、すべてのユーザーがさらに容易に画像にアクセスできます。 こちらにいくつかの重要なプロパティがあります。 完全な一覧については、Web リソースのプロパティ を参照してください。 - 名前ボックスに、このフィールドの一意の名前を入力します。 この名前には、英数字とアンダースコアのみを使用できます。
- ラベルフィールドは、指定した名前の種類に自動的に設定されますが、提案されたラベルがニーズを満たしていることを確認し、それに応じて更新します。
- Web リソースボックスで、使用するイメージ、HTML、または Silverlight Web リソースを選択します。
形式タブでは、表示されるオプションは挿入された Web リソースの種類により異なります。 これらのオプションには、表示列および行の数の指定、境界を表示するかどうかの指定、およびスクロール動作の指定が含まれます。
依存関係タブが Web リソースの追加または Web リソースのプロパティダイアログ ボックスに表示される場合、使用可能なフィールドの一覧から、Web リソースで必要なフィールドを選択し、選択したレコードの追加ボタンを選択して、選択したフィールドを依存フィールドの一覧に移動し、OK を選択してダイアログ ボックスを閉じます。
フォームの編集が終了したら、ホームタブで、保存して閉じるを選択して、フォームを閉じます。 メイン フォームの表示とイベントの動作をプレビューするには以下を実行します。
- ホームタブでプレビューを選択してから、フォームの作成、フォームの更新、または読み取り専用を選択します。
- [プレビュー] フォームを閉じるには、ファイルメニューで、閉じるを選択します。
カスタマイズが完了したら、公開します。
- 現在編集中のコンポーネントのみのカスタマイズを公開するには、ナビゲーション ウィンドウで、取り組んでいるエンティティを選択してから、公開を選択します。
- 非公開のすべてのコンポーネントのカスタマイズを一度に公開するには、ナビゲーション ウインドウで、エンティティを選択し、操作ツールバーで、全てのカスタマイズの公開を選択します。
イメージ Web リソースの追加または編集
Web リソースは、HTML ファイル、JavaScript、および Silverlight アプリケーションなどの複数のファイル形式の仮想ファイルであり、システムに格納され、一意の URL アドレスを使用して取得できます。
ソリューション エクスプローラーを開きます。
新しい Web リソースを作成するには、コンポーネント>Web リソースを選択してから、操作ツールバーで新規を選択します。
テキスト ボックスに情報を入力または変更します。
名前テキスト ボックスに入力された名前に、ファイル拡張子を加えたものがファイル名になります。
表示名テキスト ボックスに入力された名前が表示名に表示されます。
種類ドロップダウン ボックスで、使用するファイルの種類を選択します。
参照を選択して、ローカル コンピュータのファイルを選択して、アップロードします。
アップロードされているイメージ Web リソースをプレビューするには、Web リソース > プレビューを選択します。
テキスト Web リソースを編集するには: テキスト エディターを選択します。
テキスト Web リソースをプレビューするには、Web リソース >プレビューを選択します。
データを保存する準備ができたら、保存して閉じるを選択します。
カスタマイズを公開します。
編集されたコンポーネントのみの場合、ホーム上で、保存>公開を選択します。
非公開のすべてのコンポーネントを一度に公開するには、すべてのカスタマイズの公開をクリックします。
Note
ソリューションをインストールまたはカスタマイズを公開すると、標準システム操作を妨げる可能性があります。 ソリューションのインポートは、ユーザーへの影響が最小限に留まるようにスケジューリングすることを推奨します。
参照
Web リソースのプロパティ
フォームの作成および設計
カスタマイズに関する入門情報
Customer Engagement の Web リソース