Overzicht: Een gehost UI WPF-besturingselement maken

Gepubliceerd: november 2016

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

Dit overzicht toont hoe u een op Windows Presentation Foundation (WPF) gebaseerd, gehost User Interface Integration (UII)-besturingselement kunt maken dat communiceert met Unified Service Desk en externe toepassingen (zelfstandig en web).

In dit overzicht doet u het volgende:

• Maak een gehost UIIWPF-besturingselement Voorbeeld van gehost UII WPF-besturingselement, waarmee dat voornaam, achternaam, adres en id van een contactpersoon worden weergegeven wanneer u contactpersonen zoekt en klik op de naam van een contactpersoon om deze te openen in een sessie in Unified Service Desk. Deze waarden worden weergegeven in de Unified Service Desk-context.

• Wijzig de waarden van voornaam, achternaam of adres in een externe toepassing en een webtoepassing die wordt gehost in Unified Service Desk vanuit het gehoste UIIWPF-besturingselement dat we maken. De externe toepassing en de webtoepassing zijn gemaakt in de volgende eerdere overzichten: Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken.

• Wijzigingen aan de Unified Service Desk-context melden om de waarden daar bij te werken.

In dit onderwerp

Vereisten

Stap 1: een gehost UII WPF-besturingselement maken met Visual Studio

Stap 2: het gehoste besturingselement definiëren in Unified Service Desk.

Stap 3: UII-acties definiëren voor de gehoste besturingselementen van de externe toepassing en de webtoepassing in Unified Service Desk

Test het gehoste besturingselement.

Vereisten

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-clienttoepassing. Dit is vereist voor het testen van het gehoste besturingselement.

• Microsoft Visual Studio 2012, Visual Studio 2013 of Visual Studio 2015

• NuGet Pakketbeheer voor Visual Studio 2012, Visual Studio 2013 of Visual Studio 2015

• Microsoft Dynamics 365 SDK-sjablonen voor Visual Studio die de projectsjabloon voor het gehoste UIIWPF-besturingselement bevatten. U kunt de sjabloon op een van de volgende manieren krijgen:

  • Download de CRM SDK-sjabloon. Dubbelklik op het CRMSDKTemplates.vsix bestand om het sjabloon te installeren in Visual Studio.

  • Download het CRM SDK-pakket en pak het uit. Ga naar de map SDK\Templates. Dubbelklik op het CRMSDKTemplates.vsix bestand om het sjabloon te installeren in Visual Studio.

• U moet Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken hebben voltooid om ervoor te zorgen dat u de externe toepassing en de webtoepassing hebt ingesteld met de adapters om interactie met deze toepassingen mogelijk te maken.

Stap 1: een gehost UII WPF-besturingselement maken met Visual Studio

1. Start Visual Studio, en maak een nieuw project.

2. In het dialoogvenster Nieuw project:

   1. Vouw in de lijst met geïnstalleerde sjablonen Visual C# uit en selecteer Dynamics 365 SDK-sjablonen > Unified Service Desk > Gehost UII WPF-besturingselement.

   2. Geef de naam en locatie van het project op en kies OK om een nieuw project te maken.

      

3. Klik in Oplossingenverkenner met de rechtermuisknop op het bestand UiiWpfControl.xaml en selecteer Openen om de XAML-ontwerpfunctie weer te geven.

4. Voeg in de designer de volgende besturingselementen toe uit de werkset:

   Type besturingselement	Naam	Tekst
   Etiket	lblFirstName	Voornaam
   Etiket	lblLastName	Achternaam
   Etiket	lblAddress	Adres
   Etiket	lblID	Id
   Tekstvak	txtFirstName
   Tekstvak	txtLastName
   Tekstvak	txtAddress
   Tekstvak	txtID
   Knop	btnUpdate	Waarden bijwerken in gehoste apps
   Knop	btnUpdateContext	Context bijwerken

   Zo moeten de besturingselementen in de XAML-designer worden ingedeeld.

   

5. Dubbelklik op de knop Waarden bijwerken in gehoste apps (btnUpdate) om de code van de gebeurtenis click voor deze knop toe te voegen, en voeg de volgende code toe.

   private void btnUpdate_Click(object sender, System.Windows.RoutedEventArgs e)
   {
      // This is how you fire an action to other hosted applications. 
      // The DoAction() code in the other application or application adapter 
      // will be called.
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateFirstName", txtFirstName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateLastName", txtLastName.Text)); // For the external application
      FireRequestAction(new RequestActionEventArgs("QsExternalApp", "UpdateAddress", txtAddress.Text)); // For the external application
   
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateFirstName", txtFirstName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateLastName", txtLastName.Text)); // For the external web application
      FireRequestAction(new RequestActionEventArgs("QsWebApplication", "UpdateAddress", txtAddress.Text)); // For the external web application
   }
   

6. Ga naar XAML designer en dubbelklik op de knop Context bijwerken (btnUpdateContext) om de code van de gebeurtenis click voor deze knop toe te voegen. Voeg de volgende code toe.

   private void btnContextChange_Click(object sender, System.Windows.RoutedEventArgs e)
   {
      // Get the current context and create a new context object from it.
      string temp = Context.GetContext();
      Context updatedContext = new Context(temp);
   
      // Update the new context with the changed information.
      updatedContext["firstname"] = txtFirstName.Text;
      updatedContext["lastname"] = txtLastName.Text;
      updatedContext["address1_line1"] = txtAddress.Text;
   
      // Notify Unified Service Desk of this new context information.
      FireChangeContext(new ContextEventArgs(updatedContext));
   
      // Notify this UII hosted control about the change.
      NotifyContextChange(updatedContext);
   }
   

7. Werk in hetzelfde bestand (UiiWpfControl.xaml.cs) de overschrijvingsdefinitie van de methode NotifyContextChange bij met het volgende.

   public override void NotifyContextChange(Context context)
   {
      // Populating text fields from context information.
      txtFirstName.Text = context["firstname"];
      txtLastName.Text = context["lastname"];
      txtAddress.Text = context["address1_line1"];
      txtID.Text = context["CustomerID"];
   
      base.NotifyContextChange(context);
   }
   

8. Sla uw project op en maak het (Maken > Oplossing maken). Nadat het project met succes is gemaakt, wordt een assembly (.dll-bestand) gegenereerd met dezelfde naam als de projectnaam (in dit geval UIIWPFHostedControl1.dll) in de map /bin/debug van het project.

9. Kopieer dit bestand naar de installatiemap van uw Unified Service Desk-clienttoepassing (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD). Dit bestand is nodig voor het testen en uiteindelijk het gebruiken van dit besturingselement vanuit de clienttoepassing.

   Tip

   Noteer de naam van de klasse die is gebruikt om uw gehost UII-besturingselement in het bestand UiiWpfControl.xaml.cs te maken. In dit geval is dat UiiWpfControl. U hebt deze informatie in de volgende stap nodig.

Stap 2: het gehoste besturingselement definiëren in Unified Service Desk.

Als u het gehoste UII WPF-besturingselement wilt hosten in Unified Service Desk, moet u het definiëren en configureren.

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk.

3. Kies op de pagina Unified Service DeskGehoste besturingselementen.

4. Kies op de pagina Gehoste besturingselementenNieuw.

5. Geef op de pagina Nieuw gehost besturingselement de volgende waarden op.

   Veld	Waarde
   Naam	UIIWPFHostedControl
   Weergavenaam	Voorbeeld van gehost UII WPF-besturingselement
   Onderdeeltype van Volledige servicedesk	CCA-gehoste toepassing
   Gehoste toepassing	Gehost beheer
   Toepassing is algemeen	Geselecteerd
   Weergavegroep	MainPanel
   Adapter	Geen adapter gebruiken
   Assemblage-URI	UIIWPFHostedControl1
   Assemblagetype	UIIWPFHostedControl1.UiiWpfControl

   Notitie

   Assembly-URI is de naam van uw assembly en het Assemblytype is de naam van uw assembly gevolgd door een punt (.) en vervolgens de klassenaam in uw Visual Studio-project. In dit voorbeeld is de naam van de assemblage UIIWPFHostedControl1 en de naam van de klasse UiiWpfControl, wat de standaardklassenaam is wanneer u een gehost UII WPF-besturingselement maakt.

   

6. Kies Opslaan om het gehoste besturingselement te maken.

Stap 3: UII-acties definiëren voor de gehoste besturingselementen van de externe toepassing en de webtoepassing in Unified Service Desk

De adapters voor de externe toepassing en de webtoepassing maken de volgende drie acties beschikbaar: UpdateFirstName, UpdateLastName en UpdateAddress. Deze adapters en de gehoste besturingselementen voor de externe zelfstandige toepassing en de webtoepassing zijn gemaakt in de eerdere overzichten (Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken.)

Als u informatie in de externe toepassing wilt bijwerken vanuit het gehoste UII WPF-besturingselement, moet u drie UII-acties definiëren met dezelfde naam als eerder gedefinieerd in de adapters voor elke externe toepassing. In de vorige adapteroverzichten (Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken) definieerden we de volgende twee gehoste besturingselementen in Unified Service Desk om de externe toepassingen weer te geven in Unified Service Desk: QsExternalApp en QsExternalWebApplication. In deze stap voegen we drie UII-acties toe aan elk gehost besturingselement.

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk.

3. Kies op de pagina Unified Service DeskGehoste besturingselementen.

4. Zoek op de pagina Gehoste besturingselementen de QSExternalApp en open deze voor bewerking.

5. Kies op de pagina QSExternalApp de pijl-omlaag naast de naam van het gehoste besturingselement en kies vervolgens UII-acties.

6. Kies op de volgende pagina Nieuwe UII-actie toevoegen.

7. Typ op de pagina Nieuwe UII-actie de naam als UpdateFirstName en kies Opslaan en sluiten. Hierdoor wordt de actie in de vorige pagina toegevoegd.

8. Voeg op dezelfde manier de volgende twee acties toe: UpdateLastName en UpdateAddress. Alle drie de acties worden beschikbaar voor het gehoste QSExternalApp-besturingselement.

   

9. Voer stap 4 tot en met 8 uit om drie UII-acties met dezelfde namen te maken voor de QSExternalWebApp.

Test het gehoste besturingselement.

Voordat u het gehoste UIIWPF-besturingselement test, moet u ervoor zorgen dat uw voorbeeldwebtoepassing actief is zodat het wordt weergegeven in Unified Service Desk.

1. Voer de Unified Service Desk-client uit om verbinding te maken met uw Dynamics 365-server.

2. Als u zich met succes hebt aangemeld, ziet u drie gehoste besturingselementen: Voorbeeld van gehost UII WPF-besturingselement, Voorbeeld van externe webtoepassing en Voorbeeld van externe toepassing.

   

3. Kies Zoeken en kies vervolgens Contactpersonen. Kies een van de contactpersonen om de details van de contactpersoon in een sessie weer te geven. Ook de voornaam, achternaam adres en id van de huidige weergegeven contactpersoon worden weergegeven in alle drie de voorbeeldbesturingselementen:

   

4. Wijzig de waarden in Voorbeeld van gehost UII WPF-besturingselement en klik op Waarden bijwerken in gehoste apps om de waarden in de andere twee externe toepassingen bij te werken.

   

5. Kies in Voorbeeld van gehost UII WPF-besturingselementContext bijwerken om de contextinformatie in Unified Service Desk bij te werken.

   

Zie ook

Integreren met externe toepassingen en webtoepassingen
Gehoste UII-besturingselementen gebruiken met Unified Service Desk
Overzicht: Een gehost UII Windows Forms-besturingselement maken
UII-acties

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht