다음을 통해 공유

조직 테마 쿼리 및 편집

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

조직에 대한 시각적 테마를 정의하고 적용할 수 있습니다. 또한 응용 프로그램에 조직의 로고 및 색을 적용하는 지원되는 방법을 제공합니다. 사용자 지정되지 않은 Dynamics 365 시스템에서 제공하는 기본 색상과 시각적 요소를 변경하여 응용 프로그램에 대한 사용자 지정 테마를 만들 수 있습니다. 예를 들어, 개인 제품 브랜드를 만들고 회사 로고를 추가하고 엔터티 특정 컬러를 제공할 수 있습니다. 테마 색상은 일부 레거시 영역을 제외하고는 응용 프로그램 전체에 전역적으로 적용됩니다.

참고

이 기능은 CRM Online 2015 업데이트 1 및 CRM 2016(온-프레미스)에서 소개되었습니다.

테마 사용자 지정은 웹 응용 프로그램의 경우에만 이 릴리스에서 지원됩니다. 조직의 테마 변경은 조직에서 내보내는 솔루션에는 포함되지 않습니다. 여러 테마를 정의할 수 있지만 기본 테마로 하나만 설정하고 게시할 수 있습니다.

비디오: Microsoft Dynamics CRM의 테마

이 항목의 내용

현재 테마를 쿼리합니다.

테마 데이터 편집 및 게시

테마 내보내기 및 가져오기

현재 테마를 쿼리합니다.

HTML 조직에 대해 선택한 테마에 적용하려는 웹 리소스가 있는 솔루션이 있는 경우 클라이언트측 코드를 사용하여 현재 테마를 쿼리해야 할 수 있습니다. 해당 정보를 검색하려면 웹 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"
        }
    ]
}

추가 정보:웹 API를 사용하여 데이터 쿼리.

테마 데이터 편집 및 게시

테마는 개발자가 코드를 작성할 필요 없이 UI의 사용자 지정 도구를 사용하여 만듭니다. 이러한 사용자 지정을 적용하는 방법에 대한 자세한 내용은 TechNet: 조직의 브랜드와 일치하도록 색 구성표를 변경하거나 로고를 추가에서 볼 수 있습니다.

대부분의 테마 데이터는 테마 엔터티 내에 저장됩니다. 특정 엔터티에 대한 사용자 지정 색은 EntityMetadata.EntityColor 속성에 포함됩니다. 이 데이터는 엔터티가 솔루션에 포함되어 있는 경우 엔터티와 함께 내보내집니다.

다음 표는 업데이트에 유효한 Theme 엔터티 특성을 설명하며 테마에 의해 적용되는 데이터를 포함합니다.

스키마 이름

유형

기본 테마 값

설명

ControlBorder

문자열

#CCCCCC

컨트롤이 테두리에 사용할 색입니다.

ControlShade

문자열

# F3F1F1

항목 위를 가리킬 때 사용할 컨트롤의 색입니다.

DefaultCustomEntityColor

문자열

#006551

색이 할당되지 않은 경우 기본 사용자 지정 엔터티 색입니다.

DefaultEntityColor

문자열

#8B98AB

색이 할당되지 않은 경우 시스템 엔터티의 기본 색입니다.

GlobalLinkColor

문자열

#1160B7

전자 메일 주소 또는 조회와 같은 링크 색입니다.

HeaderColor

문자열

#1160B7

양식 탭 레이블 같은 머리글 텍스트에 사용할 색입니다.

HoverLinkEffect

문자열

#D7EBF9

항목 위를 가리킬 때 사용할 명령 또는 목록 색입니다.

LogoId

문자열

null

로고로 사용할 웹 리소스의 이름입니다. 권장되는 크기는 높이 50픽셀과 최대 너비 400픽셀입니다.

LogoToolTip

문자열

Microsoft Dynamics 365

도구 설명으로 사용할 텍스트와 로고로 사용할 대체 텍스트입니다.

Name

문자열

Dynamics 365 기본 테마

테마 엔터티의 이름입니다.

NavBarBackgroundColor

문자열

#002050

기본 탐색 모음 색입니다.

NavBarShelfColor

문자열

#DFE2E8

보조 탐색 모음 색입니다.

ProcessControlColor

문자열

#0755BE

프로세스 컨트롤에 사용할 기본 색입니다.

SelectedLinkEffect

문자열

#B1D6F0

선택한 항목을 나타내기 위해 사용할 명령 또는 목록 색입니다.

변경 내용을 적용한 후 PublishThemeRequest 메시지를 사용하여 테마 레코드 중 하나를 현재 테마로 만듭니다.

테마 내보내기 및 가져오기

테마는 솔루션의 일부로 포함되지 않으므로 한 조직에서 다른 조직으로 테마를 전송하려는 경우 Configuration Migration 도구를 사용하여 스키마를 생성하고 테마 데이터를 내보내고 다른 조직으로 가져올 수 있습니다. 이 도구를 사용하는 방법에 대한 자세한 내용은 구성 데이터 관리를 참조하십시오.

참고 항목

테마 엔터티 메시지 및 메서드
Microsoft Dynamics 365 응용 프로그램 사용자 지정

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보