Overzicht: Een gehost UII Windows Forms-besturingselement maken

Gepubliceerd: november 2016

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Dit overzicht toont hoe u een gehost besturingselement van het type Windows FormsUser Interface Integration (UII) maakt dat communiceert met Unified Service Desk en met zelfstandige toepassingen of externe webtoepassingen.

In dit overzicht doet u het volgende:

• Maak een gehost User Interface Integration (UII) Windows Forms-besturingselement, Voorbeeld van een gehost UII Windows Forms-besturingselement, dat de voornaam, de achternaam, het adres en de id weergeeft van een contactpersoon wanneer u contactpersonen zoekt, en klik op de naam van een contactpersoon om deze te openen in een sessie Unified Service Desk. Deze waarden worden weergegeven in de Unified Service Desk-context.

• Wijzig de waarden voor voornaam, achternaam of adres in een externe toepassing en webtoepassing die wordt gehost in Unified Service Desk vanuit het gehoste UII Windows Forms-besturingselement dat we maken. De externe toepassing en de webtoepassing zijn gemaakt in de eerdere overzichten: Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken.

• Wijzigingen aan de Unified Service Desk-context melden om de waarden daar bij te werken.

In dit onderwerp

Vereisten

Stap 1: Een gehost UII Windows Forms-besturingselement maken met Visual Studio

Stap 2: het gehoste besturingselement definiëren in Unified Service Desk.

Stap 3: UII-acties definiëren voor de gehoste besturingselementen van de externe toepassing en de webtoepassing in Unified Service Desk

Test het gehoste besturingselement.

Vereisten

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-clienttoepassing, vereist om het gehoste besturingselement te testen.

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

• NuGet Pakketbeheer voor Visual Studio 2012, Visual Studio 2013 of Visual Studio 2015

• Microsoft Dynamics 365 SDK-sjablonen voor Visual Studio die de projectsjabloon voor het gehoste UI Windows Forms-besturingselement bevatten. U kunt het via een van de volgende opties krijgen:

  • Download de CRM SDK-sjabloon. Dubbelklik op het CRMSDKTemplates.vsix bestand om het sjabloon te installeren in Visual Studio.

  • Download het CRM SDK-pakket en pak het uit. Ga naar de map SDK\Templates. Dubbelklik op het CRMSDKTemplates.vsix bestand om het sjabloon te installeren in Visual Studio.

• U moet Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken hebben voltooid om ervoor te zorgen dat u de externe toepassing en de webtoepassing hebt ingesteld met de respectievelijke adapters om interactie met deze toepassingen mogelijk te maken.

Stap 1: Een gehost UII Windows Forms-besturingselement maken met Visual Studio

1. Start Visual Studio, en maak een nieuw project.

2. In het dialoogvenster Nieuw project:

   1. Vouw in de lijst met geïnstalleerde sjablonen Visual C# uit en selecteer Dynamics 365 SDK-sjablonen > Unified Service Desk > Gehost UII Windows Forms-besturingselement.

   2. Geef de naam en locatie van het project op en klik op OK om een nieuw project te maken.

      

3. Klik in het deelvenster Oplossingenverkenner met de rechtermuisknop op het bestand UiiWinformControl.cs en selecteer Openen om de Windows Forms-ontwerpfunctie weer te geven.

4. Voeg in de designer de volgende besturingselementen toe uit de werkset:

   Type besturingselement	Naam	Tekst
   Etiket	lblFirstName	Voornaam
   Etiket	lblLastName	Achternaam
   Etiket	lblAddress	Adres
   Etiket	lblID	Id
   Tekstvak	txtFirstName
   Tekstvak	txtLastName
   Tekstvak	txtAddress
   Tekstvak	txtID
   Knop	btnUpdate	Waarden bijwerken in gehoste apps
   Knop	btnUpdateContext	Context bijwerken

   Zo moeten de besturingselementen in de designer worden ingedeeld.

   

5. Dubbelklik op de knop Waarden bijwerken in gehoste apps (btnUpdate) om de code van de gebeurtenis click voor deze knop toe te voegen, en voeg de volgende code toe.

   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. Ga naar de ontwerpweergave, dubbelklik op de knop Context bijwerken (btnUpdateContext) om de code voor de klikgebeurtenis voor deze knop toe te voegen. Voeg de volgende code toe.

   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. Werk in hetzelfde bestand (UiiWinformControl.cs) de overschrijvingsdefinitie van de methode NotifyContextChange bij met het volgende:

   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. Sla uw project op en maak het (Maken > Oplossing maken). Nadat het project met succes is gemaakt, wordt een assembly (.dll-bestand) gegenereerd met dezelfde naam als de projectnaam (in dit geval UIIWindowsFormHostedConrol1.dll) in de map /bin/debug van het project.

9. Kopieer dit bestand naar de installatiemap van uw Unified Service Desk-clienttoepassing (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD). Dit bestand is nodig voor het testen en uiteindelijk het gebruiken van dit besturingselement vanuit de clienttoepassing.

   Tip

   Noteer de naam van de klasse die is gebruikt om uw gehost UII-besturingselement in het bestand UiiWinformControl.cs te maken. In dit geval is dat UiiWinformControl. U hebt deze informatie in de volgende stap nodig.

Stap 2: het gehoste besturingselement definiëren in Unified Service Desk.

Als u het gehoste UII Windows Forms-besturingselement wilt hosten in Unified Service Desk, moet u het definiëren en configureren.

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk.

3. Klik op de pagina Unified Service Desk op Gehoste besturingselementen.

4. Klik op de pagina Gehoste besturingselementen op Nieuw.

5. Geef op de pagina Nieuw gehost besturingselement de volgende waarden op:

   Veld	Waarde
   Naam	UIIWindowsFormHostedControl
   Weergavenaam	Voorbeeld van een gehost Windows Forms UII-besturingselement
   Onderdeeltype van Volledige servicedesk	CCA-gehoste toepassing
   Gehoste toepassing	Gehost beheer
   Toepassing is algemeen	Geselecteerd
   Weergavegroep	MainPanel
   Adapter	Geen adapter gebruiken
   Assemblage-URI	UIIWindowsFormHostedControl1
   Assemblagetype	UIIWindowsFormHostedControl1.UiiWinformControl

   Notitie

   Assembly-URI is de naam van uw assembly en het Assemblytype is de naam van uw assembly gevolgd door een punt (.) en vervolgens de klassenaam in uw Visual Studio-project. In dit voorbeeld is de naam van de assemblage UIIWindowsFormHostedControl1 en de naam van de klasse UiiWinformControl, wat de standaardklassenaam is wanneer u een gehost UII Windows Forms-besturingselement maakt.

   

6. Klik op Opslaan om het gehoste besturingselement te maken.

Stap 3: UII-acties definiëren voor de gehoste besturingselementen van de externe toepassing en de webtoepassing in Unified Service Desk

De adapters voor de externe toepassing en de webtoepassing maken de volgende drie acties beschikbaar: UpdateFirstName, UpdateLastName en UpdateAddress. Deze adapters en de gehoste besturingselementen voor de externe zelfstandige toepassing en de webtoepassing zijn gemaakt in de eerdere adapteroverzichten (Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken.)

Als u informatie in de externe toepassing wilt bijwerken vanuit het gehoste UII Windows Forms-besturingselement, moet u drie UII-acties definiëren met dezelfde naam als eerder gedefinieerd in de adapters voor elke externe toepassing. In de vorige adapteroverzichten (Overzicht: Een UII-toepassingsadapter maken en Overzicht: Een UII-webtoepassingsadapter maken) definieerde u de volgende twee gehoste besturingselementen in Unified Service Desk om de externe toepassingen weer te geven in Unified Service Desk: QsExternalApp en QsExternalWebApplication. In deze stap voegt u drie UII-acties toe aan elk gehost besturingselement.

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk.

3. Kies op de pagina Unified Service DeskGehoste besturingselementen.

4. Zoek op de pagina Gehoste besturingselementen de QsExternalApp en open deze voor bewerking.

5. Klik op de pagina QsExternalApp op de pijl-omlaag naast de naam van het gehoste besturingselement en klik vervolgens op UII-acties.

6. Klik op de volgende op Nieuwe UII-actie toevoegen.

7. Typ de naam als UpdateFirstName en klik op Opslaan en sluiten. Hierdoor wordt de actie in de vorige pagina toegevoegd.

8. Voeg op dezelfde manier de volgende twee acties toe: UpdateLastName en UpdateAddress. Alle drie de acties worden beschikbaar voor het gehoste QsExternalApp-besturingselement.

   

9. Voer stap 4 tot en met 8 uit om drie UII-acties met dezelfde namen te maken voor het gehoste besturingselement QsExternalWebApp.

Test het gehoste besturingselement.

Voordat u het gehoste UII Windows Forms-besturingselement test, moet u ervoor zorgen dat uw voorbeeldwebtoepassing actief is zodat deze wordt weergegeven in Unified Service Desk.

1. Voer de Unified Service Desk-client uit om verbinding te maken met uw Dynamics 365-server.

2. Als u zich met succes hebt aangemeld, ziet u drie gehoste besturingselementen: Voorbeeld van gehost UII Windows Forms-besturingselement, Voorbeeld van externe webtoepassing en Voorbeeld van externe toepassing.

   

3. Kies Zoeken en kies vervolgens Contactpersonen. Kies een van de contactpersonen om de details van de contactpersoon in een sessie weer te geven. Ook de voornaam, achternaam, adres en id van de huidige weergegeven contactpersoon worden weergegeven in alle drie de voorbeeldbesturingselementen, zoals in de volgende illustratie.

   

4. Wijzig de waarden in Voorbeeld van gehost UII Windows Forms-besturingselement en klik op Waarden bijwerken in gehoste apps om de waarden in de andere twee externe toepassingen bij te werken.

   

5. Klik in Voorbeeld van gehost UII Windows Forms-besturingselement op Context bijwerken om de contextinformatie in Unified Service Desk bij te werken.

   

Zie ook

Gehoste UII-besturingselementen gebruiken met Unified Service Desk
Overzicht: Een gehost UI WPF-besturingselement maken

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht