Go-Live：Google Sheet to Jira 工單自動化

此節點負責從 Google Sheet 中讀取需要被建立為 Jira Ticket 的回報。

1. 新增一個 Google Sheets 節點。
2. 在 Authentication 中選擇或建立你的 Google API 憑證。
3. Resource 選擇 Row，Operation 選擇 Get。
4. 填入你的 Spreadsheet ID 和 Sheet Name。
5. 在 Filters 區塊設定篩選條件，這是確保不重複開票的關鍵：
   • Filter 1: Jira Link | Condition: Is Empty | Value: (留空)
   • Filter 2: 可Jira | Condition: Equals | Value: Y
   • Filter 3: 問題描述 | Condition: Not Equals | Value: (留空)
6. (重要) 在節點設定的 Settings 頁籤中，將 On Error 設定為 "Continue (using error output)"。這會產生一個額外的 "error" 輸出錨點，讓我們可以連接到錯誤通知節點。

如果 Google Sheet 節點因為權限、網路問題等原因執行失敗，我們希望立即收到通知。

1. 新增一個 Telegram 節點。
2. 設定你的 Telegram API Credentials 和 Chat ID。
3. 在 Text 欄位中，填寫一個清晰的錯誤訊息，例如：「❌ GoLive Jira 自動化 - 讀取 Google Sheet 失敗！」。
4. 將上一個 Google Sheets 節點的 error output (紅色圓點) 連接到此 Telegram 節點的 input。

Google Sheet 節點可能一次返回多個需要處理的列。為了確保每個回報都被獨立、穩定地處理，我們需要一個迴圈。Split in Batches 節點可以完美勝任此工作。

1. 新增一個 Split in Batches 節點。
2. 將 Batch Size 設定為 1。

這樣設定後，該節點會將收到的多個項目(Items)拆分成獨立的執行，一次只處理一個，直到所有項目都處理完畢。

這是提升工單品質的核心。此節點會用 JavaScript 將 Google Sheet 的原始資料轉換成結構化的 Jira Wiki Markup，並對應優先級。

1. 新增一個 Code 節點。
2. 將以下 JavaScript 程式碼貼入程式碼編輯區。

/**
 * n8n Code Node: Format Issue Report for Jira Description (Wiki Markup) & Map Priority
 * 
 * This script takes raw issue data and performs two tasks:
 * 1. Transforms it into a structured Wiki Markup string for Jira descriptions.
 * 2. Maps the text-based priority level ('嚴重度等級') to a numeric Jira Priority ID.
 *    If the priority level is not found or is empty, it defaults to a standard ID.
 */

// --- 1. Get data from the upstream node ---
const itemJson = $input.item.json;

// --- 2. Priority Mapping ---
const priorityMap = {
  'P1': '1', // Highest
  'P2': '2', // High
  'P3': '3', // Medium
  'P4': '4', // Low
  // Default/fallback value if no match is found
  '_': '3'  // Default to Medium
};

// --- 3. Helper function to create a wiki markup list item ---
function createListItem(emoji, label, value, defaultValue = 'N/A') {
  let displayValue = value;
  if (typeof value === 'boolean') {
    displayValue = value ? '是' : '否';
  }
  // Ensure the value is not null or undefined before displaying
  return `* ${emoji} *${label}：* ${displayValue || defaultValue}`;
}

// --- 4. Build the Wiki Markup String ---

// Panel 1: Issue Report Information
const reportInfoPanel = [
  '{panel:title=問題回報資訊|bgColor=#DEEBFF|borderColor=#B3D4FF}',
  createListItem('💻', '系統別/地點', itemJson['系統別/地點']),  
  createListItem('📝', '問題簡述', itemJson['問題簡述']),
  createListItem('👤', '回報者姓名', itemJson['提出者']),  
  createListItem('🚨', '緊急', itemJson['緊急']),  
  createListItem('👨‍⚕️', '職務', itemJson['職務']),
  createListItem('📞', '聯絡方式', itemJson['聯絡方式']),
  createListItem('🗂️', '病歷號/住院號', itemJson['病歷號/住院號']),
  createListItem('📍', '診間或病房編號', itemJson['診間或病房編號']),
  '{panel}'
].join('\n');

// Panel 2: Internal Processing Status
const internalStatusPanel = [
  '{panel:title=內部處理狀態|bgColor=#FEF0B5|borderColor=#FFC400}',
  createListItem('🚦', '嚴重度等級', itemJson['嚴重度等級'], '未分類'),
  createListItem('🧑‍💻', 'Owner', itemJson['Owner(RD)'], '未指派'),
  createListItem('⏳', '處理狀態', itemJson['處理狀態'], '待處理'),
  createListItem('🛠️', '處理方式', itemJson['處理方式'], '分析中'),
  '{panel}'
].join('\n');

// --- 5. Combine all parts and map priority ---
// Combine panels into a single description string
itemJson.jiraDescriptionString = `${reportInfoPanel}\n\n${internalStatusPanel}`;

// Map the priority using the text from the sheet, or use the default
itemJson.priorityId = priorityMap[itemJson['嚴重度等級']] || priorityMap['_'];

// --- 6. Return the enhanced item ---
return itemJson;
                                        

使用上一步格式化好的內容，正式在 Jira 中建立一張 Bug 單。

1. 新增一個 Jira 節點，設定好 API 憑證。
2. Resource 選擇 Issue，Operation 選擇 Create。
3. 選擇你的 Project 和 Issue Type (例如：Bug)。
4. 在 Summary 欄位，使用表達式填入標題，例如：=[Hospital] Prod - {{ $json['問題簡述'] }}。
5. 點擊 Add Field，選擇 Description。在 Description 欄位中，使用表達式填入上一步產生的 Wiki Markup 字串：={{ $json.jiraDescriptionString }}。
6. 同樣地，點擊 Add Field -> Priority。在 Priority 欄位右側點擊「...」選擇 Add Expression，然後填入 ={{ $json.priorityId }}。
7. 你可以用同樣的方式設定 Assignee (負責人)、Reporter (回報人)、Labels (標籤) 等欄位。
8. 同樣地，為此節點設定 On Error 為 "Continue (using error output)"，並連接到另一個 Telegram 錯誤通知節點。

建立成功後，必須更新 Google Sheet 的狀態，以形成閉環，避免重複處理。

1. 新增另一個 Google Sheets 節點。
2. Operation 選擇 Update。
3. 填寫與步驟 2 相同的 Spreadsheet ID 和 Sheet Name。
4. 在 Key Column 中，填入你的 Google Sheet 中用來唯一識別每一列的欄位名稱，例如 row_number 。
5. 在 Fields to Update 區塊：
   • Key: Jira Link | Value (使用表達式): =https://YOUR_JIRA_DOMAIN/browse/{{ $('Create an issue').item.json.key }}
   • Key: 可Jira | Value: Done

最後，我們將新建立的工單資訊，以易於閱讀的卡片形式發送到 Teams 頻道。

1. (Power Automate) 建立一個 Power Automate 流程，觸發器選擇 "When an HTTP request is received"，儲存後會產生一個 Webhook URL。
2. (n8n) 新增一個 Code 節點，用來產生 Teams Adaptive Card 的 JSON 結構。這需要你熟悉 Adaptive Card 的語法，或使用 Adaptive Card Designer 來設計。
3. (n8n) 新增一個 HTTP Request 節點。
4. Method 設為 POST。
5. 在 URL 欄位貼上你在 Power Automate 取得的 Webhook URL。
6. Body Content Type 選擇 JSON。
7. 在 Body 欄位，使用表達式填入上一步 Code 節點產生的 Adaptive Card JSON 變數。

當工作流執行到此處時，就會呼叫 Power Automate，進而將一張包含工單摘要、負責人、嚴重性等關鍵資訊的卡片發送到指定的 Teams 頻道。