https://github.com/colorfulcompany/gas-spreadsheet-onetime-reader
Google Apps Script で Spreadsheet のデータを読み取って、いい具合に検索と Object 化してくれるもの
https://github.com/colorfulcompany/gas-spreadsheet-onetime-reader
foundation google-apps-script gsuite spreadsheet
Last synced: 4 months ago
JSON representation
Google Apps Script で Spreadsheet のデータを読み取って、いい具合に検索と Object 化してくれるもの
- Host: GitHub
- URL: https://github.com/colorfulcompany/gas-spreadsheet-onetime-reader
- Owner: colorfulcompany
- License: bsd-2-clause
- Created: 2017-06-22T10:49:13.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-10-19T10:12:58.000Z (over 1 year ago)
- Last Synced: 2025-02-03T04:44:03.878Z (4 months ago)
- Topics: foundation, google-apps-script, gsuite, spreadsheet
- Language: JavaScript
- Homepage:
- Size: 464 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SpreadsheetOnetimeReader
Simple Google Spreadsheet Reader
## feature
* search()
* toObject()
SpreadsheetApp returns Array of Array structure "[ [], [] ]", but it's hard to handle them. SpreadsheetOnetimeReader provides convinent toObject() method.
# Usage
## Prepare
1. clone this repo
2. clasp init & clasp push
3. deploy this as Library and memo Library ID from Project settings
4. add Library with memoed ID from Script Editor
## create Reader from Apps Script Project
```javascript
const reader sheet = SpreadsheetOnetimeReader.createReader(
SpreadsheetApp,
[book],
[sheetName],
[opts = {
skipHeaders:
}])
reader.search('and', [ ['~', 'id', /^201706[0-9]+/], ['==', 'name', 'Aiu'] ])
reader.toObject()
```
result
```javascript
[
{
id: 2017062101,
point: 79,
name: "Aiu"
},
{
id: 2017062812,
point: 64,
name: "Aiu"
},
...
]
```
and narrowing with `pickFields` option
```javascript
reader.opts({pickFields: ['id', 'point']})
reader.toObject()
```
result
```javascript
[
{
id: 2017062101,
point: 79
},
{
id: 2017062812,
point: 64
},
...
]
```
## How to call as a function from within Spreadsheet
prepare function in Apps Script Editor
```javascript
/**
* @customfunction
*/
function readerSearch () {
const reader = SpreadsheetOnetimeReader.createReader(SpreadsheetApp)
return reader.search(
'and',
[
['~', 'id', /^201706[0-9]+/],
['==', 'name', 'Aiu']
])
}
```
call function in Spreadsheet
```
=readerSearch()
```