Jelly에 보고서 포함
UI 페이지와 같은 Jelly 기반 요소에 보고서를 포함할 수 있습니다.
임베딩 사용
Jelly에서 보고서를 포함하려면 Jelly 코드에 다음 요소를 추가합니다.
<g : 인라인 템플릿 = "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>| 매개변수 | 설명 |
|---|---|
| targetSpan | 차트를 포함할 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>
| 매개변수 | 설명 |
|---|---|
| targetSpan | 차트를 포함할 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>| 매개변수 | 설명 |
|---|---|
| targetSpan | 차트를 포함할 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 | 작성할 보고서의 유형입니다. 가능한 값: list, line, line_bar, area, spline, bar, horizontal_bar, pareto, hist, pie, donut, semi_donut, speedometer, dial, pivot, pivot_v2, funnel, calendar, pyramid, box, trend, control, trendbox 및 heat map. |
라인 |
| 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 | 보고서에 데이터 그리드가 표시되는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_show_other | 보고서에 기타 그룹이 표시되는지 여부를 제어하는 참/거짓 값입니다. 이 그룹은 그룹 수가 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 값입니다. | true |
| sysparm_show_empty | 그룹화 또는 추세 값이 비어 있는 기록이 보고서에 표시되는지 여부를 제어하는 참/거짓 값입니다. | false |
| sysparm_stack_field | 막대형 및 세로 막대형 보고서에서 누적을 제어하는 데 사용되는 필드입니다. | |
| sysparm_bar_unstack | 누적 데이터가 단일 막대나 열로 표시되는지 또는 여러 막대로 표시되는지를 제어하는 true/false 값입니다. | false |
| 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 | 보고서에 데이터 레이블이 표시되는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_show_zero | 다단계 피벗 및 히트맵 보고서에 0이 나타나는지 여부를 제어하는 true/false 값입니다. | |
| 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 | 보고서의 그려진 모든 점에 표식이 나타나는지 여부를 제어하는 true/false 값입니다. | true |
| sysparm_apply_alias | 포함된 보고서에 구성된 별칭이 표시되는지 여부를 제어하는 true/false 값입니다. |
Service Catalog 매개변수
| 매개변수 | 설명 |
|---|---|
| sysparm_sc_groupby_item_id | 카탈로그 항목의 sys_id입니다. 이 매개변수를 매개변수와 sysparm_sc_groupby_variable_id 함께 사용하여 카탈로그 변수 값을 기반으로 서비스 카탈로그 보고서를 그룹화합니다. 이러한 매개변수는 Service Catalog 변수를 그룹화할 때 매개변수를 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 함께 사용하여 카탈로그 변수 값을 기반으로 서비스 카탈로그 보고서를 스택합니다. 이러한 매개변수는 Service Catalog 변수를 그룹화할 때 매개변수를 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_...은(는) 자리 표시자 이름입니다.
group-by를 제외한 모든 특성이 필요합니다.차트별 매개변수
특정 매개변수는 특정 보고서 유형에만 사용할 수 있습니다.
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_show_chart_total | 그룹화된 도넛의 총 점수가 보고서 중앙에 표시되는지 여부를 제어하는 참/거짓 값입니다. | false |
| sysparm_donut_width_percent | 도넛형 보고서의 두께를 제어하는 숫자 1-100입니다. | 50 |
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_use_color_heatmap | 히트맵에서 그라데이션을 사용하여 보고서의 색을 지정할지 여부를 제어하는 true/false 값입니다. 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 | 다이얼이 보고서의 최소 및 최대 배율을 자동으로 계산하는지 여부를 제어하는 true/false 값입니다. 이 값을 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 활성화합니다. | false |
| 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인 경우에만 사용됩니다. 가능한 값은 left, center 및 right입니다. |
중앙 |
| sysparm_title_vertical_alignment | 제목이 보고서를 기준으로 세로로 배치되는 위치입니다. 이 값은 sysparm_custom_report_title_position가 false인 경우에만 사용됩니다. 가능한 값: top, middle, bottom. |
상위 |
| sysparm_custom_report_title_position | x 및 y 좌표가 상대 맞춤 대신 보고서 제목 위치를 정의하는지 여부를 제어하는 true/false 값입니다. | false |
| 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 | 보고서에 테두리가 표시되는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_report_border_width | 테두리의 너비를 픽셀 단위로 정의하는 숫자입니다. | 1 |
| sysparm_report_border_radius | 테두리 모서리의 반경 크기(픽셀)를 정의하는 숫자입니다. | 0 |
범례 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_show_legend | 보고서에 범례를 표시할지 여부를 제어하는 true/false 값입니다. | true |
| sysparm_legend_horizontal_alignment | 범례가 보고서를 기준으로 가로로 배치되는 위치입니다. 가능한 값: left, center 및 right. |
중앙 |
| sysparm_legend_vertical_alignment | 범례가 보고서를 기준으로 세로로 배치되는 위치입니다. 가능한 값: top, middle, bottom. |
하단 |
| sysparm_show_legend_border | 범례에 테두리가 표시되는지 여부를 제어하는 true/false 값입니다. | true |
| 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축 제목 텍스트를 굵게 표시할지 여부를 제어하는 true/false 값입니다. | true |
| sysparm_x_axis_opposite | x축이 보고서 맨 위에 표시되는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_x_axis_display_grid | x축에서 세로 그리드 선이 나타나는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_x_axis_grid_dotted | 세로 그리드 선이 점선인지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_x_axis_label_size | x축에서 증분 레이블의 글꼴 크기를 정의하는 숫자입니다. | 11 |
| sysparm_x_axis_label_bold | x축 증분 레이블을 굵게 표시할지 여부를 제어하는 true/false 값입니다. | false |
Y축 매개변수
| 매개변수 | 설명 | 기본값 |
|---|---|---|
| sysparm_y_axis_title | Y축에 표시할 이름입니다. | 자동으로 생성된 보고서 집계에 대한 설명 |
| sysparm_y_axis_title_size | y축 제목의 글꼴 크기를 정의하는 숫자입니다. | |
| sysparm_y_axis_title_bold | y축 제목 텍스트가 굵게 표시되는지 여부를 제어하는 true/false 값입니다. | true |
| sysparm_y_axis_opposite | 보고서 왼쪽에 y축이 나타나는지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_y_axis_display_grid | y축에서 수평 그리드 선이 나타나는지 여부를 제어하는 true/false 값입니다. | true |
| sysparm_y_axis_grid_dotted | 수평 그리드선이 점선인지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_y_axis_label_size | y축에서 증분 레이블의 글꼴 크기를 정의하는 숫자입니다. | 12 |
| sysparm_y_axis_label_bold | y축 증분 레이블을 굵게 표시할지 여부를 제어하는 true/false 값입니다. | false |
| sysparm_y_axis_from | y축에 표시되는 가장 낮은 값을 정의하는 숫자입니다. | |
| sysparm_y_axis_to | Y축에 표시되는 가장 높은 값을 정의하는 숫자입니다. |