Analyse: een aangepast gehost besturingselement voor Unified Service Desk maken

Gepubliceerd: november 2016

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

In dit onderwerp leert u hoe u een aangepast, gehost besturingselement met de naam My Custom Control maakt met een aangepaste actie. Het aangepaste gehoste besturingselement heeft twee Windows Presentation Foundation (WPF)-besturingselementen: een knop die het gehoste Debugger-besturingselement aanroept en een tekstlabel met de gebruikersnaam wanneer een aangepaste actie, MyCustomAction, wordt aangeroepen.

In deze sectie

Vereisten

Een aangepast gehost besturingselement maken

Test uw aangepaste gehoste besturingselement

Vereisten

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-clienttoepassing; de clienttoepassing is vereist voor het testen van het gehoste besturingselement.

• 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 aangepaste gehoste projectsjabloon bevatten voor het gehoste besturingselement. U kunt het via een van de volgende opties krijgen:

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

  • Download en installeer de CRM SDK. Het sjabloonsbestand, CRMSDKTemplates.vsix, staat in de map SDK\Templates. Dubbelklik op het sjabloonbestand om het te installeren in Visual Studio.

Een aangepast gehost besturingselement maken

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 > Aangepast USD-besturingselement.

   2. Controleer of .NET Framework 4.5.2 is geselecteerd.

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

   

3. Dubbelklik in Verkenner op het bestand USDControl.xaml om de XAML-ontwerpfunctie weer te geven.

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

   • Label: Stel in het deelvenster Eigenschappen de naam van het besturingselement in op “myLabel”.

   • Knop: Stel in het deelvenster Eigenschappen de naam van het besturingselement in op “myButton,” en de inhoud op “Start Debugger”.

   Zo zien de besturingselementen eruit in de XAML-designer.

   

5. Dubbelklik op de knop om code toe te voegen achter de XAML. Hiermee gaat u naar de definitie van de klikgebeurtenis van myButton in het bestand USDControl.xaml.cs. Voeg de volgende opdracht toe.

   private void myButton_Click(object sender, RoutedEventArgs e)
   {
       if (!this.desktopAccess.AppExistsInUI("Debugger"))
       {
           this.desktopAccess.CreateDynamicApplication("Debugger");
       }
       this.FireRequestAction(new Microsoft.Uii.Csr.RequestActionEventArgs("Debugger", "default", null));
   }
   

6. Definieer een aangepaste actie voor het gehoste besturingselement. Blader in het bestand USDControl.xaml.cs naar de overschrijvingsdefinitie van DoAction.

   protected override void DoAction(Microsoft.Uii.Csr.RequestActionEventArgs args)
   

7. Voeg de volgende code toe binnen de overschrijvingsdefinitie van DoAction om een aangepaste actie te definiëren met de naam MyCustomAction, die een parameter met de naam username accepteert:

   if (args.Action.Equals("MyCustomAction", StringComparison.OrdinalIgnoreCase))
   {
       List<KeyValuePair<string, string>> actionDataList = Utility.SplitLines(args.Data, CurrentContext, localSession);
       string valueIwant = Utility.GetAndRemoveParameter(actionDataList, "username"); // assume there is a myKey=<value> in the data.
   
       if (!string.IsNullOrEmpty(valueIwant))
       {
           this.Dispatcher.Invoke(() => { this.myLabel.Content = valueIwant; });
       }
   }
   

   Tip

   De sjabloon levert het grootste deel van de code als commentaar binnen de overschrijvingsdefinitie van DoAction om u te helpen snel aan de slag te gaan met de ontwikkeling. U moet de commentaarmarkering van de vereiste coderegel verwijderen en de tijdelijke aanduidingswaarden vervangen door uw waarden.

8. Sla uw project op en maak het (Maken > Oplossing maken) om te controleren of het met succes kan worden gemaakt.

Test uw aangepaste gehoste besturingselement

Nadat uw project met succes is gemaakt, test u het aangepaste gehoste besturingselement. Het testen bevat twee delen: het definiëren van het aangepaste gehoste besturingselement op de server en het maken van verbinding met Unified Service Desk op de server met behulp van uw clienttoepassing.

Het aangepaste gehoste besturingselement en de actie definiëren op de Dynamics 365-server

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 en selecteer Instellingen.

3. Kies Instellingen > Unified Service Desk > Gehoste besturingselementen.

4. Kies NIEUW en geef vervolgens waarden in het scherm Nieuw gehost besturingselement op, zoals hier weergegeven.

   

   Notitie

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

5. Kies Opslaan om het gehoste besturingselement te maken.

6. Maak de actie voor het gehoste besturingselement dat u in Visual Studio hebt gedefinieerd. Kies op de navigatiebalk de pijl-omlaag naast de naam van uw gehoste besturingselement en selecteer UII-acties.

7. Kies Nieuwe UII-actie toevoegen.

8. Typ MyCustomAction in het veld Naam en kies Opslaan.

U hebt nu uw aangepaste gehoste besturingselement en de aangepaste actie op uw Dynamics 365-server geconfigureerd.

De Unified Service Desk-client uitvoeren om te werken met het aangepaste gehoste besturingselement

1. Kopieer de assemblage met uw aangepaste gehoste besturingselementdefinitie uit de uitvoermap van uw Visual Studio-project (<ProjectFolder>\bin\debug) naar de toepassingsdirectory van Unified Service Desk. In dit geval kopieert u het bestand MyCustomControl.dll naar de directory c:\Program Files\Microsoft Dynamics CRM USD\USD.

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

3. Bij succesvolle aanmelding ziet u het aangepaste gehoste besturingselement, Mijn aangepast gehost besturingselement op uw bureaublad.

   

4. Klik op Debugger starten om het gehoste besturingselement Debugger te starten.

5. Als u de aangepaste actie wilt testen, kiest u het tabblad Debugger en klikt u op de pijl-omlaag boven het tabblad Actieoproepen om het gebied weer te geven waar u actieoproepen en UII-acties kunt testen.

   

6. Kies het tabblad Directe actie.

7. Selecteer in de lijst Gehost beheerMijn aangepast gehost besturingselement en selecteer in de lijst ActieMyCustomAction.

8. Aangezien deze aangepaste actie volgens de definitie een parameter genaamd username aanroept, voegen we de volgende waarde toe aan het veld Gegevens: username=Tracie Hamilton.

   

9. Klik op het pictogram Directe actie uitvoeren () en klik vervolgens op het tabblad Mijn aangepaste gehoste besturingselement. De opgegeven gebruikersnaam wordt weergegeven in het labelveld.

   

Zie ook

Gehost besturingselement van Volledige servicedesk (gehost besturingselement)
Typen gehoste besturingselementen en actie/gebeurtenisnaslag
Configuratieanalyses van Unified Service Desk importeren
Aangepast gehost besturingselement gebruiken in Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht