Página do CRM (Controlo Alojado)

Utilize o controlo alojado Página do CRM para carregar um URL ou uma página do CRM. Quando uma página do CRM é carregada dentro de um controlo alojado deste tipo, irá analisar automaticamente página para procurar a entidade e povoa automaticamente os parâmetros de substituição.

Este tipo de controlo alojado expõe várias ações e eventos predefinidos do UII que são exclusivos do processamento de janelas do CRM, incluindo ações de manipulação de listas e uma ação localizar para apresentar uma pesquisa rápida ou uma página de pesquisa avançada.

Neste Tópico

Criar um controlo alojado Página do CRM

Ações predefinidas do UII

Eventos predefinidos

Criar um controlo alojado Página do CRM

Para criar um novo controlo alojado, os campos no ecrã Novo Controlo Alojado variam consoante o tipo de controlo alojado que pretende criar. Esta secção fornece informações sobre os campos específicos que são exclusivos para o tipo de controlo alojado Página do CRM. Para obter informações detalhadas sobre a criação de um controlo alojado, consulte Criar ou editar um controlo alojado.

No ecrã Novo Controlo Alojado:

• Na área Unified Service Desk, selecione Página do CRM de lista pendente de Tipo de componente do USD.

• Na lista pendente de Permitir Várias Páginas, seleccione Sim para criar automaticamente uma lista pendente quando um segundo URL é chamado ou uma regra de navegação de janela direciona uma página para o separador. Isto permitirá que o utilizador pesquisa rapidamente entre as páginas que estão anexadas a este controlo. Se selecionar Não, quando o Unified Service Desk recebe uma chamada de ação de navegação ou uma página é encaminhada para o separador, substituirá a página apresentada atualmente e atualiza o histórico do browser.

• A lista pendente de Tipod e Alojamento especifica como pretende que este controlo seja alojado. Pode optar por WPF interno (predefinição) ou Processo do IE. Para mais informações, consulte Selecionar um método de alojamento para controlos alojados [].

• Na área de Propriedades comuns, selecione a caixa de verificação de A Aplicação é Global para definir o controlo alojado como global. Os controlos alojados globais podem ser apresentados fora de uma sessão de cliente. Os controlos como dashboard do agente, mural ou pesquisa são utilizações comuns para controlos alojados globais. Os controlos alojados globais não tem um estado específico de sessão, pelo que quando muda de sessão os controlos alojados globais permanecem. Se a caixa de verificação não estiver selecionada, o controlo alojado transforma-se em baseado na sessão. Os controlos baseados em sessão existem no contexto de sessão de cliente. Se o utilizador mudar para outra sessão, todas as páginas da sessão anterior serão ocultas.

• O campo Grupo de Apresentação indica o painel em que este controlo alojado será apresentado. MainPanel é mais frequente para este tipo de controlo alojado. Para obter mais informações sobre os vários painéis disponíveis em Unified Service Desk, consulte Painéis, tipos de painel, e esquemas de painel no Unified Service Desk.

Para informações sobre outros campos Geral, consulte Criar ou editar um controlo alojado.

Ações predefinidas do UII

Seguem-se as ações predefinidas para este tipo de controlo alojado.

New_CRM_Page

Cria uma página para criar um novo registo do CRM da entidade especificada e trata a página como se fosse um pop-up do controlo alojado especificado. As regras de navegação da janela são avaliadas para determinar a localização onde a página para criar o registo de entidade é apresentada.

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

Nota

O resto dos parâmetros deve ser composto por pares nome=valor. Estes são os valores pré-povoados adicionais no formulário para criar um novo registo da entidade especificada. Para mais informações sobre como utilizar esta ação, consulte o passo 4 em Procedimento 7: Configurar scripting de agente na aplicação de agente.

Open_CRM_Page

Abre uma instância existente da entidade especificada e identificada pelo ID e trata a página como se fosse um pop-up do controlo alojado especificado. As regras de navegação da janela são avaliadas para determinar a localização onde o pop-up deve ser apresentado.

Parâmetro	Descrição
LogicalName	O nome lógico da entidade a abrir.
id	O ID do registo de entidade a abrir.

Pop-up

Apresenta um pop-up o URL do controlo alojado e executa regras de navegação de janela sobre este para encaminhar o pop-up para a localização adequada.

Parâmetro	Descrição
URL	Encaminha um pop-up do controlo alojado utilizando este URL como se este fosse um pop-up pedido pelo controlo apresentado.
frame	A Frame em que este pop-up teve origem.

Fechar

Esta ação é utilizada para fechar o controlo alojado. Ao contrário da ação de CloseActive, se este separador (controlo alojado) está a apresentar mais de uma página, irá fechar todas as páginas apresentadas no separador na aplicação de agente.

FireEvent

Aciona um evento definido pelo utilizador a partir deste controlo alojado.

Parâmetro	Descrição
Nome	Nome do evento definido pelo utilizador.

Todos os pares nome=valor subsequentes transformam-se em parâmetros para o evento. Para mais informações sobre como criar um evento definido pelo utilizador, consulte Criar um evento definido pelo utilizador.

MoveToPanel

Esta ação é utilizada para mover controlos alojamento entre os painéis em tempo de execução.

Parâmetro	Descrição
Aplicação	Nome do controlo alojado a ser movido.
painel	Painel de destino para o controlo alojado.

SetSize

Esta ação define explicitamente a altura e largura de controlo alojado. Isto é particularmente útil para utilizar “auto” nos esquemas de painéis.

Parâmetro	Descrição
width	A largura do controlo alojado.
height	A altura do controlo alojado.

Localizar

Navegar para a vista de lista de localização rápida da entidade especificada.

Parâmetro

Descrição

O parâmetro de dados tem de especificar o nome lógico da entidade da vista de lista de localização rápida a apresentar. Existem algunas valores de incidente especiais: Utilize incidente ou caso para apresentar a vista localização rápida para incidentes. Utilize advfind para apresentar a vista localização avançada. Utilize atividades ou atividade para apresentar a vista localização rápida para atividades.

Navegar

Esta ação é utilizada para navegar para o URL do CRM.

Parâmetro	Descrição
URL	O URL de destino. Este é um parâmetro obrigatório.
Noscan	Se este parâmetro é fornecido e é True, os parâmetros de dados não serão recolhidos da página.
Hideribbon	Se este parâmetro é fornecido e é True, o frame interno será navegado, evitando carregar o friso.
Hidenav	Se este parâmetro é fornecido e é True, o painel de navegação à esquerda no CRM será fechado quando a página é carregada.
Frame	Quando existirem frames na página, este parâmetro especificaria o nome do frame para navegar, em vez da janela principal.
postdata	Dados que são enviados ao servidor como parte de uma transaçã HTTPPOST. Uma transação POST é normalmente utilizada para enviar os dados recolhidos por uma página HTML. No Unified Service Desk, estes dados poderão ser recebidos de qualquer evento acionado utilizando "http://event/?". Exemplo: [[postdata]+] Em alternativa, os dados poderão ser transmitidos como uma cadeia codificada com o tipo de cabeçalho no formato esperado.
header	Um valor de cadeia que contém cabeçalhos HTTP adicionais para enviar para o servidor. Quando o parâmetro postdata é utilizado na ação Navigate, também terá de especificar um valor adequado para o parâmetro header. Exemplo: Content-Type:application/x-www-form-urlencoded Se um evento POST do Unified Service Desk acionar a ação Navigate, o valor predefinido deste parâmetro deverá ser header=[[header]+].

ToggleRibbon

Esta ação fecha ou expande o friso. Se ocultar o friso na ação Navigate, não será apresentado e esta ação não funciona. Esta ação só funcionar quando o friso só foi carregado inicialmente.

ToggleNavigation

Esta ação fecha ou expande o painel de navegação no painel esquerdo da janela do CRM. A navegação tem de conter um painel de navegação, para que esta ação funcione.

CloseActive

Esta ação é utilizada para fechar a janela ativa neste controlo alojado. Se a janela ativa é a única janela apresentada no controlo alojado, o controlo alojado propriamente dito será fechado. Para o tipo de controlos alojados Página do CRM que não permitem várias páginas (Ativar várias páginas = Não), esta ação é equivalente à ação de Fechar.

SaveAndClose

Esta ação guarda os dados não guardados no formulário do CRM e fecha o controlo alojado.

CloseAndPrompt

Esta ação fecha o controlo alojado mas pede ao utilizador para guardar ou abandonar as alterações antes de fechar.

DisableToolbarButton

Esta ação desativa o botão da barra de ferramentas especificado na barra de ferramentas na aplicação de agente.

Parâmetro	Descrição
	Nome do botão na barra de ferramentas para desativar.

EnableToolbarButton

Esta ação ativa o botão da barra de ferramentas especificado na barra de ferramentas na aplicação de agente.

Parâmetro	Descrição
	Nome do botão na barra de ferramentas para ativar.

GoHome

Esta ação vai para o URL inicial especificado para esta instância do browser.

GoBack

Esta ação é equivalente a clicar no botão anterior na instância do browser.

GoForward

Esta ação é equivalente a clicar no botão seguinte na instância do browser.

SaveAll

Esta ação guarda todos os formulários no controlo alojado que permite que várias páginas sejam apresentadas (Allow Multiple Pages = Yes). Se o controlo alojado permite que apenas uma única página seja apresentada (Allow Multiple Pages = No), é equivalente à ação de Guardar.

Guardar

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

LoadArea

Esta ação carrega uma área específica de CRM. Isto é equivalente a selecionar uma área no painel de navegação (como Vendas, serviço e marketing). O único parâmetro é o nome da área a clicar. Por exemplo: areaService.

Parâmetro	Descrição
frame	O nome do frame a afectar. Se não for especificado um nome, o destino será automaticamente o primeiro frame encontrados na página.

RunXrmCommand

Esta ação é utilizada para injetar SDK JavaScript do CRM no formulário do CRM.

Parâmetro	Descrição
	O parâmetro de dados é o JavaScript que será injetado no formulário. Nota Os parâmetros de substituição podem ser utilizados no script e serão substituídos antes que o script seja executado.

RunScript

Esta ação injeta JavaScript no frame principal da aplicação. Tem de utilizar evitar chamadas SDK do cliente de CRM com esta ação; em alternativa, utilize a ação de RunXrmCommand.

Parâmetro	Descrição
	O parâmetro de dados é o JavaScript que será injetado no formulário. Nota Os parâmetros de substituição podem ser utilizados no script e serão substituídos antes que o script seja executado.

ReRoute

Esta ação utiliza o URL apresentado e envia-o através das regras de navegação da janela a partir do controlo alojado atual como um pop-up.

WaitForComplete

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

Nota

Algumas páginas Web, especialmente páginas do CRM, têm vários frames. Esta ação espera apenas que o frame principal esteja concluído.

Parâmetro	Descrição
Milliseconds	Parâmetro adicional para indicar quanto tempo, em milissegundos, aguardar pelo tempo limite.

AssociatedView

Esta ação carrega uma vista associada específica do CRM. Estas vistas são normalmente acedidas clicando na seta para baixo existente junto do nome de registo da entidade na barra de nav, e selecionando as entidades associadas.

Parâmetro	Descrição
navItemName	A entidade associada que quer apresentar. Exemplo: Incidentes
ID	O ID do registo de entidade principal para apresentar os registos de entidade associado.
tabset	A área no CRM. Exemplos: areaSales ou areaService.

Para mais informações sobre como utilizar esta ação, consulte o passo 5 em Procedimento 7: Configurar scripting de agente na aplicação de agente.

GetSelectedIds

Esta ação é utilizada para obter os IDs selecionados nas listas.

Parâmetro	Descrição
	O parâmetro de dados tem de especificar o nome da lista para capturar os IDs selecionados.

O valor devolvido contém uma lista delimitada por ponto e vírgula dos IDs que contêm os itens selecionados.

GetSelectedCount

Esta ação obtém o número de itens selecionados. Utilize a ação GetSelectedIds para obter a lista real de IDs para a entidade.

Parâmetro	Descrição
	O parâmetro de dados tem de especificar o nome da lista para obter os IDs selecionados.

O valor devolvido contém um número que representa a quantidade de itens selecionados.

WaitForData

Esta ação bloqueia o processamento até que os parâmetros de substituição sejam recolhidos na página atual.

Parâmetro	Descrição
Milliseconds	Parâmetro adicional para indicar quanto tempo, em milissegundos, aguardar pelo tempo limite.

LookupInfo

Apresenta uma caixa de diálogo de informações de pesquisa do CRM para lhe permitir selecionar uma entidade numa lista.

Parâmetro	Descrição
AllowFilterOff	“0 " ou “1 " para permitir que o utilizador desative a filtragem
DefaultType	O Nome Lógico do ecrã predefinido. Deve ser um dos valores numéricos especificado no parâmetro objecttypes.
DefaultViewId	“0 " ou “1 " para mostrar a vista predefinida
DisableQuickFind	“0 " ou “1 " para mostrar o campo localização rápida
DisableViewPicker	“0 " ou “1 " para mostrar o seletor de vista
LookupStyle	Single ou Multiple
ShowNewButton	“0 " ou “1 " para mostrar o botão novo
ShowPropButton	“0 " ou “1 " para mostrar o botão propriedades
Procurar	“0 " ou “1 " se utilizar o modo de navegação. O seguinte tem este valor definido como “1".
Currentid	O Guid para o valor atual
objecttypes	Lista de tipos de objeto a apresentar. Estes são os tipos etc do CRM. Exemplo: “1,2 " para apresentar contas e contactos.

Atualizar

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

Eventos predefinidos

Seguem-se os eventos predefinidos associados a este tipo de controlo alojado.

ActiveClosed

Ocorre quando o controlo alojado ativo é fechado através da ação de CloseActive.

Parâmetro	Descrição
URL	O URL que foi apresentado no controlo alojado quando o mesmo foi fechado.

BrowserDocumentComplete

Ocorre quando a página acabou de carregar. Num tipo de controlo alojado Página do CRM, este evento ocorre depois de guardar os dados na lista de parâmetros de substituição. Este evento ocorre apenas uma vez, mesmo que vários frames tenha acionado individualmente os respetivos eventos BrowserDocumentComplete.

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

PageLoadComplete

Ocorre sempre que um frame termina o carregamento. Este evento pode ocorrer várias vezes por carregamento de página quando um iFrame ou um frame são utilizados na página. Este evento corresponde aos eventos individuais BrowserDocumentComplete no código.

Parâmetro	Descrição
frame	O nome do frame que acabou de carregar, se disponível.
URL	O URL do frame que acabou de carregar.

PopupRouted

Ocorre quando um pop-up foi encaminhado pelo sistema.

Parâmetro	Descrição
URL	O URL do pop-up que foi encaminhado.

RefreshRequested

Ocorre quando a atualização é pedida na página atual. A atualização pode ser pedida premindo a tecla F5 ou chamando a ação de atualização pela aplicação.

Parâmetro	Descrição
URL	O URL apresentado quando a atualização foi pedido.

Saved

Ocorre quando um registo na página de CRM é guardado.

Parâmetro	Descrição
newId	O ID atribuído ao registo acabado de criar.

Consulte Também

Tarefas

Procedimento 3: Apresentar registos do Microsoft Dynamics CRM numa sessão na aplicação de agente

Conceitos

Diálogo do CRM (Controlo Alojado)
Ações do UII
Eventos

Outros Recursos

Tipos de controlos alojados e referência de ações e eventos
Guia de Administração do Unified Service Desk para o Microsoft Dynamics CRM

Unified Service Desk
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.