หน้านี้ได้รับการแปลโดย Cloud Translation API

พารามิเตอร์การกำหนดค่าที่ลบล้างได้

พารามิเตอร์การกำหนดค่าที่ลบล้างได้จะมีตัวเลือกเพื่อให้เครื่องมือแก้ไขรายงานแก้ไขค่าเริ่มต้นในแหล่งข้อมูลได้ การกำหนดพารามิเตอร์การกำหนดค่าเป็น "ลบล้างได้" ทำให้แหล่งข้อมูลมีความยืดหยุ่นมากขึ้นและช่วยให้ผู้ใช้สร้างเทมเพลตรายงานที่ผู้ใช้กำหนดค่าได้

ตัวอย่างเช่น เครื่องมือเชื่อมต่อที่ให้ข้อมูลสภาพอากาศอาจมีพารามิเตอร์ตำแหน่ง ที่ช่วยให้ผู้ดูรายงานขอรายงานสภาพอากาศจากภาษาอื่นที่ไม่ใช่ภาษาเริ่มต้นได้

เอกสารนี้จะอธิบายวิธีกำหนด เปิดใช้การแก้ไข และกำหนดพารามิเตอร์ที่ลบล้างได้ และผู้ใช้รายงานจะแก้ไขค่าพารามิเตอร์ได้อย่างไร ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้พารามิเตอร์ใน Looker Studio ได้ที่พารามิเตอร์แหล่งข้อมูล

บทบาท

บทบาทของผู้ใช้ที่อ้างอิงในเอกสารทั้งหมดมีดังนี้

บทบาท	คำจำกัดความ
นักพัฒนาเครื่องมือเชื่อมต่อ	ผู้ใช้ที่สร้างปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูลแล้ว
เจ้าของแหล่งข้อมูล	ผู้ใช้ที่สร้างและเป็นเจ้าของแหล่งข้อมูล
เครื่องมือแก้ไขรายงาน	ผู้ใช้ที่มีสิทธิ์เข้าถึงโหมดแก้ไขของรายงาน
ผู้ดูรายงาน	ผู้ใช้ที่มีสิทธิ์เข้าถึงรายงานในโหมดดู

การกำหนดพารามิเตอร์ที่ลบล้างได้

นักพัฒนาซอฟต์แวร์เครื่องมือเชื่อมต่อจะกำหนดพารามิเตอร์การกำหนดค่าในฟังก์ชัน getConfig() ของปลั๊กอินจากชุมชนสำหรับใช้ลิงก์ข้อมูล หากต้องการกำหนดพารามิเตอร์การกำหนดค่าเป็นลบล้างได้ ให้เรียกใช้เครื่องมือเชื่อมต่อ setAllowOverride(true)

ตัวอย่างต่อไปนี้กำหนดพารามิเตอร์ที่ลบล้างได้ 2 รายการ ได้แก่ zipcode และ units และพารามิเตอร์ 1 รายการที่ลบล้างไม่ได้: days-to-forcecast

ภาพหน้าจอของพารามิเตอร์ที่ลบล้างได้ 2 รายการ

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

กรณีที่ควรหลีกเลี่ยงการกําหนดพารามิเตอร์เป็นลบล้างได้

เราขอแนะนำให้ดูว่าเครื่องมือเชื่อมต่อ แหล่งข้อมูล และรายงานทำงานร่วมกันอย่างไรโดยอ่านวิธีที่ Looker Studio เชื่อมต่อกับข้อมูลของคุณ

หลีกเลี่ยงการกําหนดพารามิเตอร์เป็นลบล้างได้ในกรณีต่อไปนี้

เมื่อค่าของพารามิเตอร์ส่งผลต่อสคีมา
- หากผู้ใช้เปลี่ยนค่าพารามิเตอร์และสคีมาของข้อมูลใหม่ที่แสดงผลแตกต่างจากที่กำหนดไว้ในแหล่งข้อมูล รายงานใดๆ ที่ขึ้นอยู่กับแหล่งข้อมูลอาจใช้งานไม่ได้เนื่องจากไม่มีช่องข้อมูล
หากค่าพารามิเตอร์ควบคุมข้อมูลที่ละเอียดอ่อน เช่น การเลือกบัญชี
- อย่ากำหนดให้พารามิเตอร์เป็นแบบลบล้างได้ หากคุณต้องการป้องกันการดูหรือการแชร์ข้อมูลที่ละเอียดอ่อนโดยไม่ได้ตั้งใจ

การเปิดใช้พารามิเตอร์สำหรับผู้ใช้ที่รายงาน

เจ้าของแหล่งข้อมูลจะควบคุมว่าพารามิเตอร์ที่ลบล้างได้รายการใดได้รับอนุญาตให้แก้ไขโดยเครื่องมือแก้ไขรายงาน ในทำนองเดียวกัน เครื่องมือแก้ไขรายงานจะควบคุมว่าผู้ดูรายงาน จะแก้ไขพารามิเตอร์ใดได้บ้าง

อนุญาตให้เครื่องมือแก้ไขรายงานแก้ไขค่าพารามิเตอร์

เจ้าของแหล่งข้อมูลจะควบคุมพารามิเตอร์ที่แก้ไขได้ในรายงาน ซึ่งกำหนดค่าระหว่างการสร้างหรือแก้ไขแหล่งข้อมูลและใช้ได้เฉพาะกับพารามิเตอร์ที่กำหนดไว้เป็นลบล้างได้โดยนักพัฒนาซอฟต์แวร์ หากเปิดใช้ เครื่องมือแก้ไขรายงานจะแก้ไขพารามิเตอร์ในรายงานได้

ในตัวอย่างต่อไปนี้ เครื่องมือเชื่อมต่อมีพารามิเตอร์ 2 รายการที่กำหนดให้ลบล้างได้: zipcode และ units เจ้าของแหล่งข้อมูลอนุญาตให้แก้ไข zipcode ในรายงานได้เท่านั้น ในรายงาน เครื่องมือแก้ไขรายงานมีตัวเลือกในการแก้ไขค่าพารามิเตอร์ zipcode

การเปิดใช้ตัวเลือกการลบล้าง

อนุญาตให้ผู้ดูรายงานแก้ไขค่าพารามิเตอร์

เครื่องมือแก้ไขรายงานจะควบคุมพารามิเตอร์ที่ผู้ดูรายงานแก้ไขได้ ผู้ดูรายงานจะสามารถแก้ไขค่าพารามิเตอร์ผ่านทาง URL รายงานได้

ตัวอย่างเช่น ลองพิจารณาเครื่องมือเชื่อมต่อที่มีพารามิเตอร์ 2 ตัวซึ่งกำหนดเป็นลบล้างได้: zipcode และ units (รูปที่ 1) หากเจ้าของแหล่งข้อมูลอนุญาตให้แก้ไข zipcode ในรายงานได้ (รูปที่ 2) เครื่องมือแก้ไขรายงานจะอนุญาตให้ผู้ดูรายงานแก้ไข zipcode ได้เท่านั้น เครื่องมือแก้ไขรายงานจะไม่มีสิทธิ์เข้าถึงหรือระดับการเข้าถึงเพื่ออนุญาตให้ผู้ดูรายงานแก้ไขพารามิเตอร์ units

เปิดใช้พารามิเตอร์รหัสไปรษณีย์แล้ว — **ภาพที่ 1**: การกำหนดค่าเครื่องมือเชื่อมต่อ

แก้ไขได้เฉพาะพารามิเตอร์รหัสไปรษณีย์เท่านั้น — **ภาพที่ 2**: จัดการพารามิเตอร์

คำเตือน: ผู้ดูรายงานจะเข้าถึงข้อมูลใดๆ ที่ควบคุมโดยพารามิเตอร์ได้ หากต้องการหลีกเลี่ยงการแชร์ข้อมูลที่ละเอียดอ่อนโดยไม่ตั้งใจ ให้ตรวจสอบและยืนยันว่าได้กำหนดค่าแหล่งข้อมูลและข้อมูลเข้าสู่ระบบของแหล่งข้อมูลไว้อย่างถูกต้องก่อนที่จะอนุญาตให้แก้ไขพารามิเตอร์ หากพารามิเตอร์เปิดใช้การเข้าถึงข้อมูลที่ละเอียดอ่อน ให้พิจารณาใช้ข้อมูลเข้าสู่ระบบของผู้ดูเพื่อให้ผู้ดูรายงานเห็นเฉพาะข้อมูลของพวกเขาเท่านั้น

พารามิเตอร์ของ URL

วิธีอนุญาตให้ผู้ดูรายงานแก้ไขค่าพารามิเตอร์ผ่าน URL รายงานได้

แก้ไขรายงาน
เลือกแหล่งข้อมูล -> จัดการพารามิเตอร์ของ URL ของรายงาน
ใช้ช่องทำเครื่องหมายอนุญาตให้แก้ไขใน URL ของรายงานเพื่ออนุญาตหรือไม่อนุญาตให้แก้ไขค่าพารามิเตอร์ใน URL ของรายงาน ระบบจะบันทึกการเปลี่ยนแปลงโดยอัตโนมัติ
คลิกปิดที่ด้านขวาบน

การแก้ไขค่าพารามิเตอร์

เครื่องมือแก้ไขรายงานจะแก้ไขค่าพารามิเตอร์ได้โดยใช้แผงพร็อพเพอร์ตี้รายงาน ขณะที่ผู้ดูรายงานจะแก้ไขค่าพารามิเตอร์ผ่าน URL รายงานได้

แผงคุณสมบัติรายงาน

ดูวิธีที่เครื่องมือแก้ไขรายงานตั้งค่าค่าพารามิเตอร์ได้ที่หัวข้อแก้ไขพารามิเตอร์ในรายงาน

พารามิเตอร์ของ URL รายงาน

สำหรับพารามิเตอร์ที่ได้รับอนุญาตให้แก้ไขใน URL ของรายงาน คุณจะตั้งค่าผ่านออบเจ็กต์ JSON ที่เข้ารหัส URL ไว้ต่อท้าย URL ของรายงานได้ในโหมดดู

วิธีสร้างการกำหนดค่า URL

รวบรวมชื่อพารามิเตอร์
1. แก้ไขรายงาน
2. เลือกแหล่งข้อมูล -> จัดการพารามิเตอร์ของ URL ของรายงาน
3. จดชื่อของพารามิเตอร์ที่คุณต้องการตั้งค่าผ่าน URL ของรายงาน
ตัวอย่างเช่น ในรูปที่อยู่ใต้ชื่อพารามิเตอร์คือ ds0.zipcode
สร้างออบเจ็กต์พารามิเตอร์

ระบบจะกำหนดพารามิเตอร์ผ่านออบเจ็กต์ JSON คีย์สำหรับค่าพารามิเตอร์ คือชื่อพารามิเตอร์
```
{
  "parameterName": parameterValue
}
```
ประเภทค่าพารามิเตอร์ได้แก่ STRING, NUMBER หรือ BOOLEAN สำหรับพารามิเตอร์ที่ยอมรับหลายค่า (เช่น เมนูแบบเลื่อนลงที่มีการเลือกหลายรายการ) ให้ใช้อาร์เรย์ของค่า

เช่น หากชื่อพารามิเตอร์คือ ds0.zipcode หากต้องการตั้งค่ารหัสไปรษณีย์เป็น 94094 ค่า JSON จะเป็นดังนี้
```
{
  "ds0.zipcode": "94094"
}
```
เข้ารหัสออบเจ็กต์พารามิเตอร์ใน URL

หลังจากสร้างออบเจ็กต์พารามิเตอร์แล้ว ให้ใช้ JSON.stringify() เพื่อเปลี่ยนออบเจ็กต์ให้เป็นสตริง แล้วใช้ [encodeURIComponent] เพื่อเข้ารหัส URL
```
var params = {
  "ds0.zipcode": "94094"
};
var paramsAsString = JSON.stringify(params);
var encodedParams = encodeURIComponent(paramsAsString)
```
ซึ่งจะได้ผลลัพธ์เป็นสตริงที่เข้ารหัสต่อไปนี้
```
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
```
สร้าง URL ของรายงาน

เมื่อคุณมีออบเจ็กต์พารามิเตอร์ที่เข้ารหัส URL แล้ว ให้เพิ่มออบเจ็กต์ลงใน URL มุมมองรายงานโดยใช้พารามิเตอร์การค้นหา params

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

อย่าลืมแทนที่ REPORT_ID และ PAGE_ID ด้วยค่าสำหรับรายงานและหน้าเว็บของคุณ
ใช้ URL

URL ของรายงานจะลบล้างพารามิเตอร์ตามที่ระบุไว้ในออบเจ็กต์พารามิเตอร์ JSON ตามการรับช่วงพารามิเตอร์

ตัวอย่างออบเจ็กต์พารามิเตอร์

ออบเจ็กต์พารามิเตอร์ต่อไปนี้จะแสดงวิธีตั้งค่าพารามิเตอร์หลายรายการ นอกจากนี้ ยังแสดงให้เห็นการตั้งค่าพารามิเตอร์สำหรับอินพุตประเภทต่างๆ ด้วย

ds0.includeToday เป็นอินพุตช่องทำเครื่องหมาย
ds0.units เป็นอินพุตแบบเลือกรายการเดียว
ds1.countries เป็นอินพุตแบบเลือกหลายรายการ
ds1.labelName เป็นการป้อนข้อความ

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

การรับช่วงพารามิเตอร์

ค่าที่ใช้สำหรับพารามิเตอร์จะเป็นไปตามลำดับความสำคัญตามตำแหน่งที่กำหนดพารามิเตอร์ พารามิเตอร์ที่ตั้งลำดับความสำคัญสูงกว่าจะลบล้างพารามิเตอร์ที่ตั้งลำดับความสำคัญต่ำกว่า ลำดับความสำคัญ (จากต่ำสุดไปสูงสุด) คือ

แหล่งข้อมูล (ค่าเริ่มต้น)
URL รายงาน
แผงพร็อพเพอร์ตี้รายงาน โดยทำตามกฎการรับช่วงพารามิเตอร์ของแหล่งข้อมูล