GoogleSheet

Google Sheet 서비스는 사용자가 테넌트 설정에서 지정한 Google Sheet 인증 정보를 기반으로 작동합니다. 이 서비스를 사용하면 복잡한 백엔드 구성 없이도 Google Sheet에 저장된 데이터를 손쉽게 조회, 추가, 수정, 삭제할 수 있습니다. 이 서비스는 단순한 데이터 조작 작업에 적합하며, 더 복잡한 데이터 조작이 필요한 경우 Firestore 서비스를 사용하는 것을 권장합니다.

GoogleSheet의 특성

구글 시트는 빈 행이나 빈 열이 존재하는 경우 각각을 다른 테이블로 취급합니다. 그러므로 Google Sheet 서비스는 첫 번째 행에 나타나는 헤더 영역을 기준으로, 빈 행이 나오기 전까지의 영역을 테이블로 정의합니다.

위와 같이 있는경우 3개의 테이블영역으로 인식되고 Google Sheet 서비스는 첫 행에 처음나오는 헤더영역인 1번 테이블을 기준으로 동작합니다.

GoogleSheet 서비스의 제약 및 주의사항

1. 기준 컬럼명을 정의하여 지정해주어야 합니다.

   • 별도의 관리값이 없는 경우, _SUID 컬럼을 생성하고 기준 키로 _SUID를 등록하면 자동으로 생성됩니다.

2. 구글 시트의 delete는 기준 컬럼을 제외한 나머지 값만 삭제하는 기능입니다.

   • 완전한 행 삭제는 구글 시트 상에서 Delete Row를 통해서만 가능합니다.

   • Delete Row를 사용할 때 Google Sheet 서비스는 무결성을 보장해 주지 않습니다.

공통 구성 요소 설명

시스템명

서비스에서 사용 가능한 시스템 목록입니다.

모듈명

사용자가 선택한 시스템에 등록된 모듈들을 표시합니다. GoogleSheet에서는 시트에 대한 작업을 위한 다양한 모듈이 제공됩니다. Query,Append , Update, Clear 모듈이 있으며, 이를 통해 사용자는 GoogleSheet에서 원하는 작업을 수행할 수 있습니다.

spreadsheet 아이디

구글 스프레드 시트의 ID입니다. GoogleSheet의 URL에서 얻을 수 있습니다.

https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit#gid=0

Sheet 명

구글 시트의 명칭입니다. 하단 영역에서 얻을 수 있습니다.

기준 컬럼명

시트 사용 시 기준이 되는 항목으로 사용합니다. 해당 컬럼 값과 행 번호를 Key값으로 사용합니다. 업데이트 및 삭제 작업 시에도 값이 변하지 않습니다.

추가설명

모듈별 이벤트 데이터

모듈명	보내는 데이터	받는 데이터
Query	보내는 데이터를 사용하지 않습니다.	조회된 데이터에 _rowIndex를 포함하여 반환합니다.
Append	ParamBlock1의 섹터 중 기준 컬럼 항목이 있는 섹터를 추가합니다.	저장한 데이터의 _SUID와 _rowIndex를 반환합니다.
Update	ParamBlock1의 섹터의 _rowIndex와 기준 컬럼 항목이 일치하는 섹터를 업데이트합니다.	수정한 데이터의 _SUID와 _rowIndex를 반환합니다.
Clear	ParamBlock1의 섹터의 _rowIndex와 기준 컬럼 항목이 일치하는 섹터를 기준 컬럼 항목 외의 값을 삭제합니다.	삭제한 데이터의 _SUID와 _rowIndex, 삭제된 결과를 반환합니다.