Passo a passo: criar um controle hospedado personalizado para o Unified Service Desk

Artigo
04/18/2017

Publicado: novembro de 2016

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Neste tópico, vamos aprender a criar um controle hospedado personalizado chamado de My Custom Control com uma ação personalizada. O controle hospedado personalizado tem dois controles Windows Presentation Foundation (WPF): um botão que chama o controle hospedado do Debugger e um rótulo de texto que exibe o nome do usuário quando uma ação personalizada, MyCustomAction, é chamada.

Nesta seção

Pré-requisitos

Crie um controle hospedado personalizado

Teste o controle hospedado personalizado

Pré-requisitos

Microsoft .NET Framework 4.5.2
Aplicativo cliente do Unified Service Desk; o aplicativo cliente é necessário para testar o controle hospedado.
Microsoft Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015
Gerenciador de Pacotes de NuGet para Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015
Modelos de SDK do Microsoft Dynamics 365 para Visual Studio que contêm o modelo de projeto de controle hospedado personalizado. É possível obter um com as seguintes opções:
- Baixe o modelo SDK de CRM da galeria do Visual Studio. Clique duas vezes no arquivo CRMSDKTemplates.vsix para instalar o modelo no Visual Studio.
- Baixe e instale o SDK do CRM. O arquivo de modelos CRMSDKTemplates.vsix está localizado na pasta SDK\Templates. Clique duas vezes no arquivo do modelo para instalá-lo no Visual Studio.

Crie um controle hospedado personalizado

Inicie o Visual Studio e crie um novo projeto.
Na caixa de diálogo Novo projeto:
1. Na lista de modelos instalados, expanda Visual C# e selecione Modelos de SDK do Dynamics 365 > Unified Service Desk > Controle Hospedado USD Personalizado.
2. Verifique se .NET Framework 4.5.2 está selecionado.
3. Especifique o nome e o local do projeto, e clique em OK para criar um novo projeto.
No Solution Explorer, clique duas vezes no arquivo USDControl.xaml para ativar o designer de XAML.
No designer, adicione os seguintes controles da Caixa de Ferramentas:
- Rótulo: No painel Propriedades, defina o nome do controle para “myLabel.”
- Botão: No painel Propriedades, defina o nome do controle para “myButton,” e o conteúdo para “Iniciar depurador.”
Veja como os controle aparecem no designer do XAML.

Clique duas vezes no botão para adicionar o código behind do XAML. Você será direcionado para a definição do evento de clique do myButton no arquivo USDControl.xaml.cs. Adicione o seguinte 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));
}

Defina uma ação personalizada para o controle hospedado. No arquivo USDControl.xaml.cs, procure a definição de substituição de DoAction.
```
protected override void DoAction(Microsoft.Uii.Csr.RequestActionEventArgs args)
```

Adicione o seguinte código na definição de substituição de DoAction para definir uma ação personalizada chamada MyCustomAction, que aceita um parâmetro chamado 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; });
    }
}

Dica

O modelo fornece grande parte do código como comentário na definição de substituição de DoAction para ajudá-lo a iniciar rapidamente o desenvolvimento. Você precisa remover o comentário da linha de código necessária e substituir os valores de espaço pelos seus valores.

Salve o projeto e compile-o (Compilação > Solução de compilação) para verificar se ele foi compilado com sucesso.

Teste o controle hospedado personalizado

Depois que o projeto for compilado com sucesso, teste o controle hospedado personalizado. O teste consiste em duas partes: definir o controle hospedado personalizado no servidor e conectá-lo ao Unified Service Desk no servidor usando o aplicativo cliente.

Defina a ação e o controle hospedado personalizado no servidor do Dynamics 365

Entre no Microsoft Dynamics 365.
Na barra de navegação, selecione Microsoft Dynamics 365 e Configurações.
Selecione Configurações > Unified Service Desk > Controles Hospedados.
Selecione NOVO e, em seguida, especifique os valores na tela Novo controle hospedado, conforme mostrado a seguir.

Dica

URI assembly é o nome de seu assembly e o Tipo assembly é o nome de seu assembly (dll) seguido por um ponto (.) e então o nome de classe em seu projeto Visual Studio. Neste exemplo, o nome do assembly é MyCustomControl e o nome da classe é USDControl, que é o nome da classe padrão na criação de um controle hospedado personalizado.
Selecione Salvar para criar o controle hospedado.
Crie a ação para o controle hospedado definido no Visual Studio. Na barra de navegação, escolha a seta para baixo ao lado do nome do controle hospedado e selecione Ações do UII.
Escolha Adicionar Nova Ação de UII.
Digite MyCustomAction no campo Nome e escolha Salvar.

Você acaba de configurar o controle hospedado personalizado e a ação personalizada no servidor do Dynamics 365.

Execute o cliente do Unified Service Desk para que funcione com o controle hospedado personalizado

Copie o assembly que contém a definição do controle hospedado personalizado da pasta de saída do projeto Visual Studio (<ProjectFolder>\bin\debug) para o diretório do aplicativo Unified Service Desk. Neste caso, você copiará o arquivo MyCustomControl.dll para o diretório c:\Program Files\Microsoft Dynamics CRM USD\USD.
Execute o cliente do Unified Service Desk para conectar-se a seu servidor do Dynamics 365.
Após se conectar com sucesso, você verá o controle hospedado personalizado, Meu Controle Hospedado Personalizado, na área de trabalho.
Clique em Iniciar Depurador para iniciar o controle hospedado Depurador.
Para testar a ação personalizada, escolha a guia Depurador e, em seguida, clique na seta para baixo acima da guia Chamadas de Ação para exibir a área na qual você pode testar as chamadas de ação e as ações de UII.
Escolha a guia Ação Direta.
Na lista Controle Hospedado, selecione Meu Controle Hospedado Personalizado e na lista Ação, selecione MyCustomAction.
De acordo com a definição da ação personalizada, esta chamada de ação espera um parâmetro chamado username, então adicione o seguinte valor no campo Dados: username=Tracie Hamilton.
Clique no ícone Executar Ação Direta () e clique na guia Meu Controle Hospedado Personalizado. O nome de usuário especificado é exibido no campo do rótulo.