Share via

Power BI에서 페이지를 매긴 보고서의 URL 매개 변수

  • 아티클

적용 대상: Power BI Report Builder Power BI Desktop

URL에 매개 변수를 추가하여 Power BI에서 페이지를 매긴 보고서에 명령을 보낼 수 있습니다. 예를 들어, 특정 보고서 매개 변수 값을 사용하여 보고서를 보았을 수 있습니다. 미리 정의된 URL 액세스 매개 변수를 사용하여 이 정보를 URL에 캡슐화합니다. 형식을 렌더링하거나 보고서 도구 모음의 모양과 느낌을 바꾸기 위한 매개 변수를 포함하여 Power BI에서 보고서를 처리하는 방법을 추가로 사용자 지정할 수 있습니다. 그런 다음, 이 URL을 메일이나 웹 페이지에 직접 붙여넣어 다른 사용자의 브라우저에서도 같은 방식으로 보고서를 표시할 수 있습니다.

URL 액세스 매개 변수를 통해 수행할 수 있는 작업은 다음과 같습니다.

  • 보고서에 보고서 매개 변수를 보냅니다.
  • 지원되는 파일 형식으로 보고서 내용을 내보내기 시작합니다.
  • 매개 변수 창을 숨기거나 표시합니다.
  • DeviceInfo 설정을 지정합니다.

URL 액세스를 통해 사용할 수 있는 명령 및 설정의 전체 목록은 이 문서에 나오는 URL 액세스 매개 변수 참조를 참조하세요.

URL 액세스 개념

Power BI에 대한 URL 요청은 서비스에서 처리하는 매개 변수를 포함합니다. 서비스에서 URL 요청을 처리하는 방법은 매개 변수, 매개 변수 접두사, URL에 포함된 항목의 형식에 따라 달라집니다. 페이지를 매긴 보고서 URL 기능은 표준 URL 주소 지정을 지원하는 대부분의 브라우저 및 애플리케이션과 호환됩니다.

URL 액세스 구문

URL 요청에는 임의의 순서로 나열된 여러 매개 변수가 포함될 수 있습니다. 매개 변수는 앰퍼샌드(&A)로 구분됩니다. 이름 및 값 쌍은 등호(=)로 구분됩니다. 예시:

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

매개 변수 이름입니다.

value

사용 중인 매개 변수의 값에 해당하는 URL 텍스트입니다.

URL 보고서 매개 변수 참조

보고서 매개 변수를 페이지를 매긴 보고서 URL에 포함하여 보고서에 전달할 수 있습니다.

보고서 매개 변수(rp:)

URL에 보고서 매개 변수를 전달하는 예는 URL에 보고서 매개 변수 전달을 참조하세요.

참고 항목

보고서 매개 변수는 매개 변수 접두사 rp:가 필요하며 대/소문자를 구분합니다.

URL 액세스 매개 변수 참조

다음 매개 변수를 URL의 일부로 사용하여 Power BI에서 페이지를 매긴 보고서의 모양과 느낌을 구성할 수 있습니다. 이 섹션에는 가장 일반적인 매개 변수가 나열됩니다. 매개 변수는 대/소문자를 구분하지 않으며, 출력 형식과 연관된 경우 매개 변수 prefix rdl:로 시작됩니다.

보고서 명령(rdl:)

내보내기 형식

보고서를 렌더링하고 내보낼 형식을 지정합니다.

  • 예: rdl:format=PDF

사용 가능한 값:

  • PPTX(PowerPoint)
  • MHTML
  • IMAGE
  • 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:

    참고 항목

    이러한 문자열 값은 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에 하이퍼링크 추가를 참조하세요.

관련 콘텐츠