組織のテーマのクエリと編集

[アーティクル]
06/08/2022

組織に対して視覚的なテーマを定義して適用できます。これは、アプリケーションに組織のロゴと色の選択を適用する、サポートされている方法を提供します。カスタマイズされていないモデル駆動型アプリシステムで提供される既定の色と視覚要素を変更して、自分のアプリケーションに合わせて、ユーザー定義のテーマを作成できます。たとえば、個人用の製品ブランドの作成、会社ロゴの追加、テーブル固有の色の指定を行うことができます。テーマ色は、一部の従来の領域を除く、アプリケーション全体にグローバルに適用されます。

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

テーマのカスタマイズは、このリリースでは、Web アプリケーションに対してのみサポートされます。組織のテーマに対する変更は、組織からエクスポートされるソリューションには含まれません。複数のテーマを定義できますが、既定のテーマとして設定して公開できるのは 1 つだけです。

ビデオ: テーマに合わせての構成

現在のテーマのクエリ

組織に対するテーマの選択に適用する HTML Web リソースを使用したソリューションがある場合、クライアント側のコードを使用して現在のテーマをクエリすることが必要な場合があります。次のクエリを Web API で使用して、その情報を取得できます。

要求:

GET [Organization URI]/api/data/v9.0/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor

応答:

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{  
    "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#themes(defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor)",  
    "value": [  
        {  
            "defaultentitycolor": "#001CA5",  
            "defaultcustomentitycolor": "#006551",  
            "controlborder": "#CCCCCC",  
            "controlshade": "#F3F1F1",  
            "selectedlinkeffect": "#B1D6F0",  
            "globallinkcolor": "#1160B7",  
            "processcontrolcolor": "#D24726",  
            "headercolor": "#1160B7",  
            "logotooltip": "Model-driven apps",  
            "hoverlinkeffect": "#D7EBF9",  
            "navbarshelfcolor": "#DFE2E8",  
            "navbarbackgroundcolor": "#002050",  
            "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"  
        }  
    ]  
}

詳細: Web API を使用するクエリデータ

テーマ情報の編集と公開

テーマの作成には、UI のカスタマイズツールを使用します。開発者はコードを記述する必要はありません。これらのカスタマイズを適用する方法の詳細は、テーマを使用して、アプリのカスタムルックを作成するでご覧ください。

ほとんどのテーマデータは、テーマテーブルに格納されます。特定のテーブル用にカスタマイズされた色が、EntityMetadata.EntityColor に含まれていますプロパティに設定します。このデータは、テーブルがソリューションに含まれている場合は、テーブルといっしょにエクスポートされます。

次の表では、更新が有効で、テーマによって適用されるデータを含む Theme テーブル列について説明します:

スキーマ名	種類	既定のテーマの値	内容
AccentColor	String	#E83D0F	プロセスコントロールで使用される統一インターフェイスのセカンダリテーマの色。
BackgroundColor	String	#FFFFFF	内部のみで使用。
ControlBorder	String	#BDC3C7	コントロールで境界線に使用される色。
ControlShade	String	#FFFFFF	アイテムにカーソルを置いたときに、それを示すために使用するコントロールの色。
DefaultCustomEntityColor	String	#00CCA3	色が割り当てられていない場合の、カスタムテーブルの既定の色。
DefaultEntityColor	String	#666666	色が割り当てられていない場合のシステムテーブルの既定の色。
GlobalLinkColor	String	#1160B7	電子メールアドレスや検索などのリンクの色。
HeaderColor	String	#1160B7	フォームタブのラベルなど、ヘッダーテキストの色。
HoverLinkEffect	String	#E7EFF7	アイテムにカーソルを置いたときにコマンドまたはリストで使用される色。
ImportSequenceNumber	Integer	null	このレコードを作成したインポートのシーケンス番号です。
IsDefaultTheme	Boolean	正	カスタムテーマの既定値は false です。
LogoId	String	null	ループとして使用される Web リソースの名前。推奨のサイズは、高さ 50 ピクセル、最大幅 400 ピクセルです。
LogoToolTip	String	モデル駆動型アプリ	ロゴのツールヒントと alt テキストとして使用されるテキスト。
MainColor	String	#3B79B7	メインコマンドバー、ボタン、タブで使用される統一インターフェイスのプライマリテーマの色。
件名	String	モデル駆動型アプリの既定のテーマ	テーマテーブルの名前。
NavBarBackgroundColor	String	#002050	プライマリナビゲーションバーの色。
NavBarShelfColor	String	#DFE2E8	セカンダリナビゲーションバーの色。
OverriddenCreatedOn	日時	null	レコードが移行された日時です。
PageHeaderBackgroundColor	String	#E0E0E0	ページヘッダーの背景色。
PanelHeaderBackgroundColor	String	#F3F3F3	パネルヘッダーの背景色。
ProcessControlColor	String	#41A053	プロセスコントロールのプライマリカラーの選択。
SelectedLinkEffect	String	#F8FAFC	コマンドまたはリストで選択されたアイテムを示すために使用される色。
TransactionCurrencyId	検索	null	テーマに関連付けられている通貨の、基本通貨に対する為替レートです。

変更を適用した後、PublishTheme Action または PublishThemeRequest クラスを使用して、テーマレコードの 1 つを現在のテーマにします。

テーマのエクスポートとインポート

テーマはソリューションの一部として含まれないので、組織間でテーマを転送するには、構成移行ツールを使用して、テーマを生成し、テーマデータをエクスポートし、それを別の組織にインポートできます。このツールの使用方法の詳細については、「Configuration Migration ツールを使用して構成データを移動」を参照してください。

組織のテーマのクエリと編集

現在のテーマのクエリ

テーマ情報の編集と公開

テーマのエクスポートとインポート

関連項目

フィードバック