Ví dụ và Cách sử dụng

Phần mở rộng web Danh sách mục có tham số cho chức năng lõi và tham số bổ sung để tùy chỉnh nội dung của Danh sách mục.

Dưới đây là các tham số chính:

  • Khóa mục: Tham chiếu đến một phạm vi ô chứa tên duy nhất của các mục và hành động để xử lý thêm. Khi hành động được kích hoạt, Actions.Input.Text gửi một trong các giá trị sau:
    • Actions.Input.Text="Row": Hạng mục được chọn.
    • Actions.Input.Text="Edit": Đã nhấp vào nút Sửa.
    • Actions.Input.Text="Delete": Đã nhấp vào nút Xóa.
  • Dữ liệu mục: Tham chiếu đến phạm vi ô chứa dữ liệu mục hoặc đến ô chứa XML của cùng một dữ liệu. Cột đầu tiên của phạm vi dữ liệu dành riêng cho thuộc tính tùy chọn sau của khóa mục:
  • Tiêu đề (chuỗi)
  • Mô tả 1(chuỗi)
  • Mô tả 2 (chuỗi)
  • Dấu thời gian (chuỗi)
  • Hiển thị (Boolean): Nếu là False thì mục bị ẩn. True là mặc định.
  • Đã bật (boolean): Nếu là False thì mục bị vô hiệu hóa. True là mặc định.
  • Đã chọn (boolean): Nếu là True thì mục được chọn. False là mặc định.
  • Sửa (boolean): Nếu là True thì biểu tượng xóa và sửa trực tiếp được hiển thị. False là mặc định.
Các tham số bổ sung này cho phép tùy chỉnh nội dung. Xác định ="" để sử dụng mặc định khi có sẵn.
Ghi chú

Khi bạn có thể xác định văn bản, chẳng hạn như thông báo lỗi, hãy sử dụng hàm TRANSLATEUNIQUESTRING để đảm bảo rằng văn bản được dịch nếu ngôn ngữ của giao diện người dùng thay đổi.

  • Nhiều lựa chọn: Nếu là True thì nhiều lựa chọn được bật. False là mặc định.
  • Trình giữ chỗ Hộp tìm kiếm: Theo mặc định, hộp tìm kiếm được hiển thị và ở trạng thái trống. Xác định False để tắt hộp kiểm.
  • Thông báo lỗi: Theo mặc định, nếu không có mục danh sách, thông báo lỗi hiển thị Không sẵn có mục nào.
  • Tiêu đề chính: Tiêu đề của danh sách. Theo mặc định, không có tiêu đề nào được hiển thị.
  • Màu tiêu đề chính: Màu mặc định của tiêu đề là #368ac0
  • Màu tiêu đề: Màu mặc định của phông chữ tiêu đề là #1a1a1a.
  • Màu đã chọn: Màu tại đó hàng đã chọn được tô sáng. Mặc định là #c8e9f4.
  • Văn bản mục đã chọn: Theo mặc định, văn bản đã được Chọn. Tham số này chỉ áp dụng nếu bật nhiều lựa chọn.
  • Xóa hành động: Xác định hành động trên ô được kích hoạt khi nhấp vào nút Xóa. Văn bản mặc định đã được Xóa. Tham số này chỉ áp dụng nếu bật nhiều lựa chọn.
  • Ẩn đường viền cạnh: Xác định True để ẩn đường viền trái và phải của hàng. Theo mặc định, đường viền luôn hiển thị.
  • Màu sắc đường viền: Theo mặc định, màu của đường viền là #d8d8d8.
  1. Tạo Application Studio báo cáo.
  2. Chèn dữ liệu mẫu sau vào phạm vi B8:H12:
    Khóa Tiêu đề Mô tả1 Mô tả2 Đã bật Được chọn Sửa
    a Mục A Mô tả A FALSE ĐÚNG
    b Mục B Mô tả B Thông tin chi tiết B FALSE FALSE FALSE
    c Mục C Mô tả C ĐÚNG FALSE
    d Mục D Mô tả D FALSE FALSE
  3. Tạo biến báo cáo có tên rv_SelectedItem và xác định c là giá trị và giá trị mặc định và chọn làm giá trị của biến. Trong thuộc tính của biến, hãy xác định False làm giá trị của tùy chọn Liên tục.
  4. Trong ô G9, xác định =ReportVariables.rv_SelectedItem.Text=B9. Sao chép công thức vào ô G10, G11 và G12.
    Sau khi cập nhật như vậy, ô sẽ giữ lại văn bản ban đầu.
  5. Trên từng ô khóa (B9, B10, B11 và B12), tạo hành động với các đặc điểm sau:
    Hành động: Loại
    Chọn Đặt Tham số làm loại hành động.
    Hành động: Chế độ
    Chọn phần mở rộng web làm chế độ.
    Hành động: Điều kiện
    Xác định =Actions.Input.Text="ROW".
    Ghi chú

    Điều kiện này không hợp lệ trừ khi chế độ hành động là Phần mở rộng Web.

    Tham số: Tên
    Nhấp vào Thêm tham số và chọn biến rv_SelectedItem.
    Tham số: Thuộc tính
    Xác định Giá trị đã chọn (.Text).
    Tham số: Giá trị
    Đối với hành động trong B9, xác định =B9. Đối với các hành động khác, hãy xác định =B10, =B11, và =B12 tương ứng.
  6. Tạo biến báo cáo có tên rv_TitleItemA và xác định Mục A làm giá trị của nó. Trong thuộc tính của biến, hãy xác định Mục A làm giá trị mặc định và chọn False làm giá trị của tùy chọn Liên tục.
  7. Trong ô C9, hãy xác định =ReportVariables.rv_TitleItemA.Text và nhấn Enter.
    Sau lần cập nhật này, ô sẽ duy trì văn bản gốc.
  8. Trên ô B9, hãy tạo hành động với các đặc điểm sau:
    Hành động: Loại
    Chọn Đặt Tham số làm loại hành động.
    Hành động: Chế độ
    Chọn Phần mở rộng web làm chế độ.
    Hành động: Điều kiện
    Xác định =Actions.Input.Text="EDIT"
    Ghi chú

    Điều kiện này không hợp lệ trừ khi chế độ hành động là Phần mở rộng Web.

    Tham số: Tên
    Nhấp vào Thêm tham số và chọn biến rv_TitleItemA.
    Tham số: Thuộc tính
    Chọn Value(.Text)
    Tham số: Giá trị
    Xác định ="Edited Item A".
  9. Trong ô B13, xác định công thức SETPROPERTY này: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Nhấp vào Phần mở rộng web trên thanh công cụ Đối tượng và nhấp đúp vào phần mở rộng web Danh sách Mục.
    Con trỏ thay đổi thành hình chữ thập.
  11. Kéo con trỏ để chèn, điều chỉnh kích thước và định vị phần mở rộng web.
  12. Xác định các tham số sau.
    Tên duy nhất
    Xác định phạm vi ô chứa tên duy nhất của các mục danh sách. Trong ví dụ này, hãy xác định =B9:B12.
    Dữ liệu mục
    Xác định phạm vi ô giúp xác định bảng dữ liệu cho phần mở rộng. Trong ví dụ này, hãy xác định =B13.
  13. Tùy ý xác định giá trị cho những tham số này hoặc xác định ="" để sử dụng giá trị mặc định.
    Tiêu đề chính:
    Theo mặc định, danh sách không có tiêu đề. Bạn có thể tùy ý xác định tiêu đề.
    Màu phông chữ cho Tiêu đề chính
    Nếu tiêu đề chính đã được xác định thì màu mặc định của tiêu đề là màu xanh lam (#368ac0). Bạn có thể tùy ý xác định giá trị màu khác.
    Trình giữ chỗ Hộp tìm kiếm
    Theo mặc định, hộp tìm kiếm ở trạng thái trống. Bạn có thể tùy ý xác định văn bản để hiển thị trong hộp. Để ẩn hộp tìm kiếm, hãy xác định FALSE (lưu ý phân biệt chữ hoa chữ thường).
    Thông báo lỗi
    Theo mặc định, không hiển thị lỗi nào nếu không sẵn có mục nào. Bạn có thể tùy ý xác định thông báo lỗi. Sử dụng TRANSLATESTRING để hỗ trợ việc dịch lỗi nếu ngôn ngữ UI thay đổi.
    Màu Phông chữ Tiêu đề
    Theo mặc định, tiêu đề của các mục danh sách có màu xám đậm (#1a1a1a). Bạn có thể tùy ý xác định giá trị màu khác
    Màu đã chọn:
    Xác định màu mà mục danh sách đã chọn được tô sáng. Mặc định là màu xanh lam nhạt (#c8e9f4). Bạn có thể tùy ý xác định giá trị màu khác.
    Nhiều lựa chọn
    Theo mặc định, bạn chỉ có thể mục riêng lẻ. Để bật hộp kiểm để chọn nhiều mục, hãy xác định =”TRUE”.
    Ẩn đường viền cạnh
    Theo mặc định, mỗi hàng có một đường viền bên trái và một đường viền bên phải. Xác định “=TRUE” để ẩn các đường viền này.
    Màu sắc đường viền
    Theo mặc định, đường viền phía trên cùng và bên cạnh của danh sách có màu xám nhạt (#d8d8d8). Bạn có thể tùy ý xác định giá trị màu khác.
    Văn bản mục đã chọn:
    Nếu đã bật nhiều lựa chọn thì số lượng mục đã chọn sẽ được chỉ rõ, sau đó là Đã chọn. Bạn có thể tùy ý xác định một văn bản khác. Sử dụng TRANSLATESTRING để hỗ trợ việc dịch văn bản nếu ngôn ngữ UI thay đổi.
    Nút Xóa thanh hành động

    Nếu bật nhiều lựa chọn, bạn có thể hiển thị nút Xóa để bỏ chọn các mục đã chọn. Xác định tham chiếu ô chứa từ Xóa.

    Sử dụng TRANSLATESTRING để hỗ trợ việc dịch nút nếu ngôn ngữ UI thay đổi.