재정의 가능한 구성 매개변수는 보고서 수정 권한 사용자가 데이터 소스의 기본값을 수정할 수 있는 옵션을 제공합니다. 구성 매개변수를 재정의 가능한 것으로 정의하면 데이터 소스가 더 유연해지고 사용자가 구성할 수 있는 보고서 템플릿을 만들 수 있습니다.
예를 들어 날씨 데이터를 제공하는 커넥터에는 보고서 보기 권한 사용자가 기본값과 다른 언어의 날씨 보고를 요청할 수 있는 위치 매개변수가 포함될 수 있습니다.
이 문서에서는 재정의 가능한 매개변수를 정의하고 수정하는 방법, 보고서 사용자가 매개변수 값을 수정하는 방법을 설명합니다. Looker Studio에서 매개변수가 사용되는 방식에 대한 자세한 내용은 데이터 소스 매개변수를 참조하세요.
역할
문서 전체에서 참조된 사용자 역할:
역할 | 정의 |
---|---|
커넥터 개발자 | 커뮤니티 커넥터를 구축한 사용자입니다. |
데이터 소스 소유자 | 데이터 소스를 만들고 소유한 사용자입니다. |
보고서 편집기 | 보고서에 대한 수정 모드 액세스 권한이 있는 사용자입니다. |
보고서 보기 권한 사용자 | 보고서에 대한 보기 모드 액세스 권한이 있는 사용자 |
재정의 가능한 매개변수 정의
커넥터 개발자는 커뮤니티 커넥터의 getConfig()
함수에서 구성 매개변수를 정의합니다. 구성 매개변수를 재정의 가능한 것으로 정의하기 위해 커넥터는 setAllowOverride(true)
를 호출합니다.
다음 예에서는 재정의할 수 있는 매개변수 2개(zipcode
및 units
)와 재정의할 수 없는 매개변수 1개(days-to-forcecast
)를 정의합니다.
function getConfig(request) {
var config = cc.getConfig();
// A
config
.newTextInput()
.setId("zipcode")
.setName("ZIP Code")
.setAllowOverride(true);
// B
config
.newSelectSingle()
.setId("units")
.setName("Units")
.addOption(
config
.newOptionBuilder()
.setLabel("Metric")
.setValue("metric")
)
.addOption(
config
.newOptionBuilder()
.setLabel("Imperial")
.setValue("imperial")
)
.setAllowOverride(true);
// C
config
.newTextInput()
.setId("days-to-forecast")
.setName("Days to forecast")
.setAllowOverride(false);
return config.build();
}
매개변수를 재정의 가능한 것으로 정의하지 않아야 하는 경우
Looker Studio가 데이터에 연결하는 방법을 검토하여 커넥터, 데이터 소스, 보고서가 서로 관련하여 어떻게 작동하는지 알아보는 것이 좋습니다.
다음과 같은 경우 매개변수를 재정의 가능한 것으로 정의하지 마세요.
- 매개변수 값이 스키마에 영향을 미치는 경우
- 사용자가 매개변수 값을 변경하고 반환된 새 데이터의 스키마가 데이터 소스에 정의된 것과 다르면 필드 누락으로 인해 데이터 소스에 종속된 보고서가 손상될 수 있습니다.
- 매개변수 값이 민감한 정보를 제어하는지 여부 계정 선택).
- 민감한 정보가 의도치 않게 조회되거나 공유되지 않도록 하려면 매개변수를 재정의 가능한 것으로 정의하지 마세요.
보고서 사용자를 위한 매개변수 사용 설정
데이터 소스 소유자는 보고서 편집자가 수정할 수 있는 재정의 가능한 매개변수를 관리합니다. 마찬가지로 보고서 편집기는 보고서 보기 권한 사용자가 수정할 수 있는 매개변수를 제어합니다.
보고서 수정 권한 사용자가 매개변수 값을 수정하도록 허용
데이터 소스 소유자는 보고서에서 수정할 수 있는 매개변수를 관리합니다. 이는 데이터 소스를 만들거나 수정하는 동안 구성되며 커넥터 개발자가 재정의 가능으로 정의한 매개변수에만 적용됩니다. 사용 설정하면 보고서 수정 권한 사용자가 보고서에서 매개변수를 수정할 수 있습니다.
다음 예에서 커넥터에는 재정의 가능한 것으로 정의된 2개의 매개변수(zipcode
및 units
)가 있습니다. 데이터 소스 소유자가 보고서에서 zipcode
만
수정하도록 허용했습니다. 보고서의 보고서 편집기에는 zipcode
매개변수 값을 수정할 수 있는 옵션이 있습니다.
보고서 보기 권한 사용자가 매개변수 값을 수정하도록 허용
보고서 편집기에서는 보고서 보기 권한 사용자가 수정할 수 있는 매개변수를 관리합니다. 그러면 보고서 URL을 통해 보고서 조회자가 매개변수 값을 수정할 수 있습니다.
예를 들어 재정의 가능한 것으로 정의된 2개의 매개변수가 있는 커넥터가 있다고 가정해 보겠습니다(zipcode
및 units
(그림 1)). 데이터 소스 소유자가 보고서에서 zipcode
을 수정하도록 허용한 경우 (그림 2) 보고서 편집자는 보고서 보기 권한 사용자에 의한 zipcode
수정만 허용할 수 있습니다. 보고서 편집기에는 보고서 보기 권한 사용자가 units
매개변수를 수정할 수 있도록 허용할 액세스 권한이나 공개 상태가 없습니다.
![우편번호 매개변수 사용 설정됨](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters.png?authuser=6&hl=ko)
![우편번호 매개변수만 수정할 수 있습니다.](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters-2.png?authuser=6&hl=ko)
URL 매개변수
보고서 보기 권한 사용자가 보고서 URL을 통해 매개변수 값을 수정할 수 있도록 허용하려면 다음 단계를 따르세요.
- 보고서를 수정합니다.
- 리소스 -> 보고서 URL 매개변수 관리를 선택합니다.
- 보고서 URL에서 수정 허용 체크박스를 사용하여 보고서 URL의 매개변수 값 수정을 허용하거나 허용하지 않습니다. 변경사항은 자동으로 저장됩니다.
- 오른쪽 상단에서 닫기를 클릭합니다.
매개변수 값 수정
보고서 수정 권한 사용자는 보고서 속성 패널을 사용하여 매개변수 값을 수정할 수 있고, 보고서 보기 권한 사용자는 보고서 URL을 통해 매개변수 값을 수정할 수 있습니다.
보고서 속성 패널
보고서 편집기에서 매개변수 값을 설정하는 방법을 알아보려면 보고서에서 매개변수 수정을 참고하세요.
보고서 URL 매개변수
보고서 URL에서 수정할 수 있는 매개변수의 경우 보기 모드에서 보고서 URL에 추가되는 URL 인코딩 JSON 객체를 통해 값을 설정할 수 있습니다.
URL 구성을 만들려면 다음 안내를 따르세요.
매개변수 이름 수집
- 보고서를 수정합니다.
- 리소스 -> 보고서 URL 매개변수 관리를 선택합니다.
- 보고서 URL을 통해 설정하려는 매개변수의 이름을 확인합니다.
예를 들어 아래 그림에서 매개변수 이름은
ds0.zipcode
입니다.매개변수 객체 만들기
매개변수는 JSON 객체를 통해 정의됩니다. 매개변수 값의 키는 매개변수 이름입니다.
{ "parameterName": parameterValue }
매개변수 값 유형은
STRING
,NUMBER
,BOOLEAN
중 하나입니다. 여러 값을 허용하는 매개변수 (예: 다중 선택 드롭다운)의 경우 값 배열을 사용합니다.예를 들어 매개변수 이름이
ds0.zipcode
이고 우편번호를94094
로 설정하려면 JSON은 다음과 같습니다.{ "ds0.zipcode": "94094" }
URL 인코딩 매개변수 객체
매개변수 객체를 만든 후 JSON.stringify()를 사용하여 문자열로 변환하고 [encodeURIComponent] 를 사용하여 URL 인코딩합니다.
var params = { "ds0.zipcode": "94094" }; var paramsAsString = JSON.stringify(params); var encodedParams = encodeURIComponent(paramsAsString)
따라서 다음과 같은 인코딩 문자열이 생성됩니다.
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
보고서 URL 작성
URL로 인코딩된 매개변수 객체가 있으면
params
쿼리 매개변수를 사용하여 보고서 보기 URL에 추가합니다.https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D
REPORT_ID 및 PAGE_ID를 보고서 및 페이지의 값으로 바꿔야 합니다.
URL 사용
보고서 URL은 매개변수 상속에 따라 JSON 매개변수 객체에 정의된 대로 매개변수를 재정의합니다.
매개변수 객체 예
다음 매개변수 객체는 여러 매개변수를 설정하는 방법을 보여줍니다. 또한 다양한 입력 유형의 매개변수 값을 설정하는 방법도 보여줍니다.
ds0.includeToday
은 체크박스 입력입니다.ds0.units
은 단일 선택 입력입니다.ds1.countries
은(는) 다중 선택 입력입니다.ds1.labelName
은 텍스트 입력입니다.
{
"ds0.includeToday": true,
"ds0.units": "Metric",
"ds1.countries": ["Canada", "Mexico"],
"ds1.labelName": "Population"
}
매개변수 상속
매개변수에 사용되는 값은 매개변수가 설정된 위치에 따른 우선순위 순서를 따릅니다. 우선순위가 높은 위치에 설정된 매개변수는 우선순위가 낮은 위치에 설정된 매개변수를 재정의합니다. 우선순위는 다음과 같습니다 (최저에서 가장 높은 순으로).
- 데이터 소스(기본값)
- URL 신고
- 데이터 소스 매개변수 상속 규칙을 따르는 보고서 속성 패널