Partilhar via


Criar um evento definido pelo utilizador

O Unified Service Desk fornece os eventos predefinidos para os controlos alojados com base no tipo de controlo alojado. Além destes eventos predefinidos, também pode criar os seus próprios eventos em Unified Service Desk, que são chamados eventos definidos pelo utilizador. Pode utilizar a ação FireEvent ou o moniker de eventos para executar eventos definidos pelo utilizador.

Neste Tópico

Utilizar a ação FireEvent

Utilizar o moniker de eventos

Utilizar a ação FireEvent

Todos os tipos de controlo alojado predefinidos e personalizados do Unified Service Desk, exceto a Aplicação Alojada CCA têm uma ação especial do UII chamada FireEvent. Pode chamar esta ação para iniciar um evento definido pelo utilizador a partir do controlo. Esta é uma forma conveniente de agrupar várias chamadas de ação numa único chamada, criando uma função em Unified Service Desk. Também é uma forma razoável de testar eventos e sequências de ação antes de implementação.

O primeiro parâmetro de FireEvent é o nome do evento:

name=MyEvent

Todos os pares subsequentes nome/valor são parâmetros do evento e podem ser utilizados como parâmetros de substituição nas ações que são chamadas como resultado. Por exemplo, se passar a lista de parâmetros seguinte:

name=MyEvent
var1=[[account.name]]

Isto acionará o evento personalizado MyEvent ativando a capacidade de criar uma chamada de ação que utilize o parâmetro var1 do seguinte modo:

Hosted Control=Some Hosted Control
UII Action=Some action on the Hosted Control
Data=[[var1]]

Isto transmite o parâmetro do evento como parâmetro de dados para a ação do controlo alojado. Neste exemplo, isto significa que o parâmetro de dados do controlo alojado será o valor de account.name de sessão.

Utilizar o moniker de eventos

Pode criar um evento personalizado num controlo alojado e chama-o utilizando a sintaxe seguinte de moniker de eventos:

http://event/?eventname=<EVENT_NAME>&key=value&key=value&…

Na sintaxe, especifica o par key=value para transmitir a lista de parâmetros a utilizar quando o evento é acionado.

Considere um exemplo em que pretende acionar um evento definido pelo utilizador sempre que o título do incidente no formulário de incidente é alterado no CRM. Para:

  1. Crie um novo evento, denominado TitleChanged para o controlo alojado Incidente no Microsoft Dynamics CRM.

  2. Crie uma chamada de ação, denominada Action Call for Title Change, com os seguintes valores:

    Campo Valor

    Nome

    Action Call for Title Change

    Controlo Alojado

    Incidente

    Ação

    RunXrmCommand

    Dados

    function titleChangeReaction() 
    { 
       window.open("http://event/?EventName=TitleChanged&NewTitle="+encodeURIComponent(Xrm.Page.getAttribute("title").getValue()));
    }
    Xrm.Page.getAttribute("title").addOnChange(titleChangeReaction);
  3. Adicione a nova chamada de ação que criou o evento BrowserDocumentComplete do controlo alojado Incidente. Mais informações: Adicionar chamadas de ação a um evento

Quando o evento TitleChanged é acionado, o pedido seguinte é emitido:http://event/?EventName=TitleChanged&NewTitle=<NEW_TITLE>

Isto fará com que o evento TitleChanged seja acionado com o seguinte parâmetro de dados: NewTitle=<NEW_TITLE>

Consulte Também

Conceitos

Eventos

Outros Recursos

Tipos de controlos alojados e referência de ações e eventos
Gerir controlos alojados, ações e eventos

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