Apprendre google-apps-script

Apps Script : Insérez la date courante dans un Google Docs

Dans ce tutoriel nous allons créer notre premier Google Script

Vous avez sans doute eu déjà besoin d’insérer dans un document Docs,
la date du jour automatiquement.
C’est que ce que vous allez apprendre à créer, avec ce petit Script Google.

tutoriel Google Apps ScriptsLes scripts  peuvent interagir avec Google Docs de deux manières différentes:
1- tout script peut créer ou modifier un document si son utilisateur dispose des autorisations appropriées pour le document. 

2- tout script peut également être lié à un document, ce qui lui confère des possibilités spéciales de modification.

Commençons, vous êtes prêts ?

1/ Commencez par créer le Docs où vous voudriez insérer la date du jour.

tutoriel Google Apps Scripts

2/ Sélectionnez dans le menu Outils  > Éditeurs de Scripts et ouvrez le .

tutoriel Google Apps Scripts

3/ Créez votre Nouveau Google Scripts, et donnez un titre à votre projet.

Avant de créer tout projet de développement et commencer à écrire du code, il est
important de décomposer les étapes que nous devons réaliser pour arriver à notre but.

 

// 1 - Ajoute un sous menu dans la barre de tâche nommée Aujourd'hui
// 2 - Insérer de la date du jour à l'emplacement du curseur.
// 3 - Vérifier si le curseur est actif et qu'il ne contient aucun élément.
// 4 - Récupération de la date du jour
// 5 - Insertion de la date au format Européen à l'emplacement du curseur
// 6 - Envoyer un message d'erreur si négatif

 

Effacez le Script, présent à l’ouverture et commençons à répondre à la première étape de notre Script.
* Attention à la casse, chaque caractère est important en Google Script.
– Ecrivons notre code pour ajouter le sous menu à notre document Docs, avec la  fonction suivante .

// Ajouter à l’ouverture un sous menu dans la barre de tâche nommée Aujourd'hui

function onOpen() {
DocumentApp.getUi().createMenu('Date') /* créer l’onglet Date */
.addItem('Aujourd\'hui', 'insertAtCursor') /* Ajoute le bouton Aujourd’hui */
.addToUi();
}

tutoriel Google Apps Scripts

Puis ajoutons les lignes suivantes, à la suite de notre code ci dessus, afin de récupérer notre date et l’insérer dans notre document.
Remarquez les lignes de commentaires, repéré par // qui ne sont pas des instructions, mais qui servent à identifier et commenter les différentes instructions de mon code, si je le partage ou que je doivent y revenir plus tard.

/**
* Insertion de la date du jour à l'emplacement du curseur.
*/
function insertAtCursor() {
  var cursor = DocumentApp.getActiveDocument().getCursor();
// Vérifie si le curseur est actif et qu'il ne contient aucun élément.  
  if (cursor) {
  // Récupération de la date du jour 
  var date = Utilities.formatDate(new Date(), "GMT", "dd-MM-yyyy");// Insertion de la date au format Européen à l'emplacement du curseur
  var element = cursor.insertText(date);// Envoyer un message d'erreur si négatif
  if (element) {
  element.setBold(true);
  } else {
  DocumentApp.getUi().alert('Je ne peux pas insérer la date ici ! .');
  }
  } else {
  DocumentApp.getUi().alert('Je ne peux pas insérer la date ici pas de curseur actif !.');
  }
}

Nous avons terminé, ne reste plus qu’à tester votre script.
4/ Sélectionner le fonction “onOpen” et cliquez sur “Play” afin de l’initialiser.

Revenons sur notre document Docs, un menu Date est maintenant disponible,
et la date du jour s’ajoute à l’emplacement du curseur  en cliquant simplement sur
le bouton Aujourd’hui.

* Je vous renvoie vers la documentation Developers Google pour plus d’infos.
https://developers.google.com/apps-script/guides/docs

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.