# 대화형 기능 ## Content ActiveReportsJS는 더 나은 사용자 경험을 위한 보고서를 공급하기 위해, 여러 타입의 대화형 기능을 제공합니다. ## Action 속성 [텍스트 상자](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Visualizers/TextBox), [이미지](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Visualizers/Image), [차트 플롯](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/Chart), [테이블 행](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/Table), [밴드 리스트 섹션](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/BandedList), 그리고 [목록 섹션](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/List)에는 보고서 항목, 차트 플롯의 요소, 테이블 행 내의 요소, 또는 리스트나 밴디드 리스트 섹션이 차지하는 공간을 보고서 독자(reader)가 클릭할 경우에 발생하는 작업을 결정하는 `Action` 속성이 있습니다. 대화형 작업의 유형은 네 가지가 있습니다. ### 매개변수 적용 `매개변수 적용` 작업은 하나 이상의 [보고서 매개변수](/activereportsjs/docs/ReportAuthorGuide/Report-Parameters) 값을 설정하고, 업데이트된 값으로 보고서를 다시 렌더링합니다. 다음 속성을 사용하여 `매개변수 적용` 작업 구성을 구성할 수 있습니다. * **매개변수 모음:** 매개변수 값 변경 방법을 정의하는 항목 목록입니다. 각 항목에는 다음이 포함됩니다. * **매개변수:** 수정할 특정 매개변수입니다. * **설정 유형:** 매개변수 값을 변경하는 데 사용되는 방법입니다. * `Set` – 매개변수를 특정 값으로 설정합니다. * `Reset` – 매개변수를 기본값으로 되돌립니다. * `Toggle` – `다중 값` 매개변수에서 지정된 값을 추가하거나 제거합니다. * **값:** 새 매개변수 값을 지정하는 표현식입니다(`Reset` 설정 유형에는 적용되지 않습니다). * **대상 책갈피:** 매개변수가 적용되고 보고서가 다시 렌더링된 후 보고서 뷰어가 지정된 책갈피로 자동으로 이동하도록 지시하는 선택적 속성입니다. ![Apply Parameters](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/a9ec544d-3eb8-40c7-891c-0e9e47f462ea/Image-20260611.01a968.png) 이 기능의 일반적인 사용법은 `런타임 필터`를 구현하는 것입니다. 예를 들어, [판매 대시보드 데모](/activereportsjs/demos/Reports/RuntimeFilters/purejs)는 보고서 독자가 특정 연도와 하나 이상의 특정 지역의 판매 통계를 검토하기 위해 사용할 수 있는 `연도 목록`과 `대륙 목록` 컨트롤을 보여줍니다. `대륙 목록`의 `매개변수 적용` 작업은 보고서 보고서 독자가 클릭하는 `대륙 이름`을 다중 값 `pContinent` 매개변수 내에서 `토글`하도록 구성됩니다. ![image.f0b21c](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/85453172-7356-41cf-a9c1-0b4850348268/image.f0b21c.6809e6.png) `연도 목록`에 대한 작업은 보고서 독자가 클릭하는 연도를 단일 값 `pYear` 매개변수를 `설정(Set)`하도록 구성됩니다. ![image.e97de0](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/85453172-7356-41cf-a9c1-0b4850348268/image.e97de0.d99bb0.png) 이 보고서의 [데이터 영역](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions)은 매개변수에 따라 값을 필터링 하기 위해 구성됩니다. ![image.123125](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/85453172-7356-41cf-a9c1-0b4850348268/image.123125.050bdb.png) 따라서, 보고서 독자가 연도를 클릭하거나 대륙을 토글할 때, 보고서는 새로운 매개변수 값으로 다시 렌더링되고 데이터 영역이 이에 따라 필터링됩니다. ### 보고서로 이동 `보고서로 이동` 작업은 지정된 보고서를 뷰어에서 엽니다. 이 기능을 사용하여 드릴다운 보고서를 생성할 수 있습니다. 구성에는 다음 속성이 포함됩니다. * `보고서로 이동` \- 독자가 보고서 항목을 클릭했을 때 열릴 보고서 이름을 지정하는 [표현식](/activereportsjs/docs/ReportAuthorGuide/Expressions) * `매개변수` \- 위 보고서에 전달할 [매개변수](/activereportsjs/docs/ReportAuthorGuide/Report-Parameters) 값의 [컬렉션](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Common-Properties#컬렉션)입니다. ### 책갈피로 이동 `책갈피로 이동` 작업은 `책갈피`가 지정된 보고서 항목으로 포커스를 가져옵니다. [책갈피 데모](/activereportsjs/demos/Reports/Bookmarks/purejs)에서는 이 기능을 사용하여 첫 페이지에 대화형 요약 표를 표시합니다. 월 이름을 클릭하면 지정된 월에 대한 세부 정보 표를 보여 주는 페이지로 뷰어가 전환됩니다. ### URL로 이동 `URL로 이동` 작업은 브라우저 설정에 따라 새 창 또는 새 탭에서 지정된 URL을 엽니다. ### 보고서 맵 ActiveReportsJS의 [표 그룹](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/Table#table-grouping)과 같은 모든 [보고서 항목](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Common-Properties)과 그룹에는 `레이블` 속성이 있습니다. 또한 [텍스트 상자](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Visualizers/TextBox) 보고서에는 `1`부터 정수 값을 가져오는 `HeadingLevel`이 있습니다. `HeadingLevel`과 함께 텍스트 상자의 `레이블` 및 값은 [보고서 뷰어 세로 막대](/activereportsjs/docs/ReportAuthorGuide/Report-Viewer-Interface)에 표시되는 `보고서 맵`을 생성합니다. 보고서 맵에서 항목의 계층 구조는 다음 조건 중 하나로 정의됩니다. * `HeadingLevel`이 `1`로 설정된 텍스트 상자는 계층 구조의 루트 수준에 있습니다. `HeadingLevel`이 `2`로 설정된 텍스트 상자는 계층 구조의 그다음 수준에 있는 식입니다. [카탈로그 샘플](/activereportsjs/demos/Reports/Catalog/purejs)은 [표 그룹 헤더](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/Table#group-header)에 있는 텍스트 상자에 대해 `HeadingLevel` = 1입니다. 생성된 레이블은 보고서 맵과 [목차](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Supplemental-Report-Items/TableOfContents)에 모두 표시됩니다. * `레이블` 속성이 비어 있지 않은 [부모 및 자식 그룹](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Data-Regions/Table#insert-child-or-parent-groups)은 계층 구조를 유기적으로 생성합니다. 이러한 접근 방식의 예는 [중첩된 목록 데모](/activereportsjs/demos/Reports/NestedDataRegions/purejs)에서 찾을 수 있습니다. [보고서 속성](/activereportsjs/docs/ReportAuthorGuide/보고서-구성/layout-properties)의 `문서 맵` 섹션에 있는 `소스` 속성은 보고서 맵에 어떤 항목을 포함할지 결정합니다. * `레이블` \- 레이블만 포함합니다\. 기본값입니다\. * `제목` - `HeadingLevel` \>= 1인 텍스트 상자 값만 포함됩니다\. * `모두` \- 레이블과 텍스트 상자 값이 모두 포함됩니다\. 이 옵션은 드문 시나리오에 사용하기 위한 마지막 옵션이어야 합니다\. * `없음` \- 보고서 맵이 생성되지 않습니다\. 또한 보고서의 `번호 매기기 스타일` 속성은 보고서 맵과 [목차](/activereportsjs/docs/ReportAuthorGuide/Report-Items/Supplemental-Report-Items/TableOfContents)에서 항목의 표식을 결정합니다.