En este ejemplo voy a crear un Event Connector que llama a un Servicio Web. En un escenario real, este servicio puede ser el responsable para insertar información en un sistema Service Desk/Help Desk que no esta soportado de manera natural por EMCC, por ejemplo iTop.
Step by Step
1. Descriptor de Conector: Crear el archivo XML que define la descripción de nuestro Event Connector (conector). En este caso utilizo JDeveloper para crear los archivos XML y XSL que conforman el desarrollo de nuestro conector. En la figura de abajo se muestra el código nuestro Descriptor de Conector:
·
El nombre del archivo debe ser: connectorDeploy.xml
·
El código XML debe estar adherido al schema (XSD): connectorDeploy.xsd
·
El tag <Method> especifica que nuestro Event Connector actua en la creación de un evento en el sistema.
·
El tag <WebServiceEndpoint> define la ubicación del
servicio Web al cual se enviará la información, en este caso al servicio MyWebServiceToiTop. Por arte de magía, EMCC no requiere el WSDL del servicio.
·
El tag <SOAPAction> define la operación que se debe invocar en el servicio Web.
·
El tag <TemplateRegistration> de tipo OutboundXSL
define los archivos XSL necesarios para generar el mensaje de solicitud
del servicio Web. El
tag <TemplateRegistration> de tipo InboundXSL define los archivos XSL necesarios para la lectura del mensaje de respuesta.
2. Definición y registro de plantillas: Crear los archivos XSL que EMCC utilizará para generar los mensajes de solicitud del servicio Web MyWebServiceToiTop, al llamar a la operación CreateIncident.
createEvent_request.xml
createEvent_response.xml
- El contenido de las plantillas está alineado al esquema del servicio MyWebServiceToiTop, y EMEvent.xsd, así como a las dependencias que tienen estos.
- El esquema EMEvent.xsd es utilizado para especificar los campos de EMCC que deseamos enviar al servicio Web.
3. Empaquetar el Conector: Generar
el archivo JAR en el que se empaquetan los archivos XML y XSL del conector.
4. Crear archivo Manifest: Generar el archivo Manifest que se requiere para el despliegue del conector en EMCC.
connector_manifest.xml
- El tag <Archive> especifica el archivo JAR que empaqueta el conector.
- El nombre del archivo debe ser: connector_manifest.xml
5. Preparar archivo de despliegue Self-Update: Generar archivo Self-update para el despliegue
del conector en EM Cloud Control.
Utilizar la herramienta emedk para
generar el archivo Self-update, que representa el archivo de despliegue con el
conector. Ejecutamos el siguiente comando para
generar el Self-update:
- La utilería emedk puede ser configurada (descargada) siguiendo las instrucciones indicadas en la interface de usuario del EMCC, la ruta es Setup > Extensibility > Development Kit.
- El archivo ZIP que se nos genera representa el archivo de despliegue de nuestro Event Conector.
6. Importar archivo Self-update: Utilizamos la herramienta emcli,
disponible en cualquier instalación de EMCC, para importar el archivo Self-update (archivo ZIP). Para ello, copiamos el archivo al host donde está instalado el EMCC, abrimos una sesión EMCC con el usuario sysman y ejecutamos el siguiente comando:
$ emcli login -username=sysman
$ emcli
import_update –file=/opt/home/oracle/C30E0397B5C5FFBD563190F090C5BE55.zip –omslocal
- Es importante especificar la ruta completa del archivo ZIP.
7. Despliegue del Conector: Realizar
el despliegue del Conector en EM Cloud Control.
Una vez que se ha importado el conector
podemos realizar su despliegue desde la interface de usuario de EMCC. Para esto, navegamos a la página Self-Update Home y ubicamos la
entrada Connector Management.
A
continuación seleccionamos la fila que indica nuestro conector y hacemos clic
en Apply para ejecutar su despliegue.
Nota: Si al aplicar el conector se nos genera un error como el que se muestra abajo lo resolvemos creando el directorio /app/oracle/oms/sysman/connector/DD53C88B89EC2396E04400212872237D/META-INF en el sistema operativo y reintentamos el despligue.
Apply failed: Exception: Failed to deploy connector type due to connectorException: EM-02873 Failed to extract file META-INF/MANIFEST.MF due to IOException.
/app/oracle/oms/sysman/connector/DD53C88B89EC2396E04400212872237D/META-INF/MANIFEST.MF (No such file or directory)
En este punto se ha finalizado el despliegue de nuestro Event Connector y esta listo para ser utilizado. El siguiente paso consiste en Crear un recurso de tipo Conector a partir del que hemos instalado, iTop Connector; Para ello navegamos a la página principal de administración de conectores (Management Connector), de la lista de ementos seleccionamos nuestro Event Connector y hacemos clic en Ir.
Finalmente tenemos disponible un conector (Event Connector) listo para ser utilizado desde el módulo de Incidencias de EMCC. La documentación esta aqui Accessing Incident Rulesets
