다음을 통해 공유


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

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

페이지를 매긴 보고서의 보고서 URL에 보고서 매개 변수를 포함시켜 보고서에 전달할 수 있습니다. 이러한 URL 매개 변수는 보고서 처리 엔진에 직접 전달되기 때문에 접두사가 붙지 않습니다.

모든 쿼리 매개 변수에는 해당하는 보고서 매개 변수가 있을 수 있습니다. 해당 보고서 매개 변수를 전달하여 쿼리 매개 변수를 보고서에 전달합니다. 자세한 내용은 관계형 쿼리 디자이너에서 쿼리 빌드(Power BI Report Builder)을 참조하세요.

페이지를 매긴 보고서 매개 변수 규칙

보고서 매개 변수는 대/소문자를 구분하며 다음 특수 문자를 사용합니다.

  • URL 문자열에서 공백 문자는 URL 인코딩 표준에 따라 "%20" 문자로 바뀝니다.
  • 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 

부울 값을 전달하려면 false에 대해 0, true에 대해 1을 사용합니다. 부동 소수점 값을 전달하려면 서버 로캘의 소수 구분 기호를 포함합니다.

참고 항목

보고서에 기본값이 있는 보고서 매개 변수가 포함되어 있고 Prompt 속성이 false(즉 보고서 관리자에서 Prompt User 속성을 선택하지 않음)이면 URL 내에서 해당 보고서 매개 변수에 대한 값을 전달할 수 없습니다. 이러한 기능을 통해 관리자는 최종 사용자가 특정 보고서 매개 변수의 값을 추가하거나 수정하지 못하도록 설정할 수 있습니다.

추가 예제

다음 URL 예제에는 다중 값 매개 변수 “Salesperson”이 포함되어 있습니다. 다중 값 매개 변수의 형식은 각 값에 대해 매개 변수 이름을 반복하는 것입니다.

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

다음 URL 예에서는 값이 "7/1/2005"인 SellStartDate라는 단일 매개 변수를 전달합니다.

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

고려 사항 및 제한 사항

  • 보고서에 기본값이 있는 보고서 매개 변수가 포함되어 있고 Prompt 속성이 false(즉 Power BI Report Builder에서 Prompt User 속성을 선택하지 않음)이면 URL 내에서 해당 보고서 매개 변수에 대한 값을 전달할 수 없습니다. 이를 통해 관리자는 최종 사용자가 특정 보고서 매개 변수의 값을 추가하거나 수정하지 못하게 할 수 있습니다.
  • Power BI는 2,000자를 초과하는 쿼리 문자열을 지원하지 않습니다. URL 매개 변수를 사용하여 페이지를 매긴 보고서를 보는 경우, 특히 쿼리 문자열에 여러 매개 변수 값이 포함된 경우 실수로 이 값을 초과할 수 있습니다. 보고서를 제대로 로드하려면 문자 수를 2,000개 미만으로 줄이세요.
  • 쿼리 문자열의 제한은 Power BI에 로그인한 후 평가됩니다. 로그인하기 전에 보고서를 열면 제한이 줄어듭니다.