page no. 

1 개요

Bulk Editor 는 여러 보고서의 설정, SQL, 스크립트를 한 번에 변경할 수 있는 관리자 도구입니다.

변경 내용을 실제로 적용하기 전에 미리 확인(Dry-Run) 할 수 있으며, 변경 시 원본 보고서를 자동으로 백업합니다.

필요한 경우 작업 단위로 변경 전 상태로 되돌릴 수 있습니다.

컬럼 정렬 통일, Connection Code 교체, 테이블명 변경처럼 여러 보고서에 동일한 변경 사항을 일괄 적용해야 하는 경우에 사용할 수 있습니다.

Bulk Editor 의 작업은 다음 순서로 진행합니다.

변경 및 복원

Bulk Editor 는 보고서를 변경하기 전에 결과를 미리 확인할 수 있으며, 실제 저장 시 원본 보고서를 자동으로 백업합니다.

2 빠른 시작

Bulk Editor 는 다음 순서로 사용할 수 있습니다.

1. 대상 선택 을 선택하여 변경할 보고서를 체크한 후 선택 추가 를 선택합니다.
2. ② 변환 스크립트 영역에 transform(doc) 함수를 작성합니다. 처음 사용하는 경우 예제 에서 원하는 작업과 유사한 예제를 불러온 후 필요한 부분을 수정하는 것을 권장합니다.
3. Dry-Run(저장 안 함) 을 선택하여 변경 내용을 미리 확인합니다. ③ 실행 결과 에서 보고서별 변경 전·후 내용을 확인할 수 있습니다.
4. 변경 내용이 올바른지 확인한 후 ⚠ 실행 (저장) 을 선택하여 실제 보고서에 적용합니다.
5. 적용한 내용을 되돌리려면 ↺ 방금 작업 되돌리기 를 사용합니다. 이전 작업의 백업을 확인하거나 복원하려면 백업 / 복원 을 사용합니다.

3 메인 화면

메인 화면에서는 작업 대상을 선택하고 변환 스크립트를 작성한 후, 변경 내용을 미리 확인하거나 실제 보고서에 적용할 수 있습니다.

📌 화면 구성

Image Modified

3.1 상단 도구 모음

상단 도구 모음에서는 Bulk Editor 의 주요 기능을 실행할 수 있습니다.

「대상 선택」, 「대상 비우기」는 상단 도구 모음이 아닌 ① 작업 대상 영역에서 사용할 수 있습니다.

3.2 작업 단계

화면 상단에는 현재 작업 진행 상태를 확인할 수 있도록 ①~④ 단계가 표시됩니다.

3.3 작업 대상

① 작업 대상 영역에서는 Bulk Editor로 변경할 보고서를 확인하고 선택할 수 있습니다.

보고서의 처리 상태는 다음과 같이 표시됩니다.

작업 대상 영역 상단에는 전체 보고서 수와 현재 선택된 보고서 수가 표시됩니다.

등록된 작업 대상이 없는 경우에는 +대상 선택 을 선택하여 보고서를 추가할 수 있습니다.

4 작업 대상 선택

대상 선택 을 선택하면 폴더와 보고서 목록을 확인할 수 있는 팝업이 열립니다.

1. 왼쪽 폴더 영역에서 작업할 폴더를 선택합니다.
2. 선택한 폴더에 포함된 보고서가 오른쪽 목록에 표시됩니다.
3. 필요한 경우 검색창에 보고서명 또는 보고서 코드를 입력하여 목록을 검색합니다.
4. 작업 대상으로 추가할 보고서를 체크합니다.
5. 선택 N건 추가 를 선택하여 체크한 보고서를 작업 대상에 추가합니다.
6. 다른 폴더의 보고서를 추가하려면 같은 방법으로 반복합니다. 작업 대상 선택이 끝나면 닫기를 선택합니다.

검색 중에도 이미 체크한 보고서는 선택 상태가 유지됩니다.

여러 폴더에서 보고서를 추가할 수 있으며, 이미 작업 대상에 추가된 보고서는 중복으로 추가되지 않습니다.

5 변환 스크립트 작성

변환 스크립트는 transform(doc) 함수에 작성합니다. doc 에는 작업 대상 보고서의 전체 문서 정보가 JSON 형태로 전달되며, 선택한 보고서마다 transfomr(doc) 함수가 한 번씩 실행됩니다.

SQL 과 서버스크립트도 doc 을 통해 조회하고 변경할 수 있습니다.

암호화된 항목은 편집 가능한 상태로 전달되며, 저장할 때 자동으로 다시 암호화되므로 스크립트에서 암·복호화를 직접 처리할 필요는 없습니다.

처음 사용하는 경우에는 편집기 오른쪽 위 「예제」에서 작업과 유사한 예제를 불러와 필요한 조건과 값만 수정하는 것을 권장합니다.

기본 스크립트

편집기를 처음 열면 다음 스크립트가 기본으로 제공됩니다.

function transform(doc) {
    walkAllControls(doc, function (ctl, form) {
        var isGrid =
            ctl.Type === 'DataGrid' ||
            ctl.Type === 'GroupGrid' ||
            ctl.Type === 'TreeGrid';

        if (!isGrid) { return; }

        (ctl.Columns || []).forEach(function (col) {
            if (!col.Name || col.Name.indexOf('ITEM_NAME') === -1) { return; }

            // ITEM_NAME 컬럼을 왼쪽 정렬로 변경 (기본값이므로 키를 삭제한다)
            delete col.TextPosition;

            log(form.Name + '/' + ctl.Name + '/' + col.Name + ' → 왼쪽 정렬');
        });
    });

    return true;
}

반환값과 처리 결과

transform(doc) 의 반환값과 실제 변경 여부에 따라 보고서의 처리 결과가 결정됩니다.

5.1 기본 함수

transform(doc) 안에서는 다음 함수를 별도로 선언하지 않고 사용할 수 있습니다.

walkAllControls 가 탐색하는 컨테이너

OLAP 필드 주요 속

일반 필드만 변경하려면 fld.CreateType === 0 조건을 사용할 수 있습니다.

5.2 문서 구조

doc 은 보고서의 폼, 컨트롤, 데이터소스, 스크립트 정보를 포함합니다.

SQL과 서버 스크립트는 편집 가능한 문자열로 전달됩니다. 암호화되어 있던 항목은 저장할 때 자동으로 다시 암호화되므로 변환 스크립트에서 별도로 처리할 필요가 없습니다.

보고서의 실제 속성 이름과 값은 작업 대상의 🔍 문서 구조 보기에서 확인할 수 있습니다.

5.3 작성 시 참고사항

기본값은 속성을 삭제하여 적용

일부 속성은 값이 없는 상태가 기본값을 의미합니다.

예를 들어 정렬 값은 'start'(왼쪽), 'center', 'end'(오른쪽)를 사용할 수 있지만, 왼쪽 정렬은 기본값이므로 'start'를 지정하지 않고 해당 속성을 삭제합니다.

delete col.TextPosition;      // 왼쪽 정렬(기본값)
col.TextPosition = 'end';     // 오른쪽 정렬

delete ctl.Visible;           // 표시(기본값)
ctl.Visible = false;          // 숨김

컨트롤에 따라 정렬 속성이 다름

색상 변경 시 Style.Type 확인

컨트롤의 색상을 직접 변경하려면 Style.Type에 따라 적용 방식을 확인해야 합니다.

색상을 변경했지만 화면에 적용되지 않는 경우 Style.Type이 0 또는 1인지 확인하세요.

작성 시 주의사항

• 문서 전체 문자열을 변경하는 경우 속성 이름까지 변경될 수 있으므로 다른 값과 겹치지 않는 구체적인 문자열을 사용하세요.
• 정규식을 문자열로 작성하는 경우 역슬래시(\)를 두 번 입력해야 합니다. 예: '\\bNAME\\b'
• SQL에 조건을 추가하는 경우GROUP BY, ORDER BY, UNION, WHERE 등의 SQL 구조를 확인하여 적절한 위치에 추가하세요. 변경 후에는 Dry-Run으로 SQL을 확인하는 것을 권장합니다.
• 그리드 컬럼을 추가하는 경우 조회 SQL에도 해당 컬럼이 포함되어 있어야 데이터가 표시됩니다.
• 기존 문자열에 내용을 추가하는 경우 스크립트를 반복 실행하면 같은 내용이 중복될 수 있습니다. 적용 여부를 확인할 수 있는 마커를 사용하는 것을 권장합니다. (→ 예제 ⑨)

중복 적용 방지 예제

var MARKER = '/* @BULK:myFix */';

if (script.indexOf(MARKER) > -1) {
    log('이미 적용됨');
    return false;
}

5.4 예제 스크립트

편집기 오른쪽 위 「예제」 에서 자주 사용하는 변환 작업의 예제 스크립트를 불러올 수 있습니다.

예제를 선택하면 확인 후 현재 편집기의 내용이 선택한 예제로 변경됩니다. 목록에서 원하는 예제를 검색할 수도 있습니다.

※ 예제는 추가되거나 삭제될 수 있습니다.

6 Dry-Run 과 실행

변환 스크립트를 작성한 후 Dry-Run으로 변경 내용을 미리 확인하고, 결과가 올바르면 실행하여 실제 보고서에 적용합니다.

Dry-Run 과 실행은 선택된 보고서를 한 건씩 처리하며, 실제 저장 여부에 차이가 있습니다.

1. 변환 스크립트에 오류가 있는지 확인합니다. 오류가 있으면 작업을 시작하지 않습니다.
2. 선택한 보고서에 transform(doc) 을 실행합니다.
3. 변경된 내용이 있는지 확인합니다. 변경 내용이 없거나 return false 인 보고서는 저장 대상에서 제외됩니다.
4. 변경된 내용이 있으면 ③ 실행 결과에 변경 전·후 내용을 표시합니다.
5. Dry-Run 에서는 보고서를 저장하지 않고 변경 예정으로 표시합니다. 실행에서는 원본 보고서를 백업한 후 변경 내용을 저장합니다.
6. 작업이 완료되면 변경, 스킵, 오류 건수를 확인할 수 있습니다.

6.1 실행 결과 확인

③ 실행 결과에서는 보고서별 변경 내용과 처리 상태를 확인할 수 있습니다.

변경 내용은 다음과 같이 변경된 위치, 이전 값, 변경 후 값으로 표시됩니다.

경로 = 이전값 ⇒ 새값

보고서 한 건에서 변경된 항목이 많은 경우 최대 30건까지 표시되며, 나머지는 ... 외 n건 으로 표시됩니다.

log() 로 기록한 내용과 변경된 항목의 상세 내용도 실행 결과에서 확인할 수 있습니다.

6.2 결과 필터

실행 결과 상단에는 처리 결과별 건수와 필터

• Dry-Run 후에는 변경 예정, 변경 없음 등의 결과가 표시됩니다.