Trang này được dịch bởi Cloud Translation API.

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

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

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 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 bằng một ngôn ngữ khác với ngôn ngữ mặc định.

Tài liệu này mô tả cách xác định, bật và sửa đổi các thông số có thể ghi đè, cũng như 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 tham số trong Looker Studio, hãy xem bài viết Tham số nguồn dữ liệu.

Vai trò

Vai trò của người dùng được tham chiếu trong tài liệu này:

Role	Đị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	Một 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 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 vào báo cáo ở chế độ xem.

Xác định tham 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 trình kết nối cộng đồng. Để xác định một thông số cấu hình có thể ghi đè, trình kết nối sẽ gọi setAllowOverride(true).

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.

Ảnh chụp màn hình 2 tham số có thể ghi đè

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();
}

Khi nào nên tránh xác định thông 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 với 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 thông số là có thể ghi đè trong các trường hợp sau:

Khi giá trị của một tham số ảnh hưởng đến giản đồ.
- Nếu người dùng thay đổi một giá trị tham số và giản đồ của dữ liệu mới được trả về khác với đượ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ị lỗi do thiếu các trường.
Nếu một giá trị thông 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 tham số là có thể ghi đè nếu bạn muốn ngăn việc 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 việc trình chỉnh sửa báo cáo có thể sửa đổi những thông số có thể ghi đè nào. Tương tự, 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.

Cho phép trình chỉnh sửa báo cáo sửa đổi 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. Thông số 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à chỉ áp dụng cho các thông số đã được nhà phát triển Trình kết nối xác định là có thể ghi đè. Nếu bạn bật tính năng này, thì trình chỉnh sửa báo cáo sẽ có thể Sửa đổi thông số trong báo cáo.

Trong ví dụ sau, 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, trình chỉnh sửa báo cáo có tuỳ chọn sửa đổi giá trị thông số zipcode.

Bật chế độ ghi đè

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

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. Trình chỉnh sửa báo cáo sẽ không có quyền truy cập hoặc chế độ hiển thị để cho phép người xem báo cáo sửa đổi thông số units.

Đã bật thông số mã zip — **Hình 1**: Cấu hình trình kết nối.

Chỉ có thể sửa đổi thông số mã Zip — **Hình 2**: Quản lý thông số.

Tham số URL

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

Chỉnh sửa báo cáo.
Chọn Tài nguyên -> Quản lý tham số URL của báo cáo.
Sử dụng các 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. Hệ thống sẽ tự động lưu các thay đổi.
Nhấp vào Đóng ở phía trên bên phải.

Sửa đổi giá trị thông 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 thuộc tính của 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 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 bài viết Sửa đổi thông số trong báo cáo.

Tham số URL báo cáo

Đối với những thông số được cho 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 mã hoá URL được thêm vào URL báo cáo ở chế độ xem.

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

Thu thập tên thông số
1. Chỉnh sửa báo cáo.
2. Chọn Tài nguyên -> Quản lý tham số URL của báo cáo.
3. Hãy lưu ý tên của các thông số mà bạn đị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.
Tạo đối tượng tham số

Tham số được xác định thông qua đối tượng JSON. Khoá cho giá trị thông số là tên thông số.
```
{
  "parameterName": parameterValue
}
```
Các loại giá trị tham số là STRING, NUMBER hoặc BOOLEAN. Đối với các tham số chấp nhận nhiều giá trị (tức là trình đơn thả xuống nhiều lựa chọn), hãy sử dụng một mảng giá trị.

Ví dụ: nếu tên tham số là ds0.zipcode, để đặt Mã ZIP thành 94094, JSON sẽ như sau:
```
{
  "ds0.zipcode": "94094"
}
```
URL Mã hoá đối tượng tham số

Sau khi bạn tạo đối tượng tham số, hãy sử dụng JSON.stringify() để chuyể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)
```
Điều này dẫn đến chuỗi được mã hoá sau:
```
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
```
Tạo URL báo cáo

Sau khi bạn có đối tượng tham số mã hoá URL, hãy thêm đối tượng đó vào URL của 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 mình.
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 mục 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 tham số. Phần này cũng minh hoạ các giá trị tham số cài đặt cho các loại dữ liệu đầu vào.

ds0.includeToday là hộp đánh dấu
ds0.units là một giá trị nhập được chọn
ds1.countries là phương thức nhập 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 tham số

Giá trị dùng cho một tham số tuân theo thứ tự ưu tiên dựa trên nơi đặt tham số. Tham số được đặt ở vị trí có mức độ ưu tiên cao hơn sẽ ghi đè các tham số được đặt ở 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à:

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