Compartilhar via

Página do hub de serviços interativos (controle hospedado)

  • Artigo

 

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 Página do Hub de Serviços Interativos para a hospedar formulários de hubs de serviços interativos no Unified Service Desk para integrar os recursos dos dois aplicativos. O Hub de Serviços Interativos fornece uma interface intuitiva e exibe todas as informações vitais relacionadas a clientes em um local, o que permite que os agentes de atendimento ao cliente se concentrem nas coisas que precisam de atenção.

Dica

Esse recurso foi apresentado no Unified Service Desk 2.1.

Quando um formulário de hub de serviços interativos é carregado no controle hospedado da Página Hub de Serviços Interativos, ele examinará automaticamente a página para encontrar dados e populará automaticamente os parâmetros de substituição no Unified Service Desk. O tipo de controle hospedado da Página Hub de Serviços Interativos expõe várias ações e eventos de UII predefinidos que são exclusivos à manipulação das páginas de hub de serviços interativos, incluindo as ações de manipulação de lista e para uma ação de localização usada para exibir uma pesquisa rápida ou uma página de pesquisa avançada.

O Unified Service Desk fornece um pacote de exemplo, Hub de Serviços Interativos, que demonstra como você pode integrar facilmente as páginas do hub de serviços interativos no Unified Service Desk. Para saber mais: TechNet: Aplicativos de exemplo do Unified Service Desk 2.1.

Dica

É possível converter seu tipo Página Dynamics 365 existente dos controles hospedados para o tipo Página do hub do serviço interativo para exibir formulários da experiência interativa usados para o aplicativo Hub do serviço interativo em vez dos formulários Dynamics 365. No entanto, há algumas considerações ao fazer isso. Para obter mais informações, consulte Blog: Suporte para formulários centrados na interação no Unified Service Desk

Neste tópico

Criar um controle hospedado de Hub de Serviços Interativos

Ações de UII predefinidas

Eventos predefinidos

Criar um controle hospedado de Hub de Serviços Interativos

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 Página Hub de Serviços Interativos. Para obter informações detalhadas sobre como criar um controle hospedado, consulte Criar ou editar um controle hospedado.

Controle hospedado da página do hub do serviço interativo

Na tela Novo controle de hospedado:

  • Na área Unified Service Desk, selecione Página Hub de Serviços Interativos na lista suspensa Tipo de Componente do USD.

  • Na lista suspensa Permitir Várias Páginas, selecione Não (padrão) para substituir a página de hub de serviços interativos que está exibida no momento e atualizar o histórico do navegador quando o Unified Service Desk receber uma chamada de ação de navegação ou uma página for roteada para a guia. Selecione Sim para criar automaticamente uma lista suspensa quando uma segunda URL for chamada ou uma regra de navegação da janela direcionar uma página para a guia. Isso permite que o usuário pesquise rapidamente entre as páginas de hub de serviços interativos que foram anexadas a esse controle. Além disso, quando você selecionar Sim, um campo adicional, Número Máximo de Navegadores, se tornará disponível no qual você pode especificar o número máximo de páginas a serem exibidas na lista suspensa.

  • Processo do IE é o Tipo de Hospedagem padrão para esse tipo de controle hospedado, e você não pode selecionar nenhum outro tipo de hospedagem. Para saber mais sobre os métodos de hospedagem compatíveis no Unified Service Desk, confira Selecionar um método de hospedagem para seus controles.

  • Marque a caixa de seleçã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, tipos de painéis e layouts de painéis no Unified Service Desk.

  • Selecione Sim ou Não na lista Aplicativo é dinâmico para especificar se este controle hospedado é dinâmico. Os controles hospedados dinâmicos permitem que um agente inicie ou feche um controle hospedado sob demanda, usando a UI ou de forma programática por meio de código. Mais Informações: Controles hospedados do Unified Service Desk do Dynamics

    Se você selecionar Sim, a caixa de seleção Usuário Pode Fechar fica disponível. Marque essa caixa de seleção para permitir que os usuários fechem o controle hospedado.

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.

Dica

O tipo de controle hospedado Página Hub de Serviços Interativos é compatível com todas as ações de UII suportadas pelo tipo de controle hospedado Página do Dynamics 365. No entanto, as ações de UII não estão disponíveis quando você cria e salva pela primeira vez uma instância de controle hospedado do tipo Página Hub de Serviços Interativos. Qualquer atualização subsequente na instância do controle hospedado adiciona as ações de UII ausentes.

AssociatedView

Essa ação carrega uma exibição associada específica do hub de serviços interativos. Estas exibições são geralmente acessadas clicando na seta para baixo ao lado do nome de registro da entidade, na barra de navegação, e selecionando as entidades associadas.

Parâmetro

Descrição

navItemName

Entidade associada que deseja exibir. Exemplo: Cases

Id

ID do registro da entidade principal para exibir os registros de entidades associadas.

tabset

Área no Dynamics 365. Exemplos: areaSales ou areaService.

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.

FecharAtivo

Esta ação é usada para fechar a janela ativa neste controle hospedado. Se a janela ativa for a única janela exibida no controle hospedado, o próprio controle hospedado será fechado. Se você escolheu não permitir várias páginas para seu controle hospedado (Permitir Várias Páginas = Não), essa ação será equivalente à ação Fechar.

CloseAndPrompt

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

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 case ou incident para exibir a visualização da lista de localização rápida para ocorrências.

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

  • Use activities ou activity para exibir a visualização da lista de localização rápida para atividades.

FireEvent

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

Parâmetro

Descrição

name

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.

GetSelectedCount

Esta ação recupera o número de itens selecionados. Use a ação GetSelectedIds para obter a lista real de IDs para a entidade.

Parâmetro

Descrição

O parâmetro de dados deve especificar o nome da lista para recuperar as IDs selecionadas.

O valor de retorno contém um número representando a quantidade de itens selecionados.

GetSelectedIds

Esta ação é usada para recuperar as IDs selecionadas das listas.

Parâmetro

Descrição

O parâmetro de dados deve especificar o nome da lista para capturar as IDs selecionadas.

O valor de retorno contém uma lista delimitada de ponto-e-vírgula de IDs que contêm os itens selecionados.

Voltar

Essa ação é equivalente a clicar no botão voltar no hub de serviços interativos, o que levará você de volta à pilha de navegação do hub de serviços interativos.

IrParaPáginaInicial

Esta ação leva você para a página inicial especificada pelo usuário no Dynamics 365.

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 a URL do hub de serviços interativos.

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 este parâmetro for fornecido e for True, o quadro interno será exibido sem carregar a barra de comandos do hub de serviços interativos.

HideNavigationBar

Se este parâmetro for fornecido e for True, o formulário será exibido sem carregar a barra de navegação do hub de serviços interativos.

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.

Você pode passar valores de atributos em pares de nome=valor como parâmetros de dados para essa ação. Por exemplo:

LogicalName=incident
title=Sample Case

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.

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.

Atualizar

Esta ação atualiza a página atual.

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 do Dynamics 365 no formulário de hub de serviços interativos.

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 os dados atuais no formulário de hub de serviços interativos.

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 atuais no formulário de hub de serviços interativos 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.

Eventos predefinidos

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

ActiveClosed

Ocorre quando o controle hospedado ativo é fechado usando a ação CloseActive.

Parâmetro

Descrição

url

A URL exibida no controle hospedado quando foi fechado.

DataReady

Ocorre depois que os dados na página de serviços interativos foram salvos na lista de parâmetros de substituição.

Parâmetro

Descrição

url

A URL da página.

Ocorre quando ocorre navegação no hub de serviços interativos.

Parâmetro

Descrição

url

A URL da página para a qual ocorreu a navegação.

RefreshRequested

Ocorre quando a atualização é solicitada na página atual. A atualização pode ser solicitada pressionando a tecla F5 ou chamando a ação Atualizar pelo aplicativo.

Parâmetro

Descrição

url

URL exibida quando a atualização foi solicitada.

Salvo

Ocorre depois que um registro da página do hub de serviços interativos é salvo.

Parâmetro

Descrição

newId

A ID atribuída ao registro recém-criado.

Confira Também

Tipos de controle hospedado e referência de ação/evento
Página do CRM (controle hospedado)

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais