Compartilhar via

Aplicativo Web padrão (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

O tipo de controle hospedado Aplicativo Web Padrão é semelhante ao tipo de Página CRM, a diferença é que ele é destinado para armazenar páginas não- Dynamics 365, como páginas da Web externas e fornece injeção de script para recursos relevantes das páginas Web externas. Da mesma maneira que o controle hospedado Página do CRM, essas páginas podem ser automatizadas. O método preferencial de automatização é por meio de injeção de JavaScript, incluindo as funções de chamada de JavaScript já definidas na página ou que manipulam o DOM. A ação RunScript também pode ser usada para obter valores da página.

Dica

Esse tipo de controle hospedado não oferece suporte ao Kit de ferramentas do aplicativo hospedado (HAT), o que facilita a tarefa de automatização da interface do usuário de um aplicativo hospedado. O HAT consiste em adaptadores orientados a dados (DDA), associações e automações descritivas (fluxos de trabalho do Windows) para automatizar os aplicativos.Para obter mais informações:Use o adaptador de automação da UII para interagir com o os aplicativos Web e externo

Neste tópico

Crie um controle hospedado do Aplicativo Web Padrão.

Ações de UII predefinidas

Eventos predefinidos

Crie um controle hospedado do Aplicativo Web Padrão.

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 do Aplicativo Web Padrão. Para obter informações detalhadas sobre como criar um controle hospedado, consulte Criar ou editar um controle hospedado.

Controle hospedado do Aplicativo Web padrão

Na tela Novo controle de hospedado:

  • Na área Unified Service Desk, selecione Aplicativo Web Padrão na lista suspensa Tipo de Componente do USD.

  • Na lista suspensa Permitir Várias Páginas, selecione Sim para criar automaticamente uma lista suspensa quando uma segunda URL for chamada ou uma janela de navegação direcionar uma página à guia. Isso permite que o usuário pesquise rapidamente entre as páginas que foram anexadas a esse controle. Se você selecionar Não, quando o Unified Service Desk receber um chamada de ação de navegação ou uma página for encaminhada à guia, a página exibida será substituída e o histórico do navegador será atualizado.

  • A lista suspensa Tipo de Hospedagem especifica como você deseja que esse controle seja hospedado. É possível 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 anterior ficarão ocultas.

  • No campo Grupo de exibição, especifique um painel em que esse controle hospedado será exibido. Para obter informações sobre os diversos painéis disponíveis no Unified Service Desk, consulte Painéis no Unified Service Desk.

Ações de UII predefinidas

Estas são as ações de UII predefinidas disponíveis para esse tipo de controle hospedado.

Fechar

Essa ação é usada fechar o controle hospedado.

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.

Voltar

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.

IrParaPáginaInicial

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

MoveToPanel

Esta ação é usada para mover controles hospedados entre os painéis no tempo de execução.

Parâmetro

Descrição

app

Nome do controle hospedado a ser movido.

panel

Painel de destino para o controle hospedado.

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

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 em vez de carregar a barra de comandos da página.

HideNavigationBar

Se esse parâmetro for fornecido e for True, o painel de navegação na página da Web não será exibido.

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.

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.

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.

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.

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

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

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.

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

Ações da UII
Eventos
Visualizar ações e eventos predefinidos para um controle hospedado
Criar ou editar um controle hospedado
Passo a passo 2: Exibir uma página Web externa no aplicativo agente
Tipos de controle hospedado e referência de ação/evento

Unified Service Desk 2.0

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais