Gennemgang: Oprette et brugerdefineret tilknyttet kontrolelement til Unified Service Desk

Artikel
04/18/2017

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

I dette emne lærer du, hvordan du opretter et brugerdefineret tilknyttet kontrolelement, My Custom Control, med en brugerdefineret handling. Det brugerdefinerede tilknyttede kontrolelement har to Windows Presentation Foundation (WPF)-kontrolelementer: en knap, der kalder det tilknyttede Debugger-kontrolelement og en tekstetiket, der viser brugernavnet, når en brugerdefineret handling, MyCustomAction, kaldes.

Dette afsnit indeholder

Forudsætninger

Oprette et brugerdefineret tilknyttet kontrolelement

Teste dit brugerdefinerede tilknyttede kontrolelement

Forudsætninger

Microsoft .NET Framework 4.5.2
Unified Service Desk-klientprogram. Klientprogrammet bruges til at teste det tilknyttede kontrolelement.
Microsoft Visual Studio 2012, Visual Studio 2013 eller Visual Studio 2015
NuGet Package Manager for Visual Studio 2012, Visual Studio 2013 eller Visual Studio 2015
Microsoft Dynamics 365-SDK-skabeloner til Visual Studio, der indeholder den brugerdefinerede projektskabelonen for det tilknyttede kontrolelement. Du kan få den på en af følgende måder:
- Download CRM SDK-skabelonen fra Visual Studio Gallery. Dobbeltklik på CRMSDKTemplates.vsix filen for at installere skabelonen i Visual Studio.
- Download og installer CRM SDK. Skabelonfilen CRMSDKTemplates.vsix findes i mappen SDK\Templates. Dobbeltklik på skabelonfilen for at installere den i Visual Studio.

Oprette et brugerdefineret tilknyttet kontrolelement

Start Visual Studio, og opret et nyt projekt.
I dialogboksen Nyt projekt:
1. Fra listen over installerede skabeloner skal du udvide Visual C# og vælge Dynamics 365 SDK-skabeloner > Unified Service Desk > USD-brugerdefineret tilknyttet kontrolelement.
2. Sørg for, at .NET Framework 4.5.2 er valgt.
3. Angiv navnet på og placeringen af projektet, og klik på OK for at oprette et nyt projekt.
I Solution Explorer skal du dobbeltklikke på filen USDControl.xaml for at få vist XAML designer.
Tilføj følgende kontrolelementer fra designeren i Toolbox:
- Etiket: I ruden Egenskaber skal du indstille navnet på kontrolelementet til "myLabel".
- Knap: I ruden Egenskaber skal du indstille navnet på kontrolelementet til "myButton" og indholdet til "Start fejlfindingsprogram".
Dette er, hvordan kontrolelementerne ser ud i XAML-designeren.

Dobbeltklik på knappen for at tilføje koden bag ved XAML. Derved kommer du til definitionen for klikhændelsen af myButton i filen USDControl.xaml.cs. Tilføj følgende kommando.

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));
}

Definer en brugerdefineret handling for det tilknyttede kontrolelement. Gå til filen USDControl.xaml.cs til tilsidesættelsesdefinitionen af DoAction.
```
protected override void DoAction(Microsoft.Uii.Csr.RequestActionEventArgs args)
```

Tilføj følgende kode i tilsidesættelsesdefinitionen af DoAction for at definere en brugerdefineret handling, som kaldes MyCustomAction, som accepterer en parameter ved navn username.

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

Skabelonen indeholder det meste af koden som kommentar i tilsidesættelsesdefinitionen af DoAction, så du hurtigt kan komme i gang med udviklingen. Du skal fjerne kommentarmærkerne i den påkrævede kodelinje og erstatte pladsholderværdierne med dine værdier.

Gem projektet, og byg det (Opbygning > Opbyg løsning) for at kontrollere, om det blev bygget korrekt.

Teste dit brugerdefinerede tilknyttede kontrolelement

Når projektet er blevet bygget korrekt, skal du teste det brugerdefinerede tilknyttede kontrolelement. Testen består af to dele: definition af det brugerdefinerede tilknyttede kontrolelement på serveren og derefter oprettelse af forbindelse til Unified Service Desk på serveren ved hjælp af klientprogrammet.

Definere det brugerdefinerede tilknyttede kontrolelement og handlingen på Dynamics 365-serveren

Log på Microsoft Dynamics 365.
Vælg Microsoft Dynamics 365 på navigationslinjen, og vælg Indstillinger.
Vælg Indstillinger > Unified Service Desk > Tilknyttede kontrolelementer.

Vælg NY, og angiv derefter værdierne på skærmen Nyt tilknyttet kontrolelement som vist her.

Nyt brugerdefineret kontrolelement

Bemærkning
Assembly-URI er navnet på din assembly, og Assemblytype er navnet på din assembly (dll) efterfulgt af et punktum (.) og derefter navnet på klassen i dit Visual Studio-projekt. I dette eksempel er navnet på assemblyen MyCustomControl, og navnet på klassen er USDControl, som er standardklassenavnet, når du opretter et brugerdefineret tilknyttet kontrolelement.

Vælg Gem for at oprette det tilknyttede kontrolelement.
Opret handlingen for det tilknyttede kontrolelement, som du definerede i Visual Studio. På navigationslinjen skal du vælge pil ned ud for navnet på dit tilknyttede kontrolelement og vælge UII-handlinger.
Vælg Tilføj ny UII-handling.
Skriv MyCustomAction i feltet Navn og vælg Gem.

Du har nu konfigureret dit brugerdefinerede tilknyttede kontrolelement og din brugerdefinerede handling på Dynamics 365-serveren.

Køre Unified Service Desk-klienten for at arbejde med brugerdefineret tilknyttet kontrolelement

Kopiér assemblyen, der indeholder definitionen af dit brugerdefinerede tilknyttede kontrolelement fra outputmappen Visual Studio-projekt (<ProjectFolder>\bin\debug) til Unified Service Desk-programmappen. I dette tilfælde skal du kopiere filen MyCustomControl.dll til mappen c:\Program Files\Microsoft Dynamics CRM USD\USD.
Kør Unified Service Desk-klienten for at oprette forbindelse til Dynamics 365-serveren.
Ved vellykket logon kan du se det brugerdefinerede tilknyttede kontrolelement, Mit brugerdefinerede tilknyttede kontrolelement, på skrivebordet.
Klik på Start fejlfindingsprogram for at starte det tilknyttede kontrolelement for Fejlfinding.
Du tester den brugerdefinerede handling ved at vælge fanen Fejlfinding og derefter klikke på pil ned over fanen Handlingsopkald for at få vist det område, hvor du kan teste handlingskald og UII-handlinger.
Vælg fanen Direkte handling.
Fra listen Tilknyttet kontrolelement skal du vælge Mit brugerdefinerede tilknyttede kontrolelement, og fra listen Handling skal du vælge MyCustomAction.
I henhold til definitionen af den brugerdefinerede handling forventer dette handlingsopkald en parameter ved navn username. Lad os tilføje følgende værdi i feltet Data: username = Tracie Hamilton.
Klik på ikonet Kør direkte handling (), og klik derefter på fanen Mit brugerdefinerede tilknyttede kontrolelement. Det angivne brugernavn vises i etiketfeltet.