(수정중) [i-AUD] 링크드 컨트롤 (연결하여 붙여넣기) 기능이 추가되었습니다.

page no.  181338229

1. 기능 설명
   1. 여러 폼에서 사용하는 조회 조건 컨트롤을 스크립트 작성 없이 함께 움직이도록 묶어 주는 기능입니다.
   2. 링크드 컨트롤은 조건 컨트롤을 「연결하여 붙여넣기」 한 번으로 원본과 사본을 묶어, 다음을 자동으로 처리합니다.

      

      값 동기화	사용자가 화면에서 원본 또는 사본의 값을 변경하면 연결된 모든 컨트롤이 같은 값이 됩니다. (양방향)
      데이터 동기화	ComboBox 아이템 목록 등 데이터소스 조회 결과가 원본에서 한 번만 조회되고 사본에 자동 반영됩니다. 중복 쿼리가 발생하지 않습니다.
      변수 일원화	사본이 몇 개든 SQL 에서 참조되는 변수는 원본 이름 하나로 처리됩니다. (예 : :VS_제품명) 기존 SQL 을 수정해도 사본 별로 변수를 따로 관리할 필요가 없습니다.

   3. 지원  컨트롤

      1. FromTo 계열 달력은 시작 · 종료 값이 함께 동기화됩니다. 데이터 동기화 (원본 단독 조회) 는 데이터소스를 갖는 ComboBox · MultiComboBox · PickList 등에 적용됩니다.

      분류	컨트롤
      CheckBox	CheckBox, RadioButton
      InputBox	TextBox, MaskTextBox, NumberBox, RichTextBox
      Combo	PickList, ComboBox, MultiComboBox, ColorPicker
      Calendar	Daily Calendar, Daily CalendarFromTo Weekly Calendar, Weekly CalendarFromTo Monthly Calendar, Monthly CalendarFromTo Yearly Calendar, Yearly CalendarFromTo

2. 사용 방법
   ※ 동기화는 i-AUD Designer의 미리보기 (Preview) 화면 및 실행 (Viewer) 화면에서 동작합니다.
   
   1. i-AUD Designer의 편집(Edit) 화면에서 원본으로 사용할 조회 조건 컨트롤 (예 : ComboBox :VS_PRODUCT) 을 선택하고 Ctrl+C 로 복사합니다.
      
   2. 대상 폼 (탭) 으로 이동한 뒤 편집 (Edit) 화면에서 마우스 우클릭 합니다.
   3. 컨텍스트 메뉴에서 「연결하여 붙여넣기」 를 선택합니다.
      
   4. 사본이 생성되고 원본과 자동으로 연결됩니다. 
      
      1. 사본 이름은 예시 이미지처럼 :VS_PRODUCT1 처럼 자동 부여되지만, SQL 변수는 원본 이름 기준으로 동작합니다.
         

      
      

      사본을 다시 복사하면?

      • 사본을 복사해서 「연결하여 붙여넣기」 하더라도 새로 만들어진 사본도 같은 원본에 연결됩니다. 사본의 사본으로 이어지는 여러 단계 연결은 만들어지지 않습니다.
3. 동기화 동작 방식

1. 값 동기화

   1. 사용자가 원본 또는 사본 어느 폼의 화면에서 값을 변경하면 연결된 모든 컨트롤이 같은 값이 됩니다. 
   2. 사본에서 값을 변경한 경우에도 원본에 값이 반영되고, 원본을 통해 나머지 사본으로 전파됩니다. 
   3. 값 변경으로 인한 후속 조회는 원본에서 한 번만 수행되어 중복 조회가 발생하지 않습니다.

2. 데이터 동기화

   1. 데이터소스를 갖는 컨트롤 (ComboBox · MultiComboBox · PickList 등) 은 원본만 조회를 수행하고, 조회 결과 (아이템 목록) 가 사본에 자동으로 반영됩니다.
   2. 사본에서 Refresh() 가 호출되면 원본이 대신 조회를 수행하며, 보고서 자동 조회 (AutoRefresh) 대상에서도 사본은 제외됩니다. 
   3. 초기 선택 값은 원본의 초기값 (InitValue) 기준으로 결정됩니다.
      

3. 이벤트

1. 원본의 OnValueChanged 등 값 변경 이벤트는 값이 바뀔 때 항상 한 번 발생합니다. 
2. 사본의 이벤트도 기본적으로 함께 발생하여 사본에 작성한 스크립트가 동작합니다. 사본의 이벤트를 발생시키지 않으려면 [속성] 창의 「동기화 이벤트 발화」 를 각 사본 별로 꺼 주십시오.
4. [속성] 창 Link 섹션

   1. 링크된 컨트롤을 선택하면 [속성] 창에 Link 섹션이 별도 그룹으로 표시됩니다.
      
      

      항목	설명
      연결 원본	이 사본이 참조하는 원본 컨트롤의 이름입니다. (읽기 전용)
      값 동기화	원본과 값을 함께 동기화합니다. 끄면 이 사본은 값을 독립적으로 관리합니다.
      데이터 동기화	원본의 데이터소스 조회 결과를 이 사본에 자동으로 반영합니다. 끄면 이 사본이 자체적으로 데이터소스를 조회합니다.
      동기화 이벤트 발화	값 동기화 시 이 사본의 OnValueChanged 등 이벤트를 함께 발생시킵니다. 끄면 사본의 이벤트가 발생하지 않습니다. (원본 이벤트는 항상 발생)
      연결 해제	원본과의 연결을 끊고 완전히 독립된 컨트롤로 전환합니다.

   2. 원본을 선택한 경우에는 Link 섹션에 「연결된 컨트롤」 항목으로 이 컨트롤을 참조하는 사본 목록과 개수가 표시됩니다.
      
      
      
      

5. i-AUD Desinger 편집화면 표시

   1. 링크 뱃지 : 원본이나 사본 컨트롤을 선택하면 컨트롤 우상단에 뱃지가 표시됩니다.
      

      항목	이미지	설명
      원본		N 개의 사본이 이 컨트롤을 참조 중입니다.
      사본		다른 컨트롤을 원본으로 참조 중입니다.

   2. 컨트롤 위에 마우스를 올리면 툴팁에 연결 원본 이름 또는 연결된 사본 수가 함께 표시됩니다.
      

      
      

6. 링크 관리
   1. 연결 해제
      [속성] 창 Link 섹션의 「연결 해제」 버튼을 누르면 해당 사본이 독립 컨트롤로 전환됩니다. 복사 시점의 데이터소스 설정을 그대로 갖고 있으므로 해제 즉시 단독으로 동작합니다.
      
      

   2. 원본 삭제 시 자동 승격
      사본이 남아 있는 원본 컨트롤을 삭제하면 확인 메시지가 표시되고, 삭제를 진행하면 첫 번째 사본이 새 원본으로 자동 승격됩니다. 나머지 사본들은 새 원본을 참조하도록 자동 갱신됩니다.
      

      원본 삭제 시 SQL 변수 확인

      연결된 컨트롤 중 원본을 삭제하면, 남은 사본 하나가 자동으로 새 원본이 역할을 이어받습니다 (승격).

      이때 새 원본의 이름은 사본 시절 이름 (예:  :VS_PRODUCT1) 그대로 유지됩니다.

      SQL 안에서 원본 이름을 참조 (예:  :VS_PRODUCT) 하고 있다면 :
      1. 승격된 컨트롤을 확인
      2. 그 컨트롤의 이름을 원래 원본 이름 (예:  :VS_PRODUCT) 으로 수정

      컨트롤 이름을 바꿔도 링크 관계는 유지되므로 안전하게 변경 가능합니다.

   3. 실행 취소/다시 실행
      「연결하여 붙여넣기」, 삭제, 원본 승격 모두 Ctrl+Z 로 되돌릴 수 있으며 링크 정보도 함께 복원됩니다.
      
      
   4. 저장
      링크 정보는 i-AUD 보고서 파일 (.mtsd) 에 함께 저장되어, 보고서를 다시 열어도 유지됩니다. 다른 보고서로 복사해서 붙여넣는 경우에는 원본이 존재하지 않으므로 링크 없이 일반 사본으로 생성됩니다.