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

Thông số cấu hình có thể ghi đè cung cấp lựa chọn 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 tham số cấu hình là có thể ghi đè sẽ khiến nguồn dữ liệu linh hoạt hơn và cung cấp cho người dùng cách tạo nguồn dữ liệu có thể định cấu hình mẫu báo cáo.

Ví dụ: một trình kết nối cung cấp dữ liệu thời tiết có thể bao gồm thông tin 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ữ khác với chế độ mặc định.

Tài liệu này mô tả cách xác định và bật các tham số có thể ghi đè cho 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 tìm hiểu thêm về cách sử dụng các tham số trong Looker Studio. Hãy xem thêm Thông số nguồn dữ liệu.

Vai trò

Vai trò của người dùng được đề cập xuyên suốt tài liệu:

Vai trò	Định nghĩa
Nhà phát triển trình kết nối	Người dùng đã tạo 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 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 ở chế độ chỉnh sửa vào báo cáo.
Người xem báo cáo	Người dùng có quyền truy cập ở chế độ xem vào báo cáo.

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

Nhà phát triển trình kết nối xác định các thông số cấu hình trong Hàm getConfig() của trình kết nối cộng đồng. Để xác định một thông số cấu hình là có thể ghi đè trình kết nối 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 và 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 của allowOverride là false. Nếu bạn không muốn bật tính năng ghi đè cho một thông số, bạn có thể bỏ qua lệnh gọi đến setAllowOverride().

Thời điểm tránh xác định một tham số là có thể ghi đè

Bạn nên tìm hiểu cách hoạt động của Trình kết nối, Nguồn dữ liệu và Báo cáo trong với nhau bằng cách xem 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ị thông số và giản đồ của dữ liệu mới được trả về khác với đã xác định trong nguồn dữ liệu, bất kỳ báo cáo nào phụ thuộc vào nguồn dữ liệu có thể bị lỗi do thiếu trường.
2. Trường hợp 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.
   • Không xác định một thông số là có thể ghi đè nếu bạn muốn ngăn chặn vô tình xem hoặc chia sẻ dữ liệu nhạy cảm.

Bật thông 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 tham số có thể ghi đè được phép sửa đổi bởi người chỉnh sửa báo cáo. Tương tự, trình chỉnh sửa báo cáo kiểm soát người xem báo cáo có thể sửa đổi các thông số.

Cho phép trình 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 tham số được phép sửa đổi trong . Điều này được định cấu hình trong quá trình tạo hoặc chỉnh sửa nguồn dữ liệu và được chỉ áp dụng cho các thông số đã được được xác định là có thể ghi đè bởi Trình kết nối nhà phát triển. Nếu bạn bật tùy chọn này thì trình 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 zipcode sửa đổi trong báo cáo. Trong báo cáo, trình 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 các giá trị thông số

Trình 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 đó, bất kỳ người xem nào cũng có thể sửa đổi các giá trị thông số thông qua URL báo cáo của báo cáo.

Lưu ý: Kiểm soát của trình chỉnh sửa báo cáo đối với việc cho phép sửa đổi thông số là ở những tham 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 zipcode được sửa đổi trong báo cáo (hình 2), sau đó, trình 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. Báo cáo Editor sẽ không có quyền truy cập hoặc chế độ hiển thị để cho phép tham số units sửa đổi theo người xem báo cáo.

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

Hình 2: Quản lý thông số.

Cảnh báo: Người xem báo cáo sẽ có thể truy cập bất kỳ dữ liệu nào do tham số. Để tránh vô tình chia sẻ dữ liệu nhạy cảm, hãy xem xét và xác nhận nguồn dữ liệu và thông tin đăng nhập vào nguồn dữ liệu đó được định cấu hình trước khi cho phép sửa đổi thông số. Nếu một thông số bật quyền 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ể thấy 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 (Tài nguyên) -> Quản lý các tham số URL trong 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 các giá trị thông số trong URL báo cáo. Các thay đổi là đã được lưu tự động.
4. Nhấp vào Đóng ở phía trên bên phải.

Đang sửa đổi giá trị thông số

Người chỉnh sửa báo cáo có thể sửa đổi các giá trị thông số bằng bảng thuộc tính báo cáo còn 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 trình chỉnh sửa báo cáo có thể đặt giá trị thông số, hãy xem Sửa đổi các thông số trong báo cáo.

Tham số URL báo cáo

Đối với các thông số được phép sửa đổi trong URL báo cáo, các giá trị có thể được đặt thông qua đối tượng JSON được mã hoá URL đượ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 thông số

   1. Chỉnh sửa báo cáo.
   2. Chọn Resource (Tài nguyên) -> Quản lý các tham số URL trong báo cáo.
   3. Lưu ý tên của các thông số mà bạn định thiết lập thông qua báo cáo URL.

   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 đối tượng JSON. Khoá cho các giá trị thông số là tên thông số.

   {
     "parameterName": parameterValue
   }
   

   Loại giá trị thông số là một trong các loại STRING, NUMBER hoặc BOOLEAN. Cho các thông số chấp nhận nhiều giá trị (tức là trình đơn thả xuống chọn nhiều giá trị) sử dụng mảng giá trị.

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

   {
     "ds0.zipcode": "94094"
   }
   

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

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

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

   Kết quả là sẽ 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

   Khi bạn có đối tượng thông số được mã hoá URL, hãy thêm đối tượng đó vào chế độ xem báo cáo URL 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.

5. Sử dụng URL

   URL báo cáo sẽ ghi đè các tham số như được xác định trong tham số JSON dựa trên 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 đặt nhiều thông số. Điều này cũng minh hoạ các giá trị tham số cài đặt cho các kiểu dữ liệu đầu vào khác nhau.

• ds0.includeToday là giá trị nhập bằng hộp đánh dấu
• ds0.units là phương thức nhập một lần
• ds1.countries là giá trị nhập vào nhiều lựa chọn
• ds1.labelName là phương thức nhập văn bản.

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

Kế thừa thông số

Giá trị dùng cho một thông số tuân theo thứ tự ưu tiên dựa trên vị trí tham số được đặt. Ghi đè thông số được đặt ở vị trí có mức độ ưu tiên cao hơn tham số được đặt ở vị trí ư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 điều khiển thuộc tính báo cáo, theo dõi nguồn dữ liệu các quy tắc kế thừa tham số.