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

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

テーマのカスタマイズは、このリリースでは、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 エンティティ属性について説明しています。

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

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

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

参照

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