Thông số cấu hình có thể ghi đè

Các thông số cấu hình có thể ghi đè cho phép người chỉnh sửa báo cáo sửa đổi các giá trị mặc định trong một nguồn dữ liệu. Việc xác định các tham số cấu hình là có thể ghi đè sẽ giúp nguồn dữ liệu linh hoạt hơn và cho phép người dùng tạo các mẫu báo cáo mà người dùng có thể định cấu hình.

Ví dụ: trình kết nối cung cấp dữ liệu thời tiết có thể bao gồm một tham số vị trí cho phép người xem báo cáo yêu cầu báo cáo thời tiết từ một ngôn ngữ địa phương khác với ngôn ngữ mặc định.

Tài liệu này mô tả cách xác định các thông số có thể ghi đè, cách bật để sửa đổi và cách người dùng báo cáo có thể sửa đổi các giá trị thông số. Để tìm hiểu thêm về cách sử dụng các thông số trong Looker Studio, hãy xem bài viết Thông số nguồn dữ liệu.

Vai trò

Các vai trò của người dùng được đề cập trong tài liệu:

Vai trò	Định nghĩa
Nhà phát triển trình kết nối	Người dùng đã xây dựng trình kết nối cộng đồng.
Chủ sở hữu nguồn dữ liệu	Người dùng tạo và sở hữu một nguồn dữ liệu.
Trình chỉnh sửa báo cáo	Người dùng có quyền truy cập vào báo cáo ở chế độ chỉnh sửa.
Người xem báo cáo	Người dùng có quyền truy cập vào báo cáo ở chế độ xem.

Xác định các thông số có thể ghi đè

Nhà phát triển trình kết nối xác định các tham số cấu hình trong hàm getConfig() của một trình kết nối cộng đồng. Để xác định một tham số cấu hình có thể ghi đè, trình kết nối sẽ gọi setAllowOverride(true).

Lưu ý: Bạn cũng có thể xác định các thông số trong truy vấn tuỳ chỉnh BigQuery.

Ví dụ sau đây xác định 2 tham số có thể ghi đè: zipcode và units, cùng 1 tham số không thể ghi đè: days-to-forcecast.

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

Lưu ý: Giá trị mặc định cho allowOverride là false. Nếu không muốn bật chế độ ghi đè cho một thông số, bạn có thể bỏ qua lệnh gọi đến setAllowOverride().

Khi nào nên tránh xác định một tham số là có thể ghi đè

Bạn nên tìm hiểu cách Trình kết nối, Nguồn dữ liệu và Báo cáo hoạt động liên quan đến nhau bằng cách xem bài viết Cách Looker Studio kết nối với dữ liệu của bạn.

Tránh xác định một tham số là có thể ghi đè trong các trường hợp sau:

1. Khi giá trị của một tham số ảnh hưởng đến giản đồ.
   • Nếu người dùng thay đổi giá trị tham số và giản đồ của dữ liệu mới được trả về khác với giản đồ được xác định trong nguồn dữ liệu, thì mọi báo cáo phụ thuộc vào nguồn dữ liệu đều có thể bị hỏng do thiếu trường.
2. Nếu một giá trị tham số kiểm soát dữ liệu nhạy cảm. Ví dụ: Lựa chọn tài khoản.
   • Đừng xác định một tham số là có thể ghi đè nếu bạn muốn ngăn chặn việc vô tình xem hoặc chia sẻ dữ liệu nhạy cảm.

Bật các tham số cho người dùng báo cáo

Chủ sở hữu nguồn dữ liệu kiểm soát những thông số có thể ghi đè mà người chỉnh sửa báo cáo được phép sửa đổi. Tương tự, người chỉnh sửa báo cáo kiểm soát những thông số mà người xem báo cáo có thể sửa đổi.

Cho phép người chỉnh sửa báo cáo sửa đổi các giá trị thông số

Chủ sở hữu nguồn dữ liệu kiểm soát những thông số được phép sửa đổi trong báo cáo. Bạn có thể định cấu hình chế độ này trong quá trình tạo hoặc chỉnh sửa nguồn dữ liệu và chỉ áp dụng cho những thông số mà nhà phát triển Trình kết nối đã xác định là có thể ghi đè. Nếu được bật, người chỉnh sửa báo cáo sẽ có thể Sửa đổi các thông số trong báo cáo.

Trong ví dụ sau, một trình kết nối có 2 tham số được xác định là có thể ghi đè: zipcode và units. Chủ sở hữu nguồn dữ liệu chỉ cho phép sửa đổi zipcode trong báo cáo. Trong báo cáo, người chỉnh sửa báo cáo có thể sửa đổi giá trị tham số zipcode.

Cho phép người xem báo cáo sửa đổi giá trị thông số

Người chỉnh sửa báo cáo kiểm soát những thông số mà người xem báo cáo có thể sửa đổi. Sau đó, mọi người xem báo cáo đều có thể sửa đổi các giá trị tham số thông qua URL báo cáo.

Lưu ý: Người chỉnh sửa báo cáo chỉ có thể kiểm soát việc cho phép sửa đổi các thông số đối với những thông số mà chủ sở hữu nguồn dữ liệu cho phép.

Ví dụ: hãy xem xét một trình kết nối có 2 tham số được xác định là có thể ghi đè: zipcode và units (hình 1). Nếu chủ sở hữu nguồn dữ liệu đã cho phép sửa đổi zipcode trong báo cáo (hình 2), thì người chỉnh sửa báo cáo sẽ chỉ có thể cho phép người xem báo cáo sửa đổi zipcode. Người chỉnh sửa báo cáo sẽ không có quyền truy cập hoặc quyền xem để cho phép người xem báo cáo sửa đổi tham số units.

Hình 1: Cấu hình trình kết nối.

Hình 2: Quản lý các tham số.

Cảnh báo: Người xem báo cáo sẽ có thể truy cập vào mọi dữ liệu do các tham số kiểm soát. Để tránh vô tình chia sẻ dữ liệu nhạy cảm, hãy xem xét và xác nhận rằng nguồn dữ liệu và thông tin đăng nhập nguồn dữ liệu được định cấu hình chính xác trước khi cho phép sửa đổi một tham số. Nếu một thông số cho phép truy cập vào dữ liệu nhạy cảm, hãy cân nhắc sử dụng thông tin đăng nhập của người xem để đảm bảo người xem báo cáo chỉ có thể xem dữ liệu của họ.

Thông số URL

Cách cho phép người xem báo cáo chỉnh sửa các giá trị thông số thông qua URL báo cáo:

1. Chỉnh sửa báo cáo.
2. Chọn Resource -> Manage report parameters (Tài nguyên -> Quản lý các tham số báo cáo).
3. Sử dụng hộp đánh dấu Cho phép sửa đổi trong URL báo cáo để cho phép hoặc không cho phép sửa đổi giá trị tham số trong URL báo cáo. Các thay đổi sẽ được lưu tự động.
4. Nhấp vào Đóng ở phía trên bên phải.

Sửa đổi giá trị tham số

Người chỉnh sửa báo cáo có thể sửa đổi giá trị thông số bằng cách sử dụng bảng điều khiển thuộc tính báo cáo, trong khi người xem báo cáo có thể sửa đổi giá trị thông số thông qua URL báo cáo.

Bảng điều khiển thuộc tính báo cáo

Để tìm hiểu cách người chỉnh sửa báo cáo có thể đặt giá trị thông số, hãy xem bài viết Sửa đổi thông số trong báo cáo.

Tham số URL của báo cáo

Đối với những thông số được phép sửa đổi trong URL báo cáo, bạn có thể đặt giá trị thông qua một đối tượng JSON được mã hoá URL và được thêm vào URL báo cáo ở chế độ xem.

Cách tạo cấu hình URL:

1. Thu thập tên tham số

   1. Chỉnh sửa báo cáo.
   2. Chọn Resource -> Manage report parameters (Tài nguyên -> Quản lý các tham số báo cáo).
   3. Ghi lại tên của các thông số mà bạn dự định đặt thông qua URL báo cáo.

   Ví dụ: trong hình bên dưới, tên tham số là ds0.zipcode.

   

2. Tạo đối tượng tham số

   Các tham số được xác định thông qua một đối tượng JSON. Khoá cho các giá trị tham số là tên tham số.

   {
     "parameterName": parameterValue
   }
   

   Các loại giá trị tham số là một trong STRING, NUMBER hoặc BOOLEAN. Đối với các thông số chấp nhận nhiều giá trị (tức là trình đơn thả xuống có thể chọn nhiều), hãy sử dụng một mảng giá trị.

   Ví dụ: nếu tên tham số là ds0.zipcode, để đặt Mã bưu chính thành 94094, JSON sẽ có dạng như sau:

   {
     "ds0.zipcode": "94094"
   }
   

3. Mã hoá URL đối tượng tham số

   Sau khi tạo đối tượng tham số, hãy dùng JSON.stringify() để chuyển đối tượng đó thành một chuỗi, sau đó dùng [encodeURIComponent] để mã hoá URL.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Điều này dẫn đến chuỗi được mã hoá sau:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Tạo URL báo cáo

   Sau khi bạn có đối tượng tham số được mã hoá URL, hãy thêm đối tượng đó vào URL chế độ xem báo cáo bằng cách sử dụng tham số truy vấn params.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   Hãy nhớ thay thế REPORT_ID và PAGE_ID bằng các giá trị cho báo cáo và trang của bạn.

5. Sử dụng URL

   URL báo cáo sẽ ghi đè các tham số như được xác định trong đối tượng tham số JSON dựa trên Tính năng kế thừa tham số.

Ví dụ về đối tượng tham số

Đối tượng tham số sau đây cho biết cách thiết lập nhiều tham số. Phần này cũng minh hoạ cách đặt giá trị tham số cho các loại dữ liệu đầu vào khác nhau.

• ds0.includeToday là một hộp đánh dấu
• ds0.units là một lựa chọn đầu vào duy nhất
• ds1.countries là một đầu vào chọn nhiều
• ds1.labelName là một thành phần nhập văn bản.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Kế thừa tham số

Giá trị được dùng cho một tham số tuân theo thứ tự ưu tiên dựa trên vị trí đặt tham số. Các thông số được đặt ở những vị trí có mức độ ưu tiên cao hơn sẽ ghi đè các thông số được đặt ở những vị trí có mức độ ưu tiên thấp hơn. Thứ tự ưu tiên (từ thấp nhất đến cao nhất) là:

1. Nguồn dữ liệu (mặc định)
2. URL báo cáo
3. Bảng thuộc tính báo cáo, tuân theo các quy tắc kế thừa tham số của nguồn dữ liệu.