Abfragen und Bearbeiten eines Organisationsdesigns

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 benutzerdefiniertes Thema für Ihre Anwendung erstellen, indem Sie Änderungen an den Standardfarben und visuellen Elementen vornehmen, die in dem nicht angepassten modellbasierten Apps-System bereitgestellt werden. Sie können beispielsweise Ihr persönliches Produktbranding erstellen, ein Unternehmenslogo hinzufügen und tabellenspezifischen Farbton zur Verfügung stellen. Die Designfarben werden global bei der Anwendung übernommen, mit Ausnahme einiger Vorgängerbereiche.

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, aber nur eines kann als Standarddesign festgelegt und veröffentlicht werden.

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 [Organization URI]/api/data/v9.0/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor

Antwort:

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{  
    "@odata.context": "[Organization URI]/api/data/v9.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": "Model-driven apps",  
            "hoverlinkeffect": "#D7EBF9",  
            "navbarshelfcolor": "#DFE2E8",  
            "navbarbackgroundcolor": "#002050",  
            "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"  
        }  
    ]  
}  

Mehr Informationen: Datenabfrage über die 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 zum Anwenden dieser Anpassungen finden Sie in Verwenden Sie ein Design, um ein benutzerdefiniertes Aussehen für Ihre App zu erstellen.

Die meisten Designdaten werden in der Thementabelle gespeichert. Benutzerdefinierte Farben für bestimmte Tabellen sind in der Eigenschaft EntityMetadata.EntityColor enthalten. Diese Daten werden mit der Tabelle exportiert, wenn die Tabelle einer Lösung hinzugefügt wurde.

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

Nachdem Sie die Änderungen vorgenommen haben, verwenden Sie die PublishTheme Aktion oder die Klasse PublishThemeRequest, um einen der Design-Datensä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. Weitere Informationen dazu, wie Sie das Tool verwenden, finden Sie unter Verschieben von Konfigurationsdaten zwischen Umgebungen und Organisationen mit dem Tool zur Konfigurationsmigration.

Siehe auch

Thementabelle
Design erstellen
Entwicklerhandbuch zur Anpassung