Instal·lació — Plantilla Google Sheets¶

Guia per a coordinadors/es i administradors/es de centre. No cal cap coneixement tècnic.

Temps estimat: ~15 minuts

Requisits previs¶

Compte Google del centre (domini propi, p. ex. xtec.cat)
Permisos per crear fitxers a Google Drive
Accés al link de la plantilla (facilitat pel responsable tècnic del projecte)

Pas 1 — Fer una còpia de la plantilla¶

Obre el link de la plantilla proporcionat
Al menú superior: Fitxer → Fes una còpia
Posa un nom al document (p. ex. Reserves ATECA - Curs 2024-25)
Tria la carpeta de Drive on vols desar-la
Fes clic a Fes una còpia

Captura pendent

Diàleg "Fes una còpia" de Google Sheets amb el camp de nom i la carpeta de destinació.

El document resultant és el teu i conté tot el codi necessari. La plantilla original no es modifica.

Pas 2 — Desplegar com a aplicació web¶

Aquest és l'únic pas que requereix entrar a l'editor de codi de Google.

Al teu document copiat: Extensions → Apps Script

Captura pendent

Menú Extensions del Google Sheets amb l'opció Apps Script ressaltada.

A l'editor d'Apps Script: fes clic a Desplegar (cantonada superior dreta) → Nova implementació

Captura pendent

Botó "Desplegar → Nova implementació" a l'editor d'Apps Script.

A la finestra que apareix:
- Tipus: Web App (si no és el valor per defecte, fes clic a la roda dentada i selecciona-la)
- Descripció: v1.0 (o qualsevol nom que recordis)
- Executar com: Jo (el-teu-email@domini.cat)
- Qui pot accedir: Qualsevol persona
Fes clic a Desplegar
Google demanarà que autoritzis els permisos de l'aplicació. Segueix els passos fins que tornis a la finestra de confirmació.
Copia la URL de l'aplicació web que apareix. La necessitaràs al pas següent i per compartir amb el professorat.

Captura pendent

Finestra de confirmació amb la URL de la webapp i el botó "Copiar".

Guarda la URL

Aquesta URL és l'adreça de la teva aplicació. Desa-la en un lloc accessible (un document, una nota) i comparteix-la amb els/les professors/es del centre.

Pas 3 — Inicialitzar el sistema¶

Obre la URL de l'aplicació al navegador
Apareixerà la pantalla d'inicialització:

Captura pendent

Pantalla "Configuració Inicial" amb el botó "Inicializar Sistema".

Fes clic a Inicializar Sistema
Espera uns segons mentre el sistema:
- Crea tots els fulls de dades (Recursos, Reserves, Usuaris...)
- Insereix dades d'exemple
- Et configura com a administrador/a
Quan aparegui el missatge de confirmació, fes clic a OBRIR APLICACIÓ

Captura pendent

Pantalla de confirmació "¡Sistema Configurado!" amb el botó verd "OBRIR APLICACIÓ".

Pas 4 — Configuració inicial¶

Un cop a l'aplicació, accedeix al panell d'administració (botó Admin a la capçalera) i configura:

Identitat del centre¶

Pestanya Config → modifica les claus bàsiques:

Clau	Valor d'exemple	Descripció
`nombre_centro`	`Institut Eugeni d'Ors`	Nom que apareix a la capçalera
`idioma_ui`	`ca` o `es`	Llengua de la interfície

Adaptar les dades d'exemple¶

El sistema inclou dades de mostra de l'Aula ATECA (Institut Eugeni d'Ors). Substitueix-les per les del teu centre:

Pestanya	Acció
Recursos	Elimina els espais d'exemple i afegeix els teus (aules, laboratoris, equipament)
Tramos	Adapta els horaris al calendari del teu centre
Dispositius	Actualitza l'inventari de dispositius si escau
Cursos	Substitueix els grups d'exemple pels del teu centre

Afegir professors/es¶

A la pestanya Usuaris, afegeix els comptes Google del professorat que tindrà accés a l'aplicació.

Pas 5 — Compartir l'aplicació¶

Comparteix la URL de l'aplicació (del Pas 2) amb el professorat. Pots fer-ho per:

Correu electrònic
Moodle / plataforma del centre
Intranet o pàgina web del departament
Fixant-la com a marcador al navegador dels ordinadors del centre

Actualitzar el sistema¶

Llegeix abans d'actualitzar

L'actualització no és automàtica. Segueix aquest procediment per evitar la pèrdua de dades.

Quan surti una nova versió de Reserves ATECA, el procediment recomanat és:

Opció A — Actualització de codi (sense canvis d'estructura)¶

Si la nova versió no afegeix nous fulls ni columnes (la majoria d'actualitzacions):

Obre la nova plantilla (link proporcionat amb cada versió)
A la nova plantilla: Extensions → Apps Script
Copia el contingut de cada fitxer .gs i .html
Enganxa'l al teu document original (Extensions → Apps Script)
Desplega una nova versió: Desplegar → Gestionar implementacions → Editar → Nova versió

Els teus fulls de dades (Reserves, Usuaris, etc.) no es modifiquen.

Opció B — Actualització amb canvis d'estructura¶

Si la nova versió afegeix nous fulls o columnes (indicat explícitament en les notes de la versió):

Fes una còpia de seguretat: al teu document, exporta els fulls importants com a CSV (Fitxer → Descarregar → CSV)
Segueix la guia d'instal·lació completa amb la nova plantilla (com si fos una instal·lació nova)
Reimporta les dades des dels CSV: selecciona el full → Fitxer → Importar → Pujar
Torna a executar repararInstalacionYGuardarURL() des de l'editor d'Apps Script si cal

Fulls prioritaris per fer còpia de seguretat

Reservas, Usuarios, Cursos, Config (valors personalitzats). Recursos, Tramos i Dispositivos solen requerir ajustos manuals menors.

Solució de problemes habituals¶

Problema	Causa probable	Solució
La URL no obre cap pàgina	Webapp no desplegada	Repeteix el Pas 2
Error "No se pudo detectar la URL" durant la inicialització	La webapp no estava desplegada quan s'ha fet clic a "Inicializar"	Desplega primer (Pas 2) i torna a obrir la URL
"Usuario no autoritzat" en entrar	El teu email no és a la llista d'Usuaris	Obre el Google Sheets → full `Usuarios` → afegeix el teu email
Les hores dels trams apareixen com a decimals	Format de cel·la automàtic	Al full `Tramos`, selecciona les columnes hora i aplica format de text
Has copiat el fitxer i el wizard torna a aparèixer	`SETUP_COMPLETED` no existeix a la còpia nova	A l'editor Apps Script: Executar → `repararInstalacionYGuardarURL`

Veure també: Instal·lació amb clasp (tècnics) · Configuració del sistema