Apps Script로 Google Sheets의 Toast 메시지 띄우기

 

 

💡 Apps Script로 Google Sheets 우측 하단에 심플한 토스트 메세지를 띄워 줄 수 있다.
     간단한 예제와 응용 예제 대해서 알아본다.

 

 

 

 

Apps Script로 Google Sheets 에서 제공하는

Alert 뿐만 아니라 Toast 알림도 실행시켜 줄 수 있다.

 

 

메세지만 띄우기

function toastMessage() {
  SpreadsheetApp.getActiveSpreadsheet().toast('토스트 테스트');
}

 

 

 

제목과 메세지 띄우기

function toastMessage() {
  SpreadsheetApp.getActiveSpreadsheet().toast('토스트 테스트', '알림');
}

 

응용

DB에서 데이트를 가져와 뿌려줄 때 connection pool 방식으로 데이터를 가져오는 것이 아니라

가져올 때마다 db에 접근하기 때문에 웹 프로그램보다 딜레이가 발생한다.

그래서 조회 중과 조회가 종료되었을 때의 메세지를 토스트 메세지로 뿌려주면 좋을 것 같다.

/**
 * 조회시작 토스트
 * 마지막 파라미터가 음수일 경우 타이머설정 없음
 */
function executeStart() {
  SpreadsheetApp.getActiveSpreadsheet().toast('데이터를 조회중입니다.', '조회중', -1);
}

/**
 * 조회종료 토스트
 * 마지막 파라미터가 양수일 경우 타이머 설정 (초)
 */
function executeEnd() {
  SpreadsheetApp.getActiveSpreadsheet().toast('데이터 조회를 완료하였습니다.', '조회 완료', 2);
}

/**
 * 마스터 가져오기
 * @param {string} sheetUrl = 해당 function을 호출한 sheet의 URL
 */
function getMasterData(sheetUrl) {
    try {
        // 조회 시작 메세지
        executeStart();

        const sheetName   = masterSheetName;
        const datasetId   = GLOBAL_SAP_DATASET_ID;
        const tableId     = "TABLE_ID";
        const columnName  = "id, name, value, date";
        const whereState  = 'AND bukrs in ("1100", "1200") ';
        const orderbyName = "id";

        const queryString = 'SELECT ' + columnName + ' FROM `'
                            +  GLOBAL_PROJECT_ID + "." + datasetId + "." + tableId + '` ' 
                            + ' WHERE 1=1 ' + whereState
                            + ' GROUP BY ' + columnName + ' ORDER BY '  + orderbyName + ' ASC ; ';

        const dataRange = common.queryAndBinding(sheetUrl, sheetName, queryString, 2, 1, "N", null, "N");
        const sheet     = SpreadsheetApp.openByUrl(sheetUrl).getSheetByName(sheetName);

        if ( !common.isNull(dataRange) ) {
        	common.setTableBorderBySheet(sheet, dataRange, true);
        } else {
        	common.deleteAllRow(sheet, 2);
        }

        // 조회 종료 메세지
        executeEnd();

    } catch (error) {
        var msg01 = error.message;
        common.alertMessage("❌ Error", "Error Message : " + msg01);
        Logger.log(msg01);
    }
}

 

 

 

이렇게 되면 조회를 시작할 때

'조회중' 메세지가 뜨고, 데이터를 뿌려주고 border 처리를 할 때 까지 메세지가 꺼지지 않고 남아있다.

그리고 조회 후 border 처리가 마무리되면 기존의 '조회중' 메세지는 닫히고, '조회완료' 메세지를 띄워준다.