Delen via

Silverlight-webresources (XAP)

  • Artikel

 

Gepubliceerd: januari 2017

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

Belangrijk

Microsoft Silverlight webresources blijven ondersteund worden in Microsoft Dynamics 365 (online en on-premises) voor compatibiliteit met oudere systemen. Voor onderdelen die op alle clients kunnen worden weergegeven, raden we het gebruik van HTML-webresources met HTML5 aan in plaats van Silverlight.

HTML5 heeft als clienttechnologie voor het web de voorkeur over plug-ins zoals Silverlight en Flash. HTML5 kan van elk apparaat (pc, tablet, smartphone, en meer) worden gebruikt en maakt intsensief gebruik van JavaScript (en vele krachtige JavaScript-bibliotheken zoals jQuery) en CSS.

Microsoft Dynamics 365 (online en on-premises) ondersteuning voegt Silverlight 4.0 webresources toe aan entiteitsformulieren. U kunt Silverlight 5.0 webresources in een HTML webresource weergeven die gebruik maakt van een hosting <object> element dat is geconfigureerd voor deze versie.

Notitie

  • Microsoft Silverlight webresources kunnen niet worden weergegeven in de 64 bitsversie van Microsoft Office Outlook.

  • Als u een Silverlight-webresource buiten een entiteitsformulier of grafiek wilt weergeven, kunt u een HTML-webresource maken die kan dienen als hostpagina voor de Silverlight-webresource. Gebruik vervolgens de instructie $webresource: om de HTML-webresource te openen.

In dit onderwerp

Silverlight-webresources maken

De toegang tot contextgegevens

Het doorgeven van gegevens vanuit een formulier aan een ingesloten Silverlight-webresource

Het schrijven en testen van Silverlight-webresources

Fouten opsporen in Silverlight-webresources

Silverlight-webresources maken

Silverlight webresources zijn gemakkelijk gemaakt met het webresourceformulier door het invoeren van een naam, een weergavenaam, Silverlight (XAP) te selecteren als het type en het .xap-bestand te uploaden. De webresource moet worden gepubliceerd voordat u deze kunt gebruiken. Echter, omdat Silverlight de webresources meestal wat contextuele interactie met contextuele gegevens in Microsoft Dynamics 365 bieden moet u plannen hoe u uw webresources maakt.

De toegang tot contextgegevens

Als u de knop Voorbeeld resourcenformulier gebruikt of alleen door de geleverde URL bladert, wordt de toepassing Silverlight gehost in een algemene HTML pagina zonder contextinformatie. Als uw Silverlight toepassing geen contextuele informatie nodig heeft, kunt u deze URL gebruiken om uw Silverlight webresource weer te geven.

Als u contextuele informatie nodig hebt moet u een van de volgende dingen doen:

  1. Uw Silverlight webresource toevoegen aan een entiteitsformulier.

  2. Geef uw Silverlight webresource weer met behulp van een HTML webresource die is geconfigureerd om contextinformatie te bieden.

Als uw Silverlight webresource is ontworpen om in een entiteitsformulier te worden weergegeven heeft het formulier een Xrm.Page.context object waarmee u toegang kunt krijgen tot contextuele informatie. Zie Clientcontext (clientreferentie) voor meer informatie

Als uw Silverlight toepassing buiten de context van het formulier moet worden weergegeven moet u een HTML webresource configureren om deze contextinformatie te bieden door het toevoegen van een verwijzing naar de ClientGlobalContext.js.aspx pagina. Nadat deze verwijzing is toegevoegd, is voor uw Silverlight toepassing dezelfde contextuele informatie beschikbaar als in een enititeitsformulier. Dit voorbeeld laat zien hoe u de functie getClientUrl van het Xrm.Page.context object kunt gebruiken.

private string clientUrl = "";
ScriptObject xrm = (ScriptObject)HtmlPage.Window.GetProperty("Xrm");
ScriptObject page = (ScriptObject)xrm.GetProperty("Page");
ScriptObject pageContext = (ScriptObject)page.GetProperty("context");
clientUrl = (string)pageContext.Invoke("getClientUrl");

Het doorgeven van gegevens vanuit een formulier aan een ingesloten Silverlight-webresource

Als u een Silverlight webresource toevoegt aan een formulier kunt u de optie Geef de typecode van het recordobject en de unieke id als parameters door selecteren. U hebt ook de mogelijkheid om tekst als aangepaste parameter in te voeren.

Deze waarden worden doorgegeven aan het Silverlight besturingselement als een InitParams woordenboek van code-/waardeparen.

De doorgegeven waarden zijn beschreven in de volgende tabel.

Sleutel

Beschrijving

id

De unieke id van de record.

type

De code van het entiteittype. Voor aangepaste entiteiten kan dit variëren tussen organisaties.

typenaam

De logische naam van de entiteit.

orgname

De naam van de organisatie.

userlcid

De taalcode die de taalvoorkeur van de gebruiker vertegenwoordigt.

orglcid

De taalcode die de standaardtaal voor de organisatie vertegenwoordigt.

-gegevens

De waarde van de tekst die is ingevoerd als een aangepaste parameter.

Deze waarden kunnen tijdens runtime worden weergeven met gebruikt met de syntaxis in het volgende voorbeeld:

string entityTypeName = App.Current.Host.InitParams["typename"];

Het schrijven en testen van Silverlight-webresources

Als uw Silverlight webresource onafhankelijk is van contextuele gegevens van Microsoft Dynamics 365 kunt u uw Silverlight toepassing schrijven en testen zoals u dit normaal gesproken doet. Als u een nieuwe webresource maakt door uw .xap bestand te uploaden, kunt u deze testen met de knop Voorbeeld in het webresourceformulier als u de webresource hebt opgeslagen en gepubliceerd.

Echter, is het waarschijnlijker dat uw Silverlight toepassing contextuele gegevensafhankelijkheden die niet volledig gesimuleerd kunnen worden buiten Microsoft Dynamics 365.

Het het aanmaakproces van een Silverlight webresource met een formulier of contextafhankelijkheden is als volgt:

  1. Maak uw Silverlight toepassingproject.

    U moet aangeven dat u een webtoepassing wilt maken bij uw project.

  2. Schrijf en test zo veel mogelijk van de toepassing zonder dat contextuele gegevens van Microsoft Dynamics 365 vereist zijn.

  3. Maak webresources door de .xap en .htm bestanden te uploaden als Silverlight en HTML webresources.

  4. Schrijf code in uw Silverlight toepassingproject.

  5. Bouw uw Silverlight toepassingproject.

  6. Upload de gemaakte versie van het .xap bestand uit de ClientBin map van het webtoepassingproject om de Silverlight webresource die u in stap 3 hebt gemaakt bij te werken.

  7. Test uw Silverlight webresource via een van de onderstaande methoden:

    • Geef het weer met de knop Voorbeeld van de host HTML webresource die u hebt gemaakt.

    • Geef het weer in de context van een entiteitsformulier dat u eraan toegevoegd hebt.

      Gebruik deze optie als uw Silverlight toepassing afhankelijkheden heeft van formulierelementen of contextinformatie.

  8. Herhaal stap 4 tot en met 7 totdat u klaar bent.

Notitie

Wanneer u een Silverlight webresource buiten een entiteitsformulier wilt weergeven, bijvoorbeeld in het hoofdframe door het bewerken van het siteoverzicht, moet u een (HTML) webresource van een webpagina opgeven als host voor de Silverlight webresource.

Belangrijk

Bewerk nooit de HTML broncode voor een pagina die een Silverlight webresource host met de tekstverwerker die wordt geleverd in de toepassing. De teksteditor wijzigt de HTML en verstoort de <object>-elementdefinitie die nodig is om de SilverlightXAP-webresource te hosten. Zie bba8645a-a725-4c4d-a393-bab8ca692482#BKMK_UsingTextEditor voor meer informatie.

Als u de teksteditor wilt gebruiken, laat dan de data="data:application/x-silverlight-2," parameter in het element <object> weg. Hoewel dit voorkomt dat de Silverlight webresource stopt met functioneren, kan de teksteditor nog steeds ongewenste nog wijzigingen introduceren.

Fouten opsporen in Silverlight-webresources

Bij Silverlight webresources die niet afhankelijk zijn van contextuele gegevens van Microsoft Dynamics 365 kunnen fouten worden opgespoord in Microsoft Visual Studio. Echter, wanneer de Silverlight webresource contextuele gegevens nodig heeft om de taken uit te voeren, moet u een andere procedure gebruiken.

  1. Bouw uw Silverlight toepassing.

  2. Upload de gemaakte de versie van het .xap bestand uit de ClientBin map van het webtoepassingproject.

  3. Geef uw Silverlight toepassing weer in de context waarin deze gebruikt dient te worden.

  4. In uw Silverlight toepassingproject gaat u naar het Visual Studio menu, selecteert u Foutopsporing en vervolgens Toevoegen aan proces.

  5. In het dialoogvenster Toevoegen aan proces zoekt u het iexplore.exe proces waarvan de Type kolomwaarde Silverlight, x86 is.

  6. Selecteer dit proces en klik op Toevoegen om het dialoogvenster te sluiten en foutopsporing te starten.

  7. Stel in uw Silverlight toepassingproject een breekpunt in.

  8. Vernieuw het browservenster, of voer in de Silverlight toepassing de acties uit die nodig zijn om uw code te testen.

Zie ook

Toegankelijke webresources maken
Webresources voor Microsoft Dynamics 365
Webpagina (HTML) webresources
CSS-webresources
Scriptwebresources (JScript)
Gegevens (XML) Webresources
Afbeelding-webresources (JPG, PNG, GIF, ICO)
Opmaakmodelwebresources (XSL)

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht