Поделиться через


Параметры URL-адреса в отчетах с разбивкой на страницы в Power BI

ОБЛАСТЬ ПРИМЕНЕНИЯ: Power BI построитель отчетов Power BI Desktop

Команды можно отправлять в отчеты с разбивкой на страницы в Power BI, добавив параметр в URL-адрес. Например, вы могли просмотреть отчет с помощью определенного набора значений параметров отчета. Эти сведения можно инкапсулировать в URL-адресе с помощью предопределенных параметров доступа к URL-адресу. Кроме того, вы можете настроить способ обработки отчета Power BI путем внедрения параметров для форматов отрисовки или внешнего вида панели инструментов отчета. Затем вы вставьте этот URL-адрес непосредственно в электронную почту или веб-страницу, чтобы другие пользователи могли использовать отчет таким же образом в браузере.

Ниже приведены действия, которые можно выполнить с помощью параметров доступа по URL-адресу:

  • Отправка параметров отчета в отчет.
  • Инициируйте экспорт содержимого отчета в поддерживаемом формате файла.
  • Скрытие или просмотр области параметров.
  • Укажите параметр DeviceInfo .

Полный список команд и параметров, доступных через ДОСТУП по URL-адресу, см . в этой статье.

Основные понятия доступа по URL-адресу

ЗАПРОСы URL-адресов в Power BI содержат параметры, обрабатываемые службой. Способ обработки запросов URL-адресов службы зависит от параметров, префиксов параметров и типов элементов, включенных в URL-адрес. Функциональные возможности URL-адреса отчета с разбивкой на страницы совместимы с большинством браузеров и приложений, поддерживающих стандартное адресацию URL-адресов.

Синтаксис доступа по URL-адресу

ЗАПРОСы URL-адресов могут содержать несколько параметров, перечисленных в любом порядке. Параметры разделяются амперсандом (>). Пары имен и значений разделены знаком равенства (=). Например:

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value  

Описание синтаксиса

powerbiservicereporturl

URL-адрес служба Power BI отчета с разбивкой на страницы. Например:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

?

Используется для разделения powerbiservicereporturl и параметров доступа по URL-адресу.

&

Используется для разделения пар имен и значений в параметрах URL-адреса.

prefix

Префикс для параметра URL-адреса, указывающего действие в служба Power BI. Например, rp: или rdl:.

параметр

Имя параметра.

значение

Текст URL-адреса, соответствующий значению используемого параметра.

Справочник по параметру отчета URL

Параметры отчета можно передать в отчет, включив их в URL-адрес отчета с разбивкой на страницы.

Параметры отчета (rp:)

Примеры передачи параметров отчета в URL-адресе см. в разделе "Передача параметра отчета" в URL-адресе.

Примечание.

Для параметров отчета требуется префикс rp: параметра и учитывается регистр.

Справочник по параметрам доступа по URL-адресу

Следующие параметры можно использовать в качестве части URL-адреса, чтобы настроить внешний вид отчетов с разбивкой на страницы в Power BI. В этом разделе перечислены основные параметры. Параметры не учитывает регистр и начинаются с префикса rdl: параметра, если он связан с выходным форматом.

Команды отчета (rdl:)

Формат экспорта

Указывает формат, в котором необходимо отобразить и экспортировать отчет.

  • Например: rdl:format=PDF

Доступные значения:

  • PPTX (PowerPoint)
  • MHTML
  • ИЗОБРАЖЕНИЕ
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

Представление отчета

Указывает тип представления, используемый для отображения отчета.

  • rdl:reportView

Доступные значения:

  • интерактивный (по умолчанию): загружает отчет в интерактивном режиме.
  • pageView: загружает отчет в режиме просмотра страницы.

Панель параметров

Указывает, закрыта ли панель параметров или открыта при загрузке отчета или скрыта полностью.

  • rdl:parameterPanel

Доступные значения:

  • свернут: загружает отчет с закрытой панелью параметров. Кнопка параметра включена, чтобы пользователи могли выбрать кнопку для расширения.
  • скрытый: загружает отчет с закрытой панелью параметров и кнопка параметра отключена.
  • развернутый (по умолчанию): загружает отчет с открытой панелью параметров и включена кнопка параметра.

Сведения об устройстве

Дополнительные выходные параметры можно указать для следующих форматов экспорта.

  • PDF / ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=целое число
    • rdl:DpiY=целое число
    • rdl:EndPage=целое число
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=целое число
  • CSV:

    Примечание.

    Для этих строковых значений ссылки на параметры сведений об устройстве CSV.

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false
  • WORDOPENXML (WORD):

    • rdl:AutoFit=string —> True/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false
  • EXCELOPENXML (EXCEL):

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false
  • PPTX (PowerPoint):

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=целое число
    • rdl:DpiY=целое число
    • rdl:EndPage=целое число
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=целое число
    • rdl:UseReportPageSize=true/false
  • XML:

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

Вы можете добавить rdl:targetSameWindow=true к URL-адресу гиперссылки в отчете, чтобы сделать Power BI открытой гиперссылкой в том же окне браузера. Сведения о добавлении гиперссылок в отчет см. в разделе "Добавление гиперссылки в URL-адрес".