From d1f803c152a3bf622a18bfcc34a2981ae7d4dc3b Mon Sep 17 00:00:00 2001 From: kennethrioja <59597207+kennethrioja@users.noreply.github.com> Date: Mon, 20 Oct 2025 16:21:34 +0200 Subject: [PATCH 1/2] docs(sources): added google sheet ingestion --- TeSS_docs/content/sources.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/TeSS_docs/content/sources.md b/TeSS_docs/content/sources.md index 5a174e7..b06ae3a 100644 --- a/TeSS_docs/content/sources.md +++ b/TeSS_docs/content/sources.md @@ -10,4 +10,19 @@ Currently available user-managed ingestion methods: - Bioschemas -For other methods, please [contact us](https://tess.elixir-europe.org/about/us#contact) to discuss how to register your content automatically in TeSS. +Currently available admin-managed ingestion methods: + +- [Google Sheet](#google-sheet) + +For other methods, please [contact us](https://tess.elixir-europe.org/about/us#contact) to discuss how to register your content automatically in TeSS. + +## Google Sheet + +On the user side: + +1. Create a new Google Sheet. +2. Open this link : https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/. +3. Select everything from the `Example` sheet (Ctrl/Cmd + A), copy and paste it in your empty new sheet. +4. Amend the cells to properly define your training material. ⚠️ **Be careful**, some restrictions apply to specific columns, e.g., the cells under the `Keywords` column must be a coma separated list. See the list of restrictions in the [`DataDictionary` sheet](https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/edit?gid=2096797962#gid=2096797962). +5. One row corresponds to one training material, you can add as many rows/materials as you want. +6. Once your Google Sheet ready, give the URL to your TeSS administrator and ask them to use it for the Materials' Ingestion Method: CSV File and Google Spreadsheet. From 22e44baf32848c68fb0fe427156da01fcdb3a3ca Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Tue, 21 Oct 2025 10:35:30 +0100 Subject: [PATCH 2/2] Refined instructions for Google Sheets ingestion --- TeSS_docs/content/sources.md | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/TeSS_docs/content/sources.md b/TeSS_docs/content/sources.md index b06ae3a..5515d0d 100644 --- a/TeSS_docs/content/sources.md +++ b/TeSS_docs/content/sources.md @@ -18,11 +18,22 @@ For other methods, please [contact us](https://tess.elixir-europe.org/about/us#c ## Google Sheet -On the user side: +Our preferred options are for you to provide [structured data markup](structured-data-types) directly in the webpages that describe your training materials, or provide a single page with the markup for all the materials. This may not be possible, for example, if you have technical restrictions with your content management system. + +We offer an alternative option for a user to provide a collection of training materials in a spreadsheet format, following our template. (This method currently does not support ingesting events.) + +To prepare and register a spreadsheet of materials to ingest: 1. Create a new Google Sheet. -2. Open this link : https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/. -3. Select everything from the `Example` sheet (Ctrl/Cmd + A), copy and paste it in your empty new sheet. -4. Amend the cells to properly define your training material. ⚠️ **Be careful**, some restrictions apply to specific columns, e.g., the cells under the `Keywords` column must be a coma separated list. See the list of restrictions in the [`DataDictionary` sheet](https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/edit?gid=2096797962#gid=2096797962). +2. Open the template Google Sheet: https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/. +3. Select everything from the `Example` sheet {kbd}`CTRL/CMD+A`, copy and paste it in your empty new sheet. +4. Enter the details of your training materials under the headings provided. + ````{margin} + ```{warning} + Some restrictions apply to specific columns, for example, the cells under the `Keywords` column must be a comma-separated list. See the list of restrictions in the [`DataDictionary` sheet](https://docs.google.com/spreadsheets/d/1yx2AZTPaPEU_Au2Hyb_C3TuNvH4btR9pZwCmfmTQRdc/edit?gid=2096797962#gid=2096797962). + ``` + ```` 5. One row corresponds to one training material, you can add as many rows/materials as you want. -6. Once your Google Sheet ready, give the URL to your TeSS administrator and ask them to use it for the Materials' Ingestion Method: CSV File and Google Spreadsheet. +6. Once your Google Sheet is ready, give the URL to your TeSS administrator and ask them to use it for the Materials Ingestion Method: CSV File and Google Spreadsheet. + +TeSS will scan your spreadsheet once per day to ingest any new and changed training materials. \ No newline at end of file