Apps Script로 Google Sheets의 활성(선택)영역 지정

💡 Apps Script로 Google Sheets에 활성(선택)영역을 지정한다.
     웹 프로그램에서 setFocus()와 비슷한 효과를 줄 수 있다.
     간단한 사용법과 응용 예제를 알아본다.

 

SpreadsheetApp 에서 제공하는

setActiveRange() 를 이용해 아래와 같이 Google Sheets의 활성(선택)영역을 지정해 줄 수 있다.

 

아래와 같이 setActiveRange() 안에 range 를 넣어줘야 한다.

// 방식 #1
const range = sheet.getRange("A1");
sheet.setActiveRange(range);

// 방식 #2
sheet.setActiveRange(sheet.getRange("A1"));

단일 영역 지정

function setCellPositon() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("시트22");

  const range = sheet.getRange("A1");
  
  sheet.setActiveRange(range);
}

 

다중 영역 지정

function setCellPositon() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("시트22");

  const range = sheet.getRange("A1:F"+sheet.getLastRow());
  
  sheet.setActiveRange(range);
}

 

 

 

 

응용해보기

Apps Script로 Google Sheets의 저장 영역 필수 값 체크하기

Apps Script로 Google Sheets의 저장 영역 필수 값 체크하기

필수 값을 체크하고, 필수 입력에서 걸린 셀로 포인트를 이동해본다.

 

성별(C5)는 필수입력 값입니다.

 

라는 메시지에서 셀 값인 ‘C5’만 추출한다.

정규식을 이용해 괄호 안에 값을 추출한다.

const regExp = /\\(([^)]+)\\)/;
const matches = regExp.exec(validationCheck);
console.log(matches[1]);
console.log(validationCheck + "는 필수입력 값입니다.")

 

 

이제 필수 값을 체크하는 부분에 아래 로직을 추가한다.

const regExp = /\\(([^)]+)\\)/;
const matches = regExp.exec(validationCheck);

const range = sheet.getRange(matches[1]);
sheet.setActiveRange(range);

function insertSheetData() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName("Sheet3");
  const table_id  = "insert_test";

  const reqIdx =  [
                      {name:'이름(A' , index:1}
                    , {name:'나이(B' , index:2}
                    , {name:'성별(C' , index:3}
                  ];

  const validationCheck = dataNullCheck(sheet, 2, reqIdx);
  if ( validationCheck != "done" ) {
    const regExp = /\\(([^)]+)\\)/;
    const matches = regExp.exec(validationCheck);

    const range = sheet.getRange(matches[1]);
    sheet.setActiveRange(range);

    console.log(validationCheck + "는 필수입력 값입니다.")
    return;
  }

  const colInfo = {startRow:2, startColumn:1};

  const saveTime = getDateTime("BQ");
  const addValues = {
                      status      : "Y"
                      , saveTime  : saveTime
                  };

  const resultFlag = loadSpreadsheet(sheet, global_datasetId, table_id, colInfo, addValues);

  console.log(`Result Flag : ${resultFlag}`);
}

/**
 * 데이터 null 체크. like validation check
 * @param {object} spreadSheet  = 해당 function을 호출한 spreadsheet
 * @param {string} startRow     = 시작 행번호
 * @param {object} keyIdx       = 키값 정보
 */
function dataNullCheck (spreadSheet, startRow, keyIdx) {
  for ( q in keyIdx ) {
    var endRow = spreadSheet.getLastRow()-startRow+1;
    var data = spreadSheet.getSheetValues(startRow, keyIdx[q].index, endRow, 1);

    for ( i in data ) {
      var value = data[i];
      if ( isNull(value) ) {
        return keyIdx[q].name + (parseInt(i)+parseInt(startRow)) + ")";
      }
    }
  }

  return "done";
}