재사용 가능한 ONLYOFFICE 매크로로 스프레드시트 텍스트를 정리하세요

반복 가능한 스프레드시트 정리를 위해 스프레드시트 편집기에서 간단한 JavaScript 매크로를 만들고, 변경하려는 텍스트 범위만 대상으로 지정한 다음, 먼저 복사본 통합 문서에서 테스트하세요. 아래 예제는 모든 행을 그대로 유지하면서 이메일 열에서 인쇄되지 않는 문자와 불필요한 공백을 제거합니다.

ONLYOFFICE 매크로는 편집기 내에서 실행되며 Office JavaScript API를 사용합니다. 공식 문서에서는 여전히 보기 > 매크로를 열고 코드를 작성하거나 붙여넣은 다음 편집기에서 실행하는 워크플로를 설명하고 있으며, 현재 문서에서 확인된 최근 변경 사항은 이 기본 프로세스를 변경하지 않습니다. 이 매크로는 소프트웨어 테스트 보고서가 아니라 재사용 가능한 예시 스크립트입니다. ONLYOFFICE 매크로 빠른 시작 및 스프레드시트 편집기 보기 탭 참조를 확인하세요 .

안전한 사본을 준비하고 정리 방법을 정의하세요.

워크북에 1행에 머리글이 있고 B열(B2~B500)에 이메일 주소가 있는 연락처 목록이 있다고 가정해 보겠습니다. 가져온 값 중 일부에 줄 바꿈, 탭 또는 앞뒤 공백이 포함될 수 있습니다. 이 예제는 해당 텍스트 열 하나만 정리합니다. 코드를 실행하기 전에 시트에 맞게 범위를 조정하십시오.

• 통합 문서의 별도 사본을 저장하거나 워크시트를 복제하십시오. 출력 결과를 확인할 때까지 원본은 그대로 두십시오.
• 선택한 범위에 수식, 공백을 사용하는 ID 또는 정확한 간격을 유지해야 하는 데이터가 아닌 원시 텍스트가 포함되어 있는지 확인하십시오.
• 헤더 행은 범위에서 제외하십시오. 매크로는 헤더를 감지하거나 어떤 열을 변경해도 안전한지 판단하지 않습니다.

전체 범위를 사용하는 대신 B2:B500과 같이 특정 열 범위만 사용하세요. 모든 셀을 무분별하게 정리하면 이름, 주소, 코드 또는 수식 결과가 의도치 않게 변경될 수 있습니다.

매크로 편집기를 열고 스크립트를 추가하세요.

ONLYOFFICE 스프레드시트 편집기에서 통합 문서를 엽니다. 보기 > 매크로를 선택하여 매크로 편집기를 열고, 매크로를 만들거나 편집기의 시작 코드를 바꿉니다. ONLYOFFICE 매크로는 JavaScript 구문과 Office API를 사용하며 VBA 매크로가 아닙니다. 편집기의 매크로 워크플로 및 지원되는 API 메서드는 공식 매크로 시작 가이드 에 설명되어 있습니다 .

이 예시를 붙여넣은 다음, B2:B500실제 텍스트 전용 범위로 변경하세요.

(function () {
    var sheet = Api.GetActiveSheet();
    var range = sheet.GetRange("B2:B500");
    var rows = range.GetValue();
    var functions = Api.WorksheetFunction;

    for (var i = 0; i < rows.length; i++) {
        var value = rows[i][0];
        if (typeof value === "string") {
            value = functions.CLEAN(value);
            rows[i][0] = value.replace(/^\s+|\s+$/g, "")
                              .replace(/\s{2,}/g, " ");
        }
    }

    range.SetValue(rows);
})();

이 매크로는 범위를 2차원 배열로 읽어들이고, 문자열 셀을 처리한 후, 배열을 동일한 범위에 다시 저장합니다. CLEAN출력되지 않는 문자를 제거하고, 두 개의 정규 표현식 대체 기능을 사용하여 문자열 가장자리의 공백을 제거하고, 문자열 내의 반복되는 공백을 하나의 공백으로 줄입니다. API 참조에 따르면 이 매크로는 GetValue범위에 대해 2차원 배열을 반환할 수 있으며 SetValue배열을 인수로 받습니다. GetValue , SetValue 및 CLEAN 참조 문서에서 이러한 호출에 대한 설명을 확인할 수 있습니다.

스크립트가 값을 다시 저장하기 때문에 수식이 포함된 셀을 지정하지 마십시오. 수식이 포함된 셀은 현재 계산된 값으로 대체될 수 있습니다. 또한 이 스크립트는 중복 레코드를 제거하거나, 대소문자를 표준화하거나, 주소 배송 가능 여부를 검증하거나, 전화번호 형식을 변경하지 않습니다. 이러한 기능은 별도의 정리 규칙으로 설계 및 테스트해야 합니다.

통제된 범위에서 실행하십시오.

1. 범위 리터럴을 다시 한번 확인하세요. 예를 들어 목록이 240번째 행에서 끝난다면, 사용되지 않는 수백 개의 행을 처리하는 대신 B2:B240 범위를 사용하세요.
2. 매크로 편집기에서 실행을 클릭하십시오 . 편집기에 구문 오류가 표시되면 범위를 변경하거나 추가 로직을 넣기 전에 따옴표, 괄호 및 중괄호를 검토하십시오.
3. 워크시트로 돌아가서 정리해야 할 값, 이미 올바른 형식으로 되어 있는 값, 그리고 빈 셀을 포함하여 여러 셀을 검사합니다.

범위를 좁혀 시작하면 결과를 더 쉽게 이해할 수 있습니다. 출력 결과가 올바르면 범위를 의도적으로 편집하여 다른 시트에서 매크로를 재사용할 수 있습니다. 다른 통합 문서에서 열 문자나 행 경계가 그대로 유효하다고 가정하지 마십시오.

매크로 명령이 없거나 코드가 실행되지 않으면 편집기에서 매크로가 활성화되어 있는지 또는 호스트 애플리케이션 구성에서 비활성화되어 있는지 확인하십시오. 온라인 편집기에서는 관리자가 매크로 사용 여부를 제어할 수 있으며, 제품의 스프레드시트 편집기 고급 설정에서 사용자에게 표시되는 매크로 옵션을 확인할 수 있습니다. 출처를 알 수 없는 파일의 자동 실행은 허용하지 말고, 이해할 수 있는 코드만 실행하십시오.

매크로를 재사용하기 전에 결과를 확인하십시오.

정리된 열을 원본과 비교하여 외관만으로 성공 여부를 판단하지 마십시오. 모든 이메일 주소가 여전히 같은 행에 있고, 연락처가 사라지지 않았으며, 정규화하려는 문자 및 공백만 다른지 확인하십시오. 선택한 범위의 상단, 중간 및 끝 부분에서 샘플을 확인하십시오. 편집기에서 공백 표시 기능을 사용하는 경우 값의 시작이나 끝에 공백이 있는지 검색하고, 이전에 줄 바꿈이나 제어 문자가 포함된 가져온 값을 검사하십시오.

또한 행 수와 해당 열을 사용하는 종속 수식, 필터 또는 조회 기능을 비교하십시오. 수식 결과가 예기치 않게 변경된 경우 편집을 취소하거나 작업 복사본을 복원하십시오. 매크로는 일반 텍스트 셀에만 적용되도록 제한해야 합니다. 규모가 크거나 업무상 중요한 통합 문서의 경우, 정리된 열 전체를 백업본과 비교하거나 변경 사항을 검토할 수 있도록 별도의 출력 열을 먼저 생성하십시오.

청소 작업을 반복 가능하게 유지하세요

첫 실행이 올바르게 완료되면 매크로가 편집기의 매크로 워크플로에 따라 문서와 함께 유지되도록 통합 문서를 저장하십시오. 한 통합 문서에 저장된 매크로가 모든 새 파일에 자동으로 나타난다고 가정해서는 안 됩니다. 반복적으로 파일을 가져오는 경우, 깨끗한 템플릿이나 보호된 원본 복사본을 유지하고, 매크로가 예상하는 범위를 문서화하고, 시트 레이아웃이 변경될 때마다 업데이트하십시오. ONLYOFFICE 매크로는 확정적인 정리 규칙에 유용하지만, 값이 실제로 정확한지 또는 변경 사항이 데이터 세트에 적합한지 여부를 판단할 수는 없습니다.

신뢰할 수 있는 패턴은 간단합니다. 원본 복사본을 보존하고, 알려진 범위를 대상으로 지정하고, 정의된 변환을 한 번 수행한 다음, 데이터를 공유하거나 다른 곳으로 가져오기 전에 결과를 비교하는 것입니다.