Power BI のページ分割されたレポートの URL パラメーター

  • [アーティクル]

適用対象: Power BI Report Builder Power BI Desktop

URL にパラメーターを追加することで、Power BI のページ分割されたレポートにコマンドを送信できます。 たとえば、特定のレポート パラメーター値のセットを使用してレポートを表示しているとします。 定義済みの URL アクセス パラメーターを使用して、URL にこの情報をカプセル化します。 さらに、レンダリング フォーマットやレポート ツールバーの外観と雰囲気のパラメーターを埋め込んで Power BI のレポートの処理方法をカスタマイズします。 次に、この URL をメールまたは Web ページに直接貼り付けて、他のユーザーがブラウザーで同じ方法でレポートを使用できるようにします。

URL アクセス パラメーターを使用して実行できるアクションを次に示します。

  • レポート パラメーターをレポートに送信します。
  • サポートされているファイル形式でレポート コンテンツのエクスポートを開始します。
  • パラメーター ウィンドウの表示と非表示を切り替えます。
  • DeviceInfo 設定を指定します。

URL アクセスで使用できるコマンドと設定の詳細な一覧については、この記事の「URL アクセス パラメーターのリファレンス」を参照してください。

URL アクセスの概念

Power BI への URL 要求には、サービスによって処理されるパラメーターが含まれます。 サービスによって URL 要求が処理される方法は、URL に含まれるパラメーター、パラメーターのプレフィックス、および項目の種類によって変わります。 ページ分割されたレポートの URL 機能は、標準的な URL アドレス指定をサポートするほとんどのブラウザーやアプリケーションと互換性があります。

URL アクセスの構文

URL 要求には、任意の順序で列挙した複数のパラメーターを含めることができます。 複数のパラメーターはアンパサンド (&) で区切られます。 名前と値のペアは等号 (=) で区切られます。 例:

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

構文の説明

powerbiservicereporturl

改ページ対応レポートの Power BI サービス URL。 次に例を示します。

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

?

powerbiservicereporturl と URL アクセス パラメーターを区切るために使用します。

&

URL アクセス パラメーターの名前と値のペアを区切るために使用します。

prefix

Power BI サービスのアクションを指定する URL パラメーターのプレフィックス。 たとえば、rp: または rdl: です。

パラメーター (parameter)

パラメーター名。

値

使用されるパラメーターの値に対応する URL テキスト。

URL レポート パラメーターのリファレンス

レポート パラメーターをページ分割されたレポート URL に含めることで、レポートに渡すことができます。

レポート パラメーター (rp:)

URL でレポート パラメーターを渡す例については、URL 内でレポート パラメーターを渡す方法に関する記事を参照してください。

Note

レポート パラメーターにはパラメーターのプレフィックス rp: が必要であり、大文字と小文字が区別されます。

URL アクセス パラメーターのリファレンス

次のパラメーターを URL の一部として使用すると、Power BI のページ分割されたレポートの外観と雰囲気を構成できます。 このセクションでは、最も一般的なパラメーターについて説明します。 パラメーターは、出力形式に関連する場合、大文字と小文字は区別されず、パラメーター プレフィックス rdl: で始まります。

レポート コマンド (rdl:)

エクスポート形式

レポートをレンダリングおよびエクスポートする形式を指定します。

  • 例: rdl:format=PDF

選択可能な値は次のとおりです。

  • PPTX (PowerPoint)
  • MHTML
  • イメージ
  • EXCELOPENXML (Excel)
  • WORDOPENXML (Word)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

レポート ビュー

レポートを表示するために使用するビューの種類を指定します。

  • rdl:reportView

選択可能な値は次のとおりです。

  • interactive (既定値): 対話型モードでレポートを読み込みます。
  • pageView: ページ ビュー モードでレポートを読み込みます。

パラメーター パネル

レポートの読み込み時にパラメーター パネルを閉じるか、開くか、または完全に非表示にするかを指定します。

  • rdl:parameterPanel

選択可能な値は次のとおりです。

  • collapsed: パラメーター パネルが閉じられた状態でレポートを読み込みます。 ユーザーがボタンを選択して展開できるように、パラメーター ボタンが有効になっています。
  • hidden: パラメーター パネルが閉じられ、パラメーター ボタンが無効な状態でレポートを読み込みます。
  • expanded (既定値): パラメーター パネルが開かれ、パラメーター ボタンが有効な状態でレポートを読み込みます。

デバイス情報

次のエクスポート形式には、出力パラメーターを追加指定できます。

  • PDF / ACCESSIBLEPDF:

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • 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=integer

  • CSV:

    Note

    これらの 文字列 値については、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=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • 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=integer
    • 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

レポートのハイパーリンク URL に rdl:targetSameWindow=true を追加し、Power BI にこのハイパーリンクを同じブラウザー ウィンドウに開かせることができます。 レポートにハイパーリンクを追加する方法については、「URL へのハイパーリンクの追加」を参照してください。

関連するコンテンツ