Gennemgang: Oprette et tilknyttet kontrolelement af typen UII WPF

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Denne gennemgang viser, hvordan du kan bygge et Windows Presentation Foundation (WPF)-baseret User Interface Integration (UII) tilknyttet kontrolelement, der interagerer med Unified Service Desk og eksterne programmer (enkeltstående og web).

I denne gennemgang skal du:

• Oprette et tilknyttet UIIWPF-kontrolelement, et Tilknyttet UII WPF-eksempelkontrolelement, som viser fornavn, efternavn, adresse og id'et for en kontakt, når du søger efter kontakter og klikker på navnet på en kontakt for at åbne det i en session i Unified Service Desk. Disse værdier vises i Unified Service Desk-konteksten.

• Ændre fornavn, efternavn eller adresseværdierne i et eksternt program og et webprogram, som Unified Service Desk er vært for via det tilknyttede UIIWPF-kontrolelement, som vi opretter. De eksterne programmer og webprogrammer er oprettet i følgende tidligere gennemgange: Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort.

• Give besked om ændringer af Unified Service Desk-konteksten, så værdierne kan opdateres der.

Dette emne indeholder

Forudsætninger

Trin 1: Opret et tilknyttet UII WPF-kontrolelement ved hjælp af Visual Studio

Trin 2: Definer det tilknyttede kontrolelement i Unified Service Desk

Trin 3: Definer UII-handlinger for det eksterne program og webprogrammets tilknyttede kontrolelementer i Unified Service Desk

Test det tilknyttede kontrolelement.

Forudsætninger

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-klientprogram. Dette bruges til at teste det tilknyttede kontrolelement.

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

• NuGet Package Manager for Visual Studio 2012, Visual Studio 2013 eller Visual Studio 2015

• Microsoft Dynamics 365-SDK-skabeloner til Visual Studio, der indeholder det projektskabelonen for det tilknyttede UIIWPF-kontrolelement. Du kan få skabelonen på en af følgende måder:

  • Download CRM SDK-skabeloner. Dobbeltklik på CRMSDKTemplates.vsix filen for at installere skabelonen i Visual Studio.

  • Download og udpak CRM SDK-pakken. Gå til mappen SDK\Templates. Dobbeltklik på CRMSDKTemplates.vsix filen for at installere skabelonen i Visual Studio.

• Du bør have afsluttet den Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort for at sikre, at de eksterne programmer og webprogrammer er konfigureret med adapterkortene for at lette kommunikationen med disse programmer.

Trin 1: Opret et tilknyttet UII WPF-kontrolelement ved hjælp af Visual Studio

1. Start Visual Studio, og opret et nyt projekt.

2. I dialogboksen Nyt projekt:

   1. Fra listen over installerede skabeloner skal du udvide Visual C# og vælge Dynamics 365 SDK-skabeloner > Unified Service Desk > Tilknyttet UII WPF-kontrolelement.

   2. Angiv navnet på og placeringen af projektet, og vælg OK for at oprette et nyt projekt.

      

3. I Løsningsoversigt, skal du højreklikke på filen UiiWpfControl.xaml og vælge Open for at vise XAML-designeren.

4. Tilføj følgende kontrolelementer fra designeren i Toolbox:

   Type af kontrolelement	Navn	Tekst
   Etiket	lblFirstName	Fornavn
   Etiket	lblLastName	Efternavn
   Etiket	lblAddress	Adresse
   Etiket	lblID	Id
   Tekstfelt	txtFirstName
   Tekstfelt	txtLastName
   Tekstfelt	txtAddress
   Tekstfelt	txtID
   Knap	btnUpdate	Opdater værdier i tilknyttede apps
   Knap	btnUpdateContext	Opdater kontekst

   Sådan skal kontrolelementerne vises i XAML-designeren.

   

5. Dobbeltklik på knappen Opdater værdier i tilknyttede apps (btnUpdate) for at tilføje koden for click-hændelsen for denne knap og tilføje følgende kode.

   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. Gå til den XAML-designeren, og dobbeltklik på knappen Opdater kontekst (btnUpdateContext) for at tilføje koden for click-hændelsen for denne knap. Tilføj følgende kode.

   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. I den samme fil (UiiWpfControl.xaml.cs) skal du opdatere tilsidesættelsesdefinitionen af NotifyContextChange-metoden til følgende.

   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. Gem projektet, og byg det (Build > Build Solution). Når projektet er oprettet, oprettes en assembly (.dll-fil) med det samme navn som dit projektnavn (i dette tilfælde UIIWPFHostedControl1.dll) i mappen /bin/debug i dit projekt.

9. Kopier denne fil til den mappe, hvor Unified Service Desk-klientprogrammet er installeret (typisk C:\Program Files\Microsoft Dynamics CRM USD\USD). Denne fil bruges til test af og i sidste ende brug af dette kontrolelement fra klientprogrammet.

   Tip

   Notér navnet på den klasse, der bruges til at bygge dit tilknyttede UII-kontrolelement i filen UiiWpfControl.xaml.cs. I vores tilfælde er det UiiWpfControl. Du skal bruge navnet i det næste trin.

Trin 2: Definer det tilknyttede kontrolelement i Unified Service Desk

Når du vil bruge Unified Service Desk som vært for det tilknyttede UII WPF-kontrolelement, skal du definere og konfigurere det.

1. Log på Microsoft Dynamics 365.

2. Vælg Microsoft Dynamics 365 > Indstillinger > Unified Service Desk på navigationslinjen.

3. På siden Unified Service Desk skal du vælge Tilknyttede kontrolelementer.

4. Vælg Ny på siden Tilknyttede kontrolelementer.

5. På siden Nyt tilknyttet kontrolelement skal du angive følgende værdier.

   Felt	Værdi
   Navn	UIIWPFHostedControl
   Visningsnavn	Eksempel på tilknyttet UII WPF-kontrolelement
   USD-komponenttype	CCA-hostet program
   Hostet program	Tilknyttet kontrolelement
   Programmet er globalt	Markeret
   Visningsgruppe	MainPanel
   Kort	Brug ikke kort
   Assembly-URI	UIIWPFHostedControl1
   Assemblytype	UIIWPFHostedControl1.UiiWpfControl

   Bemærkning
   Assembly-URI er navnet på din assembly, og Assembly Type er navnet på din assembly efterfulgt af et punktum (.) og derefter navnet på klassen i dit Visual Studio-projekt. I dette eksempel er navnet på assemblyen UIIWPFHostedControl1, og navnet på klassen er UiiWpfControl, som er standardklassenavnet, når du opretter et brugerdefineret tilknyttet UII WPF kontrolelement.

   

6. Vælg Gem for at oprette det tilknyttede kontrolelement.

Trin 3: Definer UII-handlinger for det eksterne program og webprogrammets tilknyttede kontrolelementer i Unified Service Desk

Kortene til de eksterne enkeltstående programmer og webprogrammer viser følgende tre handlinger: UpdateFirstName, UpdateLastName og UpdateAddress. Disse kort og de tilknyttede kontrolelementer til de eksterne enkeltstående programmer og webprogrammer er oprettet i tidligere gennemgange (Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort).

Hvis du vil opdatere oplysninger i de eksterne programmer fra det tilknyttede UII WPF-kontrolelement, skal du definere tre UII-handlinger med samme navn som defineret tidligere i kortene for hvert af de eksterne programmer. I de tidligere gennemgange af kortet (Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort) har vi defineret følgende to tilknyttede kontrolelementer i Unified Service Desk for at vise de eksterne programmer i Unified Service Desk: QsExternalApp og QsExternalWebApplication. I dette trin vil vi tilføje tre UII handlinger for hvert tilknyttet kontrolelement.

Vigtigt
Hvis du allerede har tilføjet UII handlingerne som en del af trin 3 i Gennemgang: Oprette et tilknyttede UII Windows Forms-kontrolelement, du behøver ikke at udføre dette trin igen. Du kan fortsætte til næste afsnit for at teste dit tilknyttede kontrolelement.

1. Log på Microsoft Dynamics 365.

2. Vælg Microsoft Dynamics 365 > Indstillinger > Unified Service Desk på navigationslinjen.

3. På siden Unified Service Desk skal du vælge Tilknyttede kontrolelementer.

4. På siden Tilknyttede kontrolelementer skal du søge efter QSExternalApp og åbne den for redigering.

5. På siden QSExternalApp skal du vælge pil ned ud for navnet på det tilknyttede kontrolelement og derefter vælge UII-handlinger.

6. Vælg Tilføj ny UII-handling på næste side.

7. På siden Ny UII-handling skal du skrive navnet som UpdateFirstName og vælge Gem og Luk. Handlingen på den foregående side tilføjes.

8. På samme måde skal du tilføje følgende to handlinger: UpdateLastName og UpdateAddress. Alle tre handlinger bliver tilgængelige for det tilknyttede QSExternalApp-kontrolelement.

   

9. Følg trin 4 til 8 for at oprette tre UII-handlinger med de samme navne for QSExternalWebApp.

Test det tilknyttede kontrolelement.

Før du tester det tilknyttede UIIWPF-kontrolelement, skal du kontrollere, at dit eksempelprogram kører, så det gengives i Unified Service Desk.

1. Kør Unified Service Desk-klienten for at oprette forbindelse til Dynamics 365-serveren.

2. Når du har logget på, kan du se tre tilknyttede kontrolelementer: Tilknyttet UII WPF-eksempelkontrolelement, Eksternt eksempelwebprogram og Eksternt eksempelprogram.

   

3. Vælg Søg, og vælg derefter Kontakter. Vælg en kontakt for at få vist kontaktoplysninger i en session. Dette viser også fornavn, efternavn, adresse og id'et for den aktuelt viste kontaktpost i alle tre eksempelkontrolelementer:

   

4. Rediger værdierne i Tilknyttet UII WPF-eksempelkontrolelement, og klik på Opdater værdier i tilknyttede apps for at opdatere værdierne i de andre to eksterne programmer.

   

5. I Tilknyttet UII WPF-eksempelkontrolelement skal du vælge Opdater kontekst for at opdatere kontekstoplysningerne i Unified Service Desk.

   

Se også

Integrere med eksterne programmer og webprogrammer
Bruge UII-tilknyttede kontrolelementer i Unified Service Desk
Gennemgang: Oprette et tilknyttede UII Windows Forms-kontrolelement
UII-handlinger

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret