Spreadsheets

Add Spreadsheet

To add an existing spreadsheet that contains placeholders for live data, click the “Add” button with the Google Sheet Connector’s “Spreadsheets” node selected in the main application’s nagivation pane.

../_images/googlesheets-add-spreadsheet.png

This will open a dialog to enter spreadheet details.

../_images/googlesheets-add-spreadsheet-dlg.png

( 1 ) Enter your spreadsheet ID or simply copy the URL of your spreadsheet (for example “https://docs.google.com/spreadheets/d/2UV7qd0Z_dgwqTc8QQ7fgyuWtyghIPa5TbZGee-8A-qD…”) into the spreadsheet ID entry field. Make sure the the service account configured for the Google Sheets Connector has access to the spreadsheet.

( 2 ) Leave the sheet names entry field blank to parse all sheets within the spreadsheet for placeholders, or enter the names of the sheets that should be parsed.

( 3 ) Acknowledge that data may be overwritten, then press “Add”.

Once the spreadheet is succesfully added, generated tags and cell locations (target cells for live values) are shown.

../_images/googlesheets-spreadsheet-added.png

Warning

Once you start a task that sends data to the Google spreadsheet, targetted cells within the spreadheet are overwritten. If you are using “in-place” placeholder cells then the placeholders themselves will be overwritten. It is therefore advisable to keep a backup copy of your spreadsheet.

Spreadsheet Settings

For each spreadsheet you can configure:

  • Name
    The spreadheet name. It is advisable to keep this in sync with the Google spreadheet name to avoid confusion.

Reassign Spreadsheet

If you have modified your Google spreadsheet by, for example, adding or removing placeholders, then the placeholder references in the previously added spreadheet will no longer be in sync. Use “Reassign” to fetch the Google sheet again and synchronize placeholder references with the updated spreadheet.

To “Reassign”, right-click on the spreadheet in the nagivation panel and select “Reassign” from the menu.

../_images/googlesheets-reassign-spreadsheet.png

Check that the entries in the “Reassign” dialog are correct, acknowledge, and click “Reassign”:

../_images/googlesheets-reassign-spreadsheet-dlg.png

Removed placeholders may result in tags and tag connections being removed from tasks. For placeholders that have remained, tags and tag connections in tasks remain also. If new placeholders were added to the spreadsheet then tags are added but these will not yet be connected in tasks that transfer data to the spreadsheet.

Remove Spreadsheets

Remove spreadsheets by selecting “Spreadsheets” in the navigation panel, then select one or more spreadsheets to remove in the content panel, and finally click on the “Remove” toolbar button to remove selected spreadsheets.

../_images/googlesheets-remove-spreadsheet.png

Warning

Note that spreadheets are also removed from any task using the spreadheets.