Gennemgang: Oprette et tilknyttede UII Windows Forms-kontrolelement

 

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 Forms-baseretUser 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 User Interface Integration (UII) Windows Forms-kontrolelement, et Tilknyttet UII Windows Forms-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 UII Windows Forms-kontrolelement, som vi opretter. De eksterne programmer og webprogrammer er oprettet i 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 Windows Forms-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. 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 tilknyttede UII Windows Forms-kontrolelement for projektskabelonen. Du kan få den 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 Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort for at sikre, at det eksterne program og webprogrammet er konfigureret med de respektive adapterkort for at lette kommunikationen med disse programmer.

Trin 1: Opret et tilknyttet UII Windows Forms-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 Windows Forms-kontrolelement.

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

      

3. I Løsningsoversigt-ruden skal du højreklikke på filen UiiWinformControl.cs og vælge Åbn for at vise Windows Forms-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 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, EventArgs 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 designvisningen, dobbeltklik på knappen Opdater kontekst (btnUpdateContext) for at tilføje koden for klikhændelsen for denne knap. Tilføj følgende kode.

   private void btnUpdateContext_Click(object sender, EventArgs 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 (UiiWinformControl.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 UIIWindowsFormHostedConrol1.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 UiiWinformControl.cs. I vores tilfælde er det UiiWinformControl. 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 Windows Forms-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 klikke på Tilknyttede kontrolelementer.

4. Klik på Ny på siden Tilknyttede kontrolelementer.

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

   Felt	Værdi
   Navn	UIIWindowsFormHostedControl
   Vist navn	Tilknyttet UII Windows Forms-eksempelkontrolelement
   USD-komponenttype	CCA-hostet program
   Hostet program	Tilknyttet kontrolelement
   Programmet er globalt	Markeret
   Visningsgruppe	MainPanel
   Kort	Brug ikke kort
   Assembly-URI	UIIWindowsFormHostedControl1
   Assemblytype	UIIWindowsFormHostedControl1.UiiWinformControl

   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 UIIWindowsFormHostedControl1, og navnet på klassen er UiiWinformControl, som er standardklassenavnet, når du opretter et brugerdefineret tilknyttet UII Windows Forms-kontrolelement.

   

6. Klik på 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 af adapterkort (Gennemgang: Oprette et UII-programkort og Gennemgang: Oprette et UII-webprogramkort).

Hvis du vil opdatere oplysninger i de eksterne programmer fra det tilknyttede UII Windows Forms-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 du 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 skal du 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 tilknyttet kontrolelement af typen UII WPF, 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 klikke på pil ned ud for navnet på det tilknyttede kontrolelement og derefter klikke på UII-handlinger.

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

7. Skriv navnet som UpdateFirstName, og klik på 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 til det tilknyttede QsExternalWebApp-kontrolelement.

Test det tilknyttede kontrolelement.

Før du tester det tilknyttede UII Windows Forms-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 Windows Forms-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 som vist i følgende illustration.

   

4. Rediger værdierne i Tilknyttet UII Windows Forms-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 Windows Forms-eksempelkontrolelement skal du klikke på Opdater kontekst for at opdatere kontekstoplysningerne i Unified Service Desk.

   

Se også

Bruge UII-tilknyttede kontrolelementer i Unified Service Desk
Gennemgang: Oprette et tilknyttet kontrolelement af typen UII WPF

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret