Tópico anterior: Excluir uma açãoPróximo tópico: Agendador


Como registrar um evento

É possível registrar um evento, como uma maneira automatizada de simular uma ação de um usuário; por exemplo, um usuário do catálogo enviando uma solicitação, um gerente de solicitações aprovando uma solicitação ou um administrador do catálogo atualizando os detalhes de um usuário ou de uma unidade de negócios. Nos dois casos (na ação do usuário ou no evento registrado), quando o evento ocorre, suas regras são avaliadas. Se as condições de uma regra forem atendidas, as ações da regra serão executadas.

O registro de eventos é útil para executar essas tarefas usando a automação e com valores específicos e ações. Por exemplo, é possível registrar eventos para especificar valores personalizados para a integração entre o CA Service Catalog e outro produto da CA. Este tópico explica como registrar um evento do CA Service Catalog por meio do URL HTTP. Também é possível usar esse URL em ações de regra cujo tipo é Registro em HTTP.

Importante: Se você registrar um evento, teste-o integralmente antes de movê-lo para um ambiente de produção. Verifique se o evento não é executado de forma cíclica se a ação for acionada.

Para registrar um evento, siga este processo:

  1. Colete os dados do evento para construir o URL HTTP.
  2. Especifique o URL HTTP. Este tópico usa um exemplo de URL para ilustrar como registrar um evento.

    Observação: também é possível registrar eventos usando os serviços web. As duas técnicas produzem os mesmos resultados.

  3. Verifique se o evento foi registrado.

Coletar dados do evento para construir o URL HTTP

Colete os seguintes valores da definição de evento do URL.

Este exemplo usa o evento Agregação de mediação de dados na página Ferramentas, Eventos/regras/ações. Clique no nome do evento para exibir seus detalhes, incluindo os detalhes a seguir. Use esses detalhes para ajudar a especificar o URL HTTP, como ilustrado no seguinte texto:

Especificar o URL HTTP

Para especificar um URL HTTP para registrar um evento no sistema, utilize a seguinte sintaxe:

Observação: na seguinte linha e no exemplo a seguir, as quebras de linha são somente para fins de legibilidade. Na interface de usuário do produto, digite o seguinte código como uma única linha contínua.

http://hostname:port/usm/wpf?Node=icguinode.postevent
&username=userid&pass=password&domain=businessunit
&Args=eventsource&Args=nsppath&Args=transactionname&Args=eventtypename
&Args=transactiontype&Args=eventdescription&Args=associatedobjectid
&Args=false&Args=param1|oldvalue1!param#|oldvalue#!
&Args=param1|newvalue1!param#|newvalue#!

Veja este exemplo de URL:

http://hostname:port/usm/wpf?Node=icguinode.postevent
&username=spadmin&pass=spadmin&domain=ca.com&Args=LOGICAL
&Args=DATA_MEDIATION_AGGREGATION:MODIFIED
&Args=DATA_MEDIATION_AGGREGATION&Args=MODIFIED&
Args=LOGICAL&Args=Modified&Args=$id$&Args=false
&Args=end_date|abc!start_date|abc!status|123!status_date|abc!
&Args=end_date|abd!start_date|abd!status|124!status_date|abd!

Observação: quando registrar um evento por meio do URL do Java ou de outras ferramentas, talvez seja necessário codificar o URL substituindo os caracteres não suportados por códigos. Por exemplo, talvez seja necessário substituir o E comercial (&) por %26 ou substituir um único espaço em branco por %20.

Observação: o sistema do catálogo usa valores antigos e novos na avaliação de filtros de regras para regras do evento.

Os seguintes parâmetros necessitam de explicação:

id do usuário

Especifica uma ID de usuário válida para autenticação.

senha

Especifica a senha da ID de usuário.

businessunit

Especifica a unidade de negócios para a função da ID de usuário.

eventsource

Especifica a origem do evento a partir dos detalhes do evento: LOGICAL, PHYSICAL, CommonDB.

Neste exemplo, o valor é LOGICAL.

nsppath

Especifica o caminho do espaço para nome, um valor somente de espaço reservado. O sistema do Catalog não usa o valor real, mas exige um valor de espaço reservado.

Use o seguinte formato:

<Nome da transação>-<Tipo de transação>

<Tipo de transação> – MODIFIED, ADDED ou DELETED.

<Nome da transação> – conforme exibido nos detalhes do evento

Neste exemplo, o valor é DATA_MEDIATION_AGGREGATION:MODIFIED.

transactionname

Especifica o nome da transação do evento.

Como mostrado nos detalhes do evento, neste exemplo, o valor é DATA _MEDIATION _AGGREGATION.

eventtypename

Especifica o nome do tipo de evento: MODIFIED, ADDED ou DELETED.

Neste exemplo, o valor é MODIFIED.

transactiontype

Especifica o tipo de transação do evento.

Esse valor é o mesmo que o valor do parâmetro eventsource.

Neste exemplo, o valor é LOGICAL.

eventdescription

(Opcional para o serviço web) Especifica uma descrição do evento.

Especifique o tipo de transação, conforme exibido nos detalhes do evento.

Neste exemplo, o valor é Modified.

associatedobjectid

Especifica a ID de um objeto a ser associada a esse evento.

Opcionalmente, você pode especificar um dos parâmetros de evento para esse valor. Esse valor é usado para associar o alerta que foi registrado em Alterar eventos.

Este exemplo usa um valor fictício: $id$.

ispartial

Especifica se esse evento é parcial; esse valor é sempre falso.

param#|oldvalue#

Especifica o nome do parâmetro e o valor antigo. Delimite o nome e o valor com uma barra vertical. Separe cada par de nome e valor com um ponto de exclamação.

Neste exemplo, o valor é o seguinte:

end_date|abc!start_date|abc!status|123!status_date|abc!

Observação: esse exemplo usa valores fictícios para os atributos do evento. Não especifique um valor para o atributo $all$, porque ele lê todos os valores.

param#|newvalue#

Especifica o nome do parâmetro e o novo valor. Delimite o nome e o valor com uma barra vertical. Separe cada par de nome e valor com um ponto de exclamação.

Neste exemplo, o valor é o seguinte:

end_date|abd!start_date|abd!status|124!status_date|abd!

A observação do parâmetro anterior também se aplica a este parâmetro.

Verificar se o evento foi registrado

Para verificar se um evento foi registrado, Siga estas etapas:

  1. Desative todas as regras do evento que você está registrando.
  2. Ative apenas uma regra sem filtro e uma ação de linha de comando, como segue:
    cmd /c echo Posted Event: $all$ >> C:\PostEventCheck.txt
    
  3. Verifique se o arquivo PostEventCheck.txt foi criado na unidade C:\ do servidor de aplicativos do CA Service Catalog.

Observação: também é possível registrar um evento usando um dos métodos do serviço web de Administração postEvent.

Mais informações:

Usando o Web Services