次の方法で共有

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

  • [アーティクル]

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

Note

この機能は Dynamics CRM Online 2015 Update 1 および CRM 2016 (on-premises) に導入されています。

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

ビデオ: Microsoft Dynamics 365 Customer Engagement のテーマ化

現在のテーマのクエリ

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

要求:

GET [Organization URI]/api/data/v9.1/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.1/$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": "Microsoft CRM",  
            "hoverlinkeffect": "#D7EBF9",  
            "navbarshelfcolor": "#DFE2E8",  
            "navbarbackgroundcolor": "#002050",  
            "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"  
        }  
    ]  
}

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

テーマ情報の編集と公開

テーマの作成には、UI のカスタマイズ ツールを使用します。開発者はコードを記述する必要はありません。 これらのカスタマイズの適用方法の詳細については、「TechNet: 組織のブランドに合わせて配色を変更またはロゴを追加する」を参照してください。

ほとんどのテーマ データは、テーマ エンティティに格納されます。 特定のエンティティ用にカスタマイズされた色が、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 Microsoft Dynamics 365 Customer Engagement ロゴのツールヒントと alt テキストとして使用されるテキスト。
MainColor String #3B79B7 メイン コマンド バー、ボタン、タブで使用される統一インターフェイスのプライマリ テーマの色。
Name String CRM 既定のテーマ テーマ エンティティの名前。
NavBarBackgroundColor String #002050 プライマリ ナビゲーション バーの色。
NavBarShelfColor String #DFE2E8 セカンダリ ナビゲーション バーの色。
OverriddenCreatedOn 日時 null レコードが移行された日時です。
PageHeaderBackgroundColor String #E0E0E0 ページ ヘッダーの背景色。
PanelHeaderBackgroundColor String #F3F3F3 パネル ヘッダーの背景色。
ProcessControlColor String #41A053 プロセス コントロールのプライマリ カラーの選択。
SelectedLinkEffect String #F8FAFC コマンドまたはリストで選択されたアイテムを示すために使用される色。
TransactionCurrencyId 検索 null テーマに関連付けられている通貨の、基本通貨に対する為替レートです。

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

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

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

参照

テーマ エンティティ :
テーマの作成
Microsoft Dynamics 365 Customer Engagement のカスタマイズに関する開発者ガイド