{"type":"doc","content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://flexagon.atlassian.net/wiki/spaces/FD60/pages/9856632506"}},{"text":" and ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://flexagon.atlassian.net/wiki/spaces/FD60/pages/9856623813"}},{"text":" for additional details.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ServiceNow Instance Properties","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"3be503d5-909f-4f5b-9e13-1f9d23f5e776"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The URL for accessing ServiceNow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow User Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"local","type":"text","marks":[{"type":"underline"},{"type":"strong"}]},{"text":" ServiceNow service account user with a non-expiring password. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Password","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The password for the ServiceNow User Name above.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that encrypted properties are stored in Credential Store (Local or External) and can be configured using Edit button next to credential name drop down. Alternatively, you can reuse single credential for multiple properties also, in which case you should name that credential appropriately.","type":"text"}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"BasicAuth","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"OAuthResourceOwner","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Auth Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Authentication method for connecting to ServiceNow, BasicAuth, OAuthResourceOwner, OAuthJWTAssertion. Defaults to BasicAuth. ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Client ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The auto-generated unique ID of the application. The instance uses the client ID when requesting an access token.","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthResourceOwner","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Client Secret","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The shared secret string that both the instance and the client application use to authorize communications with one another. The instance uses the client secret when requesting an access token. (Encrypted). ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthResourceOwner","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Keystore Path","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Keystore Path (path to the jks file). ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Keystore Passphrase","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Java keystore passphrase for the ServiceNow Keystore (Encrypted). ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Certificate Alias","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Private certificate alias. ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Certificate Passphrase","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Passphrase for the ServiceNow Certificate (Encrypted). ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow JWT Verifier Map Key ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow JWT Verifier Map Key ID. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Certificate Algorithm","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Algorithm used for the certificate. Defaults to RS256.","type":"text"}]},{"type":"paragraph","content":[{"text":"Required for the following Auth Types, ","type":"text"},{"text":"OAuthJWTAssertion","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Refresh Token Lifespan","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Long","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The number of seconds that a refresh token is valid. The instance uses the lifespan value when requesting a refresh token. By default, refresh tokens expire in 100 days (8640000 seconds).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Request GET URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The URL to get the change request details as json response. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default URL is /api/now/table/change_request?sysparm_query=number%3D{SN_CHANGE_NUMBER}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If needed, you can change and use your custom GET url for ServiceNow REST endpoint. The URL should include {SN_CHANGE_NUMBER} string as the execution system will replace it with the actual change number during execution.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"e.g. /api/xyz/mycompanty_servicenow_generic_api/readChangeRequest?number%3{SN_CHANGE_NUMBER}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the response returned from this GET API contains an attribute called ","type":"text"},{"text":"description","type":"text","marks":[{"type":"strong"}]},{"text":" it will be mapped to the description of the linked ticket, otherwise the description on the links tab will appear as empty. Prior to ","type":"text"},{"text":"5.5.0.2","type":"text","marks":[{"type":"strong"}]},{"text":", an error would occur if the description field was not present in the payload returned from this GET API.","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Navigation Request URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The URL to open ServiceNow and navigate to the Change ticket associated to the project workflow execution","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default URL is /","type":"text"},{"text":"nav_to.do?uri=change_request.do?sysparm_query=number={SN_CHANGE_NUMBER","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":"}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The URL should include {SN_CHANGE_NUMBER} string as the execution system will replace it with the actual change number during execution.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"e.g. ","type":"text"},{"text":"https://.service-now.com/nav_to.do?uri=change_request.do?sysparm_query%3Dnumber%3DCHG0080007","type":"text","marks":[{"type":"link","attrs":{"href":"https://dev96954.service-now.com/nav_to.do?uri=change_request.do?sysparm_query%3Dnumber%3DCHG0040007"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"e.g., if you want to use Service Catalog, url will be like","type":"text"}]},{"type":"paragraph","content":[{"text":"https://.service-now.com/nav_to.do?uri=sc_request.do?sysparm_query%3Dnumber%3DREQ0067001","type":"text","marks":[{"type":"link","attrs":{"href":"https://dev96954.service-now.com/nav_to.do?uri=sc_request.do%3Fsysparm_query%3Dnumber%3DREQ0010001"}}]}]}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"ServiceNow Request POST URL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"The URL to create a change request. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Default URL is /api/now/table/change_request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If needed, you can change and use your custom url to create a new change using the POST operation","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if you want to use Service Catalog, then change the url to /api/now/table/sc_request","type":"text"}]}]}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"Approved Check Script","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"A Groovy expressions which determines whether a task for the change ticket is approved or not. The expression must return a boolean, and has access to the following variables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TICKET ","type":"text","marks":[{"type":"strong"}]},{"text":"- an object with fields (JSON) contained in the change ticket, as returned by the ServiceNow REST API. Fields are referenced as TICKET..","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_CODE","type":"text","marks":[{"type":"strong"}]},{"text":" - The environment for a particular deployment request or associated pipeline stage.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If the Approved Check Script is left blank, the default implementation is to return true if the \"approval\" field of the ticket is set to \"approved\".","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Simple Example which is used by default ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"TICKET.approval == 'approved'","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example that checks myfield value specific to target environment","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"(TICKET.myfield == 'UATApproved' && FD_ENVIRONMENT_CODE='UAT') || (TICKET.myfield == 'PRODApproved' && FD_ENVIRONMENT_CODE='PROD')","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If you want to see values that can be used, enable ","type":"text"},{"text":"FINEST","type":"text","marks":[{"type":"code"}]},{"text":" log level for ","type":"text"},{"text":"flexagon.fd.model.integration.cms.","type":"text","marks":[{"type":"code"}]},{"text":"CMSScript using ","type":"text"},{"text":"Admin Operations","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Following example is to check if current date time is between start_date and end_date defined on Ticket. Let's assume format for the date string returned and TimeZone as GMT.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Check if now is between start_date and end_date defined on ticket","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import java.util.Date;\nimport java.util.TimeZone;\nimport flexagon.ff.common.core.utils.FlexDateTimeUtils;\n\nif(TICKET.approval == 'approved' && TICKET.start_date != null && TICKET.end_date != null)\n{\n Date start = FlexDateTimeUtils.stringToDate(TICKET.start_date, \"yyyy-MM-dd HH:mm:ss\", TimeZone.getTimeZone(\"GMT\"));\n Date end = FlexDateTimeUtils.stringToDate(TICKET.end_date, \"yyyy-MM-dd HH:mm:ss\", TimeZone.getTimeZone(\"GMT\"));\n Date now = new Date();\n if(now.after(start) && now.before(end))\n {\n return true;\n }\n}\nreturn false;","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"Rejected Check Script","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"A Groovy expressions which determines whether a task for a change ticket is rejected or not. The expression must return a boolean, and as has access to the following variables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TICKET","type":"text","marks":[{"type":"strong"}]},{"text":" - an object with fields (JSON) contained in the change ticket, as returned by the ServiceNow REST API. Fields are referenced as TICKET..","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_CODE","type":"text","marks":[{"type":"strong"}]},{"text":" - The environment for a particular deployment request or associated pipeline stage.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"If the Rejected Check Script is left blank, the default implementation is to return true if the \"approval\" field of the ticket is set to \"rejected\".","type":"text"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Simple Example which is used by default ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"TICKET.approval == 'rejected'","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example that checks myfield value specific to target environment","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"(TICKET.myfield == 'UATRejected' && FD_ENVIRONMENT_CODE='UAT') || (TICKET.myfield == 'PRODRejected' && FD_ENVIRONMENT_CODE='PROD')","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"Additional Info Script","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"A Groovy expression which determines additional information to add to an external approval when it is approved or rejected. The expression must return a Map and have an entry with the key of \"notes\" for the value to get added to external approval as a task note. Script has access to the following variables:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TICKET","type":"text","marks":[{"type":"strong"}]},{"text":" - an object with fields (JSON) contained in the change ticket, as returned by the ServiceNow REST API. Fields are referenced as TICKET..","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_CODE","type":"text","marks":[{"type":"strong"}]},{"text":" - The environment for a particular deployment request or associated pipeline stage.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example where ServiceNow Approver(s) and time of approval are added to task notes ","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import flexagon.ff.common.core.rest.FlexRESTClient;\nimport flexagon.ff.common.core.rest.FlexRESTClientResponse;\nimport flexagon.ff.common.core.utils.FlexJsonUtils;\nimport flexagon.fd.model.integration.util.ApiException;\n \nimport org.json.JSONObject;\nimport org.json.JSONArray;\n \nimport java.util.HashMap;\nimport java.util.Map;\n \nimport javax.ws.rs.client.Entity;\nimport javax.ws.rs.core.Form;\nimport javax.ws.rs.core.MediaType;\n \ndef returnMap = [:]\ndef snowUrl = '{SN_URL}'\ndef user = '{SN_USER_NAME}'\ndef password = '{SN_PASSWORD}'\ndef resourcePath = '/api/now/table/sysapproval_approver?sysparm_display_value=all&sysparm_query=state%3Dapproved%5Edocument_id%3D' + TICKET.sys_id\n \ntry\n{\n FlexRESTClient restService = new FlexRESTClient();\n FlexRESTClientResponse response = restService.url(snowUrl).path(resourcePath).basicauth(user, password).mediatype(MediaType.APPLICATION_JSON).setValidateResponse(true).get();\n \n JSONObject jsonResponse = null;\n jsonResponse = FlexJsonUtils.getJSON(response.getResponseString());\n \n def listOfApprovers = jsonResponse.getJSONArray('result');\n for (int i = 0; i < listOfApprovers.length(); i++)\n {\n def approver = listOfApprovers.get(i);\n def linkRequestUrl = approver.getJSONObject('approver').getString('link')\n restService = new FlexRESTClient();\n response = restService.url(linkRequestUrl).basicauth(user, password).mediatype(MediaType.APPLICATION_JSON).setValidateResponse(true).get();\n\n jsonResponse = FlexJsonUtils.getJSON(response.getResponseString());\n jsonResponse = jsonResponse.getJSONObject('result')\n if (returnMap.isEmpty())\n {\n returnMap['notes'] = 'Approvers: ' + System.getProperty(\"line.separator\")\n }\n else\n {\n returnMap['notes'] = returnMap['notes'] + System.getProperty(\"line.separator\")\n }\n returnMap['notes'] = returnMap['notes'] + jsonResponse.getString('name') + ' (' + approver.getJSONObject('sys_updated_on').getString('display_value') + ')'\n }\n}\ncatch(Exception ex)\n{\n returnMap['notes'] = ex.getMessage()\n}\nreturn returnMap\n","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[204.0]},"content":[{"type":"paragraph","content":[{"text":"Don't Poll","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1500.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether FlexDeploy should poll ServiceNow to check the change tickets for Approval/Rejection. The default value is false, which means polling will occur. Only check this box if you are using the FlexDeploy REST API to communicate ticket approval/rejection.","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"ServiceNow Modules","type":"text"}]},{"type":"paragraph","content":[{"text":"Most common usage for ServiceNow is using the change request module, but other objects like service catalog request can be used by modifying the default GET, POST, and Nav URLs. If you plan to use a different module, for POST operation, use the tickets tab in the CMS configuration screen to add any additional fields required to create the object.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ServiceNow Ticket Fields","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"2d2f8d7d-d2bf-4792-a026-43dc85486468"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Field Code","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Display Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"Data Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"short_description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Short Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"A short description for the change ticket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"description ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph","content":[{"text":"A description for the change ticket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"state","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"State","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"sys_class_name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Sys Class Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"approval","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Approval","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"start_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Planned Start Date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"end_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Planned End Date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"closed_by","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Closed By","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"impact","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Impact","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"priority","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Priority","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"risk","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Risk","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"requested_by","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Requested By","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"assignment_group","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Assignment Group","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"assigned_to","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Assigned To","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"cmdb_ci","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"CI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[104.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[404.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[81.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[74.0]},"content":[{"type":"paragraph","content":[{"text":"No","type":"text"}]}]}]}]}],"version":1}

Browser not supported