Exemplarische Vorgehensweise: Erstellen eines UII Windows Forms gehosteten Steuerelement

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Diese Exemplarische Vorgehensweise veranschaulicht, wie Sie ein Windows Forms-basiertes User Interface Integration (UII) gehostetes Steuerelement erstellen, das mit Unified Service Desk und externen eigenständigen oder Webanwendungen interagiert.

In dieser exemplarischen Vorgehensweise werden Sie Folgendes erfahren:

• Erstellen Sie ein User Interface Integration (UII) Windows Forms gehostetes Steuerelement, Beispiel-UII Windows Forms gehostetes Steuerelement, das Vornamen, Nachnamen, Postanschrift und ID eines Kontakts anzeigt, wenn Sie nach Kontakten suchen, und klicken Sie auf einen Kontaktnamen in einer Sitzung, um ihn in einer Sitzung in Unified Service Desk zu öfnen. Diese Werte werden aus dem Unified Service Desk-Kontext angezeigt.

• Ändern Sie die Werte für Vornamen, Nachnamen oder Adresse in einer externen und Webanwendung in Unified Service Desk aus dem UII Windows Forms-gehosteten Steuerelement, das wir erstellen. Die externe und die Webanwendung wurde in früheren exemplarischen Vorgehensweisen erstellt: Exemplarische Vorgehensweise: Einen UII-Anwendungs-Adapter erstellen und Exemplarische Vorgehensweise: Einen UII-Webanwendungs-Adapter erstellen.

• Melden Sie Änderungen am Unified Service Desk-Kontext hier, um die Werte zu aktualisieren.

In diesem Thema

Voraussetzungen

Schritt 1: Erstellen eines UII Windows Forms-gehosteten Steuerelements mithilfe von Visual Studio

Schritt 2: Definieren des gehosteten Steuerelements in Unified Service Desk

Schritt 3: Definieren von UII-Aktionen für die gehosteten Steuerelemente der externen Anwendung und der Webanwendung in Unified Service Desk

Testen des gehosteten Steuerelements

Voraussetzungen

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-Client-Anwendung; erforderlich für das Testen des gehosteten Steuerelements.

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

• NuGet Package Manager für Visual Studio 2012, Visual Studio 2013 oder Visual Studio 2015

• Microsoft Dynamics 365 SDK-Vorlagen für Visual Studio, die mit Projektvorlage für ein UII Windows Forms gehostetes Steuerelement enthält. Sie können Sie auf eine der folgenden Weisen erhalten:

  • Laden Sie die CRM-SDK-Vorlage herunter. Doppelklicken Sie zur Installation der Vorlage in Visual Studio auf die Datei CRMSDKTemplates.vsix.

  • Laden Sie das CRM SDK-Paket herunter und extrahieren Sie es. Wechseln Sie zum SDK\Templates-Ordner. Doppelklicken Sie zur Installation der Vorlage in Visual Studio auf die Datei CRMSDKTemplates.vsix.

• Sie sollten die Exemplarische Vorgehensweise: Einen UII-Anwendungs-Adapter erstellen und Exemplarische Vorgehensweise: Einen UII-Webanwendungs-Adapter erstellen abgeschlossen haben, um sicherzustellen, dass Sie die externe und Websanwendung mit den jeweiligen Adaptern eingerichtet haben, um die Interaktion mit diesen Adaptern zu erleichtern.

Schritt 1: Erstellen eines UII Windows Forms-gehosteten Steuerelements mithilfe von Visual Studio

1. Starten Sie Visual Studio und erstellen Sie ein neues Projekt.

2. Im Dialogfeld Neues Projekt:

   1. Erweitern Sie in der Liste der installierten Vorlagen auf der linken Seite Visual C#, und wählen Sie Dynamics 365 SDK-Vorlagen > Unified Service Desk > UII Windows Forms gehostetes Steuerelement aus.

   2. Geben Sie den Namen und den Speicherort des Projekts an, und klicken Sie auf OK, um ein neues Projekt zu erstellen.

      

3. Klicken Sie im Bereich Lösungs-Explorer auf die UiiWinformControl.cs-Datei mit der rechten Maustaste, und wählen Sie Öffnen, um den Windows Forms-Designer anzuzeigen.

4. Im Designer fügen Sie die folgenden Steuerelemente aus der Toolbox hinzu:

   Steuerelementtyp	Name	Text
   Etikett	lblFirstName	Vorname
   Etikett	lblLastName	Nachname
   Etikett	lblAddress	Postadresse
   Etikett	lblID	ID
   TextBox	txtFirstName
   TextBox	txtLastName
   TextBox	txtAddress
   TextBox	txtID
   Schaltfläche	btnUpdate	Aktualisieren von Werten in den gehosteten Apps
   Schaltfläche	btnUpdateContext	Kontextaktualisierung

   So sollten die Steuerlemente im Designer entwickelt werden.

   

5. Doppelklicken Sie auf die Schaltfläche Updatewerte in den gehosteten Apps (btnUpdate), um den Code für click-Ereignis für das Hinzufügen dieser Schaltfläche, und fügen Sie den folgenden Code hinzu.

   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. Gehen Sie zur Designansicht, doppelklicken Sie auf die Schaltfläche Kontext aktualisieren (btnUpdateContext) um den Code für das Klick-Ereignis für diese Schaltfläche hinzuzufügen. Fügen Sie den folgenden Code hinzu:

   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. Aktualiseren Sie in derselben Datei (UiiWinformControl.cs) die Außerkraftsetzungsdefinition der NotifyContextChange-Methode zu dem Folgenden:

   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. Speichern Sie das Projekt und bauen Sie es auf (Aufbauen > Lösung aufbauen). Nachdem das Projekt erfolgreich aufgebaut wurde, wird eine Assembly (.dll-Datei) mit demselben Namen wie dem Projektnamen (in diesem Fall UIIWindowsFormHostedConrol1.dll) im /bin/debug-Ordner des Projekts erstellt.

9. Kopieren Sie diese Datei das Unified Service Desk-Client-Anwendungsinstallationsverzeichnis (in der Regel C:\Program Files\Microsoft Dynamics CRM USD\USD). Diese Datei ist zum Testen und schließlich zum Verwenden dieses Steuerelements von der Client-Anwendung aus erforderlich.

   Tipp

   Notieren Sie den Namen der Klasse, die verwendet wird, um das gehostete UII-Steuerelement in der UiiWinformControl.cs-Datei zu erstellen. In diesem Fall ist es UiiWinformControl. Sie benötigen diese Informationen im nächsten Schritt.

Schritt 2: Definieren des gehosteten Steuerelements in Unified Service Desk

Um das UIIWindows Forms gehostete Steuerlement in Unified Service Desk zu hosten, müssen Sie es definieren und konfigurieren.

1. Melden Sie sich bei Microsoft Dynamics 365 an.

2. Klicken Sie auf der Navigationsleiste auf Microsoft Dynamics 365 > Einstellungen > Unified Service Desk.

3. Wählen Sie auf der Seite Unified Service Desk die Option Gehostete Steuerelemente aus.

4. Klicken Sie auf der Seite für Gehostetes Steuerelemente auf Neu.

5. Geben Sie auf der Seite Neues gehostetes Steuerelement die folgenden Werte an:

   Feld	Wert
   Name	UIIWindowsFormHostedControl
   Anzeigename	Gehostetes Beispiel-UII Windows-Formular-Steuerelement
   USD-Komponententyp	Gehostete CCA-Anwendung
   Gehostete Anwendung	Gehostetes Steuerelement
   Anwendung ist global	Ausgewählt
   Anzeigegruppe	MainPanel
   Adapter	Keinen Adapter verwenden
   Assembly-URI	UIIWindowsFormHostedControl1
   Assemblytyp	UIIWindowsFormHostedControl1.UiiWinformControl

   Hinweis

   Assembly-URI ist der Name Ihrer Assembly, und der Assembly-Typ ist der Name Ihrer Assembly, gefolgt von einem Punkt (.) und anschließend der Klassenname in Ihrem Visual Studio-Projekt. In diesem Beispiel lautet der Name des Assemblys UIIWindowsFormHostedControl1, und der Name der Klasse ist UiiWinformControl; dies ist der Standardklassenname, wenn Sie ein UIIWindows Forms-gehostetes Steuerelement erstellen.

   

6. Klicken Sie auf Speichern, um das gehostete Steuerelement zu erstellen.

Schritt 3: Definieren von UII-Aktionen für die gehosteten Steuerelemente der externen Anwendung und der Webanwendung in Unified Service Desk

Die Adapter für die eigenständige externe und die Webanwendungen stellen die folgenden drei Aktionen zur Verfügung: UpdateFirstName, UpdateLastName und UpdateAddress. Diese Adapter und die gehosteten Steuerelemente für die externe eigenständige und die Webanwendung wurde in früheren exemplarischen Vorgehensweisen zu Adaptern erstellt (Exemplarische Vorgehensweise: Einen UII-Anwendungs-Adapter erstellen und Exemplarische Vorgehensweise: Einen UII-Webanwendungs-Adapter erstellen).

Um Informationen in externen Anwendungen aus den UII Windows Forms gehosteten Steuerelementen zu aktualisieren, müssen Sie drei UII-Aktionen mit demselben Namen definieren, wie zuvor in den Adaptern für jede externe Anwendung definiert wurden. In den früheren exemplarischen Vorgehensweisen zu Adapten (Exemplarische Vorgehensweise: Einen UII-Anwendungs-Adapter erstellen und Exemplarische Vorgehensweise: Einen UII-Webanwendungs-Adapter erstellen), definierten Sie folgende zwei gehosten Steuerlemente in Unified Service Desk, um die externen Anwendungen in Unified Service Desk: QsExternalApp und QsExternalWebApplication anzuzeigen. In diesem Schritt fügen Sie drei UII-Aktionen für jedes gehostete Steuerelement hinzu.

1. Melden Sie sich bei Microsoft Dynamics 365 an.

2. Klicken Sie auf der Navigationsleiste auf Microsoft Dynamics 365 > Einstellungen > Unified Service Desk.

3. Wählen Sie auf der Seite Unified Service Desk die Option Gehostete Steuerelemente aus.

4. Auf der Seite Gehostete Steuerelemente suchen Sie nach QsExternalApp, und öffnen Sie sie zum Bearbeiten.

5. Klicken Sie auf der QsExternalApp-Seite auf den Abwärtspfeil neben dem Namen des gehosteten Steuerelements und dann auf UII-Aktionen.

6. Klicken Sie auf der nächsten Seite auf Neue UII-Aktion hinzufügen.

7. Geben Sie den Namen als UpdateFirstName ein, und klicken Sie auf Speichern und schließen. Dadurch wird die Aktion in der vorherige Seite hinzugefügt.

8. Entsprechend fügen Sie die folgenden beiden Aktionen hinzu: UpdateLastName und UpdateAddress. Alle drei Aktionen werden für das gehostete QsExternalApp-Steuerelement verfügbar.

   

9. Führen Sie die Schritte 4 bis 8 aus, um drei UII-Aktionen mit dem gleichen Namen für die QsExternalWebApp gehosteten Steuerelemente zu erstellen.

Testen des gehosteten Steuerelements

Bevor Sie das UII Windows Forms-gehostete Steuerelement testen, stellen Sie sicher, dass es ausgeführt wird, damit es in Unified Service Desk wiedergegeben wird.

1. Führen Sie den Unified Service Desk-Client aus, um eine Verbindung mit dem Dynamics 365-Server herzustellen.

2. Bei erfolgreicher Anmeldung sehen Sie drei gehostete Steuerelemente: Windows Forms-gehostetes Steuerlement, Externe Beispiel-Webanwendung und Externe Beispiel-Anwendung.

   

3. Wählen Sie Suchen aus, und dann Kontakte. Wählen Sie die Kontakte, die in den Kontaktdetails einer Sitzung anzuzeigen sind. Dies zeigt auch Vorname, Nachname, Postanschrift und ID des derzeit angezeigten Kontaktdatensatzes in allen drei Beispiel-Steuerlementen an, wie in der folgenden Abbildung gezeigt.

   

4. Ändern Sie die Werte in Beispiel-Windows Forms-gehostetes Steuerelement, und klicken Sie auf Wwerte in den gehosteten Apps aktualisieren, um die Werte in den anderen beiden externen Anwendungen zu aktualisieren.

   

5. In Beispiel-Windows Forms-gehostetes Steuerelement wählen Sie Kontext aktualisieren, um Kontextinformationen in Unified Service Desk zu aktualisieren.

   

Siehe auch

Gehostete UII-Steuerelemente mit Unified Service Desk
Exemplarische Vorgehensweise: Erstellen eines gehosteten UII WPF-Steuerelements

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright