재정의 가능한 구성 매개변수

재정의 가능한 구성 매개변수는 보고서 수정 권한 사용자가 데이터 소스의 기본값을 사용합니다. 구성 매개변수를 재정의 가능한 make로 정의 데이터 소스를 보다 유연하게 만들 수 있으며, 사용자가 구성할 수 있는 데이터를 만드는 방법을 사용자에게 제공합니다. 보고서 템플릿을 사용할 수 있습니다.

예를 들어 날씨 데이터를 제공하는 커넥터에는 보고서 보기 권한 사용자가 특정 언어의 날씨 예보를 요청할 수 있는 매개변수 기본값과 다릅니다

이 문서에서는 재정의 가능한 매개변수가 정의되고 수정 및 보고서 사용자가 매개변수 값을 수정하는 방법을 설명합니다. 배우기 위해 Looker Studio에서 매개변수가 사용되는 방식 자세히 알아보기 데이터 소스 매개변수.

역할

문서 전체에서 참조되는 사용자 역할은 다음과 같습니다.

역할 정의
커넥터 개발자 커뮤니티 커넥터를 만든 사용자입니다.
데이터 소스 소유자 데이터 소스를 만들고 소유한 사용자입니다.
보고서 편집기 보고서에 대한 수정 모드 액세스 권한이 있는 사용자입니다.
보고서 뷰어 보고서에 대한 보기 모드 액세스 권한이 있는 사용자입니다.

재정의 가능한 매개변수 정의

커넥터 개발자는 getConfig() 함수 커뮤니티 커넥터입니다. 커넥터의 재정의 가능한 구성 매개변수를 정의하려면 다음 단계를 따르세요. setAllowOverride(true)를 호출합니다.

다음 예에서는 재정의 가능한 매개변수 2개(zipcode 및 units)를 정의합니다. 및 재정의할 수 없는 매개변수 1개: days-to-forcecast

재정의 가능한 매개변수 2개의 스크린샷

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가 데이터에 연결하는 방법을 검토하여 상호 간의 관계를 살펴봅니다.

다음과 같은 경우 매개변수를 재정의 가능한 것으로 정의하지 마세요.

  1. 매개변수 값이 스키마에 영향을 미치는 시점
    • 사용자가 매개변수 값과 새 데이터의 스키마를 변경하는 경우 데이터 소스에 정의된 것과 다르면 모든 보고서에서 필드 누락으로 인해 데이터 소스에 종속된 항목이 손상될 수 있습니다.
  2. 매개변수 값이 민감한 정보를 관리하는지 여부 예: 계정 선택
    • 특정 매개변수를 재정의하려면 의도치 않게 민감한 정보를 보거나 공유하는 행위

보고서 사용자를 위한 매개변수 사용 설정

데이터 소스 소유자는 재정의 가능한 매개변수를 관리합니다. 보고서 수정 권한 사용자가 수정했습니다. 마찬가지로 보고서 수정 권한 사용자는 매개변수는 보고서 보기 권한 사용자가 수정할 수 있습니다.

보고서 수정 권한 사용자가 매개변수 값을 수정하도록 허용

데이터 소스 소유자는 수정할 수 있는 매개변수를 관리합니다. 있습니다. 데이터 소스를 만들거나 수정하는 중에 구성되며 이전에 설정된 커넥터에 의해 재정의 정의됨 개발자를 참고하세요. 사용 설정하면 보고서 수정 권한 사용자가 다음 작업을 할 수 있습니다. 보고서에서 매개변수를 수정합니다.

다음 예에서 커넥터에는 재정의 가능한 것으로 정의된 2개의 매개변수가 있습니다. zipcode 및 units 데이터 소스 소유자가 다음을 허용하는 것을 허용: zipcode 수정할 수 있습니다. 보고서에서 보고서 편집기는 zipcode 매개변수 값입니다.

재정의 옵션 사용 설정

보고서 보기 권한 사용자가 매개변수 값을 수정하도록 허용

보고서 편집기는 보고서 보기 권한 사용자가 수정할 수 있는 매개변수를 제어합니다. 그러면 모든 뷰어가 보고서 URL을 통해 매개변수 값을 수정할 수 있습니다. 확인할 수 있습니다.

예를 들어 재정의 가능한 것으로 정의된 2개의 매개변수가 있는 커넥터가 있다고 가정해 보겠습니다. zipcode 및 units (그림 1). 데이터 소스 소유자가 허용한 경우 zipcode를 보고서에서 수정하면 (그림 2) 보고서 수정 권한 사용자만 수정할 수 있음 보고서 보기 권한 사용자가 zipcode를 수정하도록 허용할 수 있습니다. 보고서 편집자는 units 매개변수를 허용할 액세스 권한 또는 공개 상태를 갖지 않습니다. 보고서 보기 권한 사용자가 수정함

<ph type="x-smartling-placeholder">
</ph> 우편번호 매개변수 사용 설정됨
그림 1: 커넥터 구성

<ph type="x-smartling-placeholder">
</ph> 우편번호 매개변수만 수정할 수 있습니다.
그림 2: 매개변수 관리
를 통해 개인정보처리방침을 정의할 수 있습니다.

URL 매개변수

보고서 보기 권한 사용자가 보고서 URL을 통해 매개변수 값을 수정할 수 있도록 허용하려면 다음 안내를 따르세요.

  1. 보고서를 수정합니다.
  2. 리소스 ->를 선택합니다. 보고서 URL 매개변수 관리를 참조하세요.
  3. 보고서 URL에서 수정 허용 체크박스를 사용하여 보고서 URL에서 매개변수 값 수정을 허용하지 않습니다. 변경사항은 자동으로 저장됩니다.
  4. 오른쪽 상단에서 닫기를 클릭합니다.

매개변수 값 수정

보고서 편집기는 보고서 속성 패널을 사용하여 매개변수 값을 수정할 수 있습니다. 보고서 보기 권한 사용자는 보고서 URL을 통해 매개변수 값을 수정할 수 있습니다.

보고서 속성 패널

보고서 편집기에서 매개변수 값을 설정하는 방법을 알아보려면 다음을 참고하세요. 보고서에서 매개변수를 수정합니다.

보고서 URL 매개변수

다음과 같은 매개변수의 경우 보고서 URL에서 수정할 수 있는 경우 값은 보기 모드에서 보고서 URL에 추가되는 URL 인코딩 JSON 객체를 통해 설정됩니다.

URL 구성을 만들려면 다음 단계를 따르세요.

  1. 매개변수 이름 수집

    1. 보고서를 수정합니다.
    2. 리소스 ->를 선택합니다. 보고서 URL 매개변수 관리를 참조하세요.
    3. 보고서를 통해 설정하려는 매개변수의 이름을 기록합니다. URL입니다.

    예를 들어 아래 그림에서 매개변수 이름은 ds0.zipcode입니다.

    URL 매개변수 사용 설정하기

  2. 매개변수 객체 만들기

    매개변수는 JSON 객체를 통해 정의됩니다. 매개변수 값의 키 매개변수 이름입니다.

    {
  "parameterName": parameterValue
}

    매개변수 값 유형은 STRING, NUMBER, BOOLEAN 중 하나입니다. 대상 여러 값을 허용하는 매개변수 (예: 다중 선택 드롭다운)는 값의 배열입니다.

    예를 들어 매개변수 이름이 ds0.zipcode인 경우 우편번호를 94094인 경우 JSON은 다음과 같습니다.

    {
  "ds0.zipcode": "94094"
}

  3. 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"

  4. 보고서 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를 있습니다.

  5. URL 사용

    보고서 URL이 JSON 매개변수에 정의된 매개변수를 재정의합니다. 매개변수 상속을 기반으로 객체를 반환합니다.

매개변수 객체 예

다음 매개변수 객체는 여러 매개변수를 설정하는 방법을 보여줍니다. 또한 은 다양한 입력 유형의 매개변수 값을 설정하는 방법을 보여줍니다.

  • ds0.includeToday는 체크박스 입력입니다.
  • ds0.units는 단일 선택 입력입니다.
  • ds1.countries는 다중 선택 입력입니다.
  • ds1.labelName는 텍스트 입력입니다.
  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

매개변수 상속

매개변수에 사용되는 값은 매개변수가 설정됩니다. 우선순위가 더 높은 위치에 설정된 매개변수 재정의 우선순위가 낮은 위치에 설정된 매개변수만 사용합니다. 우선순위( 공식은 다음과 같습니다.

  1. 데이터 소스(기본값)
  2. 보고서 URL
  3. 데이터 소스 다음에 오는 보고서 속성 패널 매개변수 상속 규칙을 따릅니다.