Diálogo do CRM (controle hospedado)

 

Publicado: novembro de 2016

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

Usar o tipo de controle hospedado Diálogo do Dynamics 365 para trabalhar com os diálogos do Dynamics 365. Você pode chamar a ação StartDialog no controle hospedado Diálogo do Dynamics 365 para iniciar um diálogo do Dynamics 365 no Unified Service Desk.

Neste tópico

Criar um controle hospedado Diálogo do Dynamics 365

Ações de UII predefinidas

Eventos predefinidos

Criar um controle hospedado Diálogo do Dynamics 365

Ao criar um novo controle hospedado, os campos na tela Novo controle hospedado variam de acordo com o tipo de controle hospedado que você deseja criar. Esta seção fornece informações sobre os campos específicos que são exclusivos para o tipo de controle hospedado Diálogo do Dynamics 365. Para obter informações detalhadas sobre como criar um controle hospedado, consulte Criar ou editar um controle hospedado.

Na tela Novo controle de hospedado:

• Na área do Unified Service Desk, selecione Diálogo do Dynamics 365 na lista suspensa Tipo de Componente do USD.

• A lista suspensa Tipo de Hospedagem especifica como você deseja que esse controle seja hospedado. Você pode escolher entre WPF Interno (padrão) ou Processo do IE. Para obter mais informações, consulte Selecionar um método de hospedagem para seus controles.

• Na área Propriedades Comuns, selecione a caixa de seleção O Aplicativo é Global para definir o controle hospedado como global. Os controles hospedados Globais podem ser exibidos fora de uma sessão do cliente. Os controles como os agentes do painel, mural ou pesquisa são usos comuns para controles hospedados globais. Os controles hospedados globais não têm um estado específico de sessão, então, quando as sessões são alteradas, esses controles hospedados globais permanecem os mesmos. Se a caixa de seleção não estiver selecionada, o controle hospedado ficará com base em sessão. Os controles com base em sessão existem no contexto da sessão do cliente. As seguintes ações predefinidas de UII são disponíveis para o tipo de controle hospedado do Gerenciador global:

• O campo Grupo de exibição exibe o painel em que esse controle hospedado será exibido.MainPanel é o mais comum para esse tipo de controle hospedado. Para obter informações sobre os diversos painéis disponíveis no Unified Service Desk, consulte Painéis no Unified Service Desk. Para obter mais informações sobre outros campos Gerais, consulte Criar ou editar um controle hospedado.

Ações de UII predefinidas

Essas são as ações predefinidas para esse tipo de controle hospedado.

Fechar

Essa ação é usada fechar o controle hospedado.

FireEvent

Aciona um evento definido pelo usuário neste controle de hospedado.

Parâmetro	Descrição
nome	Nome do evento definido pelo usuário.

Todos os pares subsequentes de nome=valor se tornam os parâmetros do evento. Para obter mais informações sobre como criar um evento definido pelo usuário, consulte Criar um evento definido pelo usuário.

MoveToPanel

Esta ação é usada para mover controles hospedados entre os painéis no tempo de execução.

Parâmetro	Descrição
aplicativo	Nome do controle hospedado a ser movido.
painel	Painel de destino para o controle hospedado.

New_CRM_Page

Cria uma página para criar um novo registro Dynamics 365 da entidade especificada e executa a página como um pop-up do controle hospedado especificado. As regras de navegação da janela são avaliadas para determinar o local onde será apresentada a página para criar o registro da entidade.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade para criar uma nova instância.

Dica

O restante dos parâmetros deve consistir em nome=pares de valores. Estes são os valores adicionais preenchidos previamente no formulário para criação de um novo registro da entidade especificada. Para obter mais informações sobre como usar esta ação, consulte a etapa 4 em Passo a passo 7: Configurar o script do agente no aplicativo agente.

Open_CRM_Page

Abre uma instância existente da entidade especificada e identificada pela ID e executa a página como um pop-up do controle hospedado especificado. As regras de navegação da janela são avaliadas para determinar o local onde o pop-up deve ser exibido.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade a ser aberta.
id	A ID do registro da entidade a ser aberta.

Pop-up

Faz surgir um pop-up da URL de um controle hospedado e executa as regras de navegação da janela diante dele para encaminhar o pop-up ao local adequado.

Parâmetro	Descrição
url	Encaminha um pop-up desse controle hospedado usando a URL como se fosse um pop-up solicitado do controle exibido.
quadro	O quadro do qual o pop-up foi originado.

RealignWindow

Exibe o controle hospedado no local especificado de um monitor. Você pode exibir o controle hospedado em até dois monitores. Essa ação é aplicável em instâncias de controle hospedado que foram configuradas para serem posicionadas em tipo de painel USDFloatingPanel ou USDFloatingToolPanel.

Parâmetro	Descrição
screen	Especifica a tela na qual o controle hospedado será exibido. Os valores válidos são 1 ou 2. Caso esse parâmetro não seja especificado, o valor 1 é considerado o padrão.
left	Especifica a posição, sob a forma de percentual, à esquerda da tela, no monitor de destino onde o controle hospedado deve ser exibido. Os valores válidos são 0 a 100. Caso esse parâmetro não seja especificado, o valor 0 é considerado o padrão.
top	Especifica a posição, sob a forma de percentual, acima da tela, no monitor de destino onde o controle hospedado deve ser exibido. Os valores válidos são 0 a 100. Caso esse parâmetro não seja especificado, o valor 0 é considerado o padrão.
width	Especifica a largura, sob a forma de percentual, do controle hospedado no monitor de destino. Os valores válidos são 1 a 100. Caso esse parâmetro não seja especificado, o valor 100 é considerado o padrão.
height	Especifica a altura, sob a forma de percentual, do controle hospedado no monitor de destino. Os valores válidos são 1 a 100. Caso esse parâmetro não seja especificado, o valor 100 é considerado o padrão.

SetSize

Esta ação define explicitamente a largura e a altura do controle hospedado. Isso é especialmente útil ao utilizar a opção "automática" nos layouts do painel.

Parâmetro	Descrição
width	A largura do controle hospedado.
height	A altura do controle hospedado.

StartDialog

Essa ação usa vários parâmetros, mas para diálogos que não estão relacionados a um registro específico, você pode especificar apenas o parâmetro Nome.

Parâmetro	Descrição
Nome	O nome do diálogo, conforme visto na seção Configurações > Processo do Dynamics 365.
DialogId	Também é possível especificar o diálogo pela sua ID. Se você especificar o parâmetro DialogId, ele será usado pela ação, e não pelo parâmetro Nome.
Entidade	Esse é o tipo de entidade para o qual o diálogo deve ser executado. É necessário se você usar o parâmetro DialogId. Não é necessário se o parâmetro Nome for usado.
ID	É a ID da entidade à qual a sessão de Diálogo se aplica. Se esse parâmetro não for especificado, o diálogo será executado para a primeira entrada do tipo apropriado no sistema.

Quando o diálogo for finalizado, ele solicitará que o usuário feche a janela. Se o usuário concordar, a guia no Unified Service Desk também será fechada, o que é estrutural.

Eventos predefinidos

Os seguintes eventos predefinidos estão associados a esse controle hospedado.

BrowserDocumentComplete

Ocorre quando a página terminou de carregar. Em um tipo de controle hospedado Página do Dynamics 365, esse evento ocorre depois que os dados foram salvos na lista de parâmetro de substituição. Esse evento ocorre somente uma vez, mesmo que diversos quadros disparem seus eventos NavegadorDocumentoCompleto individualmente.

Parâmetro	Descrição
url	URL da página que terminou de carregar.

PopupRouted

Ocorre depois que um pop-up foi encaminhado pelo sistema.

Parâmetro	Descrição
url	A URL do pop-up que foi direcionado.

Confira Também

Página do CRM (controle hospedado)
Ações da UII
Eventos
Passo a passo da configuração do Unified Service Desk
Tipos de controle hospedado e referência de ação/evento
Guia de administração do Unified Service Desk for Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais