Näidisprotseduur: UII rakenduse adaptri loomine

Saate luua rakenduse adaptri, kui soovite integreerida välise rakenduse UII lahendusse. Microsoft Dynamics CRM annab Microsoft Visual Studio malli rakenduse adaptri loomiseks. Mall pakub põhilist koodi kommentaaridena, et aidata teil rakenduse adaptri loomisega alustada.

Selles näidisprotseduuris loote välise rakenduse QsExternalApp ja majutate selle Unified Service Deski. Seejärel saate luua ja konfigureerida rakenduse adaptri nimega ExternalApplicationAdapter, et väline rakendus saaks Unified Service Deskiga suhelda. Välisel rakendusel on neli silti, üks kliendi eesnime, perekonnanime, aadressi ja ID jaoks ja neli vastavat tekstivälja, millelt kuvatakse Unified Service Deski väärtused.

Selle jaotise sisu

Eeltingimused

1. samm: välise näidisrakenduse koostamine

2. samm: välise rakenduse konfigureerimine Microsoft Dynamics CRM-is.

3. samm: välise rakenduse testimine

4. samm: rakenduse adaptri loomine

4. samm: rakenduse adaptri konfigureerimine Dynamics CRM-is

5. samm: rakenduse adaptri testimine

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 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 SDK-s kausta SDK\Templates ja tehke topeltklõps failil CRMSDKTemplates.vsix malli installimiseks Visual Studiosse.

1. samm: välise näidisrakenduse koostamine

1. Laadige alla UII SDK pakett.

2. Topeltklõpsake paketifaili sisu ekstraktimiseks.

3. Minge kausta <ExtractedFolder>\UII\SampleCode\UII\AIF\QsExternalApp ja avage fail Microsoft.Uii.QuickStarts.QsExternalApp.csproj rakenduses Visual Studio.

4. Vajutage klahvi F5 või valige Silu > Alusta silumist välise näidisrakenduse loomiseks. Rakendus (Microsoft.Uii.QuickStarts.QsExternalApp.exe) luuakse projekti kaustas /bin/debug.

2. samm: välise rakenduse konfigureerimine Microsoft Dynamics CRM-is.

Selles etapis loote hostitud juhtelemendi tüübiga Väline majutatud rakendus, et kuvada Windowsi vormide rakendus.

1. Logige sisse rakendusse Microsoft Dynamics CRM.

2. Klõpsake või koputage navigeerimisribal valikut Microsoft Dynamics CRM ja valige seejärel Sätted.

3. Klõpsake või koputage valikuid Sätted > Unified Service Desk > Hostitud juhtelemendid.

4. Klõpsake suvandit Uus.

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

   Väli	Väärtus
   Nimi	QsExternalApp
   USD komponent	CCA majutatud rakendus
   Majutatud rakendus	Väline majutatud rakendus
   Rakendus on globaalne	Kontrollitud
   Kuva rühm	MainPanel
   Adapter	Ära kasuta adaptrit
   Rakendus on dünaamiline	Ei
   Välise rakenduse URI	Microsoft.Uii.QuickStarts.QsExternalApp.exe

6. Klõpsake nuppu Salvesta.

3. samm: välise rakenduse testimine

1. Kopeerige rakendus oma Visual Studio projekti väljundkaustast (<ProjectFolder>\bin\debug) Unified Service Deski rakenduse kausta. Praegusel juhul kopeerime faili Microsoft.Uii.QuickStarts.QsExternalApp.exefile kataloogi C:\Program Files\Microsoft Dynamics CRM USD\USD.

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

3. Sisselogimise õnnestumisel näete töölaual välise näidisrakenduse nuppu.

4. Valige Väline näidisrakendus Unified Service Deskis majutatud rakenduse nägemiseks.

4. samm: rakenduse adaptri loomine

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

2. Tehke dialoogiboksis Uus projekt järgmist.

   1. Laiendage vasakul asuvas installitud mallide loendis jaotist Visual C# ja valige CRM-i SDK mallid > Unified Service Desk > UII rakenduse adapter.

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

3. Laiendage Lahenduseuurija jaotist Viited veendumaks, et kõik assembleri viited lahenduvad õigesti.

4. Avage fail AppAdapter.cs ja lisage järgmised koodiread, et määrata iga lehe komponendi asukoht klassi definitsioonis.

   // Set up your locations for each component on the page.
           // If you wish, you could use Spy++ to get the actual names as well.
           // First Name text box
           int intFirstNameCoordX = 47;
           int intFirstNameCoordY = 32;
           // Last Name text box
           int intLastNameCoordX = 223;
           int intLastNameCoordY = 32;
           // Address Text box
           int intAddressCoordX = 47;
           int intAddressCoordY = 81;
           // Customer ID text box
           int intIDCoordX = 47;
           int intIDCoordY = 126;
   

5. Lisage järgmine kood definitsioonile NotifyContextChange rakenduse teavitamiseks konteksti muutumisest. Lisateabe jaoks vaadake teemat NotifyContextChange.

   public override bool NotifyContextChange(Context context)
           {
               IntPtr ptr = MainWindowHandle;
               // Find the control (first name) by position
               IntPtr childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intFirstNameCoordX, intFirstNameCoordY));
               // Fill data out
               Win32API.SetWindowTextAny(childHwnd, context["firstname"]);
               // Find the control (last name) by position
               childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intLastNameCoordX, intLastNameCoordY));
               // Fill out the data
               Win32API.SetWindowTextAny(childHwnd, context["lastname"]);
               childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intAddressCoordX, intAddressCoordY));
               Win32API.SetWindowTextAny(childHwnd, context["address1_line1"]);
               childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intIDCoordX, intIDCoordY));
               Win32API.SetWindowTextAny(childHwnd, context["CustomerID"]);
               // Hands control back over to the base class to notify next app of context change.
               return base.NotifyContextChange(context);
   
           }
   

6. Lisage järgmine kood alistamisdefinitsioonileDoAction vormiväljade värskendamiseks Unified Service Deski väärtustega.

   public override bool DoAction(Microsoft.Uii.Csr.Action action, RequestActionEventArgs args)
           {
               IntPtr ptr;
               IntPtr childHwnd;
               switch (args.Action)
               {
                   case "UpdateFirstName":
                       // Get locations of what you want to update and handles
                       ptr = MainWindowHandle;
                       childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intFirstNameCoordX, intFirstNameCoordY));
                       // Populate data into fields
                       Win32API.SetWindowTextAny(childHwnd, args.Data);
                       break;
                   case "UpdateLastName":
                       // Get locations of what you want to update and handles
                       ptr = MainWindowHandle;
                       childHwnd = Win32API.FindWindowByPosition(ptr, new Point(intLastNameCoordX, intLastNameCoordY));
                       // Populate data into fields
                       Win32API.SetWindowTextAny(childHwnd, args.Data);
                       break;
               }
               return base.DoAction(action, args);
           }
   

7. Salvestage oma projekt ja koostage see (Koosta > Koosta lahendus). Pärast projekti edukat koostamist luuakse assembler (ExternalApplicationAdapter.dll) teie projektikausta kaustas \bin\debug. Seda assemblerit on teil hiljem vaja rakenduse adaptri testimiseks ja kasutamiseks.

4. samm: rakenduse adaptri konfigureerimine Dynamics CRM-is

1. Logige sisse rakendusse Microsoft Dynamics CRM.

2. Valige navigeerimisribalt Microsoft Dynamics CRM ja valige siis Sätted.

3. Valige Sätted > Unified Service Desk > Hostitud juhtelemendid.

4. Valige hostitud juhtelementide loendist hostitud juhtelement QsExternalApp.

5. Määrake jaotises Adaptri konfiguratsioon järgmised väärtused.

   Väli	Väärtus
   Adapter	Kasuta adaptrit
   URI	ExternalApplicationAdapter
   Tüüp	ExternalApplicationAdapter.AppAdapter

   Märkus

   URI on teie assembleri nimi ja Tüüp on teie assembleri nimi (dll), millele järgneb punkt (.) ja seejärel klassi nimi teie Visual Studio projektis. Selles näites on assembleri nimi ExternalApplicationAdapter ja klassi nimi on AppAdapter, mis on klassi vaikenimi rakenduse adaptri loomisel.

6. Klõpsake muudatuste salvestamiseks nuppu Salvesta.

5. samm: rakenduse adaptri testimine

1. Kopeerige veebirakenduse adaptri definitsiooni sisaldav assembler oma Visual Studio projekti väljundkaustast (<ProjectFolder>\bin\debug) Unified Service Deski rakenduse kausta. Praegusel juhul kopeerime faili ExternalApplicationAdapter.dll kataloogi c:\Program Files\Microsoft Dynamics CRM USD\USD.

2. Käivitage Unified Service Deski klient ühenduse loomiseks Microsoft Dynamics CRM-i serveriga.

3. Sisselogimise õnnestumisel näete töölaual välist näidis-veebirakendust.

4. Valige Otsing, seejärel Kontaktid ja valige kontakt. Praegusel juhul valime nime Patrick Sands.

5. Klõpsake valikut Väline näidisrakendus ja näete kliendi eesnime, perekonnanime, aadressi ja ID-d.

Vt ka

Mõisted

Use UII adapters to interact with external and web applications

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