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:
|
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: 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: Se um evento POST do Unified Service Desk acionar a ação Navigate, o valor predefinido deste parâmetro deverá ser |
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.