Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/willdev12/sheetmerge
SheetMerge allows you to program multiple Google Sheets at once minus the hassle of defining hundreds of things.
https://github.com/willdev12/sheetmerge
google google-library google-script google-script-library google-scripts google-sheet google-sheets google-sheets-api google-sheets-api-v4 google-sheets-custom-function google-sheets-gs google-sheets-library libraries libraries-data library
Last synced: about 2 months ago
JSON representation
SheetMerge allows you to program multiple Google Sheets at once minus the hassle of defining hundreds of things.
- Host: GitHub
- URL: https://github.com/willdev12/sheetmerge
- Owner: WillDev12
- License: mit
- Created: 2023-02-03T21:10:46.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-27T17:22:27.000Z (about 1 year ago)
- Last Synced: 2023-11-27T18:27:56.139Z (about 1 year ago)
- Topics: google, google-library, google-script, google-script-library, google-scripts, google-sheet, google-sheets, google-sheets-api, google-sheets-api-v4, google-sheets-custom-function, google-sheets-gs, google-sheets-library, libraries, libraries-data, library
- Language: JavaScript
- Homepage:
- Size: 63.5 KB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SheetMerge
SheetMerge allows you to program multiple Google Sheets at once minus the hassle of defining hundreds of things.
# How to install
Here is a brief tutorial on how to install. If you are interested in how to use, see [here](https://github.com/WillDev12/SheetMerge#how-to-use)
1. Go to Google Sheets
2. Open new Google Script through Extensions
3. Once in the script, click the plus button above "Libraries"
4. Paste the following ID and press look up:
```
1MYnIAX-fSzeMQXHUGTrphcyFiwcSCC-fybI4CjqWj7Yv_E_5EymHxiAa
```
5. Select a version and apply
# How to use
SheetMerge provides custom commands that let you define what you want to do to another Google Sheet. In other words, you can edit two at once.
First, you will need a link. In my case, I will use %link% as a replacement for an actual one.
Here is an example of how to pair a new sheet:
``` javascript
var link = "%link%";
function yourFunction() {
var active = SheetMerge.getActiveSheet(link);
Logger.log(active);
}
```
If the logger logs the active sheet used in the link, than the program is fully installed.
There are many more things you can do besides this, and [here](https://github.com/WillDev12/SheetMerge#there-is-much-more-than-just-that-so-here-is-a-full-list-of-pre-built-functions-provided) is a full list of all of them
- - -
Here is a script on how to get the properties of a cell:
``` javascript
var link = "%link%";
function getValues() {
let text = SheetMerge.getValue("A1", link),
font = SheetMerge.getFontFamily("A1", link),
size = SheetMerge.getFontSize("A1", link);
Logger.log(text + ", " + font + ", " + size);
}
```
If you do not already have a sheet to edit, you can easily make one like this:
``` javascript
function createNew() {
var sheet = SheetMerge.createNew('name'); //upon running, this returns the url of the new sheet for you to edit.
}
```
You can even use the SheetMerge library to edit the sheet remotely!
``` javascript
function changeText() {
SheetMerge.setCell("A1", "Test text", link);
Logger.log(SheetMerge.getValue("A1", link));
}
```
- - -
Editing Sheets are easy when it comes to SheetMerge
``` javascript
var link = "%link%";
function editSheets() {
var name = SheetMerge.getSheetName(link);
var id = SheetMerge.getSheetId(link);
//Gets the name and id of the open sheet remotely
SheetMerge.renameActiveSheet("newName", link);
//Renames the sheet of your choice
SheetMerge.insertSheet("sheetName", link);
SheetMerge.copySheet("newName", link);
SheetMerge.duplicateActiveSheet(link);
//Insert and copy sheets
SheetMerge.deleteActiveSheet(link);
SheetMerge.deleteSheet("sheetName", link);
//Delete unnecessary ones
}
```
- - -
Lots of font work is involved, so be warned!
``` javascript
var link = "%link%";
function getFonts() {
let color = SheetMerge.getFontColor("A1", link),
size = SheetMerge.getFontSize("A1", link),
style = SheetMerge.getFontStyle("A1", link),
weight = SheetMerge.getFontWeight("A1", link),
family = SheetMerge.getFontFamily("A1", link);
//Get font properties
SheetMerge.setFontColor("A1", "#fff", link);
SheetMerge.setCellFontSize("A1", "10", link);
SheetMerge.setFontStyle("A1", "italic", link);
SheetMerge.setFontWeight("A1", "bold", link);
SheetMerge.setFontFamily("A1", "times new roman", link);
//Change font properties
}
```
- - -
# There is much more than just that, so here is a full list of pre-built functions provided:
| Property | Type | Description |
| :--- | :----: | :----: |
| getActiveSheet(link) | Sheets | Gets the current sheet of a Spreadsheet |
| getSpreadsheetName(link) | Sheets | Gets the name of a spreadsheet from a link |
| getSpreadsheetID(link) | Sheets | Gets the ID of a sheet from it's link |
| copySpreadsheet(newName) | Sheets | This function copies the active spreadsheet and allows users to provide a custom name for the copied spreadsheet. |
| copySpreadsheet() | Sheets | This function copies the active spreadsheet and automatically names the copy as "Copy of [original spreadsheet name]" |
| copySheet(sourceSheet, newSheetName) | Sheets | This function copies a specific sheet within the active spreadsheet and assigns a new name to the copied sheet. |
| getSheetUrl() | Sheets | This function retrieves the URL of the active spreadsheet |
| getSheetName(link) | Sheets | Gets the name of the active sheet |
| getURL(id) | Sheets | Gets the url of a Spreadsheet from the ID |
| copySheet(newname, link) | Sheets | Copies a Spreadsheet |
| deleteActiveSheet(link) | Sheets | Deletes the active sheet |
| deleteSheet(sheetName, link) | Sheets | Deletes a sheet by its name |
| duplicateActiveSheet(link) | Sheets | Duplicates the active sheet |
| renameActiveSheet(newName, link) | Sheets | Renames the active sheet |
| insertSheet(name, link) | Sheets | Inserts a new sheet |
| getviewers(link) | People | Gets a list of all the active viewers and their emails |
| getOwner(link) | People | Gets the owner of the document |
| getA1(range, link) | Cells | Gets the A1 notation of a range |
| getCellBorder(range, link) | Cells | Gets the border style of a range |
| getFontColor(range, link) | Cells | Gets the font color of a range |
| getFontSize(range, link) | Cells | Gets the font size of a range |
| getCellRow(range, link) | Cells | Gets the row position of a range |
| getCellColumn(range, link) | Cells | Gets the column position of a range |
| getValue(range, link) | Cells | Gets the text of a cell or range |
| getLastColumn(range, link) | Surroundings | Gets the last column used in the spreadsheet |
| getLastRow(range, link) | Surroundings | Gets the last row used in the spreadsheet |
| getFontStyle(range, link) | Fonts | Gets the font style of a range |
| getFontFamily(range, link) | Fonts | Gets the font of a range |
| getFontWeight(range, link) | Fonts | Gets the font weight of a range |
| setCell(cell, text, link) | Setting | Sets a cell's text |
| setCellBorder(range, top, left, bottom, right, link) | Setting | Sets the border weight of a range |
| setCellFontSize(cell, size, link) | Setting | Sets the font size of a cell/range |
| setFontColor(range, color, link) | Setting | Sets the font color of a cell/range |
| setFontStyle(range, style, link) | Setting | Sets the font style of a cell/range |
| setFontFamily(range, font, link) | Setting | Sets the font of a cell/range |
| setFontWeight(range, weight, link) | Setting | Sets the font weight of a cell/range |
| setRowHeight(row, height, link) | Setting | Sets the height of a specified row |
| setColumnWidth(column, width, link) | Setting | Sets the width of a specified column |
| setFormula(range, formula, link) | Formulas | Sets the fomula of a cell |
| getFormula(range, link) | Formulas | Retrieves the formula of a cell |
| clearRange(range, link) | Deletion | Clears the text of a range |
| deleteRow(rowNum, link) | Deletion | Deletes a row |
| deleteRows(row, howMany, link) | Deletion | Deletes multiple rows |
| deleteColumn(columnNum, link) | Deletion | Deletes a column |
| deleteColumns(column, howMany, link) | Deletion | Deletes multiple columns |
| setTabColor(color, link) | Misc | Honestly I don't even know what this one does either :'> |
# Source
You can view my source[^1] [here](https://github.com/WillDev12/SheetMerge/blob/main/library/lib.gs)
# Interested in this kind of content?
Check out my [profile](https://github.com/WillDev12) or share it! (This means a lot to me)
Also a huge thanks to my contributers!
```
https://github.com/WillDev12
https://github.com/cloud-dark
```
[^1]: Copyright © WillDev12 2023