Enable SimpCon Push XML Producer
overview the simpcon push xml producer extension template provides a framework for developing extensions that receive xml formatted records from an external source system and publish the records to a kafka topic through data streaming services the extension requires details about the external source system, including the system url and authentication credentials optional filters, such as assignment groups and domain separated company names, can be configured to limit the records processed by the extension platform service interactions the extension transforms incoming requests and forwards them to the following data streaming service topic itil xxxxx source configure the extension the following environment variables must be passed to the container variable default comments dx ext extension user (string) mandatory bridge username used for basic authentication dx ext extension pw (string) mandatory bridge password used for basic authentication dx ext source query url (string) mandatory smt url to query for ticket state dx ext source user (string) mandatory smt username used for basic authentication dx ext source pw (string) mandatory smt password used for basic authentication dx env environment (string) mandatory the type of environment the extension is running in local, dev, or prod dx env ou key (string) mandatory ou tenant key dx env ou bac id (string) mandatory bac id of the client dx env ou es instance (string) mandatory the elasticearch instance the messages are supposed to go to on the consumer side dx ext cdi tool source (string) mandatory client tool mapping value dx ext cdi customercode (string) mandatory client tool mapping value store authentication credentials securely do not include credentials in source code repositories how the extension works this application is a simplified connector designed to run as an extension instance in the integrated aiops platform the extension performs the following actions receives xml formatted records from an external source system transforms the incoming requests publishes the transformed records to a data streaming service kafka topic the extension runs as a container in a kubernetes environment results the extension runs as a containerized application and uses kubernetes liveness and readiness probes to report runtime health status deployment the extension is intended for deployment and configuration through the integrated user interface for a specific organizational unit (ou) or compute zone local execution is intended only for developers who are familiar with the extension codebase run the extension locally build the container image open a terminal session navigate to the extension directory cd \<extension path> build the docker image docker build t simpcon push producer 1 0 0 f /deployment/dockerfile start the container run the container and provide the required environment variables docker run rm \\ \ network host \\ itd \\ p 8080 8080 \\ e dx ext extension user=\<bridge username> \\ e dx ext extension pw=\<bridge password> \\ e dx ext source query url= https //devibmimieu service now\ com/api/now/table/incident https //devibmimieu service now\ com/api/now/table/incident \\ e dx ext source user=\<source username> \\ e dx ext source pw=\<source password> \\ e dx env environment=local \\ e dx env ou key=098a759b1e7c 1 \\ e dx env ou bac id=bac0000bf2 \\ e dx env ou es instance=es was1 \\ e dx ext cdi tool source=snow extsvc \\ e dx ext cdi customercode=id1 \\ simpcon push producer 1 0 0 monitor the container view running containers docker ps view container logs docker logs \<container id> | less troubleshoot the container identify the container id docker ps open a shell session in the container docker exec it \<container id> /bin/bash support the extensions development team owns and maintains this extension