Abfragen und Bearbeiten eines Organisationsdesigns

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können visuelle Designs für eine Organisation definieren und anwenden. Dies bietet eine unterstützte Methode, um das Logo und die Farbauswahl einer Organisation für die Anwendung zu übernehmen. Sie können ein angepasstes Design für Ihre Anwendung erstellen, indem Sie Änderungen an den Standardfarben und visuellen Elementen im nicht benutzerdefinierten Dynamics 365-System vornehmen. Sie können beispielsweise Ihr persönliches Produktbranding erstellen, ein Unternehmenslogo hinzufügen und entitätsspezifischen Farbton zur Verfügung stellen. Die Designfarben werden global bei der Anwendung übernommen, mit Ausnahme einiger Vorgängerbereiche.

Hinweis

Diese Funktion wurde mit CRM Online 2015 Update 1 und CRM 2016 (lokal) eingeführt.

Die Designanpassung wird in dieser Version nur für die Webanwendung unterstützt. Änderungen, die für das Design einer Organisation vorgenommen werden, sind nicht in Lösungen enthalten, die von der Organisation exportiert werden. Sie können mehrere Designs definieren, jedoch kann nur eins als das Standarddesign festgelegt und veröffentlicht werden.

Video: Designs in Microsoft Dynamics CRM

In diesem Thema

Abfrage des aktuellen Designs

Bearbeiten und Veröffentlichen von Sie Designdaten

Exportieren und Importieren von Designs

Abfrage des aktuellen Designs

Möglicherweise müssen Sie das aktuelle Design mithilfe des clientseitigen Codes abfragen, wenn Sie eine Lösung mit HTML-Webressourcen haben, die Sie für die Designauswahl für eine Organisation anpassen möchten. Sie können die folgende Abfrage mit dem Web-API verwenden, um diese Informationen abzurufen.

Anforderung:

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

Antwort:

    {
        "@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"
            }
        ]
    }

Weitere Informationen:Datenabfrage mit Web-API.

Bearbeiten und Veröffentlichen von Sie Designdaten

Ein Design wird erstellt, indem die Anpassungstools in der Benutzeroberfläche verwendet werden, ohne dass ein Entwickler hierfür Code schreiben muss. Informationen zur Anwendung dieser Anpassungen finden Sie in TechNet: Ändern des Farbschemas oder Hinzufügen eines Logos entsprechend der Marke Ihrer Organisation.

Die meisten Designdaten werden innerhalb der Designentität gespeichert. Benutzerdefinierte Farben für bestimmte Entitäten sind in der EntityMetadata.EntityColor-Eigenschaft enthalten. Diese Daten werden mit der Entität exportiert, wenn die Entität einer Lösung hinzugefügt wurde.

Die folgende Tabelle beschreibt die Theme-Entitätsattribute, die zulässig sind für Updates und Daten enthalten, die vom Design angewendet wurden:

Schemaname	Typ	Der Wert des Standarddesigns	Beschreibung
ControlBorder	Zeichenfolge	#CCCCCC	Die Farbe, die Steuerelemente für Ränder auswählen.
ControlShade	Zeichenfolge	#F3F1F1	Die Farbe für Steuerelemente, die angibt, dass auf ein Element gezeigt wird.
DefaultCustomEntityColor	Zeichenfolge	#006551	Die Standardfarbe für benutzerdefinierte Entitäten, wenn keine Farbe zugewiesen ist.
DefaultEntityColor	Zeichenfolge	#8B98AB	Die Standardfarbe für Systementitäten aus, wenn keine Farbe zugewiesen ist.
GlobalLinkColor	Zeichenfolge	#1160B7	Die Farbe für Links wie E-Mail-Adressen oder Suchbegriffe
HeaderColor	Zeichenfolge	#1160B7	Die Farbe für Überschriftentext (also beispielsweise für die Beschriftung von Formularregisterkarten).
HoverLinkEffect	Zeichenfolge	#D7EBF9	Die Farbe, die in Befehlen oder Listen verwendet wird, wenn Sie auf Elemente zeigen.
LogoId	Zeichenfolge	NULL	Der Name einer als Logo zu verwendende Webressource. Empfohlene Dimensionen sind eine Höhe von 50 Pixel und eine maximale Breite von 400 Pixel.
LogoToolTip	Zeichenfolge	Microsoft Dynamics 365	Der Text, der als QuickInfo und alternativer Text für das Logo verwendet wird.
Name	Zeichenfolge	Dynamics 365-Standard-Design	Der Name der Designentität.
NavBarBackgroundColor	Zeichenfolge	#002050	Die Primärfarbe für die Navigationsleiste.
NavBarShelfColor	Zeichenfolge	#DFE2E8	Die Sekundärfarbe für die Navigationsleiste.
ProcessControlColor	Zeichenfolge	#0755BE	Die Primärfarbe für Prozesssteuerelemente.
SelectedLinkEffect	Zeichenfolge	#B1D6F0	Die Farbe, die in Befehlen oder Listen für ausgewählte Elemente verwendet wird.

Nachdem Sie Änderungen übernommen haben, verwenden Sie die Nachricht PublishThemeRequest, um einen der Designdatensätze zum aktuellen Design zu machen.

Exportieren und Importieren von Designs

Da Designs nicht als Teil einer Lösung enthalten sind, können Sie, wenn Sie Designs von einer Organisation in die andere übertragen möchten, das Konfigurationsmigrationstool verwenden, um ein Schema zu generieren, Designdaten zu exportieren und sie in eine andere Organisation zu importieren. Ausführliche Informationen zur Verwendung dieses Tools finden Sie unter Verwalten von Konfigurationsdaten.

Siehe auch

Entitätsnachrichten und -methoden für Designs
Anpassen der Microsoft Dynamics 365-Anwendungen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright