cv scripts

Author: Duarte0903

README.md

@@ -0,0 +1,7 @@
+![Logo_red](https://github.com/FSUMinho/website/blob/main/imgs/logo_red.png)
+
+<h1 align="center">Google AppScripts Automations</h1>
+
+## About
+
+This repository contains a collection of Google App Scripts designed to automate tasks within our organization that rely on Google services. While these scripts are tailored to specific purposes, they can be adapted for use in other contexts.

cv_collection/README.md

@@ -0,0 +1,26 @@
+# Recruitment CV collection
+
+## About
+
+This script automates the collection of CVs within our organization, streamlining the process of sharing them with sponsors. Individuals can send an email following a specific format, and the script will automatically create a dedicated folder in Google Drive to store the submitted CV. Additionally, the folder is shared with the sender, granting them the ability to update its contents at any time.
+
+## Overview of Functionality
+
+1. **Prevent Duplicate Processing**: 
+   - Creates or retrieves a Gmail label named `Processed`.
+   - Ensures emails are processed only once by skipping threads already labeled as `Processed`.
+
+2. **Organize Attachments**:
+   - Creates a parent folder in Google Drive named "CVs" (if it doesn't already exist).
+   - For emails with matching subjects (e.g., `CVPG1234`, `CVAG1234`), creates subfolders named after the subject.
+
+3. **Store Attachments**:
+   - Downloads email attachments into the corresponding subfolder in Google Drive.
+   - Sets the folder's sharing permissions to "Anyone with the link" and grants edit rights.
+
+4. **Reply to the Sender**:
+   - Replies to the sender with a shareable link to the created folder.
+   - Uses the email subject to personalize the response.
+
+5. **Error Handling**:
+   - Wraps the logic in a `try-catch` block to handle errors gracefully and log them.

cv_collection/script.gs

@@ -0,0 +1,67 @@
+function processEmails() {
+  try {
+    // Specify the label for processed emails to avoid duplicates
+    var processedLabel = GmailApp.getUserLabelByName("Processed") || GmailApp.createLabel("Processed");
+
+    // Specify the parent folder where CV folders will be created
+    var parentFolderName = "CVs";
+    var parentFolders = DriveApp.getFoldersByName(parentFolderName);
+    var parentFolder = parentFolders.hasNext() ? parentFolders.next() : DriveApp.createFolder(parentFolderName);
+
+    // Broaden the search for all unread emails
+    var threads = GmailApp.search('is:unread');
+    Logger.log("Found " + threads.length + " unread threads");
+
+    threads.forEach(function(thread) {
+      var messages = thread.getMessages();
+      
+      // Check if the thread is already processed
+      if (thread.getLabels().some(label => label.getName() === processedLabel.getName())) {
+        Logger.log("Skipping already processed thread: " + thread.getFirstMessageSubject());
+        return; // Skip already processed threads
+      }
+      
+      messages.forEach(function(message) {
+        // Log the subject of each unread email
+        Logger.log("Found unread email with subject: " + message.getSubject());
+        
+        var subject = message.getSubject();
+        var match = subject.match(/^CV(A|PG)\d+$/);
+
+        if (match) {
+          var folderName = match[0];
+          Logger.log("Matched folder name: " + folderName);
+          var folders = parentFolder.getFoldersByName(folderName);
+          var folder = folders.hasNext() ? folders.next() : parentFolder.createFolder(folderName);
+
+          // Save attachments
+          var attachments = message.getAttachments();
+          attachments.forEach(function(attachment) {
+            folder.createFile(attachment);
+          });
+
+          // Generate a shareable link to the folder with edit permission
+          folder.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.EDIT);
+          var folderUrl = folder.getUrl();
+
+          // Reply to the email with the link to the created folder
+          var recipient = message.getFrom();
+          var replySubject = "Access to Your CV Folder: " + folderName;
+          var replyBody = "Hello,\n\nYour CV has been received and processed.\nYou can access your folder using the following link: " + 
+                          folderUrl + 
+                          "\nYou have edit permissions to manage the contents of this folder." +
+                          "\nBest regards,\nFSUMinho";
+          GmailApp.sendEmail(recipient, replySubject, replyBody);
+
+          // Mark the thread as processed
+          thread.addLabel(processedLabel);
+          Logger.log("Marked thread as processed and replied to: " + recipient);
+        } else {
+          Logger.log("No match for subject: " + subject);
+        }
+      });
+    });
+  } catch (error) {
+    Logger.log("Error: " + error.toString());
+  }
+}

recruitment_cv_collection/README.md

@@ -0,0 +1,36 @@
+# Recruitment CV collection
+
+## About
+
+This script serves as a suplement to the FSUMinh CV collection. It focous on collection CV from recruitment forms and share them in our collection. It does the same thing as the `cv_collection` script. The only difference is the source of the CVs.
+
+### Overview of Functionality
+
+- Extracts form responses from specified Google Sheets.
+- Creates a folder for each CV submission in a shared Google Drive directory.
+- Shares the folder with the CV's owner, granting them edit permissions to update their submission.
+- Sends a confirmation email to the submitter with a link to their folder.
+
+## Configuration
+
+This script requires the google sheets file ID where the form responses are beeing stored in order to extract the data. Multiple sheets files can be used. 
+
+You can extract the ID from the google sheets link:
+
+```
+Full link
+https://docs.google.com/spreadsheets/d/187dNnLrPZxT5eDyxnOvGuyr67nAPZXIb4rgMZuX0Uhc/edit?gid=905334468#gid=905334468
+
+ID
+187dNnLrPZxT5eDyxnOvGuyr67nAPZXIb4rgMZuX0Uhc
+```
+
+The IDs should be added in the `sheetsIds` var:
+
+```
+var sheetIds = [
+      "12j9XBAo8AXo7ofrB5Cbeu1jQ2mP3SFtqQ-c6kU4d27s", // sheet 1
+      "1liZlUD7WW9F1l-6lBJQ5Bb4VZfWVNzZMZb7D0qpKqIQ", // sheet 2
+      "187dNnLrPZxT5eDyxnOvGuyr67nAPZXIb4rgMZuX0Uhc"  // sheet 3
+    ];
+```

recruitment_cv_collection/script.gs

@@ -0,0 +1,100 @@
+function processFormResponses() {
+  try {
+    // Specify the Google Sheets linked to the forms
+    var sheetIds = [
+      "12j9XBAo8AXo7ofrB5Cbeu1jQ2mP3SFtqQ-c6kU4d27s", // mnt 
+      "1liZlUD7WW9F1l-6lBJQ5Bb4VZfWVNzZMZb7D0qpKqIQ", // mecanica
+      "187dNnLrPZxT5eDyxnOvGuyr67nAPZXIb4rgMZuX0Uhc"  // eletronica
+    ];
+
+    // Specify the parent folder in the shared drive
+    var sharedDriveFolderName = "CVs";
+    var sharedDriveFolders = DriveApp.getFoldersByName(sharedDriveFolderName);
+    var parentFolder = sharedDriveFolders.hasNext() ? sharedDriveFolders.next() : DriveApp.createFolder(sharedDriveFolderName);
+
+    // Use ScriptProperties to track processed timestamps
+    var scriptProperties = PropertiesService.getScriptProperties();
+
+    // Loop through each sheet ID
+    for (var sheetIndex = 0; sheetIndex < sheetIds.length; sheetIndex++) {
+      var sheetId = sheetIds[sheetIndex];
+      var sheet = SpreadsheetApp.openById(sheetId).getSheets()[0]; // Assuming you want the first sheet
+      Logger.log("Processing sheet: " + sheet.getName());
+
+      // Get all responses from the sheet
+      var responses = sheet.getDataRange().getValues(); // Includes headers
+
+      if (responses) {
+        Logger.log("Responses found for sheet: " + sheet.getName());
+      } else {
+        Logger.log("Erro ao obter respostas para a folha: " + sheet.getName());
+        continue; // Skip to the next sheet if no responses are found
+      }
+
+      for (var i = 1; i < responses.length; i++) {
+        var row = responses[i];
+        var timestamp = row[0];
+        var studentName = row[1];
+        var fullName = row[2];
+        var email = row[3]; 
+        var uploadedFileUrl = row[7];
+
+        // Skip processed rows or rows without file upload
+        if (scriptProperties.getProperty(timestamp) || !uploadedFileUrl) {
+          continue;
+        }
+
+        try {
+          // Create a folder named after the full name or other identifier
+          var folderName = "CV" + fullName;
+          var folders = parentFolder.getFoldersByName(folderName);
+          var folder = folders.hasNext() ? folders.next() : parentFolder.createFolder(folderName);
+
+          // Retrieve the uploaded file by its URL
+          var uploadedFileId = getFileIdFromUrl(uploadedFileUrl); // Adiciona esta linha para extrair o ID do ficheiro
+          if (uploadedFileId) {
+              try {
+                  var uploadedFile = DriveApp.getFileById(uploadedFileId);
+                  folder.addFile(uploadedFile);
+                  Logger.log("File successfully added to folder: " + folderName);
+              } catch (fileAccessError) {
+                  Logger.log("Error accessing or adding file with ID " + uploadedFileId + ": " + fileAccessError.toString());
+              }
+          } else {
+              Logger.log("No valid file ID found in URL: " + uploadedFileUrl);
+          }
+
+          // Set sharing permissions
+          folder.setSharing(DriveApp.Access.ANYONE_WITH_LINK, DriveApp.Permission.EDIT);
+          var folderUrl = folder.getUrl();
+
+          // Send a confirmation email
+          GmailApp.sendEmail(email, "Partilha de CV", 
+            "Caro " + studentName + ",\n\n" + 
+            "O teu CV foi adicionado à nossa coleção e pode agora ser consultado pelos nossos patrocinadores.\n\n" + 
+            "Caso o queiras consultar ou submeter uma nova versão, podes fazê-lo nesta pasta: " + folderUrl + "\n\n" + 
+            "Cumprimentos,\nFSUMinho");
+
+          Logger.log("Folder created and email sent for: " + fullName);
+
+          // Mark the submission as processed by storing its timestamp
+          scriptProperties.setProperty(timestamp, "processed");
+        } catch (fileError) {
+          Logger.log("Error processing file for row " + (i + 1) + ": " + fileError.toString());
+        }
+      }
+    }
+  } catch (error) {
+    Logger.log("Error: " + error.toString());
+  }
+}
+
+/**
+ * Helper function to extract the file ID from a Google Drive URL.
+ */
+function getFileIdFromUrl(url) {
+  // Verifica dois formatos: /d/<ID> ou ?id=<ID>
+  var match = url.match(/(?:\/d\/|id=)([a-zA-Z0-9_-]+)/);
+  Logger.log("Extracted File ID: " + (match ? match[1] : "No match found for URL: " + url));
+  return match ? match[1] : null;
+}