Jelly에 보고서 포함
UI 페이지와 같은 Jelly 기반 요소에 보고서를 포함할 수 있습니다.
임베딩 활성화
Jelly에 보고서 포함을 활성화하려면 Jelly 코드에 다음 요소를 추가합니다.
<g:inline template="reporting_includes.xml" />
이 코드를 추가한 후에는 기존 보고서를 포함하거나 Jelly 코드 내에 보고서를 생성할 수 있습니다.
기존 보고서 포함
embedReportById(targetSpan, reportId) 함수를 호출하여 기존 보고서를 포함할 수 있습니다.
<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<div id="report_stuff" />
</j:jelly>
var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<div id="report_stuff" />
<script>
var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);
</script>
</j:jelly>| 매개변수 | 설명 |
|---|---|
| 대상 범위 | 차트를 포함할 jQuery 요소입니다. 차트는 이 요소의 크기를 사용합니다. |
| reportId | 포함하려는 보고서의 sys_id입니다. |
보고서 생성 및 포함
embedReportByParams(targetSpan, parms) 함수를 호출하여 UI 내에 보고서를 포함할 수 있습니다. 이러한 방식으로 보고서를 포함할 때 매개변수를 사용하여 새 보고서를 생성하거나 해당 보고서를 표시하는 보고서 sys_id를 지정할 수 있습니다.
<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<div id="report_stuff" />
</j:jelly>
var params = {sysparm_title: "Average for all ratings", sysparm_field: "category", sysparm_type: "bar", sysparm_table: "asmt_category_result", sysparm_aggregate: "AVG", sysparm_sumfield: "rating"};
var div = $j("#report_stuff");
embedReportByParams(div, params);<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<div id="report_stuff" />
<script>
var params = {sysparm_title: "Average for all ratings", sysparm_field: "category", sysparm_type: "bar", sysparm_table: "asmt_category_result", sysparm_aggregate: "AVG", sysparm_sumfield: "rating"};
var div = $j("#report_stuff");
embedReportByParams(div, params);
</script>
</j:jelly>
| 매개변수 | 설명 |
|---|---|
| 대상 범위 | 차트를 포함할 jQuery 요소입니다. |
| 매개변수 | 보고서를 정의하는 JSON 객체입니다. 사용 가능한 매개변수는 보고서 유형에 따라 다릅니다. |
목록 보고서 생성 및 포함
기존 목록 보고서를 포함하거나 목록 보고서를 생성하고 포함할 때는 코드를 한 줄 더 입력해야 합니다.
<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<g:inline template="list2_js_includes.xml" />
<div id="report_stuff" />
</j:jelly>
var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);<xml version="1.0" encoding="utf-8">
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g:inline template="reporting_includes.xml" />
<g:inline template="list2_js_includes.xml" />
<div id="report_stuff" />
<script>
var div = $j("#report_stuff");
embedReportById(div, <"report sys_id">);
</script>
</j:jelly>| 매개변수 | 설명 |
|---|---|
| 대상 범위 | 차트를 포함할 jQuery 요소입니다. 차트는 이 요소의 크기를 사용합니다. |
| reportId | 포함하려는 보고서의 sys_id입니다. |
포함된 보고서 매개변수
Jelly 요소에 보고서를 포함할 때 매개변수를 전달하여 언제든지 보고서를 정의할 수 있습니다.
공통 매개변수
특정 매개변수는 여러 보고서 유형에서 사용됩니다.
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| jvar_report_id | 보고서 레코드의 sys_id입니다. 이 매개변수를 전달하는 경우 다른 매개변수를 지정하지 마십시오. 모든 값은 보고서 기록에서 가져옵니다. | |
| sysparm_report_id | 보고서에 있는 다른 sysparm 매개변수를 재정의하려면 jvar_report_id 대신 이 매개변수를 사용하십시오. | |
| sysparm_title | 보고서의 제목입니다. | |
| sysparm_table | 보고할 테이블입니다. 이 값 또는 sysparm_report_source_id 지정합니다. 둘 다 지정할 수는 없습니다. | |
| sysparm_report_source_id | 보고서 소스의 sys_id입니다. 이 값 또는 sysparm_table 지정합니다. 둘 다 지정할 수는 없습니다. 이 값은 둘 다 전달하는 경우 sysparm_table 대신 사용됩니다. | |
| sysparm_type | 작성할 보고서의 유형입니다. 가능한 값: 목록, 라인, line_bar, 영역, 스플라인, 막대, horizontal_bar, 파레토, 히스트, 원형, 도넛형, semi_donut, 속도계, 다이얼, 피벗, pivot_v2, 깔때기형, 달력, 피라미드형, 상자, 추세, 제어, 트렌드박스, 히트맵. |
라인 |
| sysparm_field | 데이터를 그룹화할 지정된 테이블의 필드입니다. 시계열, 열, 막대, 원형, 도넛형, 깔때기형, 피라미드형, 상자, 추세 및 트렌드박스 보고서에 필요합니다. 목록 보고서의 경우 선택 사항입니다. | |
| sysparm_query | 보고서를 생성하기 전에 데이터에 적용할 필터입니다. 이 값에 대한 쿼리 문자열을 지정합니다. 쿼리 결과를 특정 필드별로 정렬하려면 쿼리 문자열 끝에 ^ORDERBY <field_name> 또는 ^ORDERBYDES <field_name>를 추가합니다. ORDERBY는 오름차순으로 쿼리를 정렬합니다. ORDERBYDES는 내림차순으로 쿼리를 정렬합니다. |
|
| sysparm_aggregate | 집계 유형입니다. 가능한 값: AVG, COUNT, SUM 및 COUNT_DISTINCT |
카운트 |
| sysparm_sumfield | 데이터를 집계할 필드입니다. COUNT 집계 유형을 사용하는 경우에는 이 매개변수가 적용되지 않습니다. | |
| sysparm_display_grid | 보고서에 데이터 그리드를 표시할지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_show_other | 기타 그룹이 보고서에 표시되는지 여부를 제어하는 True/False 값입니다. 이 그룹은 그룹 수가 sysparm_others 매개변수에 지정된 수를 초과하는 경우에만 나타납니다. 이 매개변수는 막대형, 원형, 깔때기형, 피라미드형, 피벗형 및 히트맵 보고서에 적용됩니다. | 참 |
| sysparm_others | 표시할 개별 데이터의 최대 그룹 수입니다. 추가 데이터 그룹은 기타 그룹으로 결합됩니다. 이 매개변수는 막대형, 원형, 깔때기형, 피라미드형, 피벗형 및 히트맵 보고서에 적용됩니다. | |
| sysparm_source_type | 포함된 보고서의 소스입니다. 옵션입니다. 가능한 값: table, metricbase, source, import |
테이블 |
| sysparm_set_color | 보고서의 색상 설정입니다. 가능한 값: one_color, color_palette, several_colors |
color_palette |
| sysparm_color_palette | 보고서에서 사용하는 색상표입니다. 이 매개변수는 sysparm_set_color="color_palette"일 때 사용됩니다. 가능한 값: 색상표의 sys_id |
기본 UI14 |
| sysparm_color | 보고서에서 사용하는 색상입니다. 이 매개변수는 sysparm_set_color="one_color"일 때 사용됩니다. 가능한 값: 색상의 sys_id |
|
| sysparm_chart_colors | 보고서에 사용되는 차트 색상 집합입니다. 이 매개변수는 sysparm_set_color="several_colors"일 때 사용됩니다. 가능한 값: 쉼표로 구분된 색상 16진수 코드 목록 |
|
| sysparm_show_marker | 마커는 선 또는 차트의 다른 그래픽 요소의 점으로 표시되는 값입니다. 이 매개변수는 마커가 표시되는지 여부를 제어하는 true/false 값입니다. | 예 |
| sysparm_show_empty | 빈 그룹화 또는 추세 값이 있는 기록이 보고서에 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_stack_field | 막대 및 열 보고서에서 스택을 제어하는 데 사용되는 필드입니다. | |
| sysparm_bar_unstack | 누적 데이터가 단일 막대 또는 열 또는 여러 막대로 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_box_field | 데이터를 측정하는 데 사용되는 숫자 필드입니다. 이 매개변수는 상자 및 히스토그램 보고서에 필요합니다. | |
| sysparm_trend_field | 추세 데이터를 구성하는 데 사용되는 날짜-시간 필드입니다. 이 매개변수는 시계열, 추세 및 상자 보고서에 필요합니다. | |
| sysparm_trend_interval | 추세 값을 측정할 간격입니다. 가능한 값: year, quarter, month, week, dayofweek, hour 및 date. |
년 |
| sysparm_compute_percent | 보고서 백분율을 표시할 때 사용할 값입니다. 총 기록 수 또는 지정된 집계를 기준으로 백분율을 표시할 수 있습니다. 가능한 값: 집계 및 개수 |
카운트 |
| sysparm_funnel_neck_percent | 숫자 1-100은 깔때기형의 목에 해당하는 깔때기형 보고서의 백분율을 정의합니다. | 30 |
| sysparm_show_chart_data_label | 데이터 레이블이 보고서에 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_show_zero | 다단계 피벗 및 히트맵 보고서에 0이 표시되는지 여부를 제어하는 예/아니오 값입니다. | |
| sysparm_ct_row | 히트맵 및 거품형 보고서에서 행을 정의하는 데 사용되는 필드입니다. | |
| sysparm_ct_column | 히트맵 및 거품형 보고서에서 열을 정의하는 데 사용되는 필드입니다. | |
| sysparm_y_axis_category_fields | 다단계 피벗 보고서에서 행을 정의하는 데 사용되는 필드입니다. 쉼표로 구분된 필드 이름을 최대 5개까지 지정합니다. | |
| sysparm_x_axis_category_fields | 다단계 피벗 보고서에서 열을 정의하는 데 사용되는 필드입니다. 쉼표로 구분된 필드 이름을 최대 3개까지 지정합니다. | |
| sysparm_list_ui_view | 사용자가 보고서를 드릴다운할 때 사용할 목록 뷰의 sys_id입니다. | |
| sysparm_show_marker | 보고서의 모든 표시된 지점에 마커가 나타나는지 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_apply_alias | 구성된 별칭이 포함된 보고서에 표시되는지 여부를 제어하는 예/아니오 값입니다. |
서비스 카탈로그 매개변수
| 매개변수 | 설명 |
|---|---|
| sysparm_sc_groupby_item_id | 카탈로그 항목의 sys_id입니다. 이 매개변수를 매개변수와 함께 sysparm_sc_groupby_variable_id 사용하여 카탈로그 변수 값을 기준으로 서비스 카탈로그 보고서를 그룹화합니다. 이 매개변수는 서비스 카탈로그 변수에서 그룹화할 때 매개변수를 sysparm_field 대체합니다. |
| sysparm_sc_groupby_variable_id | 보고서에서 데이터를 그룹화하는 방법을 결정하는 데 사용되는 카탈로그 항목 변수의 sys_id입니다. 이 변수는 매개변수에 sysparm_sc_groupby_item_id 지정된 카탈로그 항목에 속해야 합니다. |
| sysparm_sc_stackby_item_id | 카탈로그 항목의 sys_id입니다. 이 매개변수를 매개변수와 함께 sysparm_sc_stackby_variable_id 사용하여 카탈로그 변수 값을 기반으로 서비스 카탈로그 보고서를 스택합니다. 이 매개변수는 서비스 카탈로그 변수에서 그룹화할 때 매개변수를 sysparm_stack_field 대체합니다. 막대형 보고서와 같이 스택을 지원하는 보고서만 이러한 매개변수를 지원합니다. |
| sysparm_sc_stackby_variable_id | 보고서에서 데이터를 그룹화하는 방법을 결정하는 데 사용되는 카탈로그 항목 변수의 sys_id입니다. 이 변수는 매개변수에 sysparm_sc_stackby_item_id 지정된 카탈로그 항목에 속해야 합니다. |
MetricBase 매개변수
포함된 보고서에서 MetricBase를 사용하려면 sysparm_source_type 매개변수를 "metricbase"로 설정해야 합니다.
MetricBase에는 다음 구문이 있는 sysparm_custom_configuration 매개변수도 필요합니다.
sysparm_custom_config: "{query_condition:\"\",transforms:[{transform:{transform:\"Reference\",name:\"chart-subjects\"},metric:\"mb_metricname\"}], group_by:\"\", table:\"mb_tablename\"}";
변환은 중첩된 변환 함수의 체인입니다. 모든 체인의 마지막 변환은 항상 참조 변환이어야 합니다.{transform:\"Reference\",name:\"chart-subjects\"}메트릭은 메트릭 테이블의 메트릭 필드입니다.그룹화 기준필드는 선택한 메트릭 테이블에서 시계열이 그룹화되는 필드입니다.테이블이 메트릭 테이블을 참조합니다.mb_...자리 표시자 이름입니다
그룹화 기준을 제외한 모든 속성이 필요합니다.차트별 매개변수
특정 매개변수는 특정 보고서 유형에만 사용할 수 있습니다.
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_show_chart_total | 그룹화된 도넛의 총 점수가 보고서 중앙에 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_donut_width_percent | 도넛형 보고서의 두께를 제어하는 숫자 1-100입니다. | 50 |
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_use_color_heatmap | 히트맵이 그라데이션을 사용하여 보고서의 색을 지정할지 여부를 제어하는 예/아니오 값입니다. 이 값이 true인 경우 sysparm_axis_max_color 및 sysparm_axis_min_color 값이 사용됩니다. | 참 |
| sysparm_axis_max_color | 높은 값을 나타내기 위해 히트맵 그라데이션에 사용되는 색상입니다. 이 값은 색상 정의 [sys_report_color] 기록의 sys_id이어야 합니다. | UI14 파란색 |
| sysparm_axis_min_color | 낮은 값을 나타내기 위해 히트맵 그라데이션에 사용되는 색상입니다. 이 값은 색상 정의 [sys_report_color] 기록의 sys_id이어야 합니다. | 하얀 |
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_gauge_autoscale | 다이얼이 보고서의 최소 및 최대 규모를 자동으로 계산하는지 여부를 제어하는 예/아니오 값입니다. 이 값을 false로 설정하면 sysparm_from 및 sysparm_to 값을 지정해야 합니다. | 참 |
| sysparm_from | 축 배율의 최소값을 정의하는 숫자입니다. | |
| sysparm_to | 축 배율의 최댓값을 정의하는 숫자입니다. | |
| sysparm_upper_limit | 다이얼의 상한 임계값을 정의하는 숫자입니다. 값을 지정하지 않으면 다이얼에 상한 임계치가 없습니다. | |
| sysparm_lower_limit | 다이얼의 하한 임계치를 정의하는 숫자입니다. 값을 지정하지 않으면 다이얼에 하한 임계치가 없습니다. | |
| sysparm_direction | 보고서에서 긍정적으로 간주되는 값, 낮은 값 또는 더 높은 값을 제어하는 값입니다. 가능한 값은 최소화 및 최대화입니다. |
최소화 |
차트 크기 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_chart_size | 보고서의 차트 크기입니다. 유효한 값은 small, medium 및 large입니다. | 크게 |
| sysparm_custom_chart_size | 매개변수에서 크기 옵션을 사용하는 대신 사용자 지정 차트 높이 및 너비 값을 지정하려면 이 매개변수를 활성화합니다 sysparm_chart_size . | 아니오 |
| sysparm_custom_chart_height | 보고서의 차트 높이(픽셀)입니다. | |
| sysparm_custom_chart_width | 보고서의 차트 너비(픽셀)입니다. |
차트 제목 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_report_title_size | 제목의 글꼴 크기를 정의하는 숫자입니다. | 16 |
| sysparm_report_title_color | 제목 텍스트 색입니다. 이 값은 색상 정의 [sys_report_color] 기록의 sys_id이어야 합니다. | 검정 |
| sysparm_title_horizontal_alignment | 제목이 보고서를 기준으로 가로로 배치되는 위치입니다. 이 값은 sysparm_custom_report_title_position이 false인 경우에만 사용됩니다. 가능한 값은 왼쪽, 중앙 및 오른쪽입니다. |
중앙 |
| sysparm_title_vertical_alignment | 제목이 보고서를 기준으로 세로로 배치되는 위치입니다. 이 값은 sysparm_custom_report_title_position이 false인 경우에만 사용됩니다. 가능한 값은 top, middle 및 bottom입니다. |
상위 |
| sysparm_custom_report_title_position | x와 y 좌표가 상대 정렬 대신 보고서 제목 위치를 정의하는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_report_title_x_position | 보고서에서 제목의 x 위치를 정의하는 숫자입니다. 이 값은 sysparm_custom_report_title_position이 true인 경우에만 사용됩니다. | 0 |
| sysparm_report_title_y_position | 보고서에서 제목의 y 위치를 정의하는 숫자입니다. 이 값은 sysparm_custom_report_title_position이 true인 경우에만 사용됩니다. | 0 |
차트 테두리 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_show_report_border | 보고서에 테두리 표시 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_report_border_width | 테두리의 너비를 픽셀 단위로 정의하는 숫자입니다. | 1 |
| sysparm_report_border_radius | 테두리 모서리의 반경 크기를 픽셀 단위로 정의하는 숫자입니다. | 0 |
범례 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_show_legend | 보고서에 범례를 표시할지 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_legend_horizontal_alignment | 범례가 보고서를 기준으로 가로로 배치되는 위치입니다. 가능한 값: 왼쪽, 중앙 및 오른쪽. |
중앙 |
| sysparm_legend_vertical_alignment | 범례가 보고서를 기준으로 세로로 배치되는 위치입니다. 가능한 값은 top, middle 및 bottom입니다. |
하단 |
| sysparm_show_legend_border | 범례에 테두리를 표시할지 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_legend_border_width | 범례 테두리의 너비(픽셀)를 정의하는 숫자입니다. | 1 |
| sysparm_legend_border_radius | 범례 테두리의 모서리 반경 크기를 픽셀 단위로 정의하는 숫자입니다. | 0 |
X축 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_x_axis_title | x축에 표시할 이름입니다. | |
| sysparm_x_axis_title_size | x축 제목의 글꼴 크기를 정의하는 숫자입니다. | |
| sysparm_x_axis_title_bold | x축 제목 텍스트의 굵게 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_x_axis_opposite | x축이 보고서의 맨 위에 나타나는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_x_axis_display_grid | x축에서 세로 눈금선이 나타나는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_x_axis_grid_dotted | 수직 눈금선이 점선으로 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_x_axis_label_size | x축에서 증분 레이블의 글꼴 크기를 정의하는 숫자입니다. | 11 |
| sysparm_x_axis_label_bold | x축 증가 레이블이 굵게 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
Y축 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_y_axis_title | Y축에 표시할 이름입니다. | 보고서 집계에 대해 자동으로 생성된 설명 |
| sysparm_y_axis_title_size | Y축 제목의 글꼴 크기를 정의하는 숫자입니다. | |
| sysparm_y_axis_title_bold | Y축 제목 텍스트의 굵게 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_y_axis_opposite | Y축이 보고서 왼쪽에 나타나는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_y_axis_display_grid | Y축에서 수평 눈금선이 나타나는지 여부를 제어하는 예/아니오 값입니다. | 예 |
| sysparm_y_axis_grid_dotted | 수평 눈금선이 점선으로 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_y_axis_label_size | Y축에서 증분 레이블의 글꼴 크기를 정의하는 숫자입니다. | 12 |
| sysparm_y_axis_label_bold | Y축 증가 레이블이 굵게 표시되는지 여부를 제어하는 예/아니오 값입니다. | 아니오 |
| sysparm_y_axis_from | Y축에 표시되는 가장 낮은 값을 정의하는 숫자입니다. | |
| sysparm_y_axis_to | Y축에 표시되는 가장 높은 값을 정의하는 숫자입니다. |