Procedura dettagliata: Creare un controllo ospitato personalizzato per Unified Service Desk

Data di pubblicazione: novembre 2016

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

In questo argomento verrà illustrato come creare un controllo ospitato personalizzato denominato My Custom Control con un'azione personalizzata. Il controllo ospitato personalizzato contiene due controlli Windows Presentation Foundation (WPF): un pulsante che chiama il controllo ospitato del Debugger e un'etichetta di testo che visualizza il nome utente quando viene chiamata un'azione personalizzata, MyCustomAction.

In questa sezione

Prerequisiti

Creare un controllo ospitato personalizzato

Testare il controllo ospitato personalizzato

Prerequisiti

Microsoft .NET Framework 4.5.2
Applicazione client Unified Service Desk. È necessaria per il test del controllo ospitato.
Microsoft Visual Studio 2012, Visual Studio 2013 o Visual Studio 2015
Gestione pacchetti NuGet per Visual Studio 2012, Visual Studio 2013 o Visual Studio 2015
Modelli Microsoft Dynamics 365 SDK per Visual Studio che contengono il modello del progetto di controllo ospitato personalizzato. È possibile ottenere il modello, in uno dei modi seguenti:
- Scaricare il modello CRM SDK dalla raccolta di Visual Studio. Fare doppio clic sul file CRMSDKTemplates.vsix per installare il modello in Visual Studio.
- Scaricare e installare il CRM SDK. Il file dei modelli CRMSDKTemplates.vsix è disponibile nella cartella SDK\Templates. Fare doppio clic sul file del modello per installarlo in Visual Studio.

Creare un controllo ospitato personalizzato

Avviare Visual Studio e creare un nuovo progetto.
Nella finestra di dialogo Nuovo progetto:
1. Nell'elenco dei modelli installati, espandi Visual C# e seleziona Modelli Dynamics 365 SDK > Unified Service Desk > Controllo ospitato personalizzato USD.
2. Verificare che .NET Framework 4.5.2 sia selezionato.
3. Specificare il nome e il percorso del progetto e fare clic su OK per creare un nuovo progetto.
In Esplora soluzioni, fare doppio clic sul file USDControl.xaml per aprire la finestra di progettazione XAML.
Nella finestra di progettazione, aggiungere i controlli seguenti dalla casella degli strumenti:
- Etichetta: impostare il nome del controllo su "myLabel" nel riquadro Proprietà.
- Pulsante: impostare il nome del controllo su "myButton" e il contenuto su "Avvia debugger" nel riquadro Proprietà.
Nella finestra di progettazione XAML i controlli avranno l'aspetto seguente.

Fare doppio clic sul pulsante per aggiungere codice nascosto da XAML. Verrà visualizzata la definizione dell'evento clic di myButton nel file USDControl.xaml.cs. Aggiungere il seguente comando.

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

Definire un'azione personalizzata per il controllo ospitato. Nel file USDControl.xaml.cs passare alla definizione di override di DoAction.
```
protected override void DoAction(Microsoft.Uii.Csr.RequestActionEventArgs args)
```
Aggiungere il codice seguente nella definizione di override di DoAction per definire un'azione personalizzata denominata MyCustomAction che accetta un parametro denominato 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; });
    }
}
```
Suggerimento

Il modello contiene la maggior parte di codice sotto forma di commento nella definizione di override di DoAction per iniziare da subito con l'attività di sviluppo. Sarà necessario rimuovere i commenti dalla riga di codice necessaria e sostituire i valori segnaposto con i valori specifici.
Salvare il progetto e compilarlo (CompilaCompila soluzione) per verificare se viene compilato correttamente.

Testare il controllo ospitato personalizzato

Dopo aver compilato correttamente il progetto, testare il controllo ospitato personalizzato. Il test è costituito da due parti: la definizione del controllo ospitato personalizzato nel server e la connessione a Unified Service Desk nel server utilizzando l'applicazione client.

Definire il controllo ospitato personalizzato e l'azione nel server Dynamics 365

Accedere a Microsoft Dynamics 365.
Sulla barra di spostamento scegliere Microsoft Dynamics 365 e selezionare Impostazioni.
Scegliere Impostazioni > Unified Service Desk > Controlli ospitati.
Scegliere NUOVO e quindi specificare i valori nella schermata Nuovo controllo ospitato come illustrato di seguito.

Nota

URI assembly è il nome dell'assembly e Tipo assembly è il nome dell'assembly (dll) seguito da un punto (.) e dal nome della classe del progetto Visual Studio. In questo esempio il nome dell'assembly è MyCustomControl e il nome della classe è USDControl, ovvero il nome della classe predefinita quando si crea un controllo ospitato personalizzato.
Scegliere Salva per creare il controllo ospitato.
Creare l'azione per il controllo ospitato definito in Visual Studio. Sulla barra di spostamento scegliere la freccia in giù accanto al nome del controllo ospitato e selezionare Azioni UII.
Scegliere Aggiungi nuova azione UII.
Digitare MyCustomAction nel campo Nome e scegliere Salva.

È appena terminata la configurazione del controllo ospitato personalizzato e dell'azione personalizzata nel server Dynamics 365.

Eseguire il client di Unified Service Desk per utilizzare il controllo ospitato personalizzato

Copiare l'assembly che contiene la definizione del controllo ospitato personalizzato dalla cartella di output del progetto di Visual Studio studio (<ProjectFolder>\bin\debug) nella directory dell'applicazione Unified Service Desk. In questo caso, si copia il file MyCustomControl.dll nella directory c:\Program Files\Microsoft Dynamics CRM USD\USD.
Eseguire il client Unified Service Desk per connettersi al server Dynamics 365.
All'accesso, il controllo ospitato personalizzato Controllo ospitato personalizzato sarà visibile sul desktop.
Fare clic su Avvia debugger per avviare il controllo ospitato del debugger.
Per testare l'azione personalizzata, scegliere la scheda Debugger, quindi fare clic sulla freccia giù sopra la scheda Inviti all'azione per visualizzare l'area in cui è possibile testare le azioni UII e gli inviti all'azione.
Scegliere la scheda Azione diretta.
Nell'elenco Controllo ospitato selezionare Controllo ospitato personalizzato e nell'elenco Azione selezionare MyCustomAction.
Secondo la definizione dell'azione personalizzata, questo invito all'azione prevede un parametro username, pertanto aggiungere il seguente valore nel campo Dati: username=Laura Giussani.
Fare clic sull'icona Esegui azione diretta (), quindi fare clic sulla scheda Controllo ospitato personalizzato. Il nome utente specificato verrà visualizzato nel campo etichetta.