Delen via

Ondersteunde extensies voor Microsoft Dynamics 365

  • Artikel

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

U kunt Microsoft Dynamics 365 (online en on-premises) aanpassen met hulpprogramma's die in de Microsoft Dynamics 365 webtoepassing beschikbaar zijn of die worden beschreven in de Microsoft Dynamics 365 SDK. Deze aanpassingen worden ondersteund en kunnen worden bijgewerkt.

Aanpassingen die zijn aangebracht op buiten de hier beschreven methoden worden niet ondersteund en kunnen problemen veroorzaken tijdens updates en het bijwerken van Microsoft Dynamics 365. Zie Niet-ondersteunde aanpassingen voor meer informatie.

Onderwerpen die in technische artikelen worden besproken die op MSDN zijn gepubliceerd, in het CRM developer center op MSDN worden ondersteund maar mogelijk niet bijgewerkt.

In dit onderwerp

Aannpassingen als u de Microsoft Dynamics CRM-webtoepassing gebruikt

Aanpassingen die de Microsoft Dynamics 365 SDK gebruiken

Ondersteuning voor .NET Framework-versies

Niet-ondersteunde aanpassingen

Aannpassingen als u de Microsoft Dynamics CRM-webtoepassing gebruikt

U kunt verschillende hulpmiddelen gebruiken die zijn in begrepen bij Microsoft Dynamics 365 om het aan te passen. Aanpassingen gemaakt met de Microsoft Dynamics 365 hulpprogramma's en de webtoepassing zijn volledig ondersteund en kunnen volledig worden bijgewerkt.

Met de volgende aanpassingsmethoden kunt u volledig ondersteunde aanpassingen maken:

Notitie

Volledige ondersteuning betekent dat de ondersteuning voor ontwikkelaars hulp voor aanpassingen kan verlenen en de toepassinsgondersteuning klanten kan helpen met het uitvoeren van aanpassingen.

Voor meer informatie over het gebruik van de hulpmiddelen voor aanpassingen in de webtoepassing raadpleegt u Aanpassingshandleiding voor Microsoft Dynamics CRM 2016 en Microsoft Dynamics CRM Online.

Aanpassingen die de Microsoft Dynamics 365 SDK gebruiken

Die technische artikelen, en voorbeeldcode voor Microsoft Dynamics 365 SDK gepubliceerd op Microsoft Dynamics CRM Developer Center, en de informatie van het Microsoft Dynamics 365 Ontwikkelaarondersteuningsteam zijn opgenomen in het gebied aanpassingen van Microsoft Dynamics 365 SDK. De specifieke acties en de niveaus van ondersteuning en bijwerken worden verderop beschreven in dit onderwerp.

Microsoft Dynamics 365 SDK

Het gebruik van webservices is de volledig ondersteund. Dit omvat: DiscoveryService, OrganizationService, Organization Data Service, het OData-eindpunt, het moderne app SOAP-eindpunt en de DeploymentService. We streven ernaar om API's compatibel met eerdere versies te houden maar behouden het recht om API's te wijzigen voor extra functies. Entiteitskenmerken kunnen in toekomstige versies ook wijzigen. Zie voor meer informatie Microsoft Dynamics 365 uitbreiden op de server en De installatie beheren met de installatiewebservice.

JavaScript aan de clientzijde

U kunt JavaScript in Microsoft Dynamics 365 (online en on-premises) in drie gebieden gebruiken:

  • Handlers voor gebeurtenissen van formulierscripts: U kunt formuliergebeurtenishandlers configureren om functies die in JavaScript gedefinieerd zijn op te roepen.

  • Opdrachtbalk (lint) opdrachten: U kunt de elementen van <CustomRule> (RibbonDiffXml) of <JavaScriptFunction> (RibbonDiffXml) gebruiken om acties te definiëren waardoor functies worden gedefinieerd in JavaScript-webresources.

  • IFRAMES en webresources: U kunt JavaScript gebruiken in HTML-webresources. IFRAMES die zijn geconfigureerd om scripts toe te staan op meerdere sites, of de scripts in de HTML-webresources van een formulier, kunnen interactie hebben met de gegedocumenteerde Xrm.Page of Xrm.Utility methoden in het formulier via de bovenliggende referentie.

Al deze communicatie met Microsoft Dynamics 365 toepassingspagina's mag alleen via de methoden met de Xrm.Page of Xrm.Utility naamruimtes worden uitgevoerd, zoals vastgelegd in de Programmeerreferentie op de client. Directe toegang tot het Document Object Model (DOM) van Microsoft Dynamics 365 toepassingpagina's is niet ondersteund. Het gebruik van jQuery in formulierscripts en opdrachten wordt niet aanbevolen.Meer informatie:b7840a25-f25e-409b-8b6a-0ef04c7ed9c4#BKMK_UsingjQuery

U kunt de formulieren, de weergaven, dialogen, en rapporten van Microsoft Dynamics 365 openen via de methoden die worden beschreven in Formulieren, weergaven, dialogen en rapporten met een URL openen.

Lint aanpassen

Het gebruik van RibbonDiffXml om elementen van het lint toe te voegen, te verwijderen, en te verbergen wordt ondersteund. Het hergebruik van lintopdrachten die door Microsoft Dynamics 365 worden gedefinieerd wordt ondersteund; echter, we behouden ons het recht om de beschikbare opdrachten te wijzigen of af te schaffen. Het hergebruik van JavaScript-functies gedefinieerd in lintopdrachten wordt niet ondersteund.

Oplossingsbestand

De aanpassing van een onbeheerd oplossingsbestand wordt ondersteund zoals omschreven in Microsoft Dynamics 365 SDK. Bepaalde aanpassingstaken worden uitgevoerd met de volgende stappen:

  • Exporteer een oplossingsonderdeel als een onbeheerde oplossing.

  • Pak de inhoud van het oplossingspakket uit.

  • Bewerk het bestand Customizations.xml.

  • Oplossingenbestand opnieuw verpakken.

  • Importeer de gewijzigde oplossing.

Wijzigingen aan het bestand Customizations.xml moeten voldoen aan het schema CustomizationsSolution.xsd. Zie Schemas used in Microsoft Dynamics 365 voor meer informatie.

De volgende ondersteunde taken vereisen deze procedure:

  • Lint aanpassen.

  • Aanpassen van toepassingsnavigatie met SiteMap.

  • Formulier- en dashboardaanpassing met FormXml.

  • Aanpassing van pgeslagen query.

Invoegtoepassingen.

De mogelijkheid om aangepaste bedrijfslogica te maken met het plug-in-mechanisme dat wordt beschreven in de Microsoft Dynamics 365 SDK wordt volledig ondersteund en kan worden bijgewerkt. Deze functie is beschikbaar voor alle Microsoft Dynamics 365 installaties, met inbegrip van on-premises, IFD, en online. Echter, de plug-ins kunnen alleen in de sandbox (isolatie) van Microsoft Dynamics 365 (online) worden geregistreerd en worden uitgevoerd.Meer informatie:Invoegtoepassingen schrijven om bedrijfsprocessen uit te breiden

Het toevoegen van uw plug-ins en aangepaste workflowactiviteitenassembly's aan de map %installdir%\server\bin\ wordt alleen ondersteund op Microsoft Dynamics 365 on-premises- en IFD-serverinstallaties.

Werkstroom

Het vermogen om aangepaste workflowactiviteiten (assemblages) te maken van workflowregels wordt volledig ondersteunt en kan worden bijgewerkt. Deze functie is beschikbaar voor alle Microsoft Dynamics 365 on-premises, IFD, en online. Echter, de aangepaste werkstroomactiviteiten kunnen alleen in de sandbox (isolatie) van Microsoft Dynamics 365 (online) worden geregistreerd en uitgevoerd.Meer informatie:Bedrijfsprocessen automatiseren met het Dynamics 365-proces

De mogelijkheid om XAML-werkstromen te bewerken is volledige ondersteund en kan worden bijgewerkt. Echter deze functie is beschikbaar voor alle Microsoft Dynamics 365 on-premises, IFD, en online.Meer informatie:Bedrijfsprocessen automatiseren met het Dynamics 365-proces

Ondersteuning voor .NET Framework-versies

Het volgende beschrijft de ondersteuningoverwegingen voor aangepaste code die is geschreven met de Microsoft .NET Framework 4.5.2.

Elke webserviceclient die wordt gemaakt met Microsoft .NET Framework 4.5.2 die de Microsoft Dynamics 365-webservices aanroept, wordt volledig ondersteund in Microsoft Dynamics 365.

Elke .NET-assembly gemaakt met Microsoft .NET Framework 4.5.2 voor gebruik in Microsoft Dynamics 365 als een Microsoft Dynamics 365 plug-inassembly of een Microsoft Dynamics 365 aangepaste workflowactiviteit wordt ondersteund.

Elk visualisatie (grafiek) die is gemaakt met .NET Framework 4.5.2.

Niet-ondersteunde aanpassingen

De aanpassingen die in Microsoft Dynamics 365 zijn gemaakt zonder gebruik van het hulpmiddel Microsoft Dynamics 365 SDK of Microsoft Dynamics 365 zijn niet ondersteund en worden niet behouden tijdens updates of het bijwerken van Microsoft Dynamics 365. Alle informatie die niet wordt beschreven in de Microsoft Dynamics 365 SDK en de ondersteunende documenten is niet ondersteund. Bovendien kunnen niet-ondersteunde wijzigingen problemen veroorzaken als u update door de toevoeging van hotfixes en service packs of Microsoft Dynamics 365 bijwerkt. Wijzig om problemen bij het updaten en bijwerken te minimaliseren geen Microsoft Dynamics 365 bestand dat u niet zelf hebt gemaakt.

Hier volgt een lijst van niet-ondersteunde actietypen waar vaak naar wordt gevraagd:

  • Aanpassingen aan .aspx-, .css-, .htm-, .js-, .TXT-, .jpg-,of .gif-bestanden of de toevoeging van bestanden in de wwwroot mappen van de Microsoft Dynamics 365 toepassing, Microsoft Dynamics 365 hulpmiddelen of Microsoft Dynamics 365 bestanden die zich bevinden in Program Files\Microsoft Dynamics 365. Echter, als u deze bestanden hebt gewijzigd worden deze bestanden gecontroleerd op aanpassingen en niet overschreven.

  • Aanpassingen aan de Microsoft Dynamics 365 website (bestand en website-instellingen). Aangepaste oplossingen moeten in een andere website worden geïnstalleerd. Dit geldt ook voor de system access control lists (ACLS, bestandssysteemtoegangsbeheerlijsten) van alle bestanden op de Microsoft Dynamics 365 server.

  • Het gebruik van clientcertificaten wordt niet ondersteund door Microsoft Dynamics 365 SDK. Als u de Microsoft Dynamics 365 website configureert om IIS-clientcertificaten te vereisen, krijgt u verificatiefouten voor alle toepassingen die met de SDK zijn gebouwd.

  • Aanpassingen aan het fysieke schema van de database, buiten het toevoegen of bijwerken van indexen. Dit omvat alle acties die op de database worden verricht zonder gebruik te maken van de mogelijkheden voor systeemaanpassingen in de webtoepassing of het gebruik van metadata-API's beschreven in dese SDK-documentatie. Het wijzigen van de tabellen, procedures of weergaven die zijn opgeslagen in de database wordt niet ondersteund. Het toevoegen van tabellen, weergaven of opgeslagen procedures aan de database wordt ook niet ondersteund vanwege de referentiële integriteit of problemen bij het bijwerken. Voor on-premises installaties van Microsoft Dynamics 365 wordt het toevoegen van indexen ondersteund volgens de richtlijnen in de documentatie Microsoft Dynamics CRM installeren en beheren. Dit geldt voor alle Microsoft Dynamics 365-databases en de lokale Microsoft Dynamics 365 voor Outlook-database.

    Als u de database wijzigt zonder de ondersteuningmethoden voor systeemaanpassingen te gebruiken, loopt u een risico op problemen tijdens updates en upgrades.

  • Gegevens (record) wijzigen in de Microsoft Dynamics 365 database via SQL-opdrachten of technologie buiten die wordt beschreven in de Microsoft Dynamics 365 SDK.

  • Het raadplegen van elke Microsoft Dynamics 365 dynamic-links library (DLLs) buiten de volgende:

    • Microsoft.Xrm.Sdk.dll

    • Microsoft.Crm.Sdk.Proxy.dll

    • Microsoft.Xrm.Sdk.Workflow.dll

    • Microsoft.Xrm.Sdk.Deployment.dll

    • Microsoft.Crm.Outlook.Sdk.dll

    • Microsoft.Crm.Tools.EmailProviders.dll

  • Het gebruik van application programming interfaces (API's) buiten de gedocumenteerde API's in de webservices DeploymentService, DiscoveryService, de Organisatiegegevensservice, SOAP-eindpunt voor webresources en OrganizationService.

    Voor het bewerkstelligen van het uiterlijk en de werking van Microsoft Dynamics 365 , het hergebruik van Microsoft Dynamics 365 gebruikersinterfacebesturingselementen, inclusief de rasterbesturingselementen. Deze besturingselementen kunnen tijdens een upgrade worden gewijzigd of overschreven. We adviseren u het Default.css-bestand in de Microsoft Dynamics 365 hoofdmapinstallatiemap niet te gebruiken of te wijzigen.

  • Het hergebruik van eventuele codes van JavaScript Microsoft Dynamics 365, met inbegrip van lintopdrachten. Deze code kan tijdens een upgrade worden gewijzigd of overschreven.

  • Aanpassingen aan een van de Microsoft Dynamics 365 formulieren of het toevoegen van nieuwe formulieren, zoals aangepaste .aspx-pagina's, direct naar Microsoft Office Outlook of het wijzigen van .pst bestanden. Deze wijzigingen worden niet bijgewerkt.

  • Aanpassingen maken behalve wanneer u de Microsoft Dynamics 365 ondersteunde beschikbare hulpmiddelen offline gebruikt in Dynamics 365 voor Outlook.

  • Het gebruik van om aangepaste HttpModules om HTML/DHTML in de Microsoft Dynamics 365 formulieren op te nemen.

  • Het maken van plug-inassembly voor een standaard Microsoft Dynamics 365 assembly (Microsoft.Crm.*.dll) of in het uitvoeren van een update of verwijdering van een gemaakte platform pluginassembly wordt niet ondersteund.

  • De invoegtoepassingen en aangepaste workflowactiviteiten vanuit Microsoft Dynamics CRM 4.0 worden niet ondersteund.

  • Microsoft Dynamics CRM 4.0 service-eindpunt (2007 eindpunt) wordt niet ondersteund.

  • Het maken van een Internet Information Services (IIS) toepassing in de Microsoft Dynamics 365 website voor elke VDir en specifiek in de ISV-map wordt niet ondersteund. De map <crmwebroot>\ISV wordt niet meer ondersteund.

  • Het bewerken van een oplossingenbestand om oplossingsonderdelen buiten de linten, formulieren, SiteMap of opgeslagen query's te bewerken wordt niet ondersteund. Zie Wanneer u het aanpassingenbestand moet bewerken voor meer informatie. Het definiëren van nieuwe oplossingsonderdelen door het oplossingenbestand te bewerken wordt niet ondersteund. Het bewerken van webresourcebestanden die zijn geëxporteerd met een oplossing wordt die niet ondersteund. Behalve voor de stappen die in Beheerde oplossingen onderhouden worden beschreven, wordt het bewerken van de inhoud van een beheerde oplossing niet ondersteund.

  • Silverlight wordt de opslag van toepassingsbibliotheek in cache niet ondersteund.

  • Het weergeven van een entiteitsformulier in een ingesloten IFrame in een ander entiteitsformulier wordt niet ondersteund.

Zie ook

Uw ontwikkelingsstijl voor Dynamics 365 kiezen
Microsoft Dynamics 365 uitbreiden op de server
Code schrijven voor Microsoft Dynamics 365-formulieren

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht