イメージ Web リソース
イメージ Web リソースを使用して、Dynamics 365 Customer Engagement (on-premises) でイメージを使用できます。
イメージ Web リソースには 5 つの種類があります。
- PNG 形式
- JPG 形式
- GIF 形式
- ICO 形式
- ベクター形式 (SVG)
Note
ベクター形式 (SVG) Web リソースは、Dynamics 365 for Customer Engagement アプリ バージョン 9.0 で追加されました。
イメージ Web リソースの機能
イメージ Web リソースを使用すると、必要な場所にイメージを追加できます。 一般には、以下のもので使用されます。
- ユーザー定義エンティティのアイコン
- ユーザー定義のリボン コントロールおよび
SiteMapのサブ領域用のアイコン - エンティティ フォーム用および Web ページの Web リソース用の装飾的なグラフィック
- CSS Web リソースが使用するバックグラウンド イメージ
アプリケーションに表示されるすべてのアイコンにベクター形式 (SVG) Web リソースを使用します。 ベクター イメージは、スケーラブル ベクター グラフィックス (SVG) (XML ベースのベクター イメージ形式) として定義されます。 他のイメージ Web リソースに対するベクター イメージの利点は、拡大縮小できることです。 サイズ別に複数のイメージを用意するのではなく、1 つのベクター イメージを定義して再利用できます。 カスタム エンティティを定義するために、IconLargeName、IconMediumName、IconSmallName プロパティの代わりに、新しいEntityMetadataIconVectorName プロパティで使用します。
イメージ Web リソースの制限
他のすべての Web リソースと同様、イメージ Web リソースは Dynamics 365 Customer Engagement (on-premises) のセキュリティ コンテキストを使用します。 スクリプト Web リソースにアクセスできるのは、必要な特権を持つ、ライセンスを受けた Dynamics 365 Customer Engagement (on-premises) ユーザーだけです。
Web ページの Web リソースからイメージ Web リソースを参照する
すべての Web リソースは相対 URL を使用して相互に参照できます。 以下の例では、「new_/content/contentpage.htm」と言う名前の Web ページ (HTML) の Web リソースから、「new_/Images/image1.png」と言う名前のイメージ Web リソースを参照し、次の HTML コードを「new_/content/contentpage.htm」に追加します。
<img src="../Images/image1.png" />
Dynamics 365 Customer Engagement (on-premises) フォームからのイメージ Web リソースの参照
イメージをエンティティ フォームに追加する
エンティティのフォーム エディターに移動します。
フォーム内の、イメージを追加する場所をクリックします。
挿入タブで、Web リソースをクリックします。
全般タブで、追加する Web リソース イメージを選択します。
Web リソースの名前を指定します。 ラベルや代替テキストも指定できます。
形式タブで、次の項目を定義できます。
イメージが使用する列の数。
イメージが使用する行の数、または自動的に展開して使用可能な領域を使用するかどうか。
以下のオプションを使用するイメージのサイズ
使用可能な領域の使用 (サイズに合わせて伸縮)
使用可能な領域の使用 (縦横比を固定)
元の画像サイズ
Specific
[特定のサイズ] を選択した場合、高さと幅をピクセル単位で入力できます。
OK をクリックします。
フォーム内のイメージをユーザーが表示できるようにするには、変更を保存してフォームを公開する必要があります。
リボン要素またはサイト マップのサブ領域からイメージ Web リソースを参照する
Web リソース イメージを、リボンのアイコンとして、またはサイト マップを使用したアプリケーション ナビゲーションのアイコンとして使用するように指定するには、$webresource: ディレクティブを使用します。 次のサンプルに、リボンのボタンのアイコンを指定する方法を示します。
<Button Id="MyISV.opportunity.form.actions.FlyoutAnchor.Button.1" Image16by16="$webresource:new_/icons/oneIcon16.png" Image32by32="$webresource:new_/icons/oneIcon32.png"/>
Note
$webresource: ディレクティブを使用してソリューションの依存関係を追加し、参照されているイメージ Web リソースが、他のソリューション コンポーネントで使用されている間は削除されないようにします。
関連項目
Dynamics 365 Customer Engagement (on-premises) の Web リソース
Web ページ (HTML) の Web リソースの使用
スタイルシート (CSS) ウェブ リソースを使用する
スクリプト (JScript) Web リソースの使用
データ (XML) Web リソースの使用
Silverlight (XAP) Web リソースの使用
スタイル シート (XSL) Web リソースの使用