Share via

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

  • [アーティクル]

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

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

注意

この機能は、CRM Online 2015 更新プログラム 1 および CRM 2016 (設置型) で導入されました。

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

ビデオ: Microsoft Dynamics CRM でのテーマに合わせての構成

このトピックの内容

現在のテーマのクエリ

テーマ情報の編集と公開

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

現在のテーマのクエリ

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

依頼:

GET <client_URL>/api/data/v8.0/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor

応答:

    {
        "@odata.context": "<client_URL>/api/data/v8.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": "Microsoft CRM",
                "hoverlinkeffect": "#D7EBF9",
                "navbarshelfcolor": "#DFE2E8",
                "navbarbackgroundcolor": "#002050",
                "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"
            }
        ]
    }

詳細:Web API を使用したクエリ データ。

テーマ情報の編集と公開

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

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

次の表は、テーマに対して有効であり、テーマによって適用されるデータを格納している Theme エンティティ属性について説明しています。

スキーマ名

種類

既定のテーマの値

説明

ControlBorder

文字列

#CCCCCC

コントロールで境界線に使用される色。

ControlShade

文字列

#F3F1F1

アイテムにカーソルを置いたときに、それを示すために使用するコントロールの色。

DefaultCustomEntityColor

文字列

#006551

色が割り当てられていない場合の、ユーザー定義エンティティの既定の色。

DefaultEntityColor

文字列

#8B98AB

色が割り当てられていない場合の、システム エンティティの既定の色。

GlobalLinkColor

文字列

#1160B7

電子メール アドレスや検索などのリンクの色。

HeaderColor

文字列

#1160B7

フォーム タブのラベルなど、ヘッダー テキストの色。

HoverLinkEffect

文字列

#D7EBF9

アイテムにカーソルを置いたときにコマンドまたはリストで使用される色。

LogoId

文字列

null

ループとして使用される Web リソースの名前。 推奨のサイズは、高さ 50 ピクセル、最大幅 400 ピクセルです。

LogoToolTip

文字列

Microsoft Dynamics 365

ロゴのツールヒントと alt テキストとして使用されるテキスト。

Name

文字列

Dynamics 365 の既定のテーマ

テーマ エンティティの名前。

NavBarBackgroundColor

文字列

#002050

プライマリ ナビゲーション バーの色。

NavBarShelfColor

文字列

#DFE2E8

セカンダリ ナビゲーション バーの色。

ProcessControlColor

文字列

#0755BE

プロセス コントロールのプライマリ カラーの選択。

SelectedLinkEffect

文字列

#B1D6F0

コマンドまたはリストで選択されたアイテムを示すために使用される色。

変更を適用した後、PublishThemeRequest メッセージを使用して、テーマ レコードの 1 つを現在のテーマにします。

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

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

関連項目

テーマ エンティティのメッセージおよびメソッド
Microsoft Dynamics 365 アプリケーションをカスタマイズする

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権