Tự động hóa Báo cáo Jira Service Management với Power Automate

Việc tạo báo cáo Jira Service Management (JSM) định kỳ có thể tốn nhiều công sức, đặc biệt khi phải xử lý phân trang, trường tùy chỉnh và yêu cầu định dạng CSV. Hướng dẫn này cung cấp hướng dẫn từng bước chi tiết để xây dựng quy trình báo cáo tự động sử dụng Power Automate, Jira Cloud API và SharePoint.

Bài viết này được viết cho các chuyên gia IT muốn triển khai giải pháp này mà không tiết lộ bất kỳ thông tin nhạy cảm nào của tổ chức. Tất cả các ví dụ đều sử dụng các giá trị đã được ẩn danh mà bạn có thể thay thế bằng giá trị của riêng mình.

Tổng quan Kiến trúc

Những gì chúng ta sẽ xây dựng

Một Power Automate flow:

Chạy theo lịch trình cố định (ví dụ: 2 tuần một lần)
Gọi Jira Cloud REST API với xử lý phân trang đúng cách
Thu thập tất cả issues từ một filter đã lưu (ngay cả khi có hơn 500+ issues)
Làm phẳng các trường JSON lồng nhau (bao gồm custom fields) thành file CSV
Lưu CSV vào SharePoint
Gửi email với file CSV đính kèm

Demo & Ví dụ Thực tế

Muốn xem kết quả cuối cùng có thể đạt được?

Xem showcase kết quả cuối cùng với dashboard và trực quan hóa KPI thực tế:

JSM Sales Performance Dashboard - GitHub Repository

Repository này trình bày:

KPI dashboards được xây dựng từ báo cáo Jira tự động
Use case thực tế: Theo dõi hiệu suất đội ngũ bán hàng
Ví dụ trực quan hóa dữ liệu: Cách báo cáo CSV trở thành insights có thể hành động
Triển khai production: Triển khai thực tế trong môi trường doanh nghiệp

Yêu cầu tiên quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

Jira Cloud với:
- Một filter đã lưu (chúng ta sẽ sử dụng filter ID)
- Jira API token để xác thực
Microsoft 365 với:
- Quyền truy cập Power Automate
- SharePoint Online
- Hộp thư Outlook (để gửi email)

Bước 1: Lấy Jira Filter ID

Cách tìm Filter ID

Mở Jira trong trình duyệt
Vào Filters → View all filters
Nhấp vào filter bạn muốn sử dụng cho báo cáo

Nhìn vào URL trình duyệt:

https://yourtenant.atlassian.net/issues/?filter=12345

Số sau filter= là Filter ID của bạn (trong ví dụ này: 12345)

Trong request body của API, bạn sẽ sử dụng:

"jql": "filter = 12345"

Thay thế 12345 bằng filter ID thực tế của bạn.

Bước 2: Tạo Jira API Token

Vào https://id.atlassian.com/manage-profile/security/api-tokens
Nhấp Create API token
Đặt tên nhãn (ví dụ: "Power Automate Integration")
Sao chép token và lưu trữ an toàn
Bạn sẽ sử dụng token này làm password trong HTTP Basic Authentication

Bước 3: Hiểu về Jira Search API

API Endpoint

POST https://<YOUR_TENANT>.atlassian.net/rest/api/3/search/jql

Request Body (Ví dụ)

{
  "jql": "filter = 12345",
  "maxResults": 100,
  "fields": [
    "key",
    "summary",
    "status",
    "duedate",
    "resolution",
    "created",
    "customfield_10001",
    "customfield_10002",
    "customfield_10003",
    "assignee",
    "reporter",
    "priority",
    "description"
  ],
  "nextPageToken": ""
}

Các tham số chính

Tham số	Mô tả
`jql`	Truy vấn JQL của bạn (khuyến nghị sử dụng filter ID)
`maxResults`	Số lượng issues mỗi trang (khuyến nghị: 100)
`fields`	Mảng các field ID cần lấy (bao gồm customfield_XXXXX)
`nextPageToken`	Chuỗi rỗng cho lần gọi đầu tiên, sau đó sử dụng giá trị từ response

API Response (Đơn giản hóa)

{
  "issues": [ /* mảng các issue objects */ ],
  "isLast": false,
  "nextPageToken": "eyJwYWdlIjoyfQ=="
}

Các trường quan trọng:

issues - Mảng các issue objects (tối đa 100 mỗi trang)
isLast - Boolean cho biết đây có phải trang cuối cùng không
nextPageToken - Token để lấy trang tiếp theo

Bước 4: Xây dựng Power Automate Flow

Kiến trúc Power Automate Flow

Trước khi bắt đầu xây dựng, đây là cấu trúc flow hoàn chỉnh:

Các phần của Flow:

Phần	Màu	Actions	Mục đích
Khởi tạo	Xanh dương	Recurrence + 3 Variables	Thiết lập trigger và lưu trữ
Vòng lặp phân trang	Vàng	HTTP + Parse + Append + Update	Thu thập tất cả issues qua các trang
Chuyển đổi dữ liệu	Xanh lá	Select + CSV	Làm phẳng JSON thành CSV
Đầu ra	Tím/Đỏ	SharePoint + Email	Phân phối kết quả

Điểm chính:

Cấu trúc vòng lặp: Tiếp tục cho đến khi isLast = true từ Jira API
Cập nhật biến: Xảy ra trong vòng lặp sau mỗi trang
Đầu ra song song: CSV đi đến cả SharePoint và Email đồng thời
Giới hạn an toàn: Vòng lặp tối đa 60 lần lặp và timeout 1 giờ

4.1 Tạo Flow Lập lịch Mới

Vào Power Automate
Nhấp Create → Scheduled cloud flow
Cấu hình:
- Flow name: Jira Biweekly CSV Report
- Starting: Chọn ngày/giờ bắt đầu
- Repeat every: 2 → Weeks
Nhấp Create

4.2 Cấu hình Recurrence Trigger

Đặt các giá trị này trong trigger Recurrence:

Thuộc tính	Giá trị
Frequency	`Week`
Interval	`2`
Time zone	Múi giờ của bạn (ví dụ: `(UTC+08:00) Taipei`)
At these hours	`9`
At these minutes	`0`

Có nghĩa là: Chạy mỗi 2 tuần lúc 09:00

4.3 Khởi tạo Biến

Thêm ba action Initialize variable:

Biến 1: `varAllIssues` (Array)

Name: varAllIssues
Type: Array
Value: (để trống)

Biến 2: `varNextPageToken` (String)

Name: varNextPageToken
Type: String
Value: (để trống - đại diện cho "")

Biến 3: `varIsLast` (Boolean)

Name: varIsLast
Type: Boolean
Value: false

4.4 Thêm Vòng lặp "Do until"

Thêm action: Do until

Cấu hình điều kiện:

Bên trái: variables('varIsLast')
Toán tử: is equal to
Bên phải: true

Change limits:

Count: 60 (tối đa 60 lần lặp)
Timeout: PT1H (1 giờ)

Điều này đảm bảo vòng lặp sẽ:

Tiếp tục cho đến khi Jira cho biết trang cuối cùng (isLast = true)
Có giới hạn an toàn để ngăn vòng lặp vô hạn

4.5 Trong "Do until" - HTTP Call đến Jira

Action: HTTP

Thuộc tính	Giá trị
Method	`POST`
URI	`https://<YOUR_TENANT>.atlassian.net/rest/api/3/search/jql`
Headers	`Content-Type`: `application/json`
Authentication	`Basic`
Username	Email tài khoản Jira của bạn
Password	Jira API token của bạn (từ Bước 2)

Body (sử dụng code view để chỉnh sửa dễ hơn):

{
  "jql": "filter = 12345",
  "maxResults": 100,
  "fields": [
    "key",
    "summary",
    "status",
    "duedate",
    "resolution",
    "created",
    "customfield_10001",
    "customfield_10002",
    "customfield_10003",
    "assignee",
    "reporter",
    "priority",
    "description"
  ],
  "nextPageToken": "@{variables('varNextPageToken')}"
}

Lưu ý quan trọng:

Thay thế <YOUR_TENANT> bằng tên tenant Jira của bạn
Thay thế 12345 bằng filter ID thực tế của bạn
Thay thế customfield_XXXXX bằng custom field ID thực tế của bạn
Biểu thức @{variables('varNextPageToken')} sẽ được Power Automate đánh giá

4.6 Trong "Do until" - Parse JSON

Thêm action: Parse JSON

Thuộc tính	Giá trị
Content	Dynamic content: `Body` (từ bước HTTP)
Schema	Xem schema dưới đây

JSON Schema (ví dụ):

{
  "type": "object",
  "properties": {
    "issues": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "key": { "type": "string" },
          "fields": { "type": "object" }
        },
        "required": ["id", "key", "fields"]
      }
    },
    "nextPageToken": {
      "type": ["string", "null"]
    },
    "isLast": {
      "type": "boolean"
    }
  },
  "required": ["issues", "isLast"]
}

Mẹo: Bạn có thể tạo schema này tự động:

Chạy HTTP call một lần thủ công (sử dụng Postman hoặc tương tự)
Sao chép response JSON
Trong Power Automate Parse JSON action, nhấp Use sample payload to generate schema
Dán sample response của bạn

4.7 Trong "Do until" - Append Mỗi Issue

Thêm action: Apply to each

Thuộc tính	Giá trị
Select an output from previous steps	`body('Parse_JSON')?['issues']`

Trong Apply to each này, thêm action: Append to array variable

Thuộc tính	Giá trị
Name	`varAllIssues`
Value	`item()` (biểu thức)

Quan trọng: KHÔNG sử dụng union()

Không bao giờ sử dụng:

union(variables('varAllIssues'), variables('varAllIssues'))

Điều này gây ra lỗi self-reference. Luôn sử dụng Append to array variable.

4.8 Trong "Do until" - Cập nhật Biến Phân trang

Sau Apply to each (vẫn trong vòng lặp Do until), thêm hai action Set variable:

Set Variable 1: `varNextPageToken`

Thuộc tính	Giá trị
Name	`varNextPageToken`
Value	`body('Parse_JSON')?['nextPageToken']`

Set Variable 2: `varIsLast`

Thuộc tính	Giá trị
Name	`varIsLast`
Value	`body('Parse_JSON')?['isLast']`

Quan trọng: Không bao giờ hardcode true

Luôn sử dụng giá trị API response, không phải boolean hardcode. Điều này đảm bảo xử lý phân trang đúng cách.

Bước 5: Làm Phẳng Issues thành Định dạng CSV

5.1 Select Action (Ánh xạ Field)

Sau vòng lặp Do until (bên ngoài vòng lặp), thêm action: Select

Thuộc tính	Giá trị
From	`variables('varAllIssues')`

Ánh xạ field (thêm từng hàng qua GUI):

Tên cột	Giá trị (Biểu thức)
IssueKey	`item()?['key']`
IssueId	`item()?['id']`
Summary	`item()?['fields']?['summary']`
Status	`item()?['fields']?['status']?['name']`
DueDate	`item()?['fields']?['duedate']`
Resolution	`item()?['fields']?['resolution']?['name']`
Created	`item()?['fields']?['created']`
CustomField1	`item()?['fields']?['customfield_10001']?['value']`
CustomField2	`item()?['fields']?['customfield_10002']`
CustomField3	`item()?['fields']?['customfield_10003']?['displayName']`
AssigneeName	`item()?['fields']?['assignee']?['displayName']`
AssigneeEmail	`item()?['fields']?['assignee']?['emailAddress']`
ReporterName	`item()?['fields']?['reporter']?['displayName']`
Priority	`item()?['fields']?['priority']?['name']`
Description	`item()?['fields']?['description']`

Mẹo quan trọng:

Thêm từng ánh xạ một qua GUI
KHÔNG dán object JSON lớn - Power Automate sẽ từ chối
Sử dụng toán tử ? để xử lý null an toàn
Điều chỉnh đường dẫn field dựa trên cấu trúc custom field của bạn

5.2 Tạo CSV Table

Thêm action: Create CSV table

Thuộc tính	Giá trị
From	Output của action Select
Columns	`Automatic` (hoặc `Custom` nếu cần)

Action này chuyển đổi mảng JSON thành định dạng CSV có header.

Bước 6: Lưu CSV vào SharePoint

Thêm action: Create file

Thuộc tính	Giá trị
Site Address	`https://contoso.sharepoint.com/sites/YourSite`
Folder Path	`/Shared Documents/JiraReports`
File Name	`JiraReport-@{formatDateTime(utcNow(),'yyyyMMddHHmmss')}.csv`
File Content	Output của Create CSV table

Thay thế placeholders:

contoso → tên tenant của bạn
YourSite → tên SharePoint site của bạn
JiraReports → đường dẫn document library của bạn

Điều này tạo các file có timestamp như:

JiraReport-20251121093015.csv
JiraReport-20251205093022.csv

Bước 7: Gửi Email với File Đính kèm

Thêm action: Send an email (V2)

Thuộc tính	Giá trị
To	`reports@contoso.com`
Subject	`[Biweekly Jira Report] Filter 12345 - @{formatDateTime(utcNow(),'yyyy-MM-dd')}`
Body	Xem HTML body dưới đây

Email body (Ví dụ HTML):

<p>Xin chào Team,</p>
<p>Vui lòng xem báo cáo Jira Service Management mới nhất cho filter 12345.</p>
<p>Báo cáo này bao gồm:</p>
<ul>
  <li>Tất cả issues mở và đóng</li>
  <li>Giá trị custom field</li>
  <li>Thông tin assignee và reporter</li>
</ul>
<p>File CSV cũng được lưu trữ trong SharePoint tại:</p>
<p><strong>/Shared Documents/JiraReports</strong></p>
<br/>
<p>Trân trọng,<br/>Hệ thống Tự động</p>

Attachments:

Thuộc tính	Giá trị
Attachments Name	`JiraReport-@{formatDateTime(utcNow(),'yyyyMMdd')}.csv`
Attachments Content	Output của Create CSV table

Hướng dẫn Khắc phục Sự cố

Các Vấn đề Thường gặp và Giải pháp

1. Lỗi Self-Reference trên `varAllIssues`

Thông báo lỗi:

The action 'Set_variable' cannot use the variable 'varAllIssues' in its inputs

Nguyên nhân:

Sử dụng union(variables('varAllIssues'), variables('varAllIssues'))

Giải pháp:

Luôn sử dụng Append to array variable trong Apply to each

2. Parse JSON Liên tục Thất bại

Thông báo lỗi:

Invalid type. Expected Object but got Array.

Nguyên nhân:

Schema không khớp với cấu trúc API response thực tế

Giải pháp:

Sử dụng Postman hoặc công cụ tương tự để lấy API response thực
Sao chép toàn bộ JSON response
Trong Power Automate Parse JSON action, nhấp Use sample payload to generate schema
Dán response thực của bạn
Xem xét và điều chỉnh schema được tạo

3. Select Action Hiển thị "Enter valid JSON"

Thông báo lỗi:

Invalid expression: expected JSON object

Nguyên nhân:

Dán toàn bộ object JSON vào một field ánh xạ duy nhất

Giải pháp:

Thêm từng ánh xạ cột từng cái một qua GUI
Với mỗi cột, chỉ nhập một biểu thức
Ví dụ: item()?['fields']?['summary'] (KHÔNG phải toàn bộ object)

4. Flow Chỉ Trả về 100 Issues Đầu tiên

Vấn đề:

Báo cáo luôn chứa chính xác 100 issues, mặc dù filter có 500+

Nguyên nhân:

Điều kiện Do until không được đặt đúng
varIsLast không được cập nhật từ API response
nextPageToken không được truyền trong HTTP body

Checklist giải pháp:

Điều kiện Do until kiểm tra varIsLast = true
varIsLast được cập nhật với body('Parse_JSON')?['isLast']
nextPageToken được truyền trong HTTP body dưới dạng @{variables('varNextPageToken')}
Không có giá trị true hoặc false hardcode trong cập nhật biến

5. Lỗi Xác thực 401 hoặc 403

Thông báo lỗi:

401 Unauthorized
403 Forbidden

Nguyên nhân:

API token không hợp lệ
Quyền không đủ
Định dạng username/password sai

Giải pháp:

Xác minh API token hợp lệ (tạo lại nếu cần)
Xác nhận user Jira của bạn có quyền:
- Xem filter
- Truy cập tất cả issues trong filter
- Xem tất cả custom fields được sử dụng
Đảm bảo username là địa chỉ email của bạn (không phải display name)
Đảm bảo password là API token (không phải mật khẩu Jira của bạn)

Best Practices

Tối ưu Hiệu suất

Sử dụng maxResults = 100
- Đây là kích thước batch tối ưu cho Jira API
- Giá trị lớn hơn có thể gây timeout
- Giá trị nhỏ hơn tăng overhead API call
Sử dụng saved filters thay vì JQL phức tạp
- "jql": "filter = 12345" dễ bảo trì hơn
- JQL phức tạp có thể được test trong Jira UI trước khi hardcode
Đặt giới hạn vòng lặp phù hợp
- Count: 60 (xử lý tối đa 6000 issues)
- Timeout: PT1H (thời gian chạy tối đa 1 giờ)

Cân nhắc Bảo mật

Quản lý API Token - Chọn Mức Bảo mật của Bạn

Quan trọng: Tutorial này sử dụng Level 1 (Bảo vệ Cơ bản) - lưu trữ API token trực tiếp trong HTTP action của Power Automate. Đây là phương pháp an toàn và thực tế cho hầu hết các trường hợp sử dụng. Level 2 (Azure Key Vault) là tùy chọn và chỉ cần thiết cho các kịch bản doanh nghiệp cụ thể.

Level 1: Bảo vệ Cơ bản (Sử dụng trong Tutorial này) ✓

Lưu trữ API token trực tiếp trong field Authentication của HTTP action:

Thuộc tính	Giá trị
Authentication	`Basic`
Username	`your.email@company.com`
Password	`ATATT3xFfGF0...` (API Token)

Tính năng bảo mật:

Power Automate tự động mã hóa token
Token không hiển thị trong flow definitions đã export
Truy cập được kiểm soát bởi quyền Power Automate

Khi nào sử dụng:

Dự án cá nhân hoặc proof-of-concept
Nhóm nhỏ (< 5 người)
Môi trường không được quản lý

Không khuyến nghị khi:

❌ Nhiều flows chia sẻ cùng token (rotation trở nên khó khăn)
❌ Yêu cầu tuân thủ đòi hỏi quản lý secret tập trung
❌ Cần rotation token định kỳ

Level 2: Azure Key Vault (Tùy chọn - Chỉ Yêu cầu Doanh nghiệp)

Lưu ý: Level này chỉ cần thiết nếu tổ chức của bạn yêu cầu quản lý secret tập trung. Hầu hết người dùng có thể bỏ qua phần này.

Lưu trữ tokens trong Azure Key Vault và lấy chúng động:

Bước 1: Lưu token trong Azure Key Vault

az keyvault secret set \
  --vault-name "YourKeyVault" \
  --name "JiraApiToken" \
  --value "ATATT3xFfGF0..."

Bước 2: Thêm action "Get secret" trong Power Automate

Trước vòng lặp "Do until", thêm:

Action	Get secret (Azure Key Vault)
Vault name	`YourKeyVault`
Secret name	`JiraApiToken`
Output variable	`body('Get_secret')?['value']`

Bước 3: Tham chiếu trong HTTP action

Thuộc tính	Giá trị
Authentication	`Basic`
Username	`your.email@company.com`
Password	`@{body('Get_secret')?['value']}`

Lợi ích:

✅ Quản lý token tập trung
✅ Rotation dễ dàng (cập nhật Key Vault, tất cả flows tự động cập nhật)
✅ Access audit logs
✅ Kiểm soát truy cập chi tiết với Managed Identity
✅ Đáp ứng yêu cầu tuân thủ (SOC2, ISO 27001)

Chỉ sử dụng nếu bạn có:

❗ Yêu cầu tuân thủ bắt buộc (SOC2, ISO 27001, HIPAA)
❗ Hơn 10 flows chia sẻ cùng credentials
❗ Chính sách rotation token nghiêm ngặt (mỗi 30 ngày hoặc ít hơn)
❗ Đội ngũ infrastructure Azure chuyên dụng

Đối với hầu hết người dùng: Level 1 đã đủ và dễ bảo trì hơn.

Những gì KHÔNG Nên Làm ❌

Không bao giờ nhúng tokens dưới dạng plaintext:

// ❌ ĐỪNG: Hardcode trong JSON body
{
  "jql": "filter = 12345",
  "apiToken": "ATATT3xFfGF0..."  // Lộ trong flow definition!
}

// ❌ ĐỪNG: Lưu trong biến dưới dạng plaintext
Initialize variable: varApiToken = "ATATT3xFfGF0..."

// ❌ ĐỪNG: Tự tạo Authorization header
Headers: {
  "Authorization": "Basic base64encodedtoken..."  // Hiển thị trong logs!
}

Tại sao những điều này nguy hiểm:

Tokens xuất hiện trong flow export files
Hiển thị trong run history logs
Có thể được trích xuất bởi bất kỳ ai có quyền đọc flow

Best Practices Bảo mật Bổ sung

2. Sử dụng service accounts

Tạo tài khoản Jira service chuyên dụng cho automation
- Ví dụ: automation-bot@company.com
Dễ dàng audit và rotation credentials hơn
Ngăn khóa tài khoản cá nhân ảnh hưởng đến automation
Phân tách rõ ràng giữa danh tính con người và máy

3. Giới hạn quyền SharePoint

Chỉ cấp quyền ghi cho các document libraries cụ thể
Sử dụng nguyên tắc least-privilege
Tạo SharePoint app registration chuyên dụng nếu có thể

4. Bật audit logging

Giám sát flow run history để phát hiện bất thường
Thiết lập cảnh báo cho authentication failures
Xem xét Key Vault access logs hàng tháng

5. Triển khai token rotation

Đối với Level 1: Rotation thủ công mỗi 90 ngày
Đối với Level 2: Tự động rotation với Azure Functions
Ghi lại quy trình rotation

6. Bảo mật chính flow

Giới hạn quyền chỉnh sửa flow cho người dùng được ủy quyền
Sử dụng flows theo môi trường (Dev/Test/Prod)
Version control flow definitions trong Git

Đường dẫn Di chuyển: Từ Cơ bản đến Doanh nghiệp

Nếu bạn bắt đầu với Level 1 và cần nâng cấp:

Bước 1: Tạo Azure Key Vault

az keyvault create --name "CompanyJiraVault" --resource-group "RG-Automation"

Bước 2: Chuyển token hiện có sang Key Vault

az keyvault secret set --vault-name "CompanyJiraVault" \
  --name "JiraApiToken" --value "<your-existing-token>"

Bước 3: Cập nhật flow (không cần tạo lại)

Thêm action "Get secret" trước HTTP call
Cập nhật field password HTTP Authentication để tham chiếu secret
Test với manual trigger
Xóa token hardcode cũ

Downtime: Zero - có thể được thực hiện trong maintenance window

Khả năng Bảo trì

Sử dụng tên biến mô tả
- varAllIssues tốt hơn var1
- varNextPageToken tự ghi lại
Thêm comments cho biểu thức phức tạp
- Sử dụng tính năng "Rename" trên actions
- Thêm notes giải thích business logic
Version control flows của bạn
- Export flow definitions thường xuyên
- Lưu trữ trong source control (Git)

Kết quả Mong đợi

Sau khi triển khai thành công, bạn sẽ có:

Báo cáo CSV tự động được tạo mỗi 2 tuần
Tất cả issues được capture bất kể số lượng kết quả (xử lý 500+, 1000+, v.v.)
Dữ liệu có cấu trúc với tất cả custom fields được làm phẳng
SharePoint archive của các báo cáo lịch sử
Email notifications cho các stakeholders
Không cần nỗ lực thủ công sau thiết lập ban đầu

Tóm tắt

Giải pháp này cho thấy cách Power Automate có thể tích hợp với Jira Cloud API để tạo các workflows báo cáo tự động, cấp production. Bằng cách xử lý đúng:

API pagination với nextPageToken
Quản lý biến không self-references
Chuyển đổi nested JSON thành flat CSV
Tích hợp SharePoint để lưu trữ
Phân phối email

Bạn có thể xây dựng các tích hợp mạnh mẽ có thể mở rộng trong môi trường doanh nghiệp với hàng nghìn issues.

Những Điểm Chính

Best Practice	Tại sao Quan trọng
Sử dụng API pagination tokens	Đảm bảo tất cả records được capture
Sử dụng "Append to array variable"	Tránh lỗi self-reference
Xây dựng Select mappings qua GUI	Ngăn lỗi JSON parsing
Giữ `maxResults = 100`	Hiệu suất và độ tin cậy tối ưu
Không bao giờ hardcode `isLast`	Đảm bảo loop termination đúng
Sử dụng filter IDs trong JQL	Dễ bảo trì hơn các truy vấn phức tạp

Các Bước Tiếp theo

Sẵn sàng triển khai giải pháp này? Dưới đây là một số tài nguyên:

Xem Thực tế

Truy cập repository GitHub JSM Sales Performance Dashboard để xem:

Ví dụ dashboard trực tiếp cho thấy báo cáo tự động thúc đẩy insights kinh doanh như thế nào
Kỹ thuật trực quan hóa KPI cho đội ngũ sales và support
Triển khai thực tế trong môi trường production
End-to-end workflow từ Jira issues đến executive dashboards
Performance metrics tracking và trend analysis

Đọc Thêm

Tất cả các mẫu kỹ thuật được hiển thị ở đây đã được kiểm tra trong production và được ẩn danh để chia sẻ công khai. Vui lòng điều chỉnh kiến trúc này theo nhu cầu tổ chức của bạn.

Tổng quan Kiến trúc​

Những gì chúng ta sẽ xây dựng​

Demo & Ví dụ Thực tế​

Yêu cầu tiên quyết​

Bước 1: Lấy Jira Filter ID​

Cách tìm Filter ID​

Bước 2: Tạo Jira API Token​

Bước 3: Hiểu về Jira Search API​

API Endpoint​

Request Body (Ví dụ)​

Các tham số chính​

API Response (Đơn giản hóa)​

Bước 4: Xây dựng Power Automate Flow​

Kiến trúc Power Automate Flow​

4.1 Tạo Flow Lập lịch Mới​

4.2 Cấu hình Recurrence Trigger​

4.3 Khởi tạo Biến​

Biến 1: varAllIssues (Array)​

Biến 2: varNextPageToken (String)​

Biến 3: varIsLast (Boolean)​

4.4 Thêm Vòng lặp "Do until"​

4.5 Trong "Do until" - HTTP Call đến Jira​

4.6 Trong "Do until" - Parse JSON​

4.7 Trong "Do until" - Append Mỗi Issue​

4.8 Trong "Do until" - Cập nhật Biến Phân trang​

Set Variable 1: varNextPageToken​

Set Variable 2: varIsLast​

Bước 5: Làm Phẳng Issues thành Định dạng CSV​

5.1 Select Action (Ánh xạ Field)​

5.2 Tạo CSV Table​

Bước 6: Lưu CSV vào SharePoint​

Bước 7: Gửi Email với File Đính kèm​

Hướng dẫn Khắc phục Sự cố​

Các Vấn đề Thường gặp và Giải pháp​

1. Lỗi Self-Reference trên varAllIssues​

2. Parse JSON Liên tục Thất bại​

3. Select Action Hiển thị "Enter valid JSON"​

4. Flow Chỉ Trả về 100 Issues Đầu tiên​

5. Lỗi Xác thực 401 hoặc 403​

Best Practices​

Tối ưu Hiệu suất​

Cân nhắc Bảo mật​

Quản lý API Token - Chọn Mức Bảo mật của Bạn​

Level 1: Bảo vệ Cơ bản (Sử dụng trong Tutorial này) ✓​

Level 2: Azure Key Vault (Tùy chọn - Chỉ Yêu cầu Doanh nghiệp)​

Những gì KHÔNG Nên Làm ❌​

Best Practices Bảo mật Bổ sung​

Đường dẫn Di chuyển: Từ Cơ bản đến Doanh nghiệp​

Khả năng Bảo trì​

Kết quả Mong đợi​

Tóm tắt​

Những Điểm Chính​

Các Bước Tiếp theo​

Xem Thực tế​

Đọc Thêm​

Tổng quan Kiến trúc

Những gì chúng ta sẽ xây dựng

Demo & Ví dụ Thực tế

Yêu cầu tiên quyết

Bước 1: Lấy Jira Filter ID

Cách tìm Filter ID

Bước 2: Tạo Jira API Token

Bước 3: Hiểu về Jira Search API

API Endpoint

Request Body (Ví dụ)

Các tham số chính

API Response (Đơn giản hóa)

Bước 4: Xây dựng Power Automate Flow

Kiến trúc Power Automate Flow

4.1 Tạo Flow Lập lịch Mới

4.2 Cấu hình Recurrence Trigger

4.3 Khởi tạo Biến

Biến 1: `varAllIssues` (Array)

Biến 2: `varNextPageToken` (String)

Biến 3: `varIsLast` (Boolean)

4.4 Thêm Vòng lặp "Do until"

4.5 Trong "Do until" - HTTP Call đến Jira

4.6 Trong "Do until" - Parse JSON

4.7 Trong "Do until" - Append Mỗi Issue

4.8 Trong "Do until" - Cập nhật Biến Phân trang

Set Variable 1: `varNextPageToken`

Set Variable 2: `varIsLast`

Bước 5: Làm Phẳng Issues thành Định dạng CSV

5.1 Select Action (Ánh xạ Field)

5.2 Tạo CSV Table

Bước 6: Lưu CSV vào SharePoint

Bước 7: Gửi Email với File Đính kèm

Hướng dẫn Khắc phục Sự cố

Các Vấn đề Thường gặp và Giải pháp

1. Lỗi Self-Reference trên `varAllIssues`

2. Parse JSON Liên tục Thất bại

3. Select Action Hiển thị "Enter valid JSON"

4. Flow Chỉ Trả về 100 Issues Đầu tiên

5. Lỗi Xác thực 401 hoặc 403

Best Practices

Tối ưu Hiệu suất

Cân nhắc Bảo mật

Quản lý API Token - Chọn Mức Bảo mật của Bạn

Level 1: Bảo vệ Cơ bản (Sử dụng trong Tutorial này) ✓

Level 2: Azure Key Vault (Tùy chọn - Chỉ Yêu cầu Doanh nghiệp)

Những gì KHÔNG Nên Làm ❌

Best Practices Bảo mật Bổ sung

Đường dẫn Di chuyển: Từ Cơ bản đến Doanh nghiệp

Khả năng Bảo trì

Kết quả Mong đợi

Tóm tắt

Những Điểm Chính

Các Bước Tiếp theo

Xem Thực tế

Đọc Thêm