Compartilhar via


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

 

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:

Crie um controle hospedado personalizado

  1. Inicie o Visual Studio e crie um novo projeto.

  2. 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.

    Modelo para criar um controle hospedado personalizado

  3. No Solution Explorer, clique duas vezes no arquivo USDControl.xaml para ativar o designer de XAML.

  4. 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.

    Designer de XAML com controles personalizados

  5. 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));
    }
    
  6. 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)
    
  7. 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.

  8. 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

  1. Entre no Microsoft Dynamics 365.

  2. Na barra de navegação, selecione Microsoft Dynamics 365 e Configurações.

  3. Selecione Configurações > Unified Service Desk > Controles Hospedados.

  4. Selecione NOVO e, em seguida, especifique os valores na tela Novo controle hospedado, conforme mostrado a seguir.

    Novo controle hospedado personalizado

    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.

  5. Selecione Salvar para criar o controle hospedado.

  6. 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.

  7. Escolha Adicionar Nova Ação de UII.

  8. 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

  1. 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.

  2. Execute o cliente do Unified Service Desk para conectar-se a seu servidor do Dynamics 365.

  3. Após se conectar com sucesso, você verá o controle hospedado personalizado, Meu Controle Hospedado Personalizado, na área de trabalho.

    Personalizar controle hospedado

  4. Clique em Iniciar Depurador para iniciar o controle hospedado Depurador.

  5. 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.

    Expanded testing area in debugger

  6. Escolha a guia Ação Direta.

  7. Na lista Controle Hospedado, selecione Meu Controle Hospedado Personalizado e na lista Ação, selecione MyCustomAction.

  8. 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.

    Teste o controle hospedado personalizado

  9. Clique no ícone Executar Ação Direta (Botão de chamada de ação para para executar depurador de USD) e clique na guia Meu Controle Hospedado Personalizado. O nome de usuário especificado é exibido no campo do rótulo.

    A guia Meu Controle Hospedado Personalizado mostra o nome do usuário

Confira Também

Controle hospedado do USD (controle hospedado)
Tipos de controle hospedado e referência de ação/evento
Passo a passo da configuração do Unified Service Desk
Usar controle hospedado personalizado no Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais