แชร์ผ่าน

ส่งผ่านพารามิเตอร์รายงานภายใน URL สําหรับรายงานที่มีการแบ่งหน้าของ Power BI

  • บทความ

นําไปใช้กับ: Power BI Report Builder Power BI Desktop

คุณสามารถส่งผ่านพารามิเตอร์รายงานไปยังรายงานได้โดยการรวมพารามิเตอร์เหล่านั้นใน URL รายงานสําหรับรายงานที่มีการแบ่งหน้า พารามิเตอร์ URL เหล่านี้ไม่มีคํานําหน้าเนื่องจากจะถูกส่งผ่านโดยตรงไปยังกลไกการประมวลผลรายงาน

พารามิเตอร์คิวรีทั้งหมดสามารถมีพารามิเตอร์รายงานที่สอดคล้องกันได้ คุณส่งผ่านพารามิเตอร์คิวรีไปยังรายงานโดยผ่านพารามิเตอร์รายงานที่เกี่ยวข้อง สําหรับข้อมูลเพิ่มเติม ดูสร้างคิวรีในตัวออกแบบคิวรีเชิงสัมพันธ์ (ตัวสร้างรายงานใน Power BI)

กฎพารามิเตอร์ของรายงานที่มีการแบ่งหน้า

พารามิเตอร์รายงานต้องตรงตามตัวพิมพ์ใหญ่-เล็ก และใช้อักขระพิเศษต่อไปนี้:

  • อักขระช่องว่างในสตริง URL จะถูกแทนที่ด้วยอักขระ "%20" ตามมาตรฐานการเข้ารหัส URL
  • อักขระช่องว่างในส่วนพารามิเตอร์ของ URL จะถูกแทนที่ด้วยอักขระเครื่องหมายบวก (+)
  • เครื่องหมายอัฒภาคในส่วนใด ๆ ของสตริงที่จะถูกแทนที่ด้วยอักขระ "%3A"
  • เบราว์เซอร์ควรดําเนินการเข้ารหัส URL ที่เหมาะสมโดยอัตโนมัติ คุณไม่จําเป็นต้องเข้ารหัสอักขระใด ๆ ด้วยตนเอง
  • ถ้าคุณไม่รวมไวยากรณ์พร็อกซี ให้ใส่คํานําหน้าพารามิเตอร์ด้วย rp:

ตัวอย่างพารามิเตอร์รายงานที่มีการแบ่งหน้า

หากต้องการตั้งค่าพารามิเตอร์รายงานภายใน URL ให้ใช้ไวยากรณ์ต่อไปนี้:

  
rp:parameter=value

ตัวอย่างเช่น เมื่อต้องการระบุสองพารามิเตอร์ "Salesperson" และ "State" ที่กําหนดไว้ในรายงานในพื้นที่ทํางานของฉัน คุณจะต้องใช้ URL ต่อไปนี้:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

หากต้องการระบุพารามิเตอร์สองรายการเดียวกันที่กําหนดในรายงานในแอป คุณจะต้องใช้ URL ต่อไปนี้:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

เมื่อต้องการส่งค่า null สําหรับพารามิเตอร์ ให้ใช้ไวยากรณ์ต่อไปนี้:

  
parameter:isnull=true

ตัวอย่างเช่น

rp:SalesOrderNumber:isnull=true

เมื่อต้องการส่งค่า บูลีน ให้ใช้ 0 สําหรับ false และ 1 สําหรับ true เมื่อต้องการส่งค่า Float ให้ใส่ตัวคั่นทศนิยมของตําแหน่งที่ตั้งเซิร์ฟเวอร์

หมายเหตุ

ถ้ารายงานของคุณมีพารามิเตอร์รายงานที่มีค่าเริ่มต้นและค่าของ คุณสมบัติพร้อมท์ เป็น เท็จ (นั่นคือผู้ใช้พร้อมท์ไม่ได้เลือกคุณสมบัติในโปรแกรมจัดการรายงาน) จากนั้นคุณจะไม่สามารถส่งค่าสําหรับพารามิเตอร์รายงานนั้นได้ภายใน URL ซึ่งช่วยให้ผู้ดูแลระบบมีตัวเลือกในการป้องกันผู้ใช้ปลายทางไม่ให้เพิ่มหรือแก้ไขค่าของพารามิเตอร์รายงานบางอย่าง

ตัวอย่างเพิ่มเติม

ตัวอย่าง URL ต่อไปนี้ประกอบด้วยพารามิเตอร์แบบหลายค่า "Salesperson" รูปแบบสําหรับพารามิเตอร์หลายค่าคือการทําซ้ําชื่อพารามิเตอร์สําหรับแต่ละค่า

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

ตัวอย่าง URL ต่อไปนี้จะส่งพารามิเตอร์เดียวของ SellStartDate ที่มีค่า "7/1/2005"

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

ข้อควรพิจารณาและข้อจำกัด

  • ถ้ารายงานของคุณมีพารามิเตอร์รายงานที่มีค่าเริ่มต้นและค่าของคุณสมบัติพร้อมท์เป็นเท็จ (นั่นคือผู้ใช้พร้อมท์ไม่ได้เลือกคุณสมบัติในตัวสร้างรายงาน Power BI) จากนั้นคุณจะไม่สามารถส่งค่าสําหรับพารามิเตอร์รายงานนั้นได้ภายใน URL ซึ่งช่วยให้ผู้ดูแลระบบมีตัวเลือกในการป้องกันผู้ใช้ปลายทางไม่ให้เพิ่มหรือแก้ไขค่าของพารามิเตอร์รายงานบางอย่าง
  • Power BI ไม่สนับสนุนสตริงแบบสอบถามมากกว่า 2,000 อักขระ คุณอาจไม่ได้ตั้งใจเกินกว่าค่านี้ถ้าคุณใช้พารามิเตอร์ URL เพื่อดูรายงานที่มีการแบ่งหน้าของคุณ โดยเฉพาะอย่างยิ่งถ้าสตริงแบบสอบถามของคุณมีค่าพารามิเตอร์หลายค่า หากต้องการโหลดรายงานอย่างถูกต้อง ให้ลดจํานวนอักขระลงต่ํากว่า 2,000
  • ขีดจํากัดในสตริงคิวรีจะได้รับการประเมินหลังจากที่คุณลงชื่อเข้าใช้ Power BI หากคุณเปิดรายงานก่อนลงชื่อเข้าใช้ ขีดจํากัดจะลดลง

เนื้อหาที่เกี่ยวข้อง