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.
Les 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.
2/ Sélectionnez dans le menu Outils > Éditeurs de Scripts et ouvrez le .
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();
}
|
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