{"type":"doc","content":[{"type":"paragraph","content":[{"text":"FlexDeploy has out of box integration with ServiceNow, BMC Remedyforce, Freshworks Freshservice, and Jira ITSM, and provides a framework to enable custom integrations with other change management systems. Such third-party Change Management System integrations can be enabled using a Java or Groovy implementation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Navigate to the ","type":"text"},{"text":"Change Management Systems","type":"text","marks":[{"type":"em"}]},{"text":" page from the ","type":"text"},{"text":"Administration -> Integrations -> Change Management Systems","type":"text","marks":[{"type":"strong"}]},{"text":" menu. Here you will see the out of the box integrations.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":1891,"id":"fcbed1d0-87b0-4dad-ba9e-4a89106c596c","collection":"contentId-9856632320","type":"file","height":457}}]},{"type":"paragraph","content":[{"text":"To create a custom integration for another provider click the ","type":"text"},{"text":"Create ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"button. The following tasks will be performed to complete the integration:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a unique name and description.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Determine whether you will implement the integration in Java or Groovy. Groovy has the advantage that the script is loaded dynamically and does not require a FlexDeploy server recycle when you make changes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define properties for the new change management system. Properties are configuration values used by FlexDeploy to connect to the new system and parameterize its usage. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define Ticket Fields as necessary, which are used to create Ticket or Incidents automatically from FlexDeploy.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Develop either a Java class or Groovy script to perform the integration.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The examples below demonstrate a custom integration for Zendesk using both Java and Groovy.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Properties","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"tab defines the metadata for parameters necessary to both connect to the underlying system and provide configurable options for any instances which will consume this integration.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"URL, credentials, and other connection related parameters should be exposed as properties so that the configuration can be updated without changes to the Java or Groovy classes/scripts.","type":"text"}]},{"type":"paragraph","content":[{"text":"For customers providing your own integrations you may choose to hard-code some of the logic into the scripts to follow enterprise standards for your organization. For Systems Integrators who are developing solutions which may be utilized by multiple customers it is important to make use of properties where appropriate to allow simple configuration based on end customer requirements.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":100.0},"content":[{"type":"media","attrs":{"width":1912,"id":"f7de3c0b-ac47-413a-9391-fb69e269c6b7","collection":"contentId-9856632320","type":"file","height":921}}]},{"type":"paragraph","content":[{"text":"The metadata for each property consists of the following attributes:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"f3e9e62d-667a-4561-9f51-a6ae36979f2d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Active","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"Whether this property is in use for the integration. Allows hiding the property without removing it.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Key Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"A unique name which is used by the API and other scripts, and therefore must following keyword limitations of Java and Groovy (e.g. no spaces or special characters other than underscore).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Display Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"A name for the property which will be displayed for data entry rather than the technical Key Name.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"A meaningful description of what the property is used for. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Data Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"The data type for the property. Supported types - ","type":"text"},{"text":"String","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Boolean","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Integer","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"Double","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Sub-Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"An optional qualifier describing the type of data the property will contain. This is used to validate the data entry. Supported types - ","type":"text"},{"text":"URL","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"JDBCURL","type":"text","marks":[{"type":"em"}]},{"text":", or ","type":"text"},{"text":"Directory","type":"text","marks":[{"type":"em"}]},{"text":". Simply leave blank if none of these qualifiers are applicable.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"Whether or not a value for the property is required for CMS instances using this provider. Implementations should use default values in the Java/Groovy class or script for any optional properties.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[162.0]},"content":[{"type":"paragraph","content":[{"text":"Encrypted","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1278.0]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the property is secure and should be encrypted when stored, and care should be taken not to print their values in the logs.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Values for these properties will be provided when instances of this CMS are created.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"API Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom integrations must implement the following API operations:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"08ad79fc-d1de-4742-b557-b4c2420eaa61"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"Method Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"Parameter(s)","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"Return Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"createTicket","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"Map pTicketFields","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"void","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Creates a Change Request ticket using the pDescription and pComment","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"createIncident","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"Map pTicketFields","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Creates an Incident ticket using the pDescription and pComment","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"findCMSObjectByType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"String pCMSObjectNumber","type":"text"}]},{"type":"paragraph","content":[{"text":"ChangeManagementSystem.CMSObjectType pCMSObjectType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"void","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Find a \"ticket\" or \"incident\" using the object identifier and type. The object type will be TICKET or INCIDENT, and implementations must translate that into the corresponding object type within the provider (e.g. Problem, Request, etc.) ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"isTicketApproved","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"CMSObject pTicket","type":"text"}]},{"type":"paragraph","content":[{"text":"String pEnvironmentCode","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether the ticket is approved in the CMS. ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"isTicketRejected","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"CMSObject pTicket","type":"text"}]},{"type":"paragraph","content":[{"text":"String pEnvironmentCode","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"Boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether the ticket is rejected in the CMS.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"checkConnection","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"void","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"This method should invoke any status or heath check URL of the change management system to ensure the system is up and running and a connection can be authenticated. This method will be called when the ","type":"text"},{"text":"Test Connection","type":"text","marks":[{"type":"em"}]},{"text":" button is clicked on the ","type":"text"},{"text":"CMS Instance","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"isDoPolling","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"N/A","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"void","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"Returns whether FlexDeploy should automatically poll the CMS to identify whether the ticket is approved or rejected. If polling is enabled FlexDeploy will lookup the ticket every 1 minute using ","type":"text"},{"text":"findCMSObjectByType","type":"text","marks":[{"type":"em"}]},{"text":" and then check the status using the ","type":"text"},{"text":"isTicketApproved","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"isTicketRejected","type":"text","marks":[{"type":"em"}]},{"text":" methods.","type":"text"}]},{"type":"paragraph","content":[{"text":"If polling is not enabled, the CMS or another external system is responsible for approving/rejecting the associated task using the FlexDeploy REST API.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[211.0]},"content":[{"type":"paragraph","content":[{"text":"getTicketURL","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[526.0]},"content":[{"type":"paragraph","content":[{"text":"CMSObject pCMSObject","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[172.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[531.0]},"content":[{"type":"paragraph","content":[{"text":"returns the REST API url of the change ticket","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"If your usage of the CMS will not include the automated creation of TICKET or INCIDENT objects the API can be simplified. Although createTicket and createIncident are required to be implemented, if you are not using these auto-creation features you can choose to simply throw an exception from one or both methods as appropriate.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"throw new UnsupportedOperationException(\"createIncident is not supported for Zendesk CMS integration\");","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Add custom task notes","type":"text"}]},{"type":"paragraph","content":[{"text":"With out-of-the-box CMS providers including BMCHelixRemedyforce, ServiceNow, JiraITSM, and Freshworks, you have the ability to add notes to a FlexDeploy External Approval upon approval or rejection. Custom Change Management Systems have the same functionality. Can do so by overriding the following ","type":"text"},{"text":"getAdditionalTicketInfo","type":"text","marks":[{"type":"em"}]},{"text":" in your Groovy API. It takes CMSObject and environment code as parameters and must return a Map.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Simple Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"def getAdditionalTicketInfo(CMSObject pTicket, String pEnvironmentCode)\n{\n // Create notes to add to External Approval\n def changeNumber = pTicket.getNumber()\n def map = {'notes': 'Approval note for ' changeNumber + ' added by FD admin'}\n return map\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Java Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are high level steps for Java implementation. You can use any IDE to prepare this implementation. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create java class that extends ","type":"text"},{"text":"flexagon.fd.model.integration.cms.api.ChangeManagementSystem","type":"text","marks":[{"type":"em"}]},{"text":". Example shown below has the methods implemented which uses properties map to retrieve the configuration values to connect to the change management system.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All properties defined are available in Map returned by getProperties method.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We are using ","type":"text"},{"text":"Zendesk ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"as a use case","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"package mycompany.extension.flexdeploy.zendesk;\n\n\nimport flexagon.fd.model.integration.cms.api.CMSObject;\nimport flexagon.fd.model.integration.cms.api.ChangeManagementSystem;\nimport flexagon.fd.model.integration.util.ApiException;\n\nimport java.io.Serializable;\nimport java.io.StringReader;\n\nimport java.util.Date;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.logging.Level;\nimport java.util.logging.Logger;\n\nimport javax.json.Json;\nimport javax.json.JsonObject;\nimport javax.json.JsonObjectBuilder;\nimport javax.json.JsonReader;\n\nimport javax.ws.rs.client.Client;\nimport javax.ws.rs.client.ClientBuilder;\nimport javax.ws.rs.client.Entity;\nimport javax.ws.rs.client.WebTarget;\nimport javax.ws.rs.core.MediaType;\nimport javax.ws.rs.core.Response;\n\nimport org.glassfish.jersey.client.ClientConfig;\nimport org.glassfish.jersey.client.ClientProperties;\nimport org.glassfish.jersey.filter.LoggingFilter;\n\npublic class ZendeskServiceIntegration\n extends ChangeManagementSystem\n{\n private static final String CLZ_NAM = ZendeskServiceIntegration.class.getName();\n private Logger mLogger;\n private Client mRestClient;\n private String mAccessToken;\n\n public ZendeskServiceIntegration()\n {\n super();\n this.mLogger = Logger.getLogger(CLZ_NAM);\n }\n\n private void getOAuthAccessToken(String pScope)\n throws ApiException\n {\n String methodName = \"getOAuthAccessToken\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n JsonObjectBuilder zenOAuthRequestJson = Json.createObjectBuilder();\n zenOAuthRequestJson.add(\"grant_type\", \"password\");\n zenOAuthRequestJson.add(\"client_id\", getClientId());\n zenOAuthRequestJson.add(\"client_secret\", getClientSecret());\n zenOAuthRequestJson.add(\"username\", getUserName());\n zenOAuthRequestJson.add(\"password\", getPassword());\n zenOAuthRequestJson.add(\"scope\", pScope);\n String payLoad = zenOAuthRequestJson.build().toString();\n Response clientResponse =\n getRestClient().target(getZendeskDomain()).path(getOAuthURI()).request(MediaType.APPLICATION_JSON_TYPE).accept(MediaType.APPLICATION_JSON_TYPE).post(Entity.json(payLoad));\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"OAuth Response \" + jsonResponseObject);\n mAccessToken = jsonResponseObject.getString(\"access_token\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n }\n\n private String getAccessToken(String pScope)\n throws ApiException\n {\n getOAuthAccessToken(pScope);\n return \"Bearer \" + mAccessToken;\n }\n\n private String getOAuthURI()\n {\n return getPropertyAsString(\"ZD_OAUTH_URI\");\n }\n\n private String getClientId()\n {\n return getPropertyAsString(\"ZD_CLIENT_ID\");\n }\n\n private String getClientSecret()\n {\n return getPropertyAsString(\"ZD_CLIENT_SECRET\");\n }\n\n @Override\n public CMSObject createTicket(Map pTicketFields)\n throws ApiException\n {\n String methodName = \"createRequest\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \" Creating new Request using \" + pTicketFields);\n CMSObject request = postTicket(\"request\", \"ZD_REQUEST_CREATE_PATTERN\", \"requests:write read\", pTicketFields);\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return request;\n }\n\n private CMSObject postTicket(String pObjectType, String pURLKey, String pScope, Map pTicketFields)\n throws ApiException\n {\n String methodName = \"postTicket\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n JsonObjectBuilder zenInputJson = Json.createObjectBuilder();\n Serializable requestor = pTicketFields.remove(\"requester_id\");\n JsonObjectBuilder reqParamJsonBuider = null;\n if (requestor != null)\n {\n reqParamJsonBuider = Json.createObjectBuilder();\n reqParamJsonBuider.add(\"name\", requestor.toString());\n }\n Serializable description = pTicketFields.remove(\"description\");\n JsonObjectBuilder desParamJsonBuider = null;\n if (description != null)\n {\n desParamJsonBuider = Json.createObjectBuilder();\n desParamJsonBuider.add(\"body\", description.toString());\n }\n JsonObjectBuilder inputJsonObject = buildJsonRequest(pTicketFields);\n if (requestor != null)\n {\n inputJsonObject.add(\"requester\", reqParamJsonBuider.build());\n }\n if (description != null)\n {\n inputJsonObject.add(\"comment\", desParamJsonBuider.build());\n }\n zenInputJson.add(pObjectType, inputJsonObject);\n WebTarget postRequest = getWebResource(getPropertyAsString(pURLKey));\n String payLoad = zenInputJson.build().toString();\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Creating new %s %s\", pObjectType, payLoad));\n Response clientResponse = postRequest.request(MediaType.APPLICATION_JSON_TYPE).accept(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(pScope)).post(Entity.json(payLoad));\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n JsonObject requestResponseJson = jsonResponseObject.getJsonObject(pObjectType);\n CMSObject request = createTicketFromJson(requestResponseJson, ChangeManagementSystem.CMSObjectType.TICKET);\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Successfully created ticket %s\", request.getNumber()));\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return request;\n }\n\n private CMSObject createTicketFromJson(JsonObject jsonObject, CMSObjectType pType)\n {\n String methodName = \"createTicketFromJson\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n\n CMSObject ticket = CMSObjectImpl.getInstance(String.valueOf(jsonObject.getInt(\"id\")), pType, jsonObject, jsonObject.getString(\"description\"));\n\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return ticket;\n }\n\n private JsonObject readJsonObject(String source)\n {\n String methodName = \"readJsonObject\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n JsonReader jsonReader = Json.createReader(new StringReader(source));\n JsonObject object = null;\n try\n {\n object = jsonReader.readObject();\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Json object created for response = %s\", source));\n }\n catch (Exception e)\n {\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Exception while creating response json object, error %s, response = %s\", e.getMessage(), source));\n }\n finally\n {\n if (jsonReader != null)\n {\n jsonReader.close();\n }\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return object;\n }\n\n @Override\n public CMSObject createIncident(Map pIncidentFields)\n {\n String methodName = \"createIncident\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n CMSObject request = null;\n try\n {\n request = postTicket(\"ticket\", \"ZD_TICKET_CREATE_PATTERN\", \"tickets:write read\", pIncidentFields);\n }\n catch (ApiException e)\n {\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Exception while creating incident, error %s\", e.getMessage()));\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return request;\n }\n\n @Override\n public CMSObject findCMSObjectByType(String pRequestNumber, ChangeManagementSystem.CMSObjectType pRequestType)\n throws ApiException\n {\n String methodName = \"findCMSObjectByType\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n CMSObject changeRequest = getChangeRequest(pRequestNumber);\n if (changeRequest != null && changeRequest.getTypeName().equalsIgnoreCase(\"QUESTION\") && pRequestType.equals(ChangeManagementSystem.CMSObjectType.TICKET))\n {\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, pRequestNumber + \" is of type QUESTION, setting it as REQUEST for FD\");\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return getChangeRequest(pRequestNumber);\n }\n\n private CMSObject getChangeRequest(String pRequestNumber)\n throws ApiException\n {\n return getTicket(\"request\", \"ZD_REQUEST_GET_PATTERN\", pRequestNumber, \"{ZENDESK_REQUEST}\");\n }\n\n\n private CMSObject getTicket(String pObjectType, String pURLKey, String pRequestNumber, String pSearchPattern)\n throws ApiException\n {\n String methodName = \"getTicket\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Find Ticket [%s] \", pRequestNumber));\n\n //Zendesk Get Request URL Pattern (/api/v2/requests/{ZENDESK_REQUEST}.json)\n String urlString = getPropertyAsString(pURLKey);\n\n urlString = urlString.replace(pSearchPattern, pRequestNumber);\n Response clientResponse = getWebResource(urlString).request(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(\"tickets:write read\")).get(Response.class);\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n JsonObject ticketResponseJson = jsonResponseObject.getJsonObject(pObjectType);\n CMSObject request = createTicketFromJson(ticketResponseJson, ChangeManagementSystem.CMSObjectType.TICKET);\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Successfully found ticket %s\", request.getNumber()));\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return request;\n }\n\n @Override\n public Boolean isTicketApproved(CMSObject requestNumber, String environmentCode)\n {\n String methodName = \"isTicketApproved\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n CMSObject findRequest = requestNumber;\n Boolean approved = false;\n try\n {\n if (findRequest != null)\n {\n String status = findRequest.getJson().getString(\"status\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\"#[%s] status [%s]\", requestNumber, status));\n if (\"solved\".equalsIgnoreCase(status))\n {\n approved = true;\n }\n }\n }\n catch (Exception e)\n {\n // TODO: Add catch code\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return approved;\n }\n\n\n @Override\n public Boolean isTicketRejected(CMSObject requestNumber, String environmentCode)\n {\n String methodName = \"isTicketRejected\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n CMSObject findRequest = requestNumber;\n Boolean rejected = false;\n try\n {\n if (findRequest != null)\n {\n String status = findRequest.getJson().getString(\"status\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\"#[%s] status [%s]\", requestNumber, status));\n if ((!\"New\".equalsIgnoreCase(status)) && (\"on-hold\".equalsIgnoreCase(status) || \"Closed\".equalsIgnoreCase(status)))\n {\n rejected = true;\n }\n }\n }\n catch (Exception e)\n {\n // TODO: Add catch code\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n return rejected;\n }\n\n @Override\n public Boolean isDoPolling()\n {\n return false;\n }\n\n @Override\n public void checkConnection()\n throws ApiException\n {\n String methodName = \"checkConnection\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"ENTRY\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \" getting user details to check connection\");\n // ClientResponse clientResponse = getWebResource(\"/api/v2/users/me.json\").header(\"Authorization\", \"Basic \" + getAuthString()).get(ClientResponse.class);\n Response clientResponse = getWebResource(\"/api/v2/users/me.json\").request(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(\"organizations:write read\")).get(Response.class);\n checkResponse(clientResponse);\n String responseString = clientResponse.readEntity(String.class);\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"responseString=\" + responseString + \", Validated that JSON data was received from test connction URL invocation.\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n }\n\n private StringBuilder getZendeskURLBuilder()\n {\n StringBuilder urlBuilder = new StringBuilder(getPropertyAsString(\"ZD_DOMAIN_NAME\"));\n return urlBuilder;\n }\n\n private void checkResponse(Response clientResponse)\n throws ApiException\n {\n String methodName = \"checkResponse\";\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, String.format(\" Response %s\", clientResponse));\n int statusCode = clientResponse.getStatusInfo().getStatusCode();\n if (statusCode == 401)\n {\n throw new ApiException(\"Invalid credentials.\", \"\");\n }\n if (statusCode == 500)\n {\n //record not found or other scenarious don't want to fail.\n return;\n }\n if (!(clientResponse.getStatusInfo().getFamily() == Response.Status.Family.SUCCESSFUL))\n {\n throw new ApiException(clientResponse.toString(), clientResponse.getStatusInfo().getReasonPhrase());\n }\n mLogger.logp(Level.INFO, mLogger.getName(), methodName, \"EXIT\");\n }\n\n private String getZendeskDomain()\n {\n return getZendeskURLBuilder().toString();\n }\n\n private String getUserName()\n {\n String userName = getPropertyAsString(\"ZD_USER_NAME\");\n return userName;\n }\n\n private String getPassword()\n {\n String pwd = getPropertyAsString(\"ZD_PASSWORD\");\n return pwd;\n }\n\n private String getPropertyAsString(String pKey)\n {\n return (String) getProperties().get(pKey);\n }\n\n private Client getRestClient()\n throws ApiException\n {\n if (mRestClient == null)\n {\n mRestClient = ClientBuilder.newClient(new ClientConfig().register(LoggingFilter.class));\n mRestClient.property(ClientProperties.CONNECT_TIMEOUT, 10000);\n mRestClient.property(ClientProperties.READ_TIMEOUT, 20000);\n }\n return mRestClient;\n }\n\n public WebTarget getWebResource(String resource)\n throws ApiException\n {\n if (resource != null && !resource.isEmpty() && !resource.startsWith(\"/\"))\n {\n resource += \"/\" + resource;\n }\n WebTarget webResource = null;\n try\n {\n webResource = getRestClient().target(getZendeskDomain()).path(resource);\n }\n catch (Exception e)\n {\n throw new ApiException(e.getMessage(), e.getMessage());\n }\n\n return webResource;\n }\n\n protected JsonObjectBuilder buildJsonRequest(Map pFields)\n {\n JsonObjectBuilder jsonBuider = Json.createObjectBuilder();\n\n for (String fieldKey: pFields.keySet())\n {\n Serializable fieldValue = pFields.get(fieldKey);\n\n if (fieldValue != null)\n {\n if (fieldValue instanceof String)\n {\n jsonBuider.add(fieldKey, (String) fieldValue);\n }\n else if (fieldValue instanceof Boolean)\n {\n jsonBuider.add(fieldKey, (Boolean) fieldValue);\n }\n else if (fieldValue instanceof Integer)\n {\n jsonBuider.add(fieldKey, (Integer) fieldValue);\n }\n else if (fieldValue instanceof Float)\n {\n jsonBuider.add(fieldKey, (Float) fieldValue);\n }\n else if (fieldValue instanceof Double)\n {\n jsonBuider.add(fieldKey, (Double) fieldValue);\n }\n else if (fieldValue instanceof Long)\n {\n jsonBuider.add(fieldKey, (Long) fieldValue);\n }\n else\n {\n // convert to String if type unknown\n jsonBuider.add(fieldKey, fieldValue.toString());\n }\n }\n }\n return jsonBuider;\n }\n \n public String getTicketURL(CMSObject pCMSObject)\n {\n\tString methodName = \"getTicketURL()\";\n\tlog.logFinestEntering(methodName, pCMSObject);\n\tStringBuilder tickerUrlBuilder = new StringBuilder();\n\tif(pCMSObject != null)\n\t{\n\t\ttickerUrlBuilder.append(getZendeskDomain());\n\t\tString urlString = getPropertyAsString(\"ZD_REQUEST_GET_PATTERN\");\n\t\tString changeRequestURI = urlString.replace(\"{ZENDESK_REQUEST}\"), pCMSObject.getNumber());\n\t\ttickerUrlBuilder.append(changeRequestURI);\n\t}\n String url = tickerUrlBuilder.toString();\n\tlog.logFinestExiting(methodName, url);\n return url;\n } \n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In order to compile your java class, you will need ","type":"text"},{"text":"FlexDeployAPI.jar","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/download/attachments/9856632320/FlexDeployAPI.jar?version=1&modificationDate=1598500920217&cacheVersion=1&api=v2"}}]},{"text":" on classpath.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement all the methods described in the table in the API Implementation section.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For any failure connecting to the system or if any issues with the data, then you can throw exception. For example ","type":"text"},{"text":"throw new ApiException(\"Invalid credentials.\", \"\");","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once you are ready with unit testing, you can prepare Jar file for your credential store java class and other utility classes. This jar file can be placed on server classpath now.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For Tomcat, put this jar file in ","type":"text"},{"text":"apache-tomcat-flexdeploy/lib","type":"text","marks":[{"type":"em"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For WebLogic, put this jar file in Domain lib folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are using any third-party libraries from your Java implementation, then those jar files will also need to be added to same lib folder. Keep in mind that this can cause issues with server functioning, so be prepared to remove your additional library files.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To pickup changes to your API, the FlexDeploy server must be restarted.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Groovy Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are high level steps for Groovy implementation. You can use any IDE to prepare this implementation. ","type":"text"}]},{"type":"paragraph","content":[{"text":"As groovy is able to access FlexDeploy variables and Java classes, you can take advantage of Java libraries from Groovy script. For example, if there is Java library used to access the change management system, you can places those in lib folder and use those classes from Groovy script. This allows you to keep dynamic part of implementation in Groovy and use Java library.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a groovy class. Example shown below has the methods implemented.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We are using ","type":"text"},{"text":"Zendesk ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"as a use case","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All properties defined are available as groovy binding variables. For example, properties can be accessed directly like BMC_DOMAIN_NAME, BMC_SALESFORCE_HOST_NAME or BMC_USER_NAME etc","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import flexagon.fd.model.integration.cms.api.CMSObject;\nimport flexagon.fd.model.integration.cms.api.ChangeManagementSystem;\nimport flexagon.fd.model.integration.util.ApiException;\n\nimport java.io.Serializable;\nimport java.io.StringReader;\n\nimport java.util.Date;\nimport java.util.HashMap;\nimport java.util.Map;\nimport java.util.logging.Level;\nimport java.util.logging.Logger;\n\nimport javax.json.Json;\nimport javax.json.JsonObject;\nimport javax.json.JsonObjectBuilder;\nimport javax.json.JsonReader;\n\nimport javax.ws.rs.client.Client;\nimport javax.ws.rs.client.ClientBuilder;\nimport javax.ws.rs.client.Entity;\nimport javax.ws.rs.client.WebTarget;\nimport javax.ws.rs.core.MediaType;\nimport javax.ws.rs.core.Response;\n\nimport org.glassfish.jersey.client.ClientConfig;\nimport org.glassfish.jersey.client.ClientProperties;\nimport org.glassfish.jersey.client.HttpUrlConnectorProvider;\nimport org.glassfish.jersey.filter.LoggingFilter;\nimport flexagon.fd.model.integration.cms.impl.CMSObjectImpl\n\n\nclass ZendeskGroovyIntegration {\n def className = ZendeskGroovyIntegration.class.getName();\n String mAccessToken;\n Client mRestClient;\n def now = new Date(); \n \n private void getOAuthAccessToken(String pScope)\n throws ApiException\n {\n JsonObjectBuilder zenOAuthRequestJson = Json.createObjectBuilder();\n zenOAuthRequestJson.add(\"grant_type\", \"password\");\n zenOAuthRequestJson.add(\"client_id\", getClientId());\n zenOAuthRequestJson.add(\"client_secret\", getClientSecret());\n zenOAuthRequestJson.add(\"username\", getUserName());\n zenOAuthRequestJson.add(\"password\", getPassword());\n zenOAuthRequestJson.add(\"scope\", pScope);\n String payLoad = zenOAuthRequestJson.build().toString();\n Response clientResponse =\n getRestClient().target(getZendeskDomain()).path(getOAuthURI()).request(MediaType.APPLICATION_JSON_TYPE).accept(MediaType.APPLICATION_JSON_TYPE).post(Entity.json(payLoad));\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n System.out.println(\"OAuth Response \" + jsonResponseObject);\n mAccessToken = jsonResponseObject.getString(\"access_token\");\n }\n \n private void checkResponse(Response clientResponse)\n throws ApiException\n {\n String methodName = \"checkResponse\";\n log.logFinestEntering(methodName, clientResponse); \n print(methodName + String.format(\" Invoked connection URL %s\", clientResponse));\n int statusCode = clientResponse.getStatusInfo().getStatusCode();\n if (statusCode == 401)\n {\n throw new ApiException(\"Invalid credentials.\", \"\");\n }\n if (!(clientResponse.getStatusInfo().getFamily() == Response.Status.Family.SUCCESSFUL))\n {\n throw new ApiException(clientResponse.toString(), clientResponse.getStatusInfo().getReasonPhrase());\n }\n log.logFinestExiting(methodName); \n }\n \n def createTicket(Map pTicketFields)\n {\n String methodName = \"createTicket\"; \n log.logFinestEntering(methodName, pTicketFields); \n CMSObject ticket = postTicket(\"request\", ZD_REQUEST_CREATE_PATTERN, \"question\", \"requests:write read\", pTicketFields);\n log.logFinestExiting(methodName, ticket); \n return ticket;\n }\n \n private CMSObject postTicket(String pObjectType, String pURLKey, String pTicketType, String pScope, Map pTicketFields)\n throws ApiException\n {\n String methodName = \"postTicket\";\n log.logFinestEntering(methodName, pTicketFields); \n JsonObjectBuilder zenInputJson = Json.createObjectBuilder();\n\tSerializable requestor = pTicketFields.remove(\"requester_id\");\n\tJsonObjectBuilder reqParamJsonBuider = null\n\tif(requestor != null)\n\t{\n\t reqParamJsonBuider = Json.createObjectBuilder();\n\t reqParamJsonBuider.add(\"name\", requestor.toString())\n\t}\n\tSerializable description = pTicketFields.remove(\"description\");\n\tJsonObjectBuilder desParamJsonBuider = null\n\tif(description != null)\n\t{\n\t desParamJsonBuider = Json.createObjectBuilder();\n\t desParamJsonBuider.add(\"body\", description.toString())\n\t}\n\tJsonObjectBuilder inputJsonObject = buildJsonRequest(pTicketFields)\n\tif(requestor != null)\n\t{\n\t\tinputJsonObject.add(\"requester\", reqParamJsonBuider.build())\n\t}\n\tif(description != null)\n\t{\n\t\tinputJsonObject.add(\"comment\", desParamJsonBuider.build())\n\t}\n zenInputJson.add(pObjectType, inputJsonObject);\n\n WebTarget postRequest = getWebResource(pURLKey);//getPropertyAsString(pURLKey)\n String payLoad = zenInputJson.build().toString();\n print(methodName + String.format(\" Creating new %s %s\", pObjectType, payLoad));\n Response clientResponse = postRequest.request(MediaType.APPLICATION_JSON_TYPE).accept(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(pScope)).post(Entity.json(payLoad));\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n JsonObject requestResponseJson = jsonResponseObject.getJsonObject(pObjectType);\n CMSObject request = createTicketFromJson(requestResponseJson, ChangeManagementSystem.CMSObjectType.TICKET);\n print(methodName + String.format(\" Successfully created ticket %s\", request.getNumber()));\n log.logFinestExiting(methodName, request); \n return request;\n }\n \n private CMSObject createTicketFromJson(JsonObject jsonObject, ChangeManagementSystem.CMSObjectType pType)\n {\n String methodName = \"createTicketFromJson\";\n log.logFinestEntering(methodName, jsonObject, pType); \n\n CMSObject ticket = CMSObjectImpl.getInstance(String.valueOf(jsonObject.getInt(\"id\")), pType, jsonObject, jsonObject.getString(\"description\"));\n\n log.logFinestExiting(methodName, ticket); \n return ticket;\n }\n\n private JsonObject readJsonObject(String source)\n {\n String methodName = \"readJsonObject\";\n log.logFinestEntering(methodName, source); \n JsonReader jsonReader = Json.createReader(new StringReader(source));\n JsonObject object = null;\n try\n {\n object = jsonReader.readObject();\n print(methodName + String.format(\" Json object created for response = %s\", source));\n }\n catch (Exception e)\n {\n print(methodName + String.format(\" Exception while creating response json object, error %s, response = %s\", e.getMessage(), source));\n print(methodName + \" - \" + e.getStackTrace());\n }\n finally\n {\n if (jsonReader != null)\n {\n jsonReader.close();\n }\n }\n log.logFinestExiting(methodName, object); \n return object;\n }\n \n def createIncident(Map pIncidentFields)\n {\n String methodName = \"createIncident\"; \n log.logFinestEntering(methodName, pIncidentFields);\n CMSObject incident = postTicket(\"ticket\", ZD_TICKET_CREATE_PATTERN, \"incident\", \"tickets:write read\", pIncidentFields);\n log.logFinestExiting(methodName, incident);\n return incident;\n }\n \n def findCMSObjectByType(String pCMSObjectNumber, ChangeManagementSystem.CMSObjectType pCMSObjectType)\n {\n String methodName = \"findCMSObjectByType\";\n log.logFinestEntering(methodName, pCMSObjectNumber, pCMSObjectType);\n\tCMSObject ticket = getChangeRequest(pCMSObjectNumber);\n log.logFinestExiting(methodName, ticket);\n return ticket;\n }\n \n private CMSObject getChangeRequest(String pRequestNumber)\n throws ApiException\n {\n return getTicket(\"request\", ZD_REQUEST_GET_PATTERN, pRequestNumber, \"{ZENDESK_REQUEST}\");\n }\n \n private CMSObject getTicket(String pObjectType, String pURLKey, String pRequestNumber, String pSearchPattern)\n throws ApiException\n {\n String methodName = \"getTicket\";\n log.logFinestEntering(methodName);\n\n String urlString = pURLKey;//getPropertyAsString(pURLKey);\n\n urlString = urlString.replace(pSearchPattern, pRequestNumber);\n Response clientResponse = getWebResource(urlString).request(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(\"tickets:write read\")).get(Response.class);\n checkResponse(clientResponse);\n JsonObject jsonResponseObject = readJsonObject(clientResponse.readEntity(String.class));\n JsonObject ticketResponseJson = jsonResponseObject.getJsonObject(pObjectType);\n CMSObject ticket = createTicketFromJson(ticketResponseJson, ChangeManagementSystem.CMSObjectType.TICKET);\n print(methodName + String.format(\" Successfully found ticket %s\", ticket.getNumber()));\n log.logFinestExiting(methodName, ticket);\n return ticket;\n }\n \n def findTicketByType(String pTicketNumber)\n {\n String methodName = \"findTicketByType\";\n log.logFinestEntering(methodName, pTicketNumber);\n CMSObject ticket = findCMSObjectByType(pTicketNumber, ChangeManagementSystem.CMSObjectType.TICKET);\n log.logFinestExiting(methodName, ticket);\n return ticket;\n }\n\n def isTicketApproved(CMSObject pTicket, String pEnvironmentCode)\n {\n String methodName = \"isTicketApproved\";\n log.logFinestEntering(methodName, pTicket, pEnvironmentCode);\n CMSObject findRequest = pTicket;\n Boolean approved = false;\n try\n {\n if (findRequest != null)\n {\n String status = findRequest.getJson().getString(\"status\");\n print(String.format(\"#[%s] status [%s]\", pTicket.getNumber(), status));\n if (\"solved\".equalsIgnoreCase(status))\n {\n approved = true;\n }\n }\n }\n catch (Exception e)\n {\n // TODO: Add catch code\n }\n log.logFinestExiting(methodName, approved);\n return approved;\n }\n \n def isTicketRejected(CMSObject pTicket, String pEnvironmentCode)\n {\n String methodName = \"isTicketRejected()\";\n log.logFinestEntering(methodName, pTicket, pEnvironmentCode);\n CMSObject findRequest = pTicket;\n Boolean rejected = false;\n try\n {\n if (findRequest != null)\n {\n String status = findRequest.getJson().getString(\"status\");\n print(String.format(\"#[%s] status [%s] script[%s]\", pTicket.getNumber(), status, ZD_REJECTED_SCRIPT));\n if ((!\"New\".equalsIgnoreCase(status)) && (\"on-hold\".equalsIgnoreCase(status) || \"pending\".equalsIgnoreCase(status)))\n {\n rejected = true;\n }\n }\n }\n catch (Exception e)\n {\n // TODO: Add catch code\n }\n log.logFinestExiting(methodName, rejected);\n return rejected;\n }\n \n def isDoPolling()\n {\n String methodName = \"isDoPolling()\";\n log.logFinestEntering(methodName);\n\tboolean flag = true;\n log.logFinestExiting(methodName, flag);\n\treturn flag;\n }\n \n private void print(String pText)\n {\n System.out.println(String.format(\"%s %s\", now.toString(), pText));\n }\n\n private String getUserName()\n {\n return ZD_USER_NAME;\n }\n\n\n private String getPassword()\n {\n return ZD_PASSWORD;\n }\n \n def checkConnection()\n {\n String methodName = \"checkConnection()\";\n log.logFinestEntering(methodName);\n try \n {\n\t\tprint(methodName + \" getting user details to check connection\");\n\t\tResponse clientResponse = getWebResource(\"/api/v2/users/me.json\").request(MediaType.APPLICATION_JSON_TYPE).header(\"Authorization\", getAccessToken(\"organizations:write read\")).get(Response.class);\n\t\tcheckResponse(clientResponse);\n\t\tprint(methodName + \" Test connection response code looks valid, check content of response\");\n\t\tString responseString = clientResponse.readEntity(String.class);\n\t\tprint(methodName + \"responseString=\" + responseString + \", Validated that JSON data was received from test connction URL invocation.\");\n }\n catch (Exception e)\n {\n log.logInfo(methodName, \" Test connection failed \" + e.getMessage() + \" \" + e)\n throw new ApiException(\"Connection failed. \" + e.getMessage()); \n }\n log.logFinestExiting(methodName);\n }\n \n private Client getRestClient()\n throws ApiException\n {\n if (mRestClient == null)\n {\n ClientBuilder builder;\n builder = ClientBuilder.newBuilder().withConfig(new ClientConfig().register(LoggingFilter.class)).property(HttpUrlConnectorProvider.SET_METHOD_WORKAROUND, true);\n mRestClient = builder.build();\n mRestClient.property(ClientProperties.CONNECT_TIMEOUT, 10000);\n mRestClient.property(ClientProperties.READ_TIMEOUT, 20000);\n }\n return mRestClient;\n }\n \n private WebTarget getWebResource(String resource)\n throws ApiException\n {\n if (resource != null && !resource.isEmpty() && !resource.startsWith(\"/\"))\n {\n resource += \"/\" + resource;\n }\n WebTarget webResource = null;\n try\n {\n webResource = getRestClient().target(getZendeskDomain()).path(resource);\n }\n catch (Exception e)\n {\n throw new ApiException(e.getMessage(), e.getMessage());\n }\n\n return webResource;\n }\n\n private String getAccessToken(String pScope)\n throws ApiException\n {\n getOAuthAccessToken(pScope);\n return \"Bearer \" + mAccessToken;\n }\n\n private String getOAuthURI()\n {\n return ZD_OAUTH_URI;\n }\n\n private String getClientId()\n {\n return ZD_CLIENT_ID;\n }\n\n private String getClientSecret()\n {\n return ZD_CLIENT_SECRET;\n }\n \n protected JsonObjectBuilder buildJsonRequest(Map pFields)\n {\n String methodName = \"buildJsonRequest\";\n JsonObjectBuilder jsonBuider = Json.createObjectBuilder();\n\n for (String fieldKey: pFields.keySet())\n {\n Serializable fieldValue = pFields.get(fieldKey);\n\n if (fieldValue != null)\n {\n if (fieldValue instanceof String)\n {\n jsonBuider.add(fieldKey, (String) fieldValue);\n }\n else if (fieldValue instanceof Boolean)\n {\n jsonBuider.add(fieldKey, (Boolean) fieldValue);\n }\n else if (fieldValue instanceof Integer)\n {\n jsonBuider.add(fieldKey, (Integer) fieldValue);\n }\n else if (fieldValue instanceof Float)\n {\n jsonBuider.add(fieldKey, (Float) fieldValue);\n }\n else if (fieldValue instanceof Double)\n {\n jsonBuider.add(fieldKey, (Double) fieldValue);\n }\n else if (fieldValue instanceof Long)\n {\n jsonBuider.add(fieldKey, (Long) fieldValue);\n }\n else\n {\n // convert to String if type unknown\n jsonBuider.add(fieldKey, fieldValue.toString());\n }\n }\n }\n return jsonBuider;\n }\n \n private String getZendeskDomain()\n {\n return getZendeskURLBuilder().toString();\n }\n\n private StringBuilder getZendeskURLBuilder()\n {\n StringBuilder urlBuilder = new StringBuilder(ZD_DOMAIN_NAME);\n return urlBuilder;\n }\n\n def getTicketURL(CMSObject pCMSObject)\n {\n\tString methodName = \"getTicketURL()\";\n\tlog.logFinestEntering(methodName, pCMSObject);\n\tStringBuilder tickerUrlBuilder = new StringBuilder();\n\tif(pCMSObject != null)\n\t{\n\t\ttickerUrlBuilder.append(getZendeskDomain());\n\t\tString changeRequestURI = ZD_REQUEST_GET_PATTERN.replaceAll(\"\\\\{ZENDESK_REQUEST\\\\}\", pCMSObject.getNumber());\n\t\ttickerUrlBuilder.append(changeRequestURI);\n\t}\n String url = tickerUrlBuilder.toString();\n\tlog.logFinestExiting(methodName, url);\n return url;\n }\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement all the methods described in the table in the API Implementation section","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For any failure connecting to the system or if any issues with the data, then you can throw exception. For example ","type":"text"},{"text":"throw new ApiException(\"Invalid credentials.\", \"\");","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Groovy has the advantage that changes to the API are picked up dynamically without having to recycle the server.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Groovy Utilities","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"There are some utility variables provided by FlexDeploy that can be used in your custom Groovy code.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"log","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" is a FlexDeploy logger variable which should be used to log any information from the groovy class.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"fdrestutils","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" is a utility object available to use FlexDeploy API to invoke any REST API. See the ","type":"text"},{"text":"Java docs","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.com/function-sdk-5.6/flexagon/fd/model/integration/util/FDRestUtils.html"}}]},{"text":" for more details on the functions available.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"def builder = new groovy.json.JsonBuilder()\ndef root = builder.issue\n{\n notes \"${pComment}\"\n}\nString payload = builder.toString();\nString ticketNumber = ticket.getNumber();\nString resourcePath = REDMINE_TICKET_REST_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticketNumber)\nfdrestutils.putRequest(REDMINE_URL, REDMINE_USER_NMAE, REDMINE_PASSWORD, resourcePath, payload);","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported