Smart value

1. Tổng quan

Sử dụng smart values để truy cập và thao tác với dữ liệu từ bên trong hoặc từ bên ngoài hệ thống

2. Phạm vi áp dụng

• Lấy giá trị từ trường

• Cập nhật trường sử dụng smart values

• Trong Action 'Kết nối mục': sử dụng trong lựa chọn 'Smart Values' hoặc 'Dùng bộ lọc'

3. Cấu trúc

Dữ liệu của issue được tổ chức theo dạng cây, một giá trị chứa nhiều yếu tố bên dưới

Các giá trị smart values bắt đầu các giá trị bằng dấu Dollar $, để phân biệt với các nội dung khác. Smart Values có thể truy cập thông tin issue,field,... nên ta cần cung cấp vị trí và thuộc tính để truy cập dữ liệu mình cần.

Nếu muốn chuyển tới các elements bên trong, cần thêm dấu chấm vào trong giá trị của mình.

Ví dụ $input.value

a. Khi lấy giá trị dữ liệu các issue trong luklak:

Để lấy dữ liệu từ issue, ta cần nhập smart values dưới dạng sau :

[issue]: vị trí issue muốn lấy dữ liệu

• Mục kích hoạt: trigger

• Mục hiện tại: current

• Mục cha mục kích hoạt: trigger.parent

• Mục cha mục hiện tại: current.parent

[object]: nhập đối tượng trong issue muốn lấy thông tin

• id: trả về id issue - chi tiết

• key: trả về mã của issue (issue key) - chi tiết

• url: trả về url dẫn tới issue - chi tiết

• status: truy cập thông tin trạng thái issue - chi tiết

• space: truy cập thông tin của space chứa issue - chi tiết

• issuetype: truy cập thông tin issue type - chi tiết

• fields: truy cập thông tin các field trong issue

• createdBy: truy cập thông tin người tạo issue - chi tiết

• created: truy cập thông tin thời gian tạo issue - chi tiết

[element]: nhập thông tin muốn lấy từ các đối tượng truy cập vào bên trên

• Từ space: link chi tiết

• Từ status: link chi tiết

• Từ issuetype: link chi tiết

• Từ fields: link chi tiết

  • user: chi tiết

  • group: chi tiết

  • select: chi tiết

  • checkbox: chi tiết

  • date, date time: chi tiết

  • email: chi tiết

  • phone number: chi tiết

  • text: chi tiết

  • number: chi tiết

• Từ createdBy: link chi tiết

• Từ created: link chi tiết

b. Lấy thông tin từ automation:

Có thể sử dụng Smart values để lấy thông tin liên quan tới Người kích hoạt hoặc Người thực thi của Automation đang sử dụng

• Người kích hoạt: $triggerUser

• Người thực thi: $actorUser

Sau đó có thể truy cập các thuộc tính khác về Người kích hoạt, Người thực thi tương tự như các trường Chọn 1 người

Ví dụ: Lấy tên hiển thị của Người kích hoạt automation

$triggerUser.displayName

c. Khi lấy giá trị từ dữ liệu bên ngoài

• Webhook

• HTTP Request

Các đối tượng khác

1. Tổng quan

Sử dụng smart values để lấy thông tin của issue hoặc từ space, status, issuetype, createdby, created liên quan tới issue.

2. Mô tả

2.1. Thông tin issue

Ví dụ:

issue ở mục kích hoạt với thông tin như sau:

Lấy thông tin của issue

${trigger}

${trigger.id}

${trigger.key}

${trigger.url}

[${trigger.key}]${trigger.url}

[link issue}]${trigger.url}

2.2. Space

Lấy thông tin từ space chứa issue, từ đó có thể truy cập vào thông tin của area và function của space đó

Lưu ý: cách xem id space, area hoặc function(tạm thời)

• Chọn space, area hoặc function cần xem id

• Id của space, area hoặc function hiển thị trên url

• space:

• area:

• function

Ví dụ :

space chứa issue ở mục kích hoạt với thông tin như sau:

Với thông tin về area và function của space đó:

a. Lấy thông tin từ space

${trigger.space.id}

${trigger.space.key}

${trigger.space}

${trigger.space.name}

${trigger.space.url}

[${trigger.space.key}]${trigger.space.url}

[trigger.space.name}]${trigger.url}

b. Lấy thông tin từ area

${trigger.space.area}

${trigger.space.area.id}

${trigger.space.area.name}

${trigger.space.area.url}

[link area}]${trigger.apce.area.url}

${trigger.space.area.key}

c. Lấy thông tin từ function

2.3. Status

Lấy thông tin liên quan tới trạng thái hiện tại của issue

Lưu ý: cách xem id status hoặc của status category

• Chọn status hoặc của status category cần xem id

• Id của space, area hoặc function hiển thị trên url

Ví dụ:

statsus hiện tại của issue ở mục kích hoạt với thông tin như sau:

với thông tin về category của status hiện tại của space đó:

a. Lấy thông tin từ status

${trigger.status}

${trigger.status.id}

${trigger.status.name}

${trigger.status.key}

${trigger.status.description}

b. Lấy thông tin từ category status

${trigger.status.category}

${trigger.status.category.id}

${trigger.status.category.name}

${trigger.status.category.key}

${trigger.status.category.key}

2.4. Issuetype :

Lấy thông tin liên quan tới loại mục (issuetype)của issue

Ví dụ:

issuetype hiện tại của issue ở mục kích hoạt với thông tin như sau:

a. Lấy thông tin từ issuetype

${trigger.issuetype}

${trigger.issuetype.id}

${trigger.issuetype.name}

${trigger.issuetype.category}

2.5. CreatedBy:

Lấy thông tin của người tạo ra issue

Ví dụ:

Người tạo issue ở mục kích hoạt với thông tin như sau:

Khi Smart Values truy cập đến createdBy → mặc định trả về id người dùng

Ví dụ:

${trigger.createdBy}

→ Giá trị trả về: aaa-aaa

2.6. Created

Lấy thông tin về thời gian tạo ra issue

Ví dụ :

Thời gian tạo issue ở mục kích hoạt với thông tin như sau:

Khi Smart Values truy cập đến created → mặc định trả về giá trị của trường

Ví dụ:

${trigger.created}

→ Giá trị trả về: 2024-08-05T00:09:00.000+07:00

Fields

1. Tổng quan

Sử dụng smart values để lấy thông tin từ các trường dữ liệu của một issue

2. Mô tả

1. Smart Values - List (các trường multi)

Sử dụng smart values với các trường multi (Sổ xuống chọn nhiều, Nhiều hộp kiểm, Chọn nhiều người, Chọn nhiều nhóm): link mô tả

2. Smart Values - User

Sử dụng smart values để lấy giá trị từ người dùng với các trường dạng người (Chọn một người, Chọn nhiều người): link mô tả

3. Smart Values - Group

Sử dụng smart values để lấy giá trị từ nhóm với các trường dạng nhóm (Chọn một nhóm, Chọn nhiều nhóm): link mô tả

4. Smart Values - Select

Sử dụng smart values để lấy giá trị từ các trường dạng select (Sổ xuống chọn nhiều, Sổ xuống chọn một): link mô tả

5. Smart Values - Checkbox

Sử dụng smart values để lấy giá trị từ các trường dạng dạng hộp kiểm (Nhiều hộp kiểm, Hộp kiểm đơn): link mô tả

6. Smart Values - Date, Date time

Sử dụng smart values để lấy giá trị từ các trường ngày, ngày giờ (Chọn ngày, Chọn ngày giờ): link mô tả

7. Smart Values - Email

Sử dụng smart values để lấy giá trị từ các trường email (Một email, Nhiều email): link mô tả

8. Smart Values - Phone number

Sử dụng smart values để lấy giá trị từ các trường Phone number: link mô tả

9. Smart Values - Number

Sử dụng smart values để lấy giá trị từ các trường số (Số nguyên, Số thập phân, Công thức): link mô tả

10. Smart Values - Text

Sử dụng smart values để lấy giá trị từ các trường chữ (Dòng chữ, Đoạn văn bản): link mô tả

11. Smart Values - Issue picker

Sử dụng smart values để lấy giá trị từ các trường Chọn mục (Chọn một mục, Chọn nhiều mục): link mô tả

12. Lưu ý

Với các trường thông tin đặc biệt liên quan đến việc tương tác, ghi nhận thời gian cuối sẽ không thể lấy thông tin, giá trị do các dữ liệu này không được coi là một trường dữ liệu.

• Cập nhật (updated)

• Tương tác (interacted)

• Trao đổi (dicussed)

• Chuyển trạng thái (statusChanged)

• Hoàn thành (completed)

• Kết luận (resolution)

• Người cập nhật

• Người theo dõi

List (Kiểu trường multi)

Các smart values để truy cập tới một giá trị hoặc thay đổi kí tự phân tách khi liệt kê giá trị của các trường dạng Multi:

• Chọn nhiều người

• Chọn nhiều nhóm

• Sổ xuống chọn nhiều

• Nhiều hộp kiểm

• Nhiều email

Một số lưu ý:

• Hiện tại khi cập nhật các trường dạng multi qua smart values có thể cập nhật bằng nhiều giá trị, các giá trị phân cách nhau bởi dấu phảy.

• Ví dụ: khi cập nhật trường Người Quyền Cao qua smart values của Người Liên Quan:

  Copy

  ${trigger.fields.relatedUsers.join()}

  → Giá trị trả về: aaa-aaa, bbb-bbb, ccc-ccc, ddd-ddd

1. Mô tả

Ví dụ:

Trường Người Liên Quan (key field: relatedusers) ở Mục kích hoạt có 4 giá trị Nguyễn Văn A, Nguyễn Văn B, Nguyễn Văn C, Nguyễn Văn D

Trường Lớp học (key field: class) ở Mục kích hoạt có 5 giá trị: Lớp 1, Lớp 2, Lớp 3, Lớp 4, Lớp 5

Chi tiết

Với các smart values để lấy một giá trị trong danh sách

• Với trường Chọn nhiều người, Chọn nhiều nhóm: trả về id

• Với trường Sổ xuống chọn nhiều, Nhiều hộp kiểm, Nhiều email: trả về value

• Sau đó có thể truy cập tiếp các thuộc tính của giá trị đó: Chọn nhiều người (id, username, displayName, email), Chọn nhiều nhóm (id, name), Sổ xuống chọn nhiều (key, value), Nhiều hộp kiểm (key, value)

${trigger.fields.relatedusers.empty()}

${trigger.fields.relatedusers.first()}

${trigger.fields.multiselect.first()}

${trigger.fields.relatedusers.first().displayName} 
${trigger.fields.relatedusers.first().id}
${trigger.fields.relatedusers.first().username}
${trigger.fields.relatedusers.first().email}

${trigger.fields.multiselect.first().key}
${trigger.fields.multiselect.first().value}

${trigger.fields.relatedusers.last()}

${trigger.fields.multiselect.last()}

${trigger.fields.relatedusers.get(1)}
${trigger.fields.relatedusers.get(-3)}

${trigger.fields.multiselect.get(4)}
${trigger.fields.multiselect.get(-2)}

${trigger.fields.relatedusers.quantity()}

${trigger.fields.multiselect.quantity()}

${trigger.fields.relatedusers.contains('fff-fff')}

${trigger.fields.multiselect.contains('lop_01')}

${trigger.fields.relatedusers.containsAll('aaa-aaa', 'fff-fff')}

${trigger.fields.multiselect.containsAll('lop_01', 'lop_02')}

${trigger.fields.relatedusers.join()}

${trigger.fields.relatedusers.join('/')}

${trigger.fields.relatedusers.usernames()}

${trigger.fields.relatedusers.usernames('/')}

User

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường Người (Chọn một người, Chọn nhiều người)

1. Mô tả

Lưu ý: cách xem id người dùng (tạm thời)

• vào chat riêng, chọn user muốn xem id

• id của user hiển thị trên url

2.1. Chọn một người (single user picker)

Ví dụ:

Trường Người làm (key field: assignee) có giá trị Nguyễn Văn A với thông tin như sau:

Lấy thông tin từ trường

${trigger.fields.assignee}

${trigger.fields.assignee.id}

${trigger.fields.assignee.username}

${trigger.fields.assignee.displayName}

${trigger.fields.assignee.email}

${trigger.fields.assignee.mention()}

${trigger.fields.assignee.empty()}

2.2. Chọn nhiều người(multi user picker)

Ví dụ:

Trường Người Liên Quan (key field: relatedusers) ở Mục kích hoạt có 3 giá trị Nguyễn Văn A, Nguyễn Văn B, Nguyễn Văn C

Lấy thông tin từ trường

Smart values khi lấy danh sách các thuộc tính tương tự như trường single và thêm hậu tố 's()'

Các giá trị khi trả về mặc định phân tách nhau bởi dấu phảy, người dùng có thể chủ động đổi kí tự phân tách

${trigger.fields.relatedusers}

${trigger.fields.relatedusers.ids()}

${trigger.fields.relatedusers.usernames()}

${trigger.fields.relatedusers.displayNames()}

${trigger.fields.relatedusers.emails()}

${trigger.fields.relatedusers.mention()}

Group

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường Nhóm

• Chọn một nhóm

• Chọn nhiều nhóm

1. Mô tả

Lưu ý: Cách xem id nhóm (tạm thời)

• Vào cài đặt admin / Nhóm

• Chọn nhóm muốn xem id

• Id nhóm hiển thị trên url

2.1. Chọn một nhóm(single group picker)

Ví dụ:

Trường Nhóm Thực Hiện (key field: nhom_thuc_hien) có giá trị Nhóm A

Lấy thông tin của trường

${trigger.fields.nhom_thuc_hien}

${trigger.fields.nhom_thuc_hien.id}

${trigger.fields.nhom_thuc_hien.name}

${trigger.fields.nhom_thuc_hien.empty()}

2.2. Chọn nhiều nhóm(multi group picker)

Ví dụ:

Trường Nhóm Liên Quan (key field: relatedgroups) ở Mục kích hoạt có 3 giá trị Nhóm A, Nhóm B, Nhóm C

Lấy thông tin của trường

Smart values khi lấy danh sách các thuộc tính tương tự như trường single và thêm hậu tố 's()'

Các giá trị khi trả về mặc định phân tách nhau bởi dấu phảy, người dùng có thể chủ động đổi kí tự phân tách.

${trigger.fields.relatedgroups}

${trigger.fields.relatedgroups.ids()}

${trigger.fields.relatedgroups.names()}

Select

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Sổ xuống chọn một

• Sổ xuống chọn nhiều

1. Mô tả

2.1. Sổ xuống chọn một

Ví dụ:

Trường lớp học (key field: class) ở Mục kích hoạt có giá trị 'Lớp 01' với thông tin như sau:

Lấy thông tin của trường

${trigger.fields.class}

${trigger.fields.class.key}

${trigger.fields.class.value}

${trigger.fields.class.empty()}

2.2. Sổ xuống chọn nhiều

Ví dụ:

Trường Lớp học (key field: class) ở Mục kích hoạt có đang chọn 3 giá trị: Lớp 1, Lớp 2, Lớp 3

Lấy thông tin của trường

Smart values khi lấy danh sách các thuộc tính tương tự như trường single và thêm hậu tố 's()'

Các giá trị khi trả về mặc định phân tách nhau bởi dấu phảy, người dùng có thể chủ động đổi kí tự phân tách

${trigger.fields.class}

${trigger.fields.lua_chon.keys()}

${trigger.fields.lua_chon.values()}

Checkbox

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Hộp kiểm đơn

• Nhiều hộp kiểm

1. Mô tả

2.1. Hộp kiểm đơn

a. Lấy dữ liệu từ trường

Ví dụ:

Trường Xác nhận (key field: xac_nhan) ở Mục kích hoạt đang được tick chọn

Lấy thông tin của trường

${trigger.fields.xac_nhan}

2.2. Nhiều hộp kiểm

Ví dụ:

Trường Lớp học (key field: class) ở Mục kích hoạt có đang chọn 3 giá trị: Lớp 1, Lớp 2, Lớp 3

Lấy thông tin của trường

Các giá trị khi trả về mặc định phân tách nhau bởi dấu phảy, người dùng có thể chủ động đổi kí tự phân tách

${trigger.fields.class}

${trigger.fields.lua_chon.keys()}

${trigger.fields.lua_chon.values()}

Date - Date time

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Chọn ngày

• Chọn ngày giờ

1. Mô tả

2.1. Chọn ngày

Ví dụ:

Trường Ngày làm (key field: ngay_lam) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.ngay_lam}

${trigger.fields.class.ngay_lam.date()}

${trigger.fields.ngay_lam.after('04/08/2024')}

${trigger.fields.ngay_lam.before('04/08/2024')}

${trigger.fields.ngay_lam.empty()}

${trigger.fields.ngay_lam.plusDays(5)}

${trigger.fields.ngay_lam.plusDays(${trigger.fields.so_luong})}

${trigger.fields.ngay_lam.plusMonths(5)}

${trigger.fields.ngay_lam.plusDays(${trigger.fields.so_luong})}

2.2. Chọn ngày giờ

Ví dụ:

Trường Email khách (key field: email_khach) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.thoi_diem}

${trigger.fields.class.thoi_diem.datetime()}

${trigger.fields.thoi_diem.after('08/08/2024 09:00')}

${trigger.fields.thoi_diem.before('08/08/2024 09:00')}

${trigger.fields.thoi_diem.empty()}

${trigger.fields.thoi_diem.plusHours(5)}

${trigger.fields.thoi_diem.plusDays(${trigger.fields.so_luong})}

${trigger.fields.thoi_diem.plusDays(5)}

${trigger.fields.thoi_diem.plusDays(${trigger.fields.so_luong})}

${trigger.fields.thoi_diem.plusMonths(5)}

${trigger.fields.thoi_diem.plusDays(${trigger.fields.so_luong})}

Tính khoảng thời gian giữa 2 trường:

Có thể sử dụng cú pháp sau để tính khoảng thời gian giữa 2 trường ngày giờ:

$trigger.fields.[key_field_1].diff($trigger.fields.[key_fields_2]).[abs].[unit_time]

trong đó:

• [key_field_1]: mã trường ngày giờ đích

• [key_field_2]: mã trường ngày giờ bắt đầu

• [abs]: có thể có hoặc không, giúp trả về giá trị tuyệt đối giữa 2 khoảng thời gian

• [unit_time]: đơn vị thời gian muốn tính ra kết quả

  • millis: mili giây

  • seconds: giây

  • minutes: phút

  • hours: giờ

  • days: ngày

Ví dụ:

Tính khoảng thời gian giữa 2 trường kiểu Ngày giờ là Thời điểm bắt đầu (start_time) và Thời điểm kết thúc (end_time) ở Mục kích hoạt:

$trigger.fields.start_time.diff($trigger.fields.end_time).millis
$trigger.fields.start_time.diff($trigger.fields.end_time).seconds
$trigger.fields.start_time.diff($trigger.fields.end_time).minutes
$trigger.fields.start_time.diff($trigger.fields.end_time).hours
$trigger.fields.start_time.diff($trigger.fields.end_time).days

→ Giá trị trả về:

2719800000 2719800 45330 755 31

Email

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Một email

• Nhiều email

1. Mô tả

2.1. Một email

Ví dụ:

Trường Email khách (key field: email_khach) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.email_khach}

${trigger.fields.email_khach.empty()}

2.2. Nhiều mail

Lấy thông tin từ trường

Các giá trị khi trả về mặc định phân tách nhau bởi dấu phảy, người dùng có thể chủ động đổi kí tự phân tách

${trigger.fields.email_nhan}

PhoneNumber

1. Tổng quan

Sử dụng smart values để lấy giá trị từ trường Số điện thoại

1. Mô tả

Ví dụ:

Trường Số liên hệ (key field: so_lien_he) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường:

${trigger.fields.so_lien_he}

${trigger.fields.so_lien_he.empty()}

Number

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Số nguyên

• Số thập phân

• Công thức

1. Mô tả

2.1. Số nguyên

Ví dụ:

Trường Số lượng (key field: so_luong) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.so_luong}

${trigger.fields.so_luong.empty()}

2.2. Số thập phân

Ví dụ:

Trường Chiều dài (key field: chieu_dai) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.chieu_dai}

${trigger.fields.class.chieu_dai.format()}

${trigger.fields.chieu_dai.empty()}

2.3. Công thức

Ví dụ:

Trường Khoảng cách (key field: khoang_cach) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.khoang_cach}

${trigger.fields.class.khoang_cach.format()}

${trigger.fields.khoang_cach.empty()}

Text

1. Tổng quan

Sử dụng smart values để lấy giá trị từ các trường:

• Dòng chữ (text field)

• Đoạn văn bản (text area)

1. Mô tả

2.1. Dòng chữ (text field)

Ví dụ:

Trường Lời nhắc (key field: loi_nhac) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.loi_nhac}

${trigger.fields.loi_nhac.empty()}

2. Đoạn văn bản (text area)

Ví dụ:

Trường Nội dung (key field: noi_dung) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.noi_dung}

${trigger.fields.noi_dung.empty()}

Component

1. Tổng quan

Sử dụng smart values để lấy giá trị từ component

1. Mô tả

Ví dụ:

Thành Phần (component) ở Mục kích hoạt có giá trị như sau

Lấy thông tin của trường

${trigger.fields.component}

${trigger.fields.component.id}

${trigger.fields.component.name}

Issue picker

1. Tổng quát

Sử dụng smart values để lấy giá trị từ các trường Nhóm

• Chọn một mục

• Chọn nhiều mục

1. Mô tả

2.1. Chọn một mục (single issue picker) Ví dụ:

Trường Danh sách công việc (key field: danh_sach_cong_viec) có giá trị là issue In tài liệu

Lấy thông tin của trường

${trigger.fields.danh_sach_cong_viec}

${trigger.fields.danh_sach_cong_viec.fields.title}

${trigger.fields.danh_sach_cong_viec.fields.assignee.displayName}

${trigger.fields.danh_sach_cong_viec.empty()}