Formular Absenden durch E-Mail und verfolgen Sie Antworten in der Tabelle

Beteiligten Komponenten in diesem workflow sind:

• Ein Skript zu erstellen und senden Sie eine E-Mail mit einem HTML-Formular.
• Eine HTML-Vorlage für diese E-Mail, die es uns ermöglicht das anpassen der E-Mail für jeden Empfänger.
• Eine doPost() Funktion zum verarbeiten von Antworten. Das Skript muss Bereitstellung als Web-App.
• Ein Arbeitsblatt zum sammeln von Antworten. Das Skript enthalten sind, die Tabelle und erweitert die Tabellenkalkulation Benutzeroberfläche mit einem Menü für die Zusendung einer Kopie der Umfrage. (Es kann angepasst werden, die für standalone-Nutzung, ohne die UI-Komponente.)

Hier ist ein Beispiel für einen solchen workflow, die Durchführung einer Pendler-Umfrage. Die Empfänger erhalten eine Umfrage E-Mail wie diese:

Empfänger füllen das Formular rechts Ihre E-Mail-client, wenn es hilft, die Fähigkeit. Die Antworten werden gesammelt in einer Tabelle, wie diese:

^{_{Erstellen Sie die spreadsheet-Header selbst, vor der Ausführung des Skripts.}}

Die "Serial Number" Spalte wurde Hinzugefügt, um zu zeigen, einen Weg, um Antworten korrelieren mit bestimmten Befragten; beachten Sie, dass manche Einträge wiederholen. Wenn Sie eine Umfrage-E-Mail generiert wird, erhält eine eindeutige Seriennummer, die ist dann wieder vergangen, als einen versteckten Wert mit den Antworten. Wir verlängern könnte dieses system zu erkennen, updates von Befragten, zum Beispiel.

Nun der code. (Das ist auch als gist.)

emailTemplate.html

<div>
  <form action="<?= scriptUrl ?>" method="Post">
  <table>
  <tr>
  <td>
    <label for="commute">Do you commute to work?</label>
    </td>
    <td>
    <select name="commute">
      <option>Yes</option>
      <option>No</option>
    </select>
    </td>
  </tr>
  <tr>
    <td>
    <label for="vehicle">If "Yes", how do you get to work?</label>
    </td>
    <td>
      <input type="checkbox" name="vehicle" value="Bike">I have a bike<br>
      <input type="checkbox" name="vehicle" value="Car">I have a car
    </td>
  </tr>
  <tr>
    <td>
    <!-- A Hidden field is a handy way to pass information to the
         Server-side POST handler. For example, a serial number could
         be used to collate responses from a particular recipient. -->
    <input type="hidden" name="serial" value="<?= serialNumber ?>" />
    </td>
    <td>
    <input type="submit" value="Submit" />
    </td>
  </tr>
  </table>
  </form>
</div>

Code.gs

//doPost needs the spreadsheet ID, it has no concept of "active spreadsheet".
var _spreadsheetId = '--- Spreadsheet ID ---';

//Add custom menu with option to send survey
function onOpen() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet();
  var entries = [{
    name : "Send Survey",
    functionName : "sendSurvey"
  }];
  sheet.addMenu("Custom Menu", entries);
};

/**
 * Build & Send Survey, an HTML form in email.
 */
function sendSurvey() {
  var recipient = Browser.inputBox("Send Survey", "Enter Recipient Email", Browser.Buttons.OK_CANCEL);
  if (recipient === 'cancel') return;

  var subject = 'Commuting Survey';

  //Get the URL of the published Web App, to include in email for POST of response
  var scriptUrl = ScriptApp.getService().getUrl();
  if (!scriptUrl) throw new Error( 'You must Deploy as Web App first.' ); 

  //Build email body
  var template = HtmlService.createTemplateFromFile('emailTemplate');
  template.scriptUrl = scriptUrl;
  template.serialNumber = getGUID();  //Generate serial number for this response
  var html = template.evaluate().getContent();

  //During debugging, send emails to self. Remove this line for real operation.
  recipient = Session.getActiveUser().getEmail();  

  //Send email form
  GmailApp.sendEmail(recipient, subject, 'Requires HTML', {htmlBody:html} );

  Browser.msgBox("Survey Sent");
}

/**
 * POST handler for responses; 
 */
function doPost(e) {
  Logger.log(e);
  var ss = SpreadsheetApp.openById(_spreadsheetId);
  var sheet = ss.getSheets()[0];  //Assume first sheet collects responses

  //Build a row of data with timestamp + posted response
  var row = [
    new Date(),                     //Timestamp
    e.parameters.serial[0],         //Serial Number
    e.parameters.commute[0],        //Commuter? Yes /No
    e.parameters.vehicle.join(',')  //Vehicle
  ];

  //Make sure we are the only people adding rows to the spreadsheet
  var lock = LockService.getPublicLock();
  //Wait for up to 30 seconds for other processes to finish.
  var locked = lock.tryLock(30000);

  if (locked) {
    //Save response to spreadsheet
    var rowNum = sheet.getLastRow()+1;
    sheet.getRange(rowNum, 1, 1, row.length).setValues([row]);

    //Release the lock so that other processes can continue.
    lock.releaseLock();
    var result = "Response Recorded: \n  "+row.join('\n  ');
  }
  else {
    //Failed to get lock
    result = "System busy, please try again.";
  }

  //Report result of POST, in plain text
  return ContentService.createTextOutput(result)
                       .setMimeType(ContentService.MimeType.TEXT);
}


/**
 * Returns an rfc4122 version 4 compliant GUID /UUID string
 * Thanks to @broofa!
 * http://stackoverflow.com/a/2117523/1677912
 */
function getGUID() {
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
    var r = Math.random()*16|0, v = c == 'x' ? r : (r&0x3|0x8);
    return v.toString(16);
  });
}

Bereitstellung

Nutzen das Umfrage-system ist:

1. Erstellen Sie ein neues Arbeitsblatt in Ihrem Drive-Konto. Fügen Sie überschriften für "Timestamp", "Seriennummer", "Commuter?", und "Fahrzeug" in Zeile 1.
2. Tools - Skript-Editor. Kopieren Sie die Code.gs Inhalt. Kopieren Sie die ID Ihrer Tabelle und aktualisieren Sie die _spreadsheetId variable am Anfang der Datei. Speichern.
3. Datei - Neu-HTML-Datei, benennen Sie die Datei emailTemplate. Kopieren Sie die emailTemplate.html Inhalt. Speichern.
4. Veröffentlichen - die Bereitstellung als Web-app... Machen es zugänglich von jedermann, auch anonym. In einer Google Apps-domain können Sie einschränken, es zu Benutzer in der Domäne).
5. Autorisieren Sie das Skript aus, durch das Neuladen Ihrer Tabelle oder das ausführen der onOpen Funktion im editor.

Bereit zu gehen! Finden Sie ein "Benutzerdefiniertes Menü" in Ihrem Tabellenkalkulationsprogramm, mit einer "Umfrage Senden" - Befehl.