{"type":"doc","content":[{"type":"paragraph","content":[{"text":"FlexDeploy has out-of-box integrations with Jira, Redmine, Azure Boards, GitLab, and GitHub. You can easily integrate with other issue tracking systems as well. Such third-party ","type":"text"},{"text":"Issue Tracking System","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" integrations can be enabled using Java or Groovy implementation. Several ITS templates are shipped with FlexDeploy, but you can create more to connect to other systems that aren’t supported with a vanilla install.","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to Issue Tracking Systems page using ","type":"text"},{"text":"Configuration ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"→ ","type":"text"},{"text":"Integrations","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"→ ","type":"text"},{"text":"Issue Tracking","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"menu.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":616,"id":"0aceacfa-3a14-4495-a8ea-3c1bdb657783","collection":"contentId-10125813542","type":"file","height":572}}]},{"type":"paragraph","content":[{"text":"Let's look at more details on how to create a custom Issue Tracking System Provider with FlexDeploy. Click ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"to implement an integration with custom issue tracking system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to the ITS Providers screen.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":1722,"id":"b746c5b8-281d-49a3-8e84-f0ed45c630d7","collection":"contentId-10125813542","type":"file","height":360}}]},{"type":"paragraph","content":[{"text":"Click create, or click on an existing row if you are making changes to an existing ITS Provider.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":1690,"id":"975600d8-d8ae-4211-97bd-c0c6ac103e13","collection":"contentId-10125813542","type":"file","height":432}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a unique name and optionally description","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define properties for the new issue tracking system. Properties are configuration values used by FlexDeploy to connect to the new system. The values of the properties that you define here are set on ","type":"text"},{"text":"Issue Tracking Instances","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":", ","type":"text"},{"text":"folders","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":", and ","type":"text"},{"text":"projects","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you define properties, you can indicate display and validation details. You can also indicate if a property is required and/or encrypted.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter a unique Name before adding any properties","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide either Java Implementation or Groovy API. If both are supplied, the Java Implementation is used. Java implementation means that you are giving the classpath for a java class which you are placing the jar for in the libext folder. Groovy is defined on the Groovy Api tab. A Groovy script would allow for dynamic update, whereas use of Java code will require restart of server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Here we are editing a custom issue tracking system with properties. You can add existing properties using the drop down on the create button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":1411,"id":"3179dcf4-22ed-499f-8383-900ef67ba6e4","collection":"contentId-10125813542","type":"file","height":827}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"API Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Your Implementation must extend ","type":"text"},{"text":"IssueTrackingSystem","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.com/function-sdk/6.5/flexagon/fd/model/integration/its/api/IssueTrackingSystem.html"}}]},{"text":" in order to be used by FlexDeploy. If you are not going to allow calling a method, you can leave the body blank, or throw an error in the body, but the method must be defined. If you choose to make a Java implementation, your IDE will verify that you have implemented all the required methods. If you choose the Groovy implementation, then the FlexDeploy UI will validate that your class contains the necessary methods. Groovy implementations can be used even with 3rd party jars that you place in libext, and allow for easier iterations. The advantage of a Java implementation is a potentially tighter integration with source control.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Java Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are the high level steps for a 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.its.api.IssueTrackingSystem","type":"text","marks":[{"type":"em"}]},{"text":". Example shown below has testConnection method implemented which uses properties map to retrieve the configuration values to connect to the issue tracking system.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All properties defined are available in Map returned by getProperties method.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Java Example","type":"text"}]},{"type":"expand","attrs":{"title":"Example class RedmineServiceIntegration.java"},"content":[{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"package flexagon.fd.model.integration.its.impl.redmine;\n\nimport flexagon.fd.model.integration.its.api.IssueTrackingSystem;\nimport flexagon.fd.model.integration.its.api.WorkItem;\nimport flexagon.fd.model.integration.its.api.WorkItemAttachment;\nimport flexagon.fd.model.integration.its.api.WorkItemComment;\nimport flexagon.fd.model.integration.its.api.WorkItemDetails;\nimport flexagon.fd.model.integration.its.api.WorkItemStatus;\nimport flexagon.fd.model.integration.its.api.WorkItemUpdate;\nimport flexagon.fd.model.integration.util.ApiException;\nimport flexagon.fd.model.integration.util.RestService;\n\nimport flexagon.ff.common.core.exceptions.FlexCheckedException;\nimport flexagon.ff.common.core.logging.FlexLogger;\nimport flexagon.ff.common.core.rest.FlexRESTClient;\nimport flexagon.ff.common.core.rest.FlexRESTClientResponse;\nimport flexagon.ff.common.core.utils.FlexCommonUtils;\n\nimport java.io.InputStream;\nimport java.io.Serializable;\n\nimport java.util.ArrayList;\nimport java.util.Collection;\nimport java.util.Collections;\nimport java.util.HashMap;\nimport java.util.List;\nimport java.util.Map;\n\nimport javax.json.Json;\nimport javax.json.JsonArray;\nimport javax.json.JsonObject;\nimport javax.json.JsonObjectBuilder;\n\nimport javax.ws.rs.core.MediaType;\n\npublic class RedmineIssueTrackingSystem\n extends IssueTrackingSystem\n{\n private static final String CLZ_NAM = RedmineIssueTrackingSystem.class.getName();\n private static final FlexLogger LOG = FlexLogger.getLogger(CLZ_NAM);\n\n private static final String FDREDMINE_URL = \"FDREDMINE_URL\";\n private static final String FDREDMINE_TICKET_URL_PATTERN = \"FDREDMINE_TICKET_URL_PATTERN\";\n private static final String FDREDMINE_ISSUE = \"{REDMINE_ISSUE}\";\n private static final String FDREDMINE_USER_NMAE = \"FDREDMINE_USER_NMAE\";\n private static final String FDREDMINE_PASSWORD = \"FDREDMINE_PASSWORD\";\n\n public RedmineIssueTrackingSystem()\n {\n super();\n }\n\n private StringBuilder getURLBuilder()\n {\n StringBuilder urlBuilder = new StringBuilder((String) getProperties().get(FDREDMINE_URL));\n return urlBuilder;\n }\n\n\n private String getPropertyForTicket(String propertyName, String pTicketNummber)\n {\n String origPropValue = (String) getProperties().get(propertyName);\n if (origPropValue != null)\n {\n return origPropValue.replace(FDREDMINE_ISSUE, pTicketNummber);\n }\n else\n {\n return null;\n }\n }\n\n private String getURLProperty(String propertyName, String pTicketNummber)\n {\n String methodName = \"getURLProperty\";\n LOG.logFinestEntering(methodName);\n\n StringBuilder ticketURLBuilder = getURLBuilder();\n String urlProperty = ticketURLBuilder.append(getPropertyForTicket(propertyName, pTicketNummber)).toString();\n\n LOG.logFinestExiting(methodName, urlProperty);\n return urlProperty;\n }\n\n private String getHostNameURL()\n {\n return getURLBuilder().toString();\n }\n\n private String getUserName()\n {\n return (String) getProperties().get(FDREDMINE_USER_NMAE);\n }\n\n private String getPassword()\n {\n return (String) getProperties().get(FDREDMINE_PASSWORD);\n }\n\n private FlexRESTClient getRestService()\n throws ApiException\n {\n return RestService.getService(getHostNameURL(), getUserName(), getPassword());\n }\n\n private FlexRESTClient getTicketWebResource(String pTicketNummber)\n throws ApiException\n {\n String ticketPath = getPropertyForTicket(FDREDMINE_TICKET_URL_PATTERN, pTicketNummber);\n return getRestService().path(ticketPath);\n }\n\n public String getWorkItemStatus(WorkItem ticket)\n throws ApiException\n {\n String methodName = \"getTicketStatus\";\n LOG.logFinestEntering(methodName, ticket.getNumber());\n\n FlexRESTClientResponse response;\n try\n {\n response = RestService.checkResponse(getTicketWebResource(ticket.getNumber()).get());\n }\n catch (FlexCheckedException e)\n {\n throw new ApiException(e);\n }\n\n JsonObject jsonObject = RestService.readJsonObject(response.getResponseString());\n JsonObject issueObject = (JsonObject) jsonObject.get(\"issue\");\n String statusName = null;\n if (issueObject != null)\n {\n javax.json.JsonObject status = issueObject.getJsonObject(\"status\");\n if (status != null)\n {\n statusName = status.getString(\"name\");\n }\n\n }\n LOG.logFinestExiting(methodName, statusName);\n return statusName;\n }\n\n /*\n * Populates ticket's data (e.g. Description with summary)\n */\n @Override\n public void populateWorkItem(WorkItem ticket)\n throws ApiException\n {\n String methodName = \"populateWorkItem\";\n LOG.logFinestEntering(methodName, ticket);\n\n FlexRESTClientResponse response;\n try\n {\n response = RestService.checkResponse(getTicketWebResource(ticket.getNumber()).get());\n }\n catch (FlexCheckedException e)\n {\n throw new ApiException(e);\n }\n\n JsonObject jsonObject = RestService.readJsonObject(response.getResponseString());\n if (jsonObject != null)\n {\n javax.json.JsonObject issue = jsonObject.getJsonObject(\"issue\");\n if (issue != null)\n {\n ticket.setDescription(issue.getString(\"description\"));\n javax.json.JsonObject tracker = issue.getJsonObject(\"tracker\");\n if (tracker != null)\n {\n ticket.setType(tracker.getString(\"name\"));\n }\n }\n }\n LOG.logFinestExiting(methodName);\n }\n\n\n /*\n * Builds absolute ticket's URL\n */\n @Override\n public String getWorkItemURL(WorkItem ticket)\n throws ApiException\n {\n String methodName = \"getWorkItemURL\";\n LOG.logFinestEntering(methodName, ticket);\n\n String url = getURLProperty(FDREDMINE_TICKET_URL_PATTERN, ticket.getNumber());\n url = url.replace(\".json\", \"\");\n LOG.logFinestExiting(methodName, url);\n return url;\n }\n\n /*\n * Adds a comment to a ticket\n *\n */\n @Override\n public void addCommentToWorkItem(WorkItem ticket, String comment)\n throws ApiException\n {\n String methodName = \"addCommentToWorkItem\";\n LOG.logFinestEntering(methodName, ticket.getNumber(), comment);\n JsonObject commentJson = Json.createObjectBuilder().add(\"issue\", Json.createObjectBuilder().add(\"notes\", comment)).build();\n\n FlexRESTClientResponse response;\n try\n {\n response = RestService.checkResponse(getTicketWebResource(ticket.getNumber()).mediatype(MediaType.APPLICATION_JSON_TYPE).put(commentJson.toString()));\n }\n catch (FlexCheckedException e)\n {\n throw new ApiException(e);\n }\n\n LOG.logFinestExiting(methodName);\n }\n\n @SuppressWarnings(\"oracle.jdeveloper.java.insufficient-catch-block\")\n private int getStatusIdFromName(String pStatus)\n throws ApiException\n {\n String methodName = \"getStatusIdFromName\";\n LOG.logFinestEntering(methodName, pStatus);\n\n int status_id = -1;\n try\n {\n String statusNumber = pStatus.split(\"##\")[0];\n // If user saves 10 or 10##In Progress, let's try to parse it as number\n status_id = Integer.parseInt(statusNumber);\n }\n catch (Exception nfe)\n {\n // not integer value, call API\n }\n\n if (status_id == -1)\n {\n // call API to do conversion\n try\n {\n FlexRESTClientResponse response = RestService.checkResponse(getRestService().path(\"/issue_statuses.json\").get());\n Map statusMap = parseIssueStatuses(response.getResponseString());\n if (statusMap.containsKey(pStatus))\n {\n status_id = statusMap.get(pStatus);\n }\n }\n catch (ApiException apie)\n {\n throw apie;\n }\n catch (FlexCheckedException e)\n {\n throw new ApiException(e);\n }\n }\n\n LOG.logFinestExiting(methodName, status_id);\n return status_id;\n }\n\n private Map parseIssueStatuses(String pJson)\n {\n String methodName = \"parseIssueStatuses\";\n LOG.logFinestEntering(methodName, pJson);\n\n // Example output\n // {\n // \"issue_statuses\": [\n // {\n // \"id\": 1,\n // \"name\": \"New\",\n // \"is_closed\": false\n // },\n // {\n // \"id\": 2,\n // \"name\": \"In Progress\",\n // \"is_closed\": false\n // },\n // {\n // \"id\": 3,\n // \"name\": \"Resolved\",\n // \"is_closed\": false\n // },\n // {\n // \"id\": 4,\n // \"name\": \"Closed\",\n // \"is_closed\": true\n // },\n // {\n // \"id\": 5,\n // \"name\": \"Rejected\",\n // \"is_closed\": true\n // },\n // {\n // \"id\": 6,\n // \"name\": \"Ready\",\n // \"is_closed\": false\n // }\n // ]\n // }\n\n Map map = new HashMap<>();\n\n JsonObject jsonObject = RestService.readJsonObject(pJson);\n JsonArray ar = jsonObject.getJsonArray(\"issue_statuses\");\n for (int i = 0; i < ar.size(); i++)\n {\n String name = ar.getJsonObject(i).getString(\"name\");\n int id = ar.getJsonObject(i).getInt(\"id\");\n map.put(name, id);\n }\n\n LOG.logFinestExiting(methodName, map);\n return map;\n }\n\n /*\n * Changes ticket's status\n *\n */\n @Override\n public void changeWorkItemStatusTo(WorkItem ticket, Serializable status)\n throws ApiException\n {\n String methodName = \"changeWorkItemStatusTo\";\n LOG.logFinestEntering(methodName, ticket.getNumber(), status);\n\n // Redmine API needs id and not status name\n JsonObjectBuilder addStatus = Json.createObjectBuilder().add(\"notes\", \"Status updated to \" + status);\n addStatus = addStatus.add(\"status_id\", getStatusIdFromName((String) status));\n JsonObject statusJson = Json.createObjectBuilder().add(\"issue\", addStatus).build();\n\n FlexRESTClientResponse response;\n try\n {\n response = RestService.checkResponse(getTicketWebResource(ticket.getNumber()).mediatype(MediaType.APPLICATION_JSON_TYPE).put(statusJson.toString()));\n }\n catch (FlexCheckedException e)\n {\n throw new ApiException(e);\n }\n\n LOG.logFinestExiting(methodName);\n }\n\n @Override\n public void checkConnection()\n throws ApiException\n {\n String methodName = \"checkConnection\";\n LOG.logFineEntering(methodName);\n\n try\n {\n String aboutUrl = \"/users/current.json\";\n LOG.logInfo(methodName, \"Checking Redmine connection for user {0} with path {1}\", getUserName(), getHostNameURL() + aboutUrl);\n FlexRESTClientResponse clientResponse = getRestService().path(aboutUrl).get();\n LOG.logInfo(methodName, \"Successfully invoked test connection URL {0}\", clientResponse);\n int statusCode = clientResponse.getResponse().getStatusInfo().getStatusCode();\n if (statusCode == 401)\n {\n throw new ApiException(\"Invalid credentials.\", \"\");\n }\n RestService.checkResponse(clientResponse);\n LOG.logInfo(methodName, \"Test connection response code looks valid, check content of response\");\n RestService.readJsonObject(clientResponse.getResponseString());\n LOG.logInfo(methodName, \"Validated that JSON data was received from test connction URL invocation.\");\n }\n catch (ApiException e)\n {\n LOG.logInfo(methodName, \"ApiException in Test connection\", e);\n throw e;\n }\n catch (Exception e)\n {\n LOG.logInfo(methodName, \"Failed in Test connection\", e);\n throw new ApiException(\"Connection failed. \" + e.getMessage(), \"\");\n }\n LOG.logFineExiting(methodName);\n }\n\n @Override\n public Collection parseWorkItemNumberFromChangeLogs(List pChangeLogMessages, List pTicketPatternList)\n throws ApiException\n {\n String methodName = \"parseWorkItemNumberFromChangeLogs\";\n LOG.logFinestEntering(methodName, pChangeLogMessages, pTicketPatternList);\n Collection ticketNumberList = new ArrayList();\n Collection parsedTicketNumbers = flexagon.fd.model.integration.its.util.ChangeLogParser.getParser().parse(pChangeLogMessages, pTicketPatternList);\n if (FlexCommonUtils.isNotEmpty(parsedTicketNumbers) && FlexCommonUtils.isNotEmpty(pTicketPatternList))\n {\n for (String parsedTicketWithPattern: parsedTicketNumbers)\n {\n for (String pattern: pTicketPatternList)\n {\n if (parsedTicketWithPattern.startsWith(pattern))\n {\n String ticketNumber = parsedTicketWithPattern.substring(pattern.length(), parsedTicketWithPattern.length());\n ticketNumberList.add(ticketNumber);\n }\n }\n }\n }\n LOG.logFinestExiting(methodName);\n return ticketNumberList;\n }\n\n @Override\n public Collection getWorkItemComments(WorkItem pTicket, int i, int i2)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptySet();\n }\n\n @Override\n public Collection getWorkItemHistory(WorkItem pTicket, int i, int i2)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptySet();\n }\n\n @Override\n public Collection getWorkItemAttachments(WorkItem pTicket)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptySet();\n }\n\n @Override\n public WorkItemDetails getWorkItem(WorkItem pTicket)\n throws ApiException\n {\n // TODO Implement this method\n return null;\n }\n\n @Override\n public InputStream getWorkItemAttachmentContent(WorkItem pTicket, Serializable pSerializable)\n throws ApiException\n {\n // TODO Implement this method\n return null;\n }\n\n @Override\n public List getWorkItems(List pList)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptyList();\n }\n\n @Override\n public List getAvailableWorkItemStatuses(WorkItem pWorkItem)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptyList();\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":"#"}}]},{"text":" on classpath.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement all the methods defined by ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://flexagon.com/function-sdk/6.5/flexagon/fd/model/integration/its/api/IssueTrackingSystem.html"}},{"text":".","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":"Put this jar file in ","type":"text"},{"text":"apache-tomcat-flexdeploy/libext","type":"text","marks":[{"type":"em"}]},{"text":" 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 libext folder.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Groovy Implementation","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are the high level steps for a 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 issue tracking 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. The example shown below has testConnection and some other methods implemented.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You need to implement all methods defined in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://flexagon.com/function-sdk/6.5/flexagon/fd/model/integration/its/api/IssueTrackingSystem.html"}},{"text":" .","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 REDMINE_URL, REDMINE_USER_NAME, REDMINE_PASSWORD, etc,","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Groovy Example","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"Example groovy RedmineIssueTrackingSystem.groovy"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import flexagon.fd.model.integration.its.api.WorkItem;\nimport flexagon.fd.model.integration.its.api.WorkItemAttachment;\nimport flexagon.fd.model.integration.its.api.WorkItemComment;\nimport flexagon.fd.model.integration.its.api.WorkItemDetails;\nimport flexagon.fd.model.integration.its.api.WorkItemStatus;\nimport flexagon.fd.model.integration.its.api.WorkItemUpdate;\nimport flexagon.fd.model.integration.util.ApiException; \n\nclass RedmineIssueTrackingSystem extends IssueTrackingSystem\n{\n void checkConnection()\n {\n\tString methodName = \"checkConnection()\";\n try\n { \n fdrestutils.testConnection(REDMINE_URL, \"/projects/1/versions.json\", REDMINE_USER_NMAE, REDMINE_PASSWORD)\n }\n catch (Exception e)\n {\n log.logInfo(methodName, \" Failed in Test connection\" + e.getMessage() + \" \" + e)\n throw new ApiException(\"Connection failed. \" + e.getMessage());\n }\n }\n \n String getWorkItemStatus(WorkItem ticket)\n {\n String methodName = \"getWorkItemStatus()\";\n String message = \" ticket# ${ticket.toString()}\"\n log.logInfo(methodName, message);\n String resourcePath = REDMINE_TICKET_URL_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticket.getNumber())\n javax.json.JsonObject jsonObj = fdrestutils.getRequest(REDMINE_URL, resourcePath, REDMINE_USER_NMAE, REDMINE_PASSWORD);\n if(jsonObj != null)\n {\n javax.json.JsonObject issue = jsonObj.getJsonObject(\"issue\")\n if(issue!=null)\n {\n javax.json.JsonObject status = issue.getJsonObject(\"status\")\n if(status !=null)\n {\n return status.getString(\"name\")\n } \n }\n }\n\treturn null;\n }\n\n \n String getWorkItemURL(WorkItem ticket)\n {\n String methodName = \"getWorkItemURL()\";\n String message = \"ticket# ${ticket.toString()}\"\n log.logInfo(methodName, message);\n String resourcePath = REDMINE_TICKET_URL_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticket.getNumber())\n\tmessage = \"Redmine ticket URL is # ${REDMINE_URL}, resourcePath=${resourcePath}\"\n log.logInfo(methodName, message)\n\treturn REDMINE_URL + resourcePath;\n }\n \n void populateWorkItem(WorkItem ticket)\n {\n String methodName = \"populateWorkItem()\";\n\tString message = \"Populate ticket# ${ticket.toString()}\"\n log.logInfo(methodName, message)\n String resourcePath = REDMINE_TICKET_URL_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticket.getNumber())\n javax.json.JsonObject jsonObj = fdrestutils.getRequest(REDMINE_URL, resourcePath, REDMINE_USER_NMAE, REDMINE_PASSWORD);\n if(jsonObj != null)\n {\n javax.json.JsonObject issue = jsonObj.getJsonObject(\"issue\")\n if(issue!=null)\n {\n ticket.setDescription(issue.getString(\"description\"))\n javax.json.JsonObject tracker = issue.getJsonObject(\"tracker\")\n if(tracker !=null)\n {\n ticket.setType(tracker.getString(\"name\"))\n } \n }\n }\n }\n \n void addCommentToWorkItem(WorkItem ticket, String pComment)\n {\n\tString methodName = \"addCommentToWorkItem()\"; \n try\n { \n\t String message = \" Adding comment to ${ticket.toString()} , comment=${pComment}\"\n log.logInfo(methodName, message)\n def builder = new groovy.json.JsonBuilder()\n def root = builder.issue {\n notes \"${pComment}\"\n }\n String payload = builder.toString();\n String resourcePath = REDMINE_TICKET_REST_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticket.getNumber())\n fdrestutils.putRequest(REDMINE_URL, REDMINE_USER_NMAE, REDMINE_PASSWORD, resourcePath, payload);\n }\n catch (Exception e)\n {\n log.logInfo( methodName, \" Failed while adding comment to the issue - \" + e.getMessage() + \" \" + e)\n throw new ApiException(\"Connection failed. \" + e.getMessage());\n }\n }\n \n void changeWorkItemStatusTo(WorkItem ticket, Serializable pStatus)\n {\n String methodName = \"changeWorkItemStatusTo()\";\n\tString message = \" Adding comment to ${ticket.toString()} , status=${pStatus}\"\n log.logInfo(methodName, message)\n\tdef builder = new groovy.json.JsonBuilder()\n\tdef root = builder.issue {\n\t\tnotes \"Status updated to ${pStatus}\"\n\t\tstatus_id \"${pStatus}\"\n\t}\n\tString payload = builder.toString();\n\tString resourcePath = REDMINE_TICKET_REST_PATTERN.replaceAll(\"\\\\{REDMINE_ISSUE\\\\}\", ticket.getNumber())\n\tfdrestutils.putRequest(REDMINE_URL, REDMINE_USER_NMAE, REDMINE_PASSWORD, resourcePath, payload);\n }\n \n def parseWorkItemNumberFromChangeLogs(List pChangeLogMessages, List pTicketPatternList)\n {\n\tString methodName = \"parseWorkItemNumberFromChangeLogs()\";\n\tSet ticketNumberList = HashSet();\n\tString message = \" Input ChangeLogMessages=${pChangeLogMessages} , TicketPatternList=${pTicketPatternList}\"\n log.logInfo(methodName, message)\t\n \n Collection parsedTicketNumbers = flexagon.fd.model.integration.its.util.ChangeLogParser.getParser().parse(pChangeLogMessages, pTicketPatternList);\n\tmessage = \"parsedTicketNumbers=${parsedTicketNumbers}\"\n log.logInfo(methodName, message)\n\t\t\n if(parsedTicketNumbers != null && !parsedTicketNumbers.isEmpty() && pTicketPatternList != null && !pTicketPatternList.isEmpty())\n {\n parsedTicketNumbers.each{ parsedTicket ->\n pTicketPatternList.each{ pattern ->\n\t\t\tif(parsedTicket.startsWith(pattern))\n\t\t\t{\n\t\t\t\tString ticketNumber = parsedTicket.substring(pattern.length(),parsedTicket.length())\n\t\t\t\tticketNumberList.add(ticketNumber)\n\t\t\t}\n\t\t}\n }\n }\n\treturn ticketNumberList;\n }\n \n public Collection getWorkItemComments(WorkItem pTicket, int i, int i2)\n throws ApiException\n {\n return Collections.emptySet();\n }\n \n public Collection getWorkItemHistory(WorkItem pTicket, int i, int i2)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptySet();\n }\n\n public Collection getWorkItemAttachments(WorkItem pTicket)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptySet();\n }\n\n public WorkItemDetails getWorkItem(WorkItem pTicket)\n throws ApiException\n {\n // TODO Implement this method\n return null;\n }\n\n public InputStream getWorkItemAttachmentContent(WorkItem pTicket, Serializable pSerializable)\n throws ApiException\n {\n // TODO Implement this method\n return null;\n }\n\n public List getWorkItems(List pList)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptyList();\n }\n\n public List getAvailableWorkItemStatuses(WorkItem pWorkItem)\n throws ApiException\n {\n // TODO Implement this method\n return Collections.emptyList();\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":"heading","attrs":{"level":4},"content":[{"text":"Groovy Utilities","type":"text"}]},{"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":"itsstatusmap","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"is a map which can be used for getting the ITS status names from status ids. This can be useful for getting and updating ticket statuses if the API for your custom issue tracking system uses status names only.","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