Looker 22.16 문서를 보고 있습니다. 최신 문서는 여기에서 확인할 수 있습니다.

LookML 대시보드의 버튼 매개변수

버튼 매개변수를 사용하려면 Looker 관리자가 대시보드용 맞춤 버튼 실험실 기능을 사용 설정해야 합니다.

버튼은 다음 설정이 있는 LookML 대시보드에서만 지원됩니다.

preferred_viewer을(를) dashboards-next(으)로 설정
layout을(를) newspaper(으)로 설정

이 페이지에서는 dashboard.lkml 파일에서 LookML 대시보드 매개변수를 사용하여 type: button의 LookML 대시보드 요소를 추가하고 맞춤설정하는 방법을 보여줍니다. 버튼은 대시보드 내에 링크를 배치하는 데 유용합니다. Looks 및 대시보드와 같은 Looker 콘텐츠 또는 다른 웹사이트에 연결할 수 있습니다.

Looker UI를 통해 대시보드에 버튼을 추가하는 방법에 대한 자세한 내용은 사용자 정의 대시보드 만들기 문서 페이지를 참조하세요.

사용 예시


## BASIC PARAMETERS
type: button
name: text
height: N
width: N
row: N
col: N

## BUTTON PARAMETER
rich_content_json: '{
 "text": "button text",
 "description": "description",
 "newTab": true | false,
 "alignment": "left" | "right" | "center",
 "size": "small" | "medium" | "large",
 "style": "OUTLINED" | "FILLED" | "TRANSPARENT",
 "color": "hex string or css color",
 "href": "link"
 }'

매개변수 정의

매개변수 이름	설명
기본 매개변수
`type` (요소용)	요소에서 사용할 시각화 유형을 결정합니다.
`name`(요소용)	요소 만들기
`height` (요소용)	버튼 요소의 타일 상자 높이를 정의합니다. 높이는 `layout: newspaper` 대시보드의 행 단위입니다.
`width`(요소용)	버튼 요소 타일 상자의 너비를 정의합니다. 너비는 `layout: newspaper` 대시보드의 열 단위입니다.
`row`	`layout: newspaper` 대시보드의 행 단위에 있는 버튼 요소의 타일 상자에서 위에서 아래로 위치를 정의합니다.
`col`	`layout: newspaper` 대시보드의 열 단위 내에서 버튼 요소의 타일 상자의 왼쪽에서 오른쪽으로 위치를 정의합니다.
버튼 매개변수
`rich_content_json`	버튼에 대한 정보와 함께 키-값 쌍을 포함하는 JSON 객체

기본 매개변수

type: button의 LookML 대시보드 요소를 정의할 때는 최소한 name 및 type 매개변수에 값을 지정해야 합니다.

height, width, row, col 매개변수는 버튼 자체가 아닌 버튼 요소의 타일 상자에 적용됩니다.

`name`

이 섹션에서는 대시보드 요소의 일부인 name 매개변수를 설명합니다.

name은 대시보드 매개변수 문서 페이지에 설명된 대시보드 필터의 일부로 사용할 수도 있습니다.

각 name 선언은 새 대시보드 요소를 만들고 이름을 할당합니다. 요소 이름은 고유해야 합니다.

버튼에 지정된 name는 대시보드 UI에 표시되지 않습니다.

- name: orders_by_date

`type`

이 섹션에서는 대시보드 요소의 일부인 type 매개변수를 설명합니다.

type은 대시보드 매개변수 문서 페이지에 설명된 대시보드 필터의 일부로 사용할 수도 있습니다.

type는 type(조인의 경우) 매개변수 문서 페이지에 설명된 조인의 일부로 사용할 수도 있습니다.

type은 측정기준, 필터, 매개변수 유형 문서 페이지에 설명된 측정기준의 일부로 사용할 수도 있습니다.

type는 측정 유형 문서 페이지에 설명된 측정의 일부로 사용할 수도 있습니다.

type 매개변수는 요소에서 사용할 시각화 유형을 결정합니다.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall |
        looker_wordcloud | looker_boxplot | button

여러 유형의 LookML 대시보드 요소에 대한 개요는 type(LookML 대시보드용) 문서 페이지를 참조하세요.

`height`

이 섹션에서는 대시보드 요소의 일부인 height 매개변수를 설명합니다.

height은 대시보드 매개변수 문서 페이지에 설명된 대로 대시보드 행의 일부로 사용할 수도 있습니다.

height 매개변수는 버튼 요소의 타일 상자 높이를 행 단위로 정의합니다.

버튼 요소 타일 상자의 높이는 6행으로 기본 설정됩니다. 최소 높이는 1행입니다. 버튼 요소 높이를 변경하면 대시보드의 다른 요소에 영향을 줄 수 있지만 버튼 자체의 높이는 영향을 받지 않습니다.

예를 들어 다음 코드는 버튼의 타일 상자를 12행 높이로 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

`width`

이 섹션에서는 대시보드 요소의 일부인 width 매개변수를 설명합니다.

width은 대시보드 매개변수 문서 페이지에 설명된 대로 대시보드의 일부로 사용할 수도 있습니다.

width 매개변수는 버튼 요소의 타일 상자의 너비를 열 단위로 정의합니다.

버튼 요소의 타일 상자 너비는 기본적으로 8개 열로, 대시보드 전체 너비의 1/3입니다. 버튼 타일 상자의 최소 너비는 2입니다.

예를 들어 다음 코드는 버튼의 타일 상자를 대시보드 너비의 절반으로 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

버튼의 타일 상자 안에 공간이 있으면 text에 정의된 긴 텍스트 문자열을 수용하기 위해 버튼의 너비가 늘어납니다. 그러나 버튼의 너비는 width 매개변수에 설정된 값을 넘어서지 않습니다. 필요한 경우 text에 정의된 문자열이 버튼에서 잘립니다.

`row`

row 매개변수는 버튼 요소의 타일 상자의 상단 가장자리가 배치된 행을 정의합니다.

대시보드는 대시보드 상단의 0행부터 시작합니다. 대시보드 버튼 요소의 기본값은 6개 행의 요소 높이입니다. 즉, 대시보드 상단에 있는 대시보드 요소 (row: 0)의 기본값은 0~5행입니다.

다음 예에서 코드는 요소가 기본 높이로 설정되어 있다고 가정하고 대시보드의 두 번째 행에 버튼의 타일 상자를 배치하도록 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

`col`

col 매개변수는 버튼 요소의 타일 상자의 왼쪽 가장자리가 배치되는 열을 정의합니다.

대시보드는 24개의 열로 나뉩니다. 대시보드는 대시보드 왼쪽의 0열로 시작합니다. 신문 레이아웃이 포함된 대시보드의 기본값은 요소 너비가 8열입니다. 즉, 대시보드 왼쪽의 대시보드 요소 (col: 0)가 기본적으로 0~7열을 차지합니다.

예를 들어 다음 코드는 대시보드에서 요소의 세 번째 열에 설정할 요소를 설정합니다.

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

버튼 매개변수

이 섹션에 설명된 매개변수를 사용하여 type: button의 LookML 대시보드 요소에 콘텐츠를 추가할 수 있습니다.

`rich_content_json`

rich_content_json는 대시보드 버튼의 특성을 정의하는 여러 키-값 쌍이 있는 JSON 객체입니다.

rich_content_json: '{
 "text": "Go to Sales Dashboard",
 "description": "View sales from the last 18 months.",
 "newTab": true,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "href":"https://instance_name.looker.com/dashboards/152?State=California&Created+Fiscal+Quarter=2022"
 }'

`text`

text는 대시보드 UI의 버튼에 표시될 텍스트를 정의합니다. 버튼의 너비가 확장되어 width 매개변수에 설정된 한도에 도달할 때까지 텍스트가 잘리며 텍스트가 잘립니다.

`description`

description는 버튼 위로 마우스를 가져가면 팝업 도움말로 표시되는 텍스트를 정의합니다. 설명이 제공되지 않으면 기본적으로 href에 제공된 링크가 표시됩니다.

`newTab`

newTab은 버튼 링크를 새 탭에서 열 것인지 (true) 현재 탭에서 열지 (false) 정의하는 부울입니다. newTab의 기본값은 true입니다.

`alignment`

alignment는 버튼 요소의 타일 상자 내에서 버튼의 정렬을 설정합니다. alignment의 기본값은 center입니다.

크기

size는 버튼과 버튼의 크기를 small, medium 또는 large로 설정합니다. size 값은 버튼 요소의 타일 상자 또는 height 매개변수의 크기에 영향을 주지 않습니다.

`style`

style는 버튼 스타일을 다음 값 중 하나로 설정합니다.

FILLED: 버튼의 본문은 color에 설정된 색상으로 채워집니다. 버튼의 텍스트는 흰색입니다. 이 설정이 기본 설정입니다.
OUTLINED: 버튼의 가장자리에 윤곽선이 있지만 본문은 투명합니다. 버튼 텍스트의 색상은 color에 의해 설정됩니다.
TRANSPARENT: 버튼의 본문은 투명합니다. 버튼 텍스트의 색상은 color에 의해 설정됩니다.

`color`

color는 style 설정에 따라 버튼 색상이나 버튼 텍스트 색상을 설정합니다. color는 기본적으로 Looker 인스턴스 기본 범주형 색상 컬렉션의 첫 번째 색상으로 설정됩니다.

색상 값 형식을 #2ca6cd와 같은 16진수 문자열이나 mediumblue와 같은 CSS 색상 이름으로 지정할 수 있습니다.

`href`

href은 버튼을 통해 사용자가 이동할 URL을 설정합니다. 다른 Looker 대시보드 링크에는 대시보드 필터를 특정 값으로 설정하는 필터 매개변수가 포함될 수 있습니다.

삽입된 환경에서 대시보드 링크는 링크 URL에 embed/가 있어야 합니다.