Ressources Google Apps Script

Dans le tutoriel précédent nous avons vu comment ajouter des fonctions JavaScript à un document de la suite de Google. Pour poursuivre notre apprentissage nous verrons comment ajouter des variables liées à l'utilisateurs connectés puis nous verrons la liste des éléments dynamiques mis à notre disposition

Écrire notre seconde fonction

Reprenons notre document et ouvrons l’éditeur de code afin de développer une seconde fonction qui fera usage de variables concernant l’utilisateur.
Nous allons simplement signer automatiquement notre lettre modèle avec l’adresse e-mail de la personne connectée.
Commençon par ajouter une nouvelle fonction insererEmail() à notre liste de fonctions à executer au lancement.
Comme suit :

  
onOpen(){
    //Actualiser la date
    actualiserDate();
    //Insérer l’email
    insererEmail();
    }
  

Deux informations à savoir : le curseur de l’utilisateur, la barre oblique clignotante, est appelée Position. Pour l'instant nous allons nous contenter d’insérer du texte à la toute fin du texte ou au tout début. On ne peut obtenir la position du curseur seulement avec du code intégré au document, dans le cas d'un code à part le document n'est pas vraiment ouvert et donc l'utilisateur n'a pas de pointeur à l'écran.

Après avoir obtenu le contenu du document et l’avoir converti en texte nous pouvons utiliser :
- text.insertText(0, 'Texte à insérer.\n') pour insérer du texte au début du document, position 0
- text.appendText('\n. Texte à insérer') afin d’ajouter un élement texte à la fin de document

Écrivons la fonction complète :

  
function insererEmail(){
  let body = DocumentApp.getActiveDocument().getBody();
  let text = body.editAsText();
  let emailAddress = Session.getActiveUser().getEmail();
  text.appendText('\n' + emailAddress);
}
    

Cliquer la disquette pour enregistrer au besoin puis retourner à l'onglet du document contenant le texte et actualisez la page. L’adresse électroique de l’utilisateur sera ajouté à la fin du document.