Näidisprotseduur: UII WPF-i hostitud juhtelemendi loomine

See näidisprotseduur näitab, kuidas luua Windows Presentation Foundationil (WPF-il) põhinevat User Interface Integration (UII) hostitud juhtelementi, mis suhtleb Unified Service Deski ja väliste (eraldiseisvate ja veebipõhiste) rakendustega.

Selles näidisprotseduuris teete järgmist.

• Loote UII WPF-i hostitud juhtelemendi nimega UII WPF-i hostitud juhtelemendi näidis, mis kuvab kontakti eesnime, perekonnanime, aadressi ja ID, kui kontakte otsite ja klõpsate kontakti nime selle avamiseks Unified Service Deski seansis. Need väärtused kuvatakse Unified Service Deski kontekstist.

• Muudate UII WPF-i hostitud juhtelemendi kaudu eesnime, perekonnanime või aadressi väärtusi Unified Service Deskis majutatud välises rakenduses ja veebirakenduses. Väline rakendus ja veebirakendus loodi järgmistes varasemates näidisprotseduurides: Näidisprotseduur: UII rakenduse adaptri loomine and Näidisprotseduur: UII veebirakenduse adaptri loomine.

• Märkige üles Unified Service Deski konteksti muudatused, et seal väärtusi värskendada.

Selle teema sisu

Eeltingimused

1. samm: UII WPF-i hostitud juhtelemendi loomine Visual Studio abil

2. samm: hostitud juhtelemendi määratlemine Unified Service Deskis

3. samm: määratlege välisele rakendusele ja veebirakenduse hostitud juhtelementidele Unified Service Deskis UII toimingud

Testige hostitud juhtelementi

Eeltingimused

• Microsoft .NET Framework 4.5.2

• Unified Service Deski klientrakendus. See on vajalik hostitud juhtelemendi testimiseks.

• Microsoft Visual Studio 2012 või Visual Studio 2013

• NuGet Package Manager rakendusele Visual Studio 2012 või Visual Studio 2013

• Microsoft Dynamics CRM SDK mallid Visual Studiole, mis sisaldavad UII WPF-i majutatud juhtelemendi projektimalli. Võite hankida malli ühel järgmistest viisidest.

  • CRM-i SDK malli allalaadimine. Topeltklõpsake faili CRMSDKTemplates.vsix malli installimiseks Visual Studiosse.

  • CRM-i SDK paketi allalaadimine ja ekstraktimine. Minge kausta SDK\Templates. Topeltklõpsake faili CRMSDKTemplates.vsix malli installimiseks Visual Studiosse.

• Peate olema läbinud protseduurid Näidisprotseduur: UII rakenduse adaptri loomine ja Näidisprotseduur: UII veebirakenduse adaptri loomine, veendumaks, et teil on väline rakendus ja veebirakendus koos adaptritega seadistatud, et hõlbustada nende rakendustega suhtlemist.

1. samm: UII WPF-i hostitud juhtelemendi loomine Visual Studio abil

1. Käivitage Visual Studio ja looge uus projekt.

2. Tehke dialoogiboksis Uus projekt järgmist.

   1. Laiendage installitud mallide loendis jaotist Visual C# ja valige CRM-i SDK mallid > Unified Service Desk > UII WPF-i hostitud juhtelement.

   2. Määrake projekti nimi ja asukoht ning valige uue projekti loomiseks OK.

3. Tehke lahenduseuurijas paremklõps failil UiiWpfControl.xaml ja valige käsk AvaXAML-i kujundaja kuvamiseks.

4. Kujundajas lisage tööriistakastist järgmised juhtelemendid.

   Juhtelemendi tüüp	Nimi	Tekst
   Silt	lblFirstName	Eesnimi
   Silt	lblLastName	Perekonnanimi
   Silt	lblAddress	Aadress
   Silt	lblID	ID
   TextBox	txtFirstName
   TextBox	txtLastName
   TextBox	txtAddress
   TextBox	txtID
   Nupp	btnUpdate	Väärtuste värskendamine majutatud rakendustes
   Nupp	btnUpdateContext	Konteksti värskendamine

   Nii peaksid juhtelemendid olema XAML-i kujundajas paigutatud.

5. Topeltklõpsake nuppu Väärtuste värskendamine majutatud rakendustes (btnUpdate) sündmuse click koodi lisamiseks sellele nupule ja lisage järgmine kood.

   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. Minge XAML-i kujundajasse ja tehke topeltklõps nupul Konteksti värskendamine (btnUpdateContext) sündmuse click koodi lisamiseks sellele nupule. Lisage järgmine kood.

   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. Värskendage samas failis (UiiWpfControl.xaml.cs) meetodi NotifyContextChange alistamisdefinitsioon järgmiseks.

   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. Salvestage oma projekt ja koostage see (Koosta > Koosta lahendus). Kui projekt on edukalt koostatud, luuakse assembler (.dll-fail) projektiga sama nimega (praegusel juhul UIIWPFHostedControl1.dll) teie projekti kausta /bin/debug.

9. Kopeerige see fail oma Unified Service Deski klientrakenduse installikausta (tavaliselt C:\Program Files\Microsoft Dynamics CRM USD\USD). See fail on vajalik testimiseks ja hiljem selle juhtelemendi kasutamiseks klientrakendusest.

   Näpunäide
   Märkige üles klassi nimi, mida teie UII hostitud juhtelemendi loomiseks failis UiiWpfControl.xaml.cs kasutatakse. Praegusel juhul on see UiiWpfControl. Seda teavet vajate järgmises sammus.

2. samm: hostitud juhtelemendi määratlemine Unified Service Deskis

UII WPF-i hostitud juhtelemendi majutamiseks Unified Service Deskis tuleb see määratleda ja konfigureerida.

1. Logige sisse rakendusse Microsoft Dynamics CRM.

2. Valige navigeerimisribalt Microsoft Dynamics CRM > Sätted > Unified Service Desk.

3. Valige lehelt Unified Service DeskHostitud juhtelemendid.

4. Tehke lehel Hostitud juhtelemendid valik Uus.

5. Määrake lehel Uus hostitud juhtelement järgmised väärtused.

   Väli	Väärtus
   Nimi	UIIWPFHostedControl
   Kuvatav nimi	UII Windowsi vormide hostitud juhtelemendi näidis
   USD komponendi tüüp	CCA majutatud rakendus
   Majutatud rakendus	Hostitud juhtelement
   Rakendus on globaalne	Valitud
   Kuva rühm	MainPanel
   Adapter	Ära kasuta adaptrit
   Assembleri URI	UIIWPFHostedControl1
   Assembleri tüüp	UIIWPFHostedControl1.UiiWpfControl

   Märkus

   Assembleri URI on teie assembleri nimi ja Assembleri tüüp on teie assembleri nimi, millele järgneb punkt (.) ja seejärel klassi nimi teie Visual Studio projektis. Selles näites on assembleri nimi UIIWPFHostedControl1 ja klassi nimi on UiiWpfControl, mis on klassi vaikenimi UII WPF-i hostitud juhtelemendi loomisel.

6. Valige hostitud juhtelemendi loomiseks nupp Salvesta.

3. samm: määratlege välisele rakendusele ja veebirakenduse hostitud juhtelementidele Unified Service Deskis UII toimingud

Välise eraldiseisva rakenduse ja veebirakenduse adaptrid näitavad kolme järgmist toimingut: UpdateFirstName, UpdateLastName ja UpdateAddress. Need adaptrid ja välise eraldiseisva rakenduse ning veebirakenduse hostitud juhtelemendid loodi varasemates näidisprotseduurides (Näidisprotseduur: UII rakenduse adaptri loomine ja Näidisprotseduur: UII veebirakenduse adaptri loomine).

UII Windowsi vormide hostitud juhtelemendi kaudu väliste rakenduste teabe värskendamiseks peate määratlema kolm UII toimingut, millel on sama nimi, mis määratleti varem kõigi nende väliste rakenduste adaptritele. Varasemates adaptrite näidisprotseduurides (Näidisprotseduur: UII rakenduse adaptri loomine ja Näidisprotseduur: UII veebirakenduse adaptri loomine) määratlesime kaks järgmist hostitud juhtelementi Unified Service Deskis väliste rakenduste kuvamiseks Unified Service Deskis: QsExternalApp ja QsExternalWebApplication. Selles sammus lisame kolm UII toimingut igale hostitud juhtelemendile.

Tähtis
Kui olete juba lisanud UII toimingud 3. sammu ajal protseduuris Näidisprotseduur: UII Windowsi vormide hostitud juhtelemendi loomine, ei pea te seda sammu kordama. Võite jätkata hostitud juhtelemendi testimiseks järgmise sammuga.

1. Logige sisse rakendusse Microsoft Dynamics CRM.

2. Valige navigeerimisribalt Microsoft Dynamics CRM > Sätted > Unified Service Desk.

3. Valige lehelt Unified Service DeskHostitud juhtelemendid.

4. Otsige lehelt Hostitud juhtelemendid üksust QSExternalApp ja avage see redigeerimiseks.

5. Valige lehelt QSExternalApp hostitud juhtelemendi kõrval olev allanool ja valige siis UII toimingud.

6. Valige järgmiselt lehelt käsk Lisa uus UII toiming.

7. Sisestage lehele Uus UII toiming nimi UpdateFirstName ja valige Salvesta ja sule. See lisab toimingu eelmisele lehele.

8. Samamoodi lisage kaks järgmist toimingut: UpdateLastName ja UpdateAddress. Kõik kolm toimingut muutuvad hostitud juhtelemendi QSExternalApp puhul kättesaadavaks.

9. Järgige samme 4–8 kolme UII samanimelise toimingu loomiseks üksusele QSExternalWebApp.

Testige hostitud juhtelementi

Enne UII WPF-i hostitud juhtelemendi testimist veenduge, et teie näidis-veebirakendus töötab, et see Unified Service Deskis toimiks.

1. Käivitage Unified Service Deski klient ühenduse loomiseks CRM-i serveriga.

2. Sisselogimise õnnestumise korral näete kolme hostitud juhtelementi: UII WPF-i hostitud juhtelemendi näidis, Välise veebirakenduse näidis ja Välise rakenduse näidis.

3. Valige Otsing ja seejärel Kontaktid. Valige mõni kontakt selle kontakti andmete kuvamiseks seansis. See kuvab ka kuvatud kontaktikirje eesnime, perekonnanime, aadressi ja ID kõigis kolmes näidisjuhtelemendis.

4. Muutke väärtusi rakenduses UII WPF-i hostitud juhtelemendi näidis ja klõpsake valikut Väärtuste värskendamine majutatud rakendustes väärtuste värskendamiseks kahes teises välises rakenduses.

5. Valige jaotisest UII WPF-i hostitud juhtelemendi näidisKonteksti värskendamine konteksti värskendamiseks Unified Service Deskis.

Vt ka

Tööülesanded

Näidisprotseduur: UII Windowsi vormide hostitud juhtelemendi loomine

Mõisted

Integrate with external applications and web applications
UII actions

Muud ressursid

Use UII hosted controls with Unified Service Desk

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.