Compartilhar via


Gerenciador de desktop CTI (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

Use o tipo de controle hospedado do Gerenciador de área de trabalho de CTI para conectar um adaptador de Computer Telephone Integration (CTI) ao Unified Service Desk para tratar a exibição da tela, o roteamento de chamadas, o controle de softphone e outras funcionalidades de CTI.

Neste tópico

Criar um controle hospedado do Gerenciador de área de trabalho de CTI

Ações de UII predefinidas

Eventos predefinidos

Criar um controle hospedado do Gerenciador de área de trabalho de CTI

Para obter informações sobre a criação de um Gerente de Desktop de CTI e configurar o controle hospedado correspondente, consulte Criar um CTI Desktop Manager.

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. Diferentemente da ação CloseActive, se esta guia (controle hospedado) estiver exibindo mais de uma página, ela fechará todas as páginas exibidas na guia do seu aplicativo agente.

CloseAndPrompt

Esta ação fecha o controle hospedado, mas solicita que o usuário salve ou abandone as alterações antes de fechar.

DisableToolbarButton

Esta ação desabilita o botão da barra de ferramentas especificado na barra de ferramentas do aplicativo agente.

Parâmetro

Descrição

Nome do botão da barra de ferramentas para desabilitar.

EnableToolbarButton

Esta ação habilita o botão da barra de ferramentas especificado na barra de ferramentas do aplicativo agente.

Parâmetro

Descrição

Nome do botão da barra de ferramentas para habilitar.

Localizar

Navegue até a exibição de lista de localização rápida da entidade especificada.

Parâmetro

Descrição

O parâmetro de dados deve especificar o nome lógico da entidade da exibição de lista de localização rápida para exibição. Há alguns valores para casos especiais:

  • Use ocorrência ou incidente para exibir a exibição de lista de localização rápida para ocorrências.

  • Use advfind para exibir a exibição de localização avançada.

  • Use atividades ou atividade para exibir a exibição de lista de localização rápida para atividades.

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.

Voltar

Esta ação é equivalente a clicar no botão para voltar na instância do navegador.

Avançar

Esta ação é equivalente a clicar no botão para avançar na instância do navegador.

IrParaPáginaInicial

Essa ação vai para a URL inicial especificada para esta instância do navegador.

ÁreaDeCarregamento

Esta ação carrega uma área específica do Dynamics 365. Isto é equivalente a selecionar outra área no painel de navegação (como Vendas, Serviço e Marketing.) O único parâmetro é o nome da área a ser clicada. Por exemplo: areaService.

Parâmetro

Descrição

quadro

Nome do quadro que será afetado. Se nenhum nome for especificado, será selecionado automaticamente o primeiro quadro localizado na página.

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.

Esta ação é usada para navegar para uma URL do Dynamics 365.

Parâmetro

Descrição

URL

URL para usar para navegar. Este é um parâmetro obrigatório.

Noscan

Se esse parâmetro for fornecido e Verdadeiro, os parâmetros de dados não serão capturados da página.

HideCommandBar

Se esse parâmetro for fornecido e for True, o quadro interno será exibido sem carregar a barra de comandos do Dynamics 365.

HideNavigationBar

Se esse parâmetro for fornecido e for True, o formulário será exibido sem carregar a barra de navegação do Dynamics 365.

Quadro

Quando as páginas tiverem quadros, esse parâmetro especifica o nome do quadro para navegar, em vez de navegar na janela principal.

postdata

Dados que são enviados para o servidor como parte de uma transação HTTPPOST. Uma transação POST normalmente é usada para enviar dados coletados por uma página HTML. No Unified Service Desk, esses dados podem ser recebidos de qualquer evento disparado usando "http://event/?". Exemplo: [[postdata]+]

Como alternativa, os dados podem ser transmitidos como uma cadeia de caracteres codificada pelo com seu tipo de cabeçalho no formato pretendido.

header

Um valor de cadeia de caracteres que contém outros cabeçalhos HTTP a serem enviados ao servidor. Quando o parâmetro postdata é usado na ação Navigate, você também deve especificar um valor apropriado para o parâmetro header. Exemplo: Content-Type:application/x-www-form-urlencoded

Se um evento Unified Service DeskPOST aciona a ação Navigate, o valor padrão deste parâmetro deve ser header=[[header]+]

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.

ReRoute

Esta ação seleciona a URL exibida no momento e envia-a como um pop-up pelas regras de navegação da janela do controle hospedado em andamento.

RunScript

Esta ação injeta o Javascript no quadro principal do aplicativo. Você deve evitar usar chamadas SDK do cliente Dynamics 365 com essa ação; em vez disso, use a ação RunXrmCommand.

Parâmetro

Descrição

O parâmetro de dados é o Javascript que será injetado no formulário.

Dica

Os parâmetros de substituição podem ser usados no script e serão substituídos antes dele ser executado.

RunXrmCommand

Esta ação é usada para injetar Javascript do SDK Dynamics 365 no formulário Dynamics 365.

Parâmetro

Descrição

O parâmetro de dados é o Javascript que será injetado no formulário.

Dica

Os parâmetros de substituição podem ser usados no script e serão substituídos antes dele ser executado.

Salvar

Esta ação salva a página atual do Dynamics 365.

SalvarTodos

Esta ação salva todos os formulários no controle hospedado, permitindo que várias páginas sejam exibidas (Permitir várias páginas = Sim). Se o controle hospedado permitir que uma única página seja exibida (Permitir várias páginas = Não), isso será equivalente à ação Salvar.

SaveAndClose

Esta ação salva os dados sujos no formato Dynamics 365 e fecha o controle hospedado.

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.

ToggleNavigation

Esta ação recolhe ou expande o painel de navegação no painel esquerdo da janela Dynamics 365. A navegação deve conter um painel de navegação para que essa ação funcione.

ToggleRibbon

Essa ação recolhe ou expande a faixa de opções. Se você oculta a faixa de opções na ação Navegar, ela não será exibida e essa ação não funcionará. Esta ação só funcionará quando a faixa de opções for carregada inicialmente.

WaitForComplete

Esta ação pode ser usada para bloquear o processamento até que a URL termine de carregar.

Dica

Algumas páginas da web, principalmente páginas Dynamics 365, têm múltiplos quadros. Esta ação espera a finalização somente do quadro principal.

Parâmetro

Descrição

Milissegundos

Parâmetro opcional para indicar quanto tempo, em milissegundos, para aguardar o tempo limite.

Eventos predefinidos

Esses são os eventos predefinidos para esse tipo de controle hospedado.

BrowserDocumentComplete

Ocorre quando a página terminou de carregar.

Parâmetro

Descrição

url

URL da página que terminou de carregar.

FrameLoadComplete

Ocorre sempre que um quadro terminou de carregar. Este evento ocorre várias vezes a cada carregamento de página quando um iFrame ou um quadro estão sendo usados na página. Este evento corresponde aos eventos BrowserDocumentComplete no código.

Parâmetro

Descrição

quadro

O nome do quadro que terminou de carregar.

url

URL do quadro 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

Integrar com sistemas de CTI usando adaptadores de CTI

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais