1Genel Bakış ve Mimari

Bu entegrasyon, SDP On-Premise üzerindeki ticketların Jira Cloud'da otomatik olarak issue oluşturmasını sağlar. Teknisyen, SDP ticket detay sayfasındaki butona bastığında süreç başlar ve Jira'da yeni bir issue oluşturulur.

1.1 Entegrasyon Akışı

1.2 Kurulum Öncesi Gereken Bilgiler

2Network / Firewall Kurulumu

SDP sunucusundan Jira Cloud'a erişim için firewall kuralı gereklidir. Bu adım atlanırsa Deluge script'ten Jira'ya bağlantı kurulamaz.

2.1 Gerekli Firewall Kuralı

2.2 Bağlantı Testi — CMD (Sunucu Üzerinde)

curl -v https://JIRA_DOMAIN.atlassian.net

2.3 Deluge'dan Bağlantı Testi

SDP Admin > Automation > Custom Functions altında aşağıdaki test scriptini çalıştırın:

testUrl = "https://JIRA_DOMAIN.atlassian.net";
response = invokeurl
[
    url: testUrl
    type: GET
];
info response.toString();
return response.toString();

3Jira Hazırlık Adımları

3.1 Jira API Token Oluşturma

3.2 Base64 Authorization String Oluşturma

Jira REST API, Basic Auth için email ve API token'ın birleşik Base64 kodunu kullanır.

Windows CMD ile:

echo -n "email@firma.com:API_TOKEN" | base64

Online araç ile:

https://www.base64encode.org adresine gidin. email@firma.com:API_TOKEN formatında girin ve "Encode" butonuna basın.

3.3 Jira Field ID'lerini Bulma

Proje ID Bulma:

curl --request GET \
  --url "https://JIRA_DOMAIN.atlassian.net/rest/api/3/project/search" \
  --user "email@firma.com:API_TOKEN" \
  --header "Accept: application/json"

Issue Type ID Bulma:

curl --request GET \
  --url "https://JIRA_DOMAIN.atlassian.net/rest/api/3/issuetype/project?projectId=PROJE_ID" \
  --user "email@firma.com:API_TOKEN" \
  --header "Accept: application/json"

Custom Field ID'leri Bulma:

curl --request GET \
  --url "https://JIRA_DOMAIN.atlassian.net/rest/api/3/field" \
  --user "email@firma.com:API_TOKEN" \
  --header "Accept: application/json"

Response'da alan adlarını arayarak ilgili "id" değerlerini bulunuz. Örnek:

3.4 Postman ile Test

Method: POST  |  URL: https://JIRA_DOMAIN.atlassian.net/rest/api/3/issue
Authorization: Basic Auth  |  Username: email  |  Password: api_token

{
  "fields": {
    "project": { "key": "PROJE_KEY" },
    "issuetype": { "id": "ISSUE_TYPE_ID" },
    "summary": "Test Ticket",
    "description": {
      "type": "doc", "version": 1,
      "content": [{
        "type": "paragraph",
        "content": [{ "type": "text", "text": "Test açıklama" }]
      }]
    },
    "customfield_XXXXX": "deger"
  }
}

4SDP Callback Custom Function

Callback Function, Jira API'ye POST isteğini gönderecek Deluge scriptini barındıran yapıdır. Page Script bu fonksiyonu URL üzerinden çağırarak tetikler.

4.1 Callback Function Oluşturma

Admin > General Settings > Automation > Callback Functions > New

4.2 Deluge Script

// ============================================
// SDP -> Jira Cloud Entegrasyonu
// Callback Custom Function
// ============================================

// 1. SDP API'den ticket bilgilerini çek
sdpUrl = "https://SDP_LOKAL_URL/api/v3/requests/" + request_id;
sdpHeaders = {
    "authtoken": "SDP_AUTH_TOKEN",
    "PORTALID": "1"
};
sdpResponse = invokeurl
[
    url: sdpUrl
    type: GET
    headers: sdpHeaders
];
requestObj = sdpResponse.get("request");

// 2. Item - Modül Mapping
// Müşteri ortamına göre güncelleyiniz
modulMap = Map();
modulMap.put("SDP_ITEM_ADI_1", "JIRA_MODUL_DEGERI_1");
modulMap.put("SDP_ITEM_ADI_2", "JIRA_MODUL_DEGERI_2");
// Diğer item'ları buraya ekleyiniz...

sdpItem = requestObj.get("item").get("name");
sdpModul = modulMap.get(sdpItem);
if(sdpModul == null || sdpModul == "")
{
    sdpModul = "VARSAYILAN_MODUL";
}

// 3. SDP alanlarını al
sdpSubject = requestObj.get("subject");

// Description HTML'den temizle
sdpDescriptionRaw = requestObj.get("description");
sdpDescription = sdpDescriptionRaw
    .replaceAll("<[^>]*>", "")
    .replaceAll("&nbsp;", " ")
    .replaceAll("&amp;", "&")
    .replaceAll("&lt;", "<")
    .replaceAll("&gt;", ">");

sdpTicketID = requestObj.get("id");

// Tarihi Jira formatına (yyyy-MM-dd) dönüştür
sdpDetectDateRaw = requestObj.get("created_time").get("display_value");
sdpDetectDate = sdpDetectDateRaw
    .toDate("MMM dd, yyyy hh:mm a")
    .toString("yyyy-MM-dd");

// 4. Jira API'ye POST gönder
jiraUrl = "https://JIRA_DOMAIN.atlassian.net/rest/api/3/issue";
headers = Map();
headers.put("Authorization", "Basic BASE64_STRING");
headers.put("Content-Type", "application/json");

body = "{\"fields\":{" +
    "\"project\":{\"key\":\"PROJE_KEY\"}," +
    "\"issuetype\":{\"id\":\"ISSUE_TYPE_ID\"}," +
    "\"summary\":\"" + sdpSubject + "\"," +
    "\"description\":{\"type\":\"doc\",\"version\":1," +
    "\"content\":[{\"type\":\"paragraph\"," +
    "\"content\":[{\"type\":\"text\"," +
    "\"text\":\"" + sdpDescription + "\"}]}]}," +
    "\"customfield_TICKET_NO_ID\":" + sdpTicketID + "," +
    "\"customfield_ISLEM_KODU_ID\":\"-\"," +
    "\"customfield_MODUL_ID\":[{\"value\":\"" + sdpModul + "\"}]," +
    "\"customfield_IS_BIRIMI_ID\":[{\"name\":\"IS_BIRIMI_DEGERI\"}]," +
    "\"customfield_TARIH_ID\":\"" + sdpDetectDate + "\"" +
"}}";

response = invokeurl
[
    url: jiraUrl
    type: POST
    parameters: body
    headers: headers
    content-type: "application/json"
];

// 5. Sonucu döndür
returnObj = Collection();
if(response.get("key") != null)
{
    returnObj.insert("result":"success");
    returnObj.insert("message":"Jira issue olusturuldu: " + response.get("key"));
}
else
{
    returnObj.insert("result":"failure");
    returnObj.insert("message":"Hata: " + response.toString());
}
return returnObj;

4.3 Değişken Referans Tablosu

5SDP Page Script — Buton Kurulumu

Page Script, SDP ticket detay sayfasına "Create JIRA Ticket" butonu ekler. Teknisyen butona bastığında Callback Function tetiklenir.

5.1 Page Script Oluşturma

Admin > General Settings > Page Scripts > New

5.2 Page Script Kodu

// ============================================
// SDP -> Jira Cloud | Page Script
// Request Details Page - Create Jira Button
// ============================================

$CS.addButton("edit", "Create JIRA Ticket", function(){

    // Ticket ID'yi URL'den al
    var woID = window.location.href.match(/woID=(\d+)/);
    var requestId = woID ? woID[1] : null;

    if(!requestId){
        alert("Request ID alinamadi!");
        return;
    }

    // Callback Function URL
    // NOT: Teknisyenlerin erişim URL'si ile aynı domain olmalıdır (CORS)
    var callbackUrl = "https://SDP_TEKNISYEN_URL/AppIntegrations" +
        "?serviceName=callbackFunctions" +
        "&api_name=create_jira_issue" +
        "&auth_token=CALLBACK_AUTH_TOKEN" +
        "&PORTALID=1";

    // Arguments encode et ve POST ile gönder
    var bodyData = "arguments=" +
        encodeURIComponent('{"request_id":"' + requestId + '"}');

    var promise = fetch(callbackUrl, {
        method: "POST",
        headers: {"Content-Type": "application/x-www-form-urlencoded"},
        body: bodyData
    });

    promise.then(function(response){
        return response.text();
    }).then(function(text){
        try {
            var result = JSON.parse(text);
            var output = result.output;
            if(output && output.result === "success"){
                alert("Jira ticket basariyla olusturuldu!\n" + output.message);
            } else {
                alert("Jira ticket olusturulamadi!\n" +
                    (output ? output.message : text));
            }
        } catch(e){
            alert("Sunucu yaniti: " + text);
        }
    }).catch(function(err){
        alert("Baglanti hatasi: " + err);
    });

}, {
    "class": "btn btn-default btn-xs ml10",
    "style": "background-color: #e57373; color: white; border-color: #e57373;"
});

5.3 Callback Auth Token Bulma

6Sorun Giderme

6.1 Authentication Test (Deluge)

testUrl = "https://JIRA_DOMAIN.atlassian.net/rest/api/3/myself";
headers = Map();
headers.put("Authorization", "Basic BASE64_STRING");
response = invokeurl
[
    url: testUrl
    type: GET
    headers: headers
];
info response.toString();
return response.toString();

7Yeni Müşteri Kurulum Kontrol Listesi

Her yeni müşteri kurulumunda aşağıdaki adımları sırayla tamamlayın.