Hàm của kiểu dữ liệu List trong Cogover

Trong Cogover, các hàm instance của kiểu dữ liệu Lựa chọn (SelectList) giúp truy xuất và thay đổi thông tin của các lựa chọn trong 3 trường dữ liệu Lựa chọn đơn, Lựa chọn nhiều và Cây thư mục, hỗ trợ cho việc xử lý các câu lệnh khác để trả về kết quả mong muốn. Dưới đây là tổng quan chi tiết về cách sử dụng các nhóm hàm instance này.

Tạo tùy chọn mới cho danh sách lựa chọn

• Cú pháp: {field}.addOption(id, slug, value)
• Mô tả: Thêm một lựa chọn mới vào danh sách các lựa chọn của trường.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần thêm lựa chọn
  id	Text	Có	ID của lựa chọn cần thêm
  slug	Text	Có	Slug của lựa chọn cần thêm
  value	Text	Có	Giá trị của lựa chọn cần thêm

Kiểm tra một giá trị lựa chọn có tồn tại trong danh sách lựa chọn

• Cú pháp: {field}.containsOptionValue(value)
• Mô tả: Kiểm tra sự tồn tại của một giá trị cụ thể trong danh sách lựa chọn.
• Kiểu dữ liệu trả về: Boolean
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần kiểm tra giá trị
  value	Text	Có	Giá trị cần kiểm tra trong {field}

Loại bỏ lựa chọn

Loại bỏ lựa chọn bằng ID

• Cú pháp: {field}.removeOption(id)
• Mô tả: Loại bỏ một lựa chọn khỏi danh sách lựa chọn theo ID.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần loại bỏ lựa chọn
  id	Text	Có	ID của lựa chọn cần loại bỏ

Loại bỏ lựa chọn bằng slug

• Cú pháp: {field}.removeOptionBySlug(slug)
• Mô tả: Loại bỏ một lựa chọn khỏi danh sách lựa chọn theo slug.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần loại bỏ lựa chọn
  slug	Text	Có	Slug của lựa chọn cần loại bỏ

Loại bỏ lựa chọn bằng giá trị

• Cú pháp: {field}.removeOptionByValue(value)
• Mô tả: Loại bỏ một lựa chọn khỏi danh sách lựa chọn theo slug.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần loại bỏ lựa chọn
  value	Text	Có	Giá trị của lựa chọn cần loại bỏ

Lấy thông tin các tùy chọn đã chọn

Lấy thông tin lựa chọn đầu tiên đã chọn

• Cú pháp: {field}.getSelectedOption()
• Mô tả:
  • Trường dữ liệu Lựa chọn đơn: Trả về danh sách key-value id, slug, giá trị của lựa chọn đã chọn.
  • Trường dữ liệu Lựa chọn nhiều: Trả về danh sách key-value id, slug, value của lựa chọn đầu tiên đã chọn.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần lấy thông tin lựa chọn đầu tiên đã chọn

Lấy thông tin chi tiết lựa chọn đầu tiên đã chọn:

• Cú pháp:
  • {field}.getSelectedOption().id
  • {field}.getSelectedOption().slug
  • {field}.getSelectedOption().value
• Kiểu dữ liệu trả về: Text
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần lấy thông tin chi tiết lựa chọn đã chọn

Lấy thông tin các lựa chọn đã chọn

• Cú pháp: {field}.getSelectedOptions()
• Mô tả: Trả về List chứa các danh sách key-value id, slug, value của các lựa chọn đã chọn.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần lấy thông tin các lựa chọn đã chọn

Lấy thông tin chi tiết các lựa chọn đã chọn

• Cú pháp:
  • {field}.getSelectedOptions()[index].id
  • {field}.getSelectedOptions()[index].slug
  • {field}.getSelectedOptions()[index].value
• Mô tả: Trả về List chứa các danh sách key-value id, slug, value của các lựa chọn đã chọn.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần lấy thông tin các lựa chọn đã chọn
  index	Number	Có	Vị trí của lựa chọn đã chọn cần lấy thông tin chi tiết trong List dữ liệu trả về

Xóa tất cả các lựa chọn

• Cú pháp: {field}.clearOptions()
• Mô tả: Xóa tất cả các lựa chọn thuộc danh sách lựa chọn của trường.
• Tham số đầu vào:

  Tên tham số	Loại dữ liệu	Bắt buộc	Mô tả
  {field}	SelectList	Có	Trường dữ liệu cần xóa tất cả lựa chọn đã chọn

Ví dụ

Thông tin ban đầu của trường

Người dùng có một trường dữ liệu Lựa chọn nhiều có tên và Industry, slug là Industry gồm các lựa chọn sau:

Giá trị của trường do người dùng chọn như sau:

Trong hàm công thức, Industry sẽ là kiểu dữ liệu SelectList, các lựa chọn của trường được lưu như sau:

$record.Industry = [
    {
        "id": "OPNKZWQE6KR3J",
        "slug": "Apparel",
        "id": "Apparel"
    },
    {
        "id": "OPNKZWQE7KR3L",
        "slug": "Chemicals",
        "id": "Chemicals"
    },
    {
        "id": "OPNKZWQEEKR3B",
        "slug": "Agriculture",
        "id": "Agriculture"
    },
    {
        "id": "OPNKZWQEFKR3K",
        "slug": "Banking",
        "id": "Banking"
    },
    {
        "id": "OPNKZWQEGKR5Q",
        "slug": "Construction",
        "id": "Construction"
    }
]

Thêm lựa chọn vào danh sách lựa chọn của trường

var list = $record.Industry;
list.addOption("id1", "Technology", "Technology");
list.addOption("id2", "Healthcare", "Healthcare");

// Kết quả
list = [
    {
        "id": "OPNKZWQE6KR3J",
        "slug": "Apparel",
        "id": "Apparel"
    },
    {
        "id": "OPNKZWQE7KR3L",
        "slug": "Chemicals",
        "id": "Chemicals"
    },
    {
        "id": "OPNKZWQEEKR3B",
        "slug": "Agriculture",
        "id": "Agriculture"
    },
    {
        "id": "OPNKZWQEFKR3K",
        "slug": "Banking",
        "id": "Banking"
    },
    {
        "id": "OPNKZWQEGKR5Q",
        "slug": "Construction",
        "id": "Construction"
    },
    {
        "id": "id1",
        "slug": "Technology",
        "id": "Technology"
    },
    {
        "id": "id2",
        "slug": "Healthcare",
        "id": "Healthcare"
    }
]

Kiểm tra một giá trị lựa chọn có tồn tại trong danh sách lựa chọn

var isExist = $record.Industry.containsOptionValue("Chemicals");
return isExist;
 
// Kết quả
// isExist = true

var isExist = $record.Industry.containsOptionValue("Transportation");
return isExist;
 
// Kết quả
// isExist = false

Loại bỏ lựa chọn bằng ID

var list = $record.Industry;
list.removeOption("OPNKZWQEGKR5Q");
list.removeOption("OPNKZWQEFKR3K");
list.removeOption("OPNKZWQEEKR3B");

// Kết quả
list = [
    {
        "id": "OPNKZWQE6KR3J",
        "slug": "Apparel",
        "id": "Apparel"
    },
    {
        "id": "OPNKZWQEFKR3K",
        "slug": "Banking",
        "id": "Banking"
    }
]

Loại bỏ lựa chọn bằng slug

var list = $record.Industry;
list.removeOptionBySlug("Apparel");
list.removeOptionBySlug("Agriculture");
list.removeOptionBySlug("Banking");

// Kết quả
list = [
    {
        "id": "OPNKZWQE7KR3L",
        "slug": "Chemicals",
        "id": "Chemicals"
    },
    {
        "id": "OPNKZWQEFKR3K",
        "slug": "Banking",
        "id": "Banking"
    }
]

Loại bỏ lựa chọn bằng giá trị

var list = $record.Industry;
list.removeOptionByValue("Apparel");
list.removeOptionByValue("Chemicals");
list.removeOptionByValue("Agriculture");

// Kết quả
list = [
    {
        "id": "OPNKZWQEFKR3K",
        "slug": "Banking",
        "id": "Banking"
    },
    {
        "id": "OPNKZWQEGKR5Q",
        "slug": "Construction",
        "id": "Construction"
    }
]

Lấy thông tin lựa chọn đầu tiên đã chọn

var selected = $record.Industry.getSelectedOption();

// Kết quả
selected = {
    "id": "OPNKZWQE6KR3J",
    "slug": "Apparel",
    "id": "Apparel"
}

Lấy thông tin chi tiết lựa chọn đầu tiên đã chọn:

var selected = $record.Industry.getSelectedOption();
var selectedValue = "ID: " + selected.id + " - Slug: " + selected.slug + " - Value: " + selected.value;
return selectedValue;
 
// Kết quả
// selectedValue = "ID: OPNKZWQE6KR3J - Slug: Apparel - Value: Apparel"

Lấy thông tin các lựa chọn đã chọn

var selected = $record.Industry.getSelectedOptions();

// Kết quả
selected = [
    {
        "id": "OPNKZWQE6KR3J",
        "slug": "Apparel",
        "id": "Apparel"
    },
    {
        "id": "OPNKZWQE7KR3L",
        "slug": "Chemicals",
        "id": "Chemicals"
    }
]

Lấy thông tin chi tiết các lựa chọn đã chọn

Lấy thông tin của lựa chọn thứ 2

var selectedList = $record.Industry.getSelectedOptions();
var sencondSelectedValue = "ID: " + selectedList[1].id + " - Slug: " + selectedList[1].slug + " - Value: " + selectedList[1].value;
return sencondSelectedValue;
 
// Kết quả
// sencondSelectedValue = "ID: OPNKZWQE7KR3L - Slug: Chemicals - Value: Chemicals"

Xóa tất cả các lựa chọn

$record.Industry.clearOptions();
var numberOfItems = $record.Industry.size();
return numberOfItems;
 
// Kết quả
// numberOfItems = 0