Página 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

Use o tipo de controle hospedado da Página do CRM para carregar um URL ou página do Dynamics 365. Quando uma página do Dynamics 365 é carregada em um controle hospedado desse tipo, ele examinará a página por dados na entidade e preencherá automaticamente os parâmetros de substituição.

Esse tipo de controle hospedado expõe um número de ações e eventos de UII predefinidos que são exclusivos para a manipulação das janelas do Dynamics 365, incluindo as ações de manipulação de lista e uma ação de pesquisa usada para exibir uma busca rápida ou uma página de pesquisa avançada

Neste tópico

Crie um controle hospedado Página do CRM

Ações de UII predefinidas

Eventos predefinidos

Crie um controle hospedado Página do CRM

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 do CRM. 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 Unified Service Desk, selecione Página do CRM 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 do Dynamics 365 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 do Dynamics 365 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.

• A lista suspensa Tipo de Hospedagem especifica como você deseja que esse controle seja hospedado. Você pode escolher Processo do IE (padrão) ou WPF Interno. 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. Se o usuário mudar para outra sessão, todas as páginas da sessão da sessão anterior são ocultas.

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

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.

AssociatedView

Esta ação carrega uma exibição associada específica do Dynamics 365. 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: Ocorrências
ID	ID do registro da entidade principal para exibir os registros de entidades associadas.
tabset	Área no Dynamics 365. Exemplos: areaSales ou areaService.

Para obter mais informações sobre como usar esta ação, consulte a etapa 5 em Passo a passo 7: Configurar o script do agente no aplicativo agente.

Close

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.

CloseActive

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. Para o tipo Página do CRM de controles hospedados que não permitem várias páginas (Permitir Várias Páginas = Não), essa ação é equivalente à ação Fechar.

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.

Find

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

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.

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.

GoHome

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

GoBack

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

GoForward

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

LoadArea

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
frame	Nome do quadro que será afetado. Se nenhum nome for especificado, será selecionado automaticamente o primeiro quadro localizado na página.

LookupInfo

Exibe uma caixa de diálogo de informações de pesquisa Dynamics 365 para permitir a seleção de uma entidade em uma lista.

Parâmetro	Descrição
AllowFilterOff	“0 " ou “1 " para permitir que o usuário desative a filtragem
DefaultType	O nome lógico da exibição padrão. Este deve ser um dos valores numéricos especificados no parâmetro objecttypes.
DefaultViewId	“0” ou “1” para mostrar a visualização padrão
DisableQuickFind	"0 "ou "1 " para exibir o campo de localização rápida
DisableViewPicker	“0" ou “1" para exibir o seletor de exibição
LookupStyle	Único ou Vários
ShowNewButton	"0" ou "1" para exibir o novo botão
ShowPropButton	"0" ou "1" para exibir o botão propriedades
Browse	"0" ou "1" se deseja usar modo de navegação. As ações a seguir estão definidas em "1".
Currentid	O Guid para o valor atual
objecttypes	Lista de tipos de objetos a serem exibidos. Estes são os tipos de etc. do Dynamics 365. Exemplo: “1,2" para exibir contas e contatos.

MoveToPanel

Esta ação move um controle hospedado da Página CRM para um painel diferente no tempo de execução.

Parâmetro	Descrição
	O parâmetro de dados deve especificar o nome do painel de destino para onde deverá ser movido o controle hospedado. Por exemplo: FloatingPanel.

Navigate

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

Popup

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

Refresh

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

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.

SaveAndClose

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

SaveAll

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.

Save

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

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.

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.

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.

BrowserDocumentComplete

Ocorre quando a página terminou de carregar. Em um tipo de controle hospedado Página do CRM, 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.

PageLoadComplete

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 individuais no código.

Parâmetro	Descrição
frame	O nome do quadro que terminou de carregar, se disponível.
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.

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.

Saved

Ocorre depois que um registro na página Dynamics 365 é salvo.

Parâmetro	Descrição
newId	A ID atribuída ao registro recém-criado.

Confira Também

Diálogo do CRM (controle hospedado)
Ações da UII
Eventos
Passo a passo 3: Exibir registros do Microsoft Dynamics 365 no aplicativo agente
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