GoogleSheet
Last updated
Last updated
Google Sheet 서비스는 사용자가 테넌트 설정에서 지정한 Google Sheet 인증 정보를 기반으로 작동합니다. 이 서비스를 사용하면 복잡한 백엔드 구성 없이도 Google Sheet에 저장된 데이터를 손쉽게 조회, 추가, 수정, 삭제할 수 있습니다. 이 서비스는 단순한 데이터 조작 작업에 적합하며, 더 복잡한 데이터 조작이 필요한 경우 Firestore 서비스를 사용하는 것을 권장합니다.
구글 시트는 빈 행이나 빈 열이 존재하는 경우 각각을 다른 테이블로 취급합니다. 그러므로 Google Sheet 서비스는 첫 번째 행에 나타나는 헤더 영역을 기준으로, 빈 행이 나오기 전까지의 영역을 테이블로 정의합니다.
위와 같이 있는경우 3개의 테이블영역으로 인식되고 Google Sheet 서비스는 첫 행에 처음나오는 헤더영역인 1번 테이블을 기준으로 동작합니다.
기준 컬럼명을 정의하여 지정해주어야 합니다.
별도의 관리값이 없는 경우, _SUID 컬럼을 생성하고 기준 키로 _SUID를 등록하면 자동으로 생성됩니다.
구글 시트의 delete는 기준 컬럼을 제외한 나머지 값만 삭제하는 기능입니다.
완전한 행 삭제는 구글 시트 상에서 Delete Row를 통해서만 가능합니다.
Delete Row를 사용할 때 Google Sheet 서비스는 무결성을 보장해 주지 않습니다.
서비스에서 사용 가능한 시스템 목록입니다.
사용자가 선택한 시스템에 등록된 모듈들을 표시합니다. GoogleSheet에서는 시트에 대한 작업을 위한 다양한 모듈이 제공됩니다. Query,Append , Update, Clear 모듈이 있으며, 이를 통해 사용자는 GoogleSheet에서 원하는 작업을 수행할 수 있습니다.
구글 스프레드 시트의 ID입니다. GoogleSheet의 URL에서 얻을 수 있습니다.
https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit#gid=0
구글 시트의 명칭입니다. 하단 영역에서 얻을 수 있습니다.
시트 사용 시 기준이 되는 항목으로 사용합니다. 해당 컬럼 값과 행 번호를 Key값으로 사용합니다. 업데이트 및 삭제 작업 시에도 값이 변하지 않습니다.
| 모듈명 | 보내는 데이터 | 받는 데이터 |
|---|---|---|
Query
보내는 데이터를 사용하지 않습니다.
조회된 데이터에 _rowIndex를 포함하여 반환합니다.
Append
ParamBlock1의 섹터 중 기준 컬럼 항목이 있는 섹터를 추가합니다.
저장한 데이터의 _SUID와 _rowIndex를 반환합니다.
Update
ParamBlock1의 섹터의 _rowIndex와 기준 컬럼 항목이 일치하는 섹터를 업데이트합니다.
수정한 데이터의 _SUID와 _rowIndex를 반환합니다.
Clear
ParamBlock1의 섹터의 _rowIndex와 기준 컬럼 항목이 일치하는 섹터를 기준 컬럼 항목 외의 값을 삭제합니다.
삭제한 데이터의 _SUID와 _rowIndex, 삭제된 결과를 반환합니다.
