Ondersteunde en niet-ondersteunde aanpassingspraktijken
Ontwikkelaars die Dynamics 365 Customer Engagement (on-premises) uitbreiden, hebben een verantwoordelijkheid om regels en aanbevolen procedures te volgen die in de SDK zijn gedocumenteerd: Aanbevolen procedures voor ontwikkelen met Dynamics 365 Customer Engagement (on-premises). De SDK-documenten en API's zijn beschikbaar voor ontwikkelaars en bieden begeleiding over hoe ze het best te gebruiken zijn. Microsoft ondersteunt alleen de API's en procedures die worden beschreven in de SDK. U vindt misschien iets op internet waar wordt beschreven hoe u een probleem kunt oplossen, maar als daar geen API's in worden genoemd die in de SDK zijn vastgelegd, wordt dit niet ondersteund door Microsoft. Voordat u een ontwikkelaar een wijziging laat toepassen, moet u controleren of de ondersteunde methoden worden gebruikt.
Als ontwikkelaars API's en aanbevolen methoden gebruiken die in de SDK zijn beschreven, weten we zeker dat we kunnen testen of de aanpassingen die we in Customer Engagement aanbrengen, schade kunnen toebrengen aan bestaande aanpassingen. Het doel is dat aanpassingen in code met behulp van ondersteunde methoden blijven werken wanneer nieuwe versies of updates van Customer Engagement-apps worden uitgebracht. U profiteert aangezien u naar nieuwe versies kunt upgraden met verbeterde functies zonder dat onwikkelaars telkens hun code moeten wijzigen.
Als we ontdekken dat een wijziging in een nieuwe versie van Customer Engagement-apps schade zal toebrengen aan een ondersteunde aanpassing, zullen we vastleggen wat de schade is en hoe gebruikers hun code kunnen wijzigen om de schade te herstellen.
Welke soorten aanpassingen worden niet ondersteund met Dynamics 365 Customer Engagement (on-premises)?
Dat bepaalde API's en programmeringsprocedures niet worden ondersteund door Microsoft, betekent niet dat ze niet werken. "Niet ondersteund door Microsoft" betekent dat u geen ondersteuning kunt krijgen van Microsoft voor deze API's of programmeringsprocedures. We testen ze niet en we weten niet of ze beschadigd raken als we iets wijzigen. Wij kunnen niet voorspellen niet wat er zal gebeuren als iemand code in onze toepassing wijzigt.
De ontwikkelaar die niet-ondersteunde API's en programmeringsprocedures gebruikt, neem de verantwoordelijkheid om hun code te ondersteunen. Ze moeten hun code testen om te controleren of die werkt.
Als u ervoor kiest niet-ondersteunde aanpassingen te gebruiken in uw installatie van Customer Engagement-apps, moet u vastleggen wat er is uitgevoerd en een strategie hebben om deze aanpassingen te verwijderen voordat u contact opneemt met Technische Ondersteuning van Dynamics 365 Customer Engagement (on-premises). Als u hulp nodig hebt met niet-ondersteunde aanpassingen, neem dan contact om met de ontwikkelaar of organisatie die de aanpassingen heeft voorbereid.
Algemeen niet-ondersteunde aanpassingsprocedures
Hier volgt een lijst met algemene aanpassingsprocedures die niet worden ondersteund. Dit is geen volledige lijst. Meer informatie: Ondersteunde extensies voor Dynamics 365 Customer Engagement (on-premises): niet-ondersteunde aanpassingen.
Werken met de elementen van de webtoepassing Document ObjectMmodel (DOM) met behulp van JavaScript
Alle JavaScript-bibliotheken die waar dan ook in de toepassing worden gebruikt, moeten alleen met gedocumenteerde API's werken. Als JavaScript-ontwikkelaars met toepassingen werken, openen ze vaak DOM-elementen door specifieke namen te gebruiken. Aangezien Dynamics 365 Customer Engagement (on-premises) een webtoepassing is, werken deze technieken, maar ze raken waarschijnlijk beschadigd tijdens een update omdat de namen van de elementen waarnaar ze verwijzen elk moment gewijzigd kunnen worden. We behouden ons het recht voor wijzigingen in de toepassing toe te brengen als dit nodig is en dit houdt vaak in dat de manier waarop de pagina is opgebouwd wordt gewijzigd. Als u wijzigingen toebrengt die afhangen van de huidige structuur van de pagna, moet u dit testen en misschien elke keer dat u een update toepast en uw toepassing upgradet de aangepaste code in deze scirpts wijzigen.
jQuery is een zeer algemene bibliotheek die wordt gebruikt door JavaScript-ontwikkelaars. Het grootste voordeel van het gebruik van jQuery, is dat dit het vermogen van ontwikkelaars vergroot om DOM-elementen te openen en te maken, wat precies is wat wij niet ondersteunen op de toepassingspagina's van Customer Engagement-apps. jQuery wordt aanbevolen wanneer ontwikkelaars aangepaste gebruikersinterfaces met HTML-webresources maken, maar in de toepassingspagina's van Customer Engagement-apps vereisen de ondersteunde API's niet het gebruik van jQuery.
Niet-gedocumenteerde interne objecten of methoden gebruiken met JavaScript
Dynamics 365 Customer Engagement (on-premises) gebruikt veel JavaScript-objecten in pagina's. Een JavaScript-ontwikkelaar kan deze objecten detecteren door fouten op een pagina op te sporen en vervolgens deze objecten te openen en hergebruiken. We behouden ons het recht voor wijzigingen in deze objecten toe te brengen als dit nodig is, waaronder het verwijderen van de objecten of het wijzigen van de namen van de methoden. Als een script naar deze objecten verwijst, raakt het script beschadigd als ze niet worden gevonden.