Διαβίβαση μιας παραμέτρου αναφοράς εντός μιας διεύθυνσης URL για μια σελιδοποιημένη αναφορά Power BI

ΙΣΕΙ ΓΙΑ: Power BI Εργαλείο δόμησης αναφορών Power BI Desktop

Μπορείτε να διαβιβάσετε παραμέτρους αναφοράς σε μια αναφορά συμπεριλαμβάνοντάς τις σε μια διεύθυνση URL αναφοράς για σελιδοποιημένες αναφορές. Αυτές οι παράμετροι διεύθυνσης URL δεν έχουν πρόθεμα επειδή διαβιβάζονται απευθείας στον μηχανισμό επεξεργασίας αναφορών.

Όλες οι παράμετροι ερωτήματος μπορούν να έχουν αντίστοιχες παραμέτρους αναφοράς. Διαβιβάζετε μια παράμετρο ερωτήματος σε μια αναφορά διαβιβάζοντας την αντίστοιχη παράμετρο αναφοράς. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία ερωτήματος στο Σχεδίαση Σχεσιακών ερωτημάτων (Power BI Εργαλείο δόμησης αναφορών).

Κανόνες παραμέτρων σελιδοποιημένης αναφοράς

Στις παραμέτρους αναφοράς γίνεται διάκριση πεζών-κεφαλαίων και χρησιμοποιούνται οι ακόλουθοι ειδικοί χαρακτήρες:

  • Οποιοιδήποτε χαρακτήρες διαστήματος στη συμβολοσειρά διεύθυνσης URL αντικαθίστανται με τους χαρακτήρες "%20", σύμφωνα με τα πρότυπα κωδικοποίησης διεύθυνσης URL.
  • Ένας χαρακτήρας διαστήματος στο τμήμα παραμέτρου της διεύθυνσης URL αντικαθίσταται με έναν χαρακτήρα συν (+).
  • Ένα ερωτηματικό σε οποιοδήποτε τμήμα της συμβολοσειράς αντικαθίσταται με τους χαρακτήρες "%3A".
  • Τα προγράμματα περιήγησης θα πρέπει να εκτελούν αυτόματα την κατάλληλη κωδικοποίηση διεύθυνσης URL. Δεν χρειάζεται να κωδικοποιήσετε κανέναν από τους χαρακτήρες με μη αυτόματο τρόπο.
  • Εάν δεν συμπεριλάβετε τη σύνταξη του διακομιστή μεσολάβησης, τότε, προσθέστε ένα πρόθημα στην παράμετρο rp:.

Παραδείγματα παραμέτρων σελιδοποιημένης αναφοράς

Για να ορίσετε μια παράμετρο αναφοράς σε μια διεύθυνση URL, χρησιμοποιήστε την ακόλουθη σύνταξη:

  
rp:parameter=value  

Για παράδειγμα, για να καθορίσετε δύο παραμέτρους, "Πωλητής" και "Πολιτεία", που ορίζονται σε μια αναφορά στην περιοχή "Ο χώρος εργασίας μου", θα χρησιμοποιήσετε την ακόλουθη διεύθυνση 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. Για διαβίβαση μιας τιμής κινητής υποδιαστολής , συμπεριλάβετε το διαχωριστικό δεκαδικών των τοπικών ρυθμίσεων διακομιστή.

Σημείωμα

Εάν η αναφορά σας περιέχει μια παράμετρο αναφοράς που διαθέτει μια προεπιλεγμένη τιμή και η τιμή της ιδιότητας Prompt είναι false (δηλαδή, η ιδιότητα Prompt User δεν επιλέγεται στη Διαχείριση αναφορών), τότε δεν μπορείτε να διαβιβάσετε μια τιμή για αυτήν την παράμετρο αναφοράς εντός μιας διεύθυνσης URL. Αυτό παρέχει στους διαχειριστές μια επιλογή για να αποτρέπουν τους τελικούς χρήστες από το να προσθέτουν ή τροποποιούν τις τιμές ορισμένων παραμέτρων αναφοράς.

Πρόσθετα παραδείγματα

Το παρακάτω παράδειγμα διεύθυνσης URL περιλαμβάνει μια παράμετρο πολλαπλών τιμών "Πωλητής". Η μορφή για μια παράμετρο πολλαπλών τιμών είναι να επαναλαμβάνεται το όνομα παραμέτρου για κάθε τιμή.

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

Ζητήματα προς εξέταση και περιορισμοί

  • Εάν η αναφορά σας περιέχει μια παράμετρο αναφοράς που διαθέτει μια προεπιλεγμένη τιμή και η τιμή της ιδιότητας Prompt είναι false (δηλαδή, η ιδιότητα Prompt User δεν επιλέγεται στο Power BI Εργαλείο δόμησης αναφορών), τότε δεν μπορείτε να διαβιβάσετε μια τιμή για αυτήν την παράμετρο αναφοράς εντός μιας διεύθυνσης URL. Αυτό παρέχει στους διαχειριστές την επιλογή να αποτρέπουν τους τελικούς χρήστες από το να προσθέτουν ή τροποποιούν τις τιμές ορισμένων παραμέτρων αναφοράς.
  • Το Power BI δεν υποστηρίζει συμβολοσειρά ερωτήματος με περισσότερους από 2.000 χαρακτήρες. Μπορεί να υπερβείτε κατά λάθος αυτή την τιμή εάν χρησιμοποιείτε παραμέτρους διεύθυνσης URL για την προβολή της σελιδοποιημένης αναφοράς σας, ιδιαίτερα εάν η συμβολοσειρά ερωτήματος περιέχει πολλές τιμές παραμέτρων. Για να φορτώσετε σωστά την αναφορά, μειώστε τον αριθμό χαρακτήρων σε κάτω από 2.000.
  • Το όριο στη συμβολοσειρά ερωτήματος αξιολογείται αφού έχετε εισέλθει στο Power BI. Εάν ανοίξετε την αναφορά πριν από την είσοδο, το όριο μειώνεται.