Näidisprotseduur: UII Windowsi vormide hostitud juhtelemendi loomine

See näidisprotseduur näitab, kuidas luua Windowsi vormide User Interface Integration (UII) hostitud juhtelementi, mis suhtleb Unified Service Deski ja väliste eraldiseisvate ning veebipõhiste rakendustega.

Selles näidisprotseduuris teete järgmist.

• Looge User Interface Integration (UII) Windowsi vormide hostitud juhtelement, UII Windowsi vormide 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 loodava UII Windowsi vormide 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 varasemates näidisprotseduurides: Näidisprotseduur: UII rakenduse adaptri loomine ja 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 Windowsi vormide 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, mis 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 sisaldab UII Windowsi vormide hostitud juhtelemendi projekti malli. Võite selle hankida ü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 vastavate adaptritega seadistatud, et hõlbustada nende rakendustega suhtlemist.

1. samm: UII Windowsi vormide 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 Windowsi vormide hostitud juhtelement.

   2. Määrake projekti nimi ja asukoht ning klõpsake uue projekti loomiseks OK.

3. Tehke lahenduseuurija paanil paremklõps failil UiiWinformControl.cs ja valige käsk Ava Windowsi vormide 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 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, 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. Minge kujundamise vaatesse ja tehke topeltklõps nupul Konteksti värskendamine (btnUpdateContext) selle nupu klõpsamissündmuse koodi lisamiseks. Lisage järgmine kood.

   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. Värskendage samas failis (UiiWinformControl.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) (praegusel juhul UIIWindowsFormHostedConrol1.dll) projektiga sama nimega 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 UiiWinformControl.cs kasutatakse. Praegusel juhul on see UiiWinformControl. Seda teavet vajate järgmises sammus.

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

UII Windowsi vormide 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. Klõpsake lehel Unified Service Desk valikut Hostitud juhtelemendid.

4. Klõpsake lehel Hostitud juhtelemendid valikut Uus.

5. Lehel Uus hostitud juhtelement määrake järgmised väärtused.

   Väli	Väärtus
   Nimi	UIIWindowsFormHostedControl
   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	UIIWindowsFormHostedControl1
   Assembleri tüüp	UIIWindowsFormHostedControl1.UiiWinformControl

   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 UIIWindowsFormHostedControl1 ja klassi nimi on UiiWinformControl, mis on klassi vaikenimi UII Windowsi vormide hostitud juhtelemendi loomisel.

6. Klõpsake hostitud juhtelemendi loomiseks nuppu 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 adaptri 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ääratlesite kaks järgmist hostitud juhtelementi Unified Service Deskis väliste rakenduste kuvamiseks Unified Service Deskis: QsExternalApp ja QsExternalWebApplication. Selles sammus lisate kolm UII toimingut igale hostitud juhtelemendile.

Tähtis
Kui olete juba lisanud UII toimingud 3. sammu ajal protseduuris Näidisprotseduur: UII WPF-i 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. Klõpsake lehel QsExternalApp hostitud juhtelemendi kõrval olevat allanoolt ja seejärel valikut UII toimingud.

6. Järgmisel lehel klõpsake nuppu Lisa uus UII toiming.

7. Sisestage nimi kujul UpdateFirstName ning klõpsake käsku 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 hostitud juhtelemendile QsExternalWebApp.

Testige hostitud juhtelementi

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

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

2. Sisselogimise õnnestumise korral näete kolme hostitud juhtelementi: UII Windowsi vormide 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, nagu on näidatud järgmisel joonisel.

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

5. Klõpsake jaotises UII Windowsi vormide hostitud juhtelemendi näidis valikut Konteksti värskendamine konteksti värskendamiseks Unified Service Deskis.

Vt ka

Tööülesanded

Näidisprotseduur: UII WPF-i hostitud juhtelemendi loomine

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.