brpm_module_demo 0.1.14 → 0.1.15

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDkwMDM5YzYwYmE0MjkxYzU3MjY4Zjk5OTBkYzY0OWY5OGEzYzczMg==
+    NWVjNzdkMWY5OWE3NTBiZGZhMDgxYWE4ZmEwMjhiNTllNGZjMWZiNw==
   data.tar.gz: !binary |-
-    OGFlZDE3ZmRjNzYwOWFmYzBlMWNhZmIwZGE5MWE3MDAzYTZiMWU3Yw==
+    MGUzYzFmYjE2ZjM1MjQyZTUzOGIwMTRmM2FjYTYyYzRlZjlmYjkwNg==
 SHA512:
   metadata.gz: !binary |-
-    MWMzZDIxYzFiZjY3YmNkOGEwNTAyOWNmY2NhZTJiZTY5ZGQwMDQ3NGY2MmIx
-    YWY3OTI4Y2Y1ZWYzZjM5NDI1MmJiOTE2YzA5MmUxNmM2ZDczOWI4ZTNhMzcy
-    NmE2Nzk1MTUyNTMwYzg3Mjc3YWM0NDAxOGE0Njg1ZjM4OWE1NWM=
+    MGQ5N2Q1NDUxYzdmNTNkZjc0MTcxNDE1M2YzYWM4ZGM3OTk3MmQwMmFhYjM0
+    YmZmNjAxOWMyZjJkM2M2YzFjYWY1YzA4MmRkYjYxNjIxM2RhMmI3MjlhNzZi
+    NTE2YjAwYjk0MjY3ZmZmY2JiMGI3ZTZkNmYwZmI3MTIwMDU2NjY=
   data.tar.gz: !binary |-
-    ODhkMTFmZDM0ZjM4MTU0ZTc1NzM0NGNjNTRkNzMzM2Y1OWEyOWZmZTZiZWI0
-    NjkxMTg3OTc0NjVlYjA1MTZkZWQxNDg2ZDI1NGUwODRlOWVmZDUxYjU0Zjlk
-    ZGQyMTYwOGJkMTE2MjU3NmFiMmIwYzdlYjYwNjFmNDI0OWJlZjU=
+    NWI0OTkyZWIyOTc0Nzc1N2FhMDk5NGVkZmViZjI2NzQ2ZTE5MWJmYTg4Mzg1
+    NDUxNTBhZTE2YWZlOTVjNjRjNjc4YTk5ZjQ5NmE4NjA5NzFhYTQ1MDczNzVl
+    MDEzOGNiNjNmN2YwMzYwZGE1M2FiMDlhYTkxOWExOGVmNTMwMDA=

data/config.yml

@@ -2,7 +2,7 @@ dependencies:
   - brpm_module_brpm
   - brpm_module_jira
 
-version: 0.1.14
+version: 0.1.15
 
 author: Niek Bartholomeus
 email: niek.bartholomeus@gmail.com

data/lib/integrations/servicenow/README.md

@@ -0,0 +1,51 @@
+# Service-Now to BRPM integration
+## Intro
+This integration will automatically create a request in BRPM when a new change request is created in Service-Now. This is just a first step in integration Service-Now with BRPM. It can easily be extended to cover more complex integration needs. 
+
+## Getting started
+### Run the webhook receiver as a daemon
+This script should be used with a [webhook_receiver wrapper](https://github.com/BMC-RLM/brpm_content_framework/blob/master/infrastructure/scripts/run_webhook_receiver.sh). Set the environment variable ```WEBHOOK_RECEIVER_PROCESS_EVENT_SCRIPT``` to the location of this script and execute it in daemon mode: ```nohup ./run_webhook_receiver.sh &```
+
+### Create a request template in BRPM
+Create one or more request templates with the name "[Template] Self Service - <automation type>" where automation_type can be "Reboot server", etc.
+
+### Configuring Service-Now
+_ Create a new dropdown field for a change request with the name u_choice_automation_type and configure a nmber of choices like "Reboot server" etc.
+
+- Create an outbound REST Message and set the endpoint to http://your-server:port/webhooks (only the POST HTTP method is needed so you may delete the others)
+
+- In the POST HTTP method, specify the content you want to send to the process_webhook_receiver.rb script in json format and create variables substitutions for each of the variables
+
+You can use this content as an example:
+```
+{"change_request": {"number":"${number}", "automation_type":"${automation_type}", "cmdb_ci":"${cmdb_ci}"}}
+```
+
+- Copy the generated javascript code from the "Preview Script Usage" link
+ 
+- Create a business rule and have it trigger after a change request is created
+
+- Pass it the generated javascript code and adapt the field values to the change request's field 
+
+As an example of a javascript piece of code:
+```
+function onAfter(current, previous) {
+	try {
+		var r = new sn_ws.RESTMessageV2('BRPM', 'post');
+		r.setStringParameter('number', current.number);
+		r.setStringParameter('automation_type', current.u_choice_automation_type);
+		r.setStringParameter('cmdb_ci', current.cmdb_ci);
+		var response = r.execute();
+		var responseBody = response.getBody();
+		var httpStatus = response.getStatusCode();
+	}
+	catch(ex) {
+		var message = ex.getMessage();
+	}	
+}
+```
+
+Voila, we're all set. Now create a change request and see how it triggers a new request in BRPM!
+
+
+

data/lib/integrations/servicenow/process_webhook_event.rb

@@ -11,7 +11,7 @@ def process_event(event)
   request_params["target_path_or_servers"] = change_request["cmdb_ci"]
   request_params["change_request_number"] = change_request["number"]
 
-  @brpm_rest_client.create_request("[Template] Tieto Self Service - #{change_request["automation_type"]}", "Tieto Self Service - #{change_request["automation_type"]} - #{change_request["number"]}","Production", true, request_params)
+  @brpm_rest_client.create_request("[Template] Self Service - #{change_request["automation_type"]}", "Self Service - #{change_request["automation_type"]} - #{change_request["number"]}","Production", true, request_params)
 
   BrpmAuto.log "Finished processing the event."
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brpm_module_demo
 version: !ruby/object:Gem::Version
-  version: 0.1.14
+  version: 0.1.15
 platform: ruby
 authors:
 - Niek Bartholomeus
@@ -102,6 +102,7 @@ files:
 - lib/integrations/jenkins/spec/api/requests_spec.rb
 - lib/integrations/jenkins/spec/spec_helper.rb
 - lib/integrations/jira/process_webhook_event.rb
+- lib/integrations/servicenow/README.md
 - lib/integrations/servicenow/process_webhook_event.rb
 - lib/jira_mappings.rb
 - module.gemspec