Apps Scriptリファレンス: Apps Script Reference |障害・課題追跡: IssueTracker |Google Workspace: Status Dashboard - Summary

2020年2月16日日曜日

JIRAで特定の課題の変更履歴をシートに書き出したい


特定の課題でどのフィールドが何から何にいつ変更されたかシートに書き出したい。



事前準備
  1. スクリプトのプロパティに「token」という名で値を保存しておく
  2. 以下の値を書き換える
    • var ISSUE_URL
    • var ss_url 
    • var key 



コード.gs
var ISSUE_URL = 'https://SITENAME.atlassian.net/rest/api/2/issue/';
var ss_url = "https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0";

/************************************
これを実行する
************************************/
function getIssueHistories(){
  var key = "KT-12";
  var response = getHistories(key);
  var jobj = JSON.parse(response);
  var histories = jobj["changelog"]["histories"];
  var arrays = [];
  for(var i = 0; i < histories.length; i++) {
    var history = histories[i];
    var created = returnFormatDate(history["created"]);
    var items = history["items"];
    for(var j = 0; j < items.length; j++) {
      var item = items[j];
      var field = item["field"];
      var from = item["fromString"];
      var to = item["toString"];
      arrays.push([field, from, to, created]);
    }
  }
  setValuesToSheet(arrays)
}

/************************************
履歴を取得して返す
************************************/
function getHistories(key) {
  var options = {
    contentType: "application/json",
    headers: {"Authorization": " Basic " + getProp("token")}
  };
  var url = ISSUE_URL + key + '?expand=changelog';
  var response = UrlFetchApp.fetch(url, options);
  return response;
}


/************************************
シートに書き込む
************************************/
function setValuesToSheet(arrays){
  var sheet = SpreadsheetApp.openByUrl(ss_url).getSheets()[0];
  var last_row = sheet.getLastRow();
  var start_row = last_row + 1;
  var start_col = 1;
  var num_rows = arrays.length;
  var num_cols = arrays[0].length;
  var range = sheet.getRange(start_row, start_col, num_rows, num_cols);
  range.setValues(arrays);
}


/************************************
日付をフォーマットして返す
************************************/
function returnFormatDate(date) {
  return Utilities.formatDate(new Date(date), 'Asia/Tokyo', 'yyyy/MM/dd/HH:mm:ss');
}


/************************************
受け取ったkeyの値をスクリプトのプロパティから返す
************************************/
function getProp(key) {
  return PropertiesService.getScriptProperties().getProperty(key);
}



関連記事

JIRAでAPIトークンを取得したい
JIRA APIでissueの変更履歴を取得する
setValuesを使う話

Latest post

Googleドキュメントに見出しを追加したい

今回の例では、ドキュメントの末尾に「見出しD」 を追加します。 見出しA, B, C, Dのスタイルは、見出し3 ( HEADING3 ) に設定しています。  下記Code.gsの  GOOGLE_DOCUMENT_URL を設定して  addHeadingToEnd()  を...