Unterstützte Erweiterungen

  • Artikel

Sie können Dynamics 365 Customer Engagement (on-premises) anpassen, indem Sie Tools verwenden, die in der Webanwendung Dynamics 365 Customer Engagement (on-premises) verfügbar sind oder die in den Dynamics 365 Customer Engagement Webdiensten beschrieben sind. Diese Anpassungen werden unterstützt und können aktualisiert werden.

Anpassungen, die mit anderen Methoden als den hier beschriebenen Methoden vorgenommen werden, sind nicht unterstützt und können während Updates und Upgrades auf Dynamics 365 Customer Engagement (on-premises) Probleme verursachen. Weitere Informationen finden Sie unter Nicht unterstützte Anpassungen.

Die Themen, die technischen Artikeln veröffentlicht wurden auf Microsoft-Websites wie MSDN oder dieser, werden unterstützt, sind jedoch möglicherweise nicht erweiterungsfähig.

Anpassungen mit der Dynamics 365 Customer Engagement (on-premises) Webanwendung.

Es gibt eine Reihe von Tools, die in Dynamics 365 Customer Engagement (on-premises) enthalten sind und die Sie für die Anpassung verwenden können. Die Anpassungen, die mithilfe von Dynamics 365 Customer Engagement (on-premises) Tools und Webanwendungen vorgenommen werden, werden vollständig unterstützt und sind vollständig aktualisierbar.

Die folgenden Anpassungsmethoden können verwendet werden, um vollständig unterstützte Anpassungen zu erstellen:

Notiz

Vollständig unterstützt bedeutet, dass der Entwickler-Support Hilfe bei Anpassungen leisten kann und dass der Anwendungs-Support Kunden beim Ausführen dieser Änderungen helfen kann.

Weitere Informationen zur Verwendung der Anpassungstools in der Webanwendung finden Sie unter Anpassungshandbuch für (Dynamics 365 Customer Engagement (on-premises)).

Anpassungen mithilfe des Dynamics 365 Customer Engagement (on-premises) SDK

Die Dynamics 365 Customer Engagement Webdienste, die technischen Artikel und der Beispielcode, die auf dieser Website veröffentlicht werden, sowie die vom Dynamics 365 Customer Engagement (on-premises) Developer Support Team herausgegebenen Informationen gehören zum Bereich der Anpassungen, die die Dynamics 365 Customer Engagement Webdienste nutzen. Die bestimmten Aktionen und Ebenen der Supportfähigkeit und Aktualisierbarkeit werden weiter unten in diesem Thema beschrieben.

Dynamics 365 Customer Engagement (on-premises)-Webdienste

Die Verwendung von Webdiensten wird vollständig unterstützt. Dazu gehören: Discovery Service, Organization Service, Organization Data Service, die Web-API und der Deployment Service. Wir bemühen uns, die APIs abwärtskompatibel zu halten, behalten uns jedoch das Recht vor, APIs für zusätzliche Features zu ändern. Entitätsattribute können sich in zukünftigen Versionen möglicherweise auch ändern. Weitere Informationen finden Sie unter Schreiben von Code für Dynamics 365 Customer Engagement (on-premises) (Webdienste).

Clientseitiges JavaScript

Sie können JavaScript innerhalb von Dynamics 365 Customer Engagement (on-premises) in drei Bereichen verwenden:

  • Formularskriptereignishandler: Sie können Formularereignishandler so konfigurieren, dass sie Funktionen aufrufen, die in JavaScript-Webressourcen definiert sind.

  • Befehle auf der Befehlsleiste (Menüband): Sie können die Elemente oder <CustomRule> oder <JavaScriptFunction> verwenden, um Aktionen zu definieren, die Features aufrufen, die in JavaScript-Webressourcen definiert sind.

  • Webressourcen und IFRAMEs: Sie können JavaScript-Webressourcen innerhalb von HTML-Webressourcen verwenden. IFRAMES, die so konfiguriert sind, dass sie siteübergreifendes Skripting erlauben, oder Skripts in HTML-Webressourcen, die in einem Formular enthalten sind, interagieren ggf. mit den dokumentierten Xrm.Utility oder Xrm.Page-Methoden innerhalb des Formulars über den übergeordneten Verweis.

    Alle Interaktion mit Dynamics 365 Customer Engagement (on-premises)-Anwendungsseiten dürfen nur über die Methoden mit den Methoden durchgeführt werden, die in der Client-API-Referenz dokumentiert sind. Direkter Zugriff auf das Dokumentobjektmodell (DOM) von Dynamics 365 Customer Engagement (on-premises)-Anwendungsseiten wird nicht unterstützt. Die Verwendung von jQuery in Formularskripten und Befehlen wird nicht empfohlen. Weitere Informationen: Client Scripting in Customer Engagement (on-premises) mit JavaScript

    Sie können die Dynamics 365 Customer Engagement (on-premises) Formulare , Ansichten, Dialogfelder und Berichte mithilfe der Identifizierungsmöglichkeiten öffnen, die in Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL dokumentiert sind.

Menübandanpassung

Die Verwendung von RibbonDiffXml zum Hinzufügen, Entfernen oder Ausblenden von Menübandelementen wird unterstützt. Die Wiederverwendung von Menübandbefehlen, die von Dynamics 365 Customer Engagement (on-premises) definiert werden, wird unterstützt, allerdings behalten wir uns das Recht vor, die verfügbaren Befehle zu ändern oder zu entfernen. Die Wiederverwendung von JavaScript-Funktionen, die in den Menübandbefehlen definiert werden, wird nicht unterstützt.

Lösungsdatei

Die Änderung einer Datei einer nicht verwalteten Lösung wird unterstützt, wie in dieser Dokumentation beschrieben. Bestimmte Anpassungsaufgaben werden mithilfe dieser Schritte ausgeführt:

  • Exportieren einer Lösungskomponente als nicht verwaltete Lösung.

  • Extrahieren der Inhalte des Lösungspakets.

  • Bearbeiten der Customizations.xml-Datei.

  • Neupacken der Lösungsdatei.

  • Importieren der geänderten Lösung.

    Notiz

    Änderungen an der Datei Customizations.xml müssen dem CustomizationsSolution.xsd-Schema entsprechen. Für weitere Informationen siehe Verwendete Schemas in Dynamics 365 Customer Engagement (on-premises).

Die folgenden unterstützten Aufgaben erfordern diese Vorgehensweise:

  • Menübandanpassung.
  • Anpassung der Anwendungsnavigation mithilfe von SiteMap.
  • Formular- und Dashboardanpassung mithilfe FormXml.
  • Anpassung gespeicherter Abfragen.

Plug-Ins

Die Fähigkeit, eine angepasste Geschäftslogik mithilfe des in dieser Dokumentation beschriebenen Plug-In-Mechanismus zu erstellen, wird vollständig unterstützt und ist aktualisierbar. Dieses Feature ist für alle Dynamics 365 Customer Engagement (on-premises)-Bereitstellungen, einschließlich lokal, IFD und Online-Bereitstellungen verfügbar. Plug-Ins können jedoch nur im Sandkasten (Isolation) von Dynamics 365 Customer Engagement (on-premises) registriert und ausgeführt werden. Weitere Informationen: Plug-ins für die Erweiterung von Dynamics 365 Customer Engagement (on-premises)

Das Hinzufügen von Plug-In- und Workflowaktion-Assemblys zum %installdir%\server\bin\-Ordner wird nur auf lokalen und IFD-Serverinstallationen von Dynamics 365 Customer Engagement (on-premises) unterstützt.

Workflow

Die Möglichkeit, angepasste Workflowaktivitäten (Assemblys) zu erstellen, die von Workflowregeln aufgerufen werden können, ist vollständig unterstützt und kann aktualisiert werden. Dieses Feature ist für Dynamics 365 Customer Engagement (on-premises) lokal, IFD und Online verfügbar. Angepasste Workflowaktivitäten können jedoch nur im Sandkasten (Isolation) von Dynamics 365 Customer Engagement (on-premises) registriert und aktiviert werden. Weitere Informationen: Automatisieren Sie Ihre Geschäftsprozesse in Customer Engagement

Die Möglichkeit zum Bearbeiten von XAML-Workflows ist vollständig unterstützt und aktualisierbar. Dieses Feature ist jedoch nur für Dynamics 365 Customer Engagement (on-premises) lokal und IFD verfügbar. Weitere Informationen: Automatisieren Sie Ihre Geschäftsprozesse in Customer Engagement (on-premises)

Unterstützung für .NET Framework-Versionen

Im Folgenden werden die Unterstützungsüberlegungen für benutzerdefinierten Code, die mit Microsoft .NET Framework 4.6.2 geschrieben wurde.

  • Jeder Webdienstclient, der mithilfe von Microsoft .NET Framework 4.6.2 oder höher verwendet wird, die den Dynamics 365 Customer Engagement (on-premises) Webservices aufruft, wird in Dynamics 365 Customer Engagement (on-premises) vollständig unterstützt.

    Wichtig

    Sie sollten alle benutzerdefinierten Client-Anwendungen mit Microsoft .NET Framework 4.6.2 oder höher erstellen. Ab Dynamics 365 Customer Engagement (on-premises) Version 9 sind für die Verbindung nur Anwendungen zulässig, die die Sicherheit auf Transportebene (TLS) 1.2 oder höher verwenden. TLS 1.2 ist nicht das Standardprotokoll, das von .NET Framework 4.5.2 verwendet wird, aber es ist in .NET Framework 4.6.2.

    Die Durchsetzung dieses höheren Sicherheitsstandards wird diesmal nur auf Dynamics 365 Customer Engagement (on-premises) Version 9 angewendet. Wenn Ihre Clients so konzipiert sind, dass sie mit jeder Version oder jedem Bereitstellungstyp verbunden werden können, können Sie sich vorbereiten, indem Sie die Anwendung auf die Verwendung von .NET Framework 4.6.2 umstellen. Weitere Informationen: Blogbeitrag: Kommende Updates zu Dynamics 365 Customer Engagement (on-premises)-Verbindungssicherheit

  • Sämtliche .NET-Assemblys, die mit Microsoft .NET Framweor 4.6.2 zur Verwendung in Dynamics 365 Customer Engagement (on-premises) als Dynamics 365 Customer Engagement (on-premises) Plug-in-Assembly oder als Dynamics 365 Customer Engagement (on-premises) benutzerdefinierte Workflowaktivität erstellt werden , werden unterstützt.

  • Jede Visualisierung (Diagramm), die mit .NET Framework 4.5.2 erstellt wird.

Nicht unterstützte Anpassungen

Änderungen an Dynamics 365 Customer Engagement (on-premises), die ohne die Verwendung der Methoden, die in dieser Dokumentation beschrieben sind oder Dynamics 365 Customer Engagement (on-premises)-Tools vorgenommen werden, werden nicht unterstützt und werden während Updates oder Upgrades von Dynamics 365 Customer Engagement (on-premises) nicht beibehalten. Alles, was nicht in dieser Dokumentation und den unterstützenden Dokumenten dokumentiert wird, wird nicht unterstützt. Außerdem könnten nicht unterstützte Änderungen Probleme verursachen, wenn Sie durch das Hinzufügen von Hotfixes oder Service Packs aktualisieren oder Dynamics 365 Customer Engagement (on-premises) aktualisieren. Zur Minimierung der Update- und Upgradeprobleme ändern Sie keine Dynamics 365 Customer Engagement (on-premises)-Datei, die Sie nicht selbst erstellt haben.

Im Folgenden finden Sie eine Liste nicht unterstützter Aktionstypen, nach denen häufig gefragt wird:

  • Änderungen an sämtlichen .aspx-, .css, .htm-, .js-, .xml-, .jpg- oder .gif-Dateien oder das Hinzufügen von Dateien in den wwwroot-Verzeichnissen der Dynamics 365 Customer Engagement (on-premises)-Anwendung, der Dynamics 365 Customer Engagement (on-premises)-Tools oder Dynamics 365 Customer Engagement (on-premises)-Dateien, die sich unter Program Files\\Dynamics 365 Customer Engagement (on-premises) befinden. Wenn Sie jedoch Änderungen an den Daten vorgenommen haben, werden diese Dateien auf Änderungen überprüft und werden nicht überschrieben.

  • Änderungen an der Dynamics 365 Customer Engagement (on-premises)-Website (Datei und Websiteeinstellungen). Benutzerdefinierte Anwendungen müssen in einer anderen Website installiert werden. Dazu gehören Änderungen an den Dateisystem-Zugriffskontrolllisten (ACLs) aller Dateien auf dem Dynamics 365 Server.

  • Die Verwendung von Clientzertifikaten wird nicht unterstützt. Wenn Sie die Dynamics 365 Customer Engagement (on-premises)-Website so konfigurieren, dass IIS-Clientzertifikate erforderlich sind, erhalten Sie Authentifizierungsfehler bei allen Anwendungen, die mithilfe des SDK erstellt wurden.

  • Änderungen am physischen Schema der Datenbank, abgesehen vom Hinzufügen oder Aktualisieren von Indizes. Dies umfasst alle Aktionen, die für die Datenbank ausgeführt werden, ohne dass Systemanpassungsmöglichkeiten in der Webanwendung oder die Metadaten-APIs verwenden wurden, die in dieser SDK-Dokumentation beschrieben sind. Das Ändern von Tabellen, gespeicherten Prozeduren oder Ansichten in der Datenbank wird nicht unterstützt. Das Hinzufügen von Tabellen, gespeicherten Prozeduren oder Ansichten in der Datenbank wird ebenfalls aufgrund der referenziellen Integrität oder Problemen beim Upgrade nicht unterstützt. Für lokale Dynamics 365 Customer Engagement (on-premises)-Bereitstellungen wird das Hinzufügen von Indizes gemäß den Richtlinien in der Bereitstellen und Verwalten von Microsoft Dynamics 365 Customer Engagement (on-premises)-Dokumentation. Dies gilt für alle Dynamics 365 Customer Engagement (on-premises)-Datenbanken und die lokale Dynamics 365 for Outlook-Datenbank.

    Wichtig

    Wenn die Datenbank geändert wird, ohne dass die Unterstützungsmethoden für die Systemanpassung angewendet werden, gehen Sie das Risiko ein, dass Probleme während der Updates und Upgrades auftreten.

  • Daten(satz)änderungen in der Dynamics 365 Customer Engagement (on-premises)-Datenbank mithilfe von SQL-Befehlen oder einer anderen Technologie außer denen, die in dieser Dokumentation beschrieben sind.

  • Verweisen von Dynamics 365 Customer Engagement (on-premises)-Dynamic-Link-Libraries (DLLs) abgesehen von Folgenden:

    • Microsoft.Crm.Outlook.Sdk.dll
    • Microsoft.Crm.Sdk.Proxy.dll
    • Microsoft.Xrm.Sdk.dll
    • Microsoft.Xrm.Sdk.Data.dll
    • Microsoft.Xrm.Sdk.Deployment.dll
    • Microsoft.Xrm.Sdk.Workflow.dll
    • Microsoft.Xrm.Tooling.Connector.dll
    • Microsoft.Xrm.Tooling.CrmConnectControl.dll
    • Microsoft.Xrm.Tooling.PackageDeployment.CrmPackageExtentionBase.dll
    • Microsoft.Xrm.Tooling.WebResourceUtility.dll

  • Die Nutzung von Anwendungsprogrammierschnittstellen (APIs) abgesehen von den in den Webdiensten: Web-API, Organisationsdienst, Bereitstellungsdienst, Suchdienst, Organisationsdatendienst dokumentierten.

  • Um die Darstellung und das Verhalten von Dynamics 365 Customer Engagement (on-premises) zu erreichen, die Wiederverwendung von sämtlichen Dynamics 365 Customer Engagement (on-premises)-Benutzeroberflächensteuerelementen, einschließlich der Rastersteuerelemente. Diese Schnittstellen können sich ändern oder werden bei einem Upgrade überschrieben. Es wird nicht empfohlen, die Default.css-Datei im Dynamics 365 Customer Engagement (on-premises)-Stamminstallationsordner zu verwenden oder zu ändern.

  • Die Wiederverwendung von Dynamics 365 Customer Engagement (on-premises)-JavaScript-Code, einschließlich Menübandbefehle. Dieser Code könnte bei einem Upgrade geändert oder überschrieben werden.

  • Änderungen an einem der Dynamics 365 Customer Engagement (on-premises)-Formulare oder Hinzufügen neuer Formulare, wie z.B. angepasste .aspx-Seiten, direkt in Office Outlook oder Änderungen an .pst-Dateien. Diese Änderungen werden nicht aktualisiert.

  • Das Vornehmen von Anpassungen, außer wenn Sie die unterstützten Dynamics 365 Customer Engagement (on-premises)-Tools, die offline in Dynamics 365 for Outlook verfügbar sind, verwenden.

  • Die Verwendung von benutzerdefinierten HttpModules zum Injizieren in HTML/DHTML Dynamics 365 Customer Engagement (on-premises)-Formulare.

  • Das Erstellen eines Plug-In-Assemblys für ein Standard-Dynamics 365 Customer Engagement (on-premises)-Assembly (Microsoft.Crm.*.dll) oder zum Ausführen eines Updates oder Löschens einer Plattform, die in pluginassembly erstellt wurde, wird nicht unterstützt.

  • Das Erstellen einer Internet Information Services (IIS)-Anwendung innerhalb der Website Dynamics 365 Customer Engagement (on-premises) für ein beliebiges VDir und speziell innerhalb des ISV-Ordners wird nicht unterstützt. Der Ordner <crmwebroot>\ISV wird nicht mehr unterstützt.

  • Bearbeiten einer Lösungsdatei zum Bearbeiten von Lösungskomponenten, abgesehen von Menübändern, Formularen, SiteMap oder gespeicherten Abfragen wird nicht unterstützt. Weitere Informationen finden Sie unter Support für die Bearbeitung der Anpassungs-Datei. Das Definieren neuer Lösungskomponenten durch das Bearbeiten der Lösungsdatei wird nicht unterstützt. Das Bearbeiten der Webressourcendateien, die mit einer Lösung exportiert werden, wird nicht unterstützt. Abgesehen von den Schritten, die in Bearbeiten einer verwalteten Lösung dokumentiert werden, wird das Bearbeiten von Inhalten einer verwalteten Lösung nicht unterstützt.

  • Silverlight Application Library Caching wird nicht unterstützt.

  • Beim Anzeigen eines Entitätsformulars mit einem IFrame, der eingebettet in einem anderen Entitätsformular ist, wird nicht unterstützt.

  • Plug-In- und Workflow-Assemblys müssen die gesamte notwendige Logik innerhalb der jeweiligen DLL enthalten. Plug-Ins können auf einige Kern-.Net-Assemblys verweisen. Allerdings werden Abhängigkeiten auf .Net-Assemblys nicht unterstützt, die mit Windows-APIs auf niedriger Ebene, wie der Grafikentwurfsschnittstelle, interagieren. Zuvor ließ Dynamics 365 Customer Engagement zu, dass Assemblys auf diese Schnittstellen verweist, um aber den Sicherheitsstandards gerecht zu werden, sind Änderungen an dem Verhalten erforderlich.

Siehe auch

Auswählen des Entwicklungsstils für verwalteten Code
Schreiben von Code für Dynamics 365 Customer Engagement (on-premises) (Webdienste)
Clientskripting mit Customer Engagement (on-premises) mithilfe von JavaScript