الردّ على الملاحظات

مستوى الترميز: مبتدئ
المدة: 15 دقيقة
نوع المشروع: أتمتة باستخدام قائمة مخصّصة ومشغّل مستند إلى حدث

الأهداف

• فهم ما يفعله الحلّ
• فهم وظائف خدمات "برمجة تطبيقات Google" ضمن الحلّ
• إعداد النص البرمجي
• شغِّل النص البرمجي.

لمحة عن هذا الحل

إنشاء مسودّات ردود تلقائية على الرسائل الإلكترونية التي تتضمّن ملاحظات من "نماذج Google" يركّز هذا الحلّ على ملاحظات الطلاب بشأن الدورات التدريبية، ولكن يمكنك تطبيقه على أي حالة استخدام تتلقّى فيها ملاحظات باستخدام "نماذج Google".

آلية العمل

يثبِّت البرنامج النصي مشغّلاً مستندًا إلى الأحداث يتم تشغيله في كل مرة يرسل فيها المستخدم نموذجًا. مع كل عملية إرسال للنموذج، ينشئ النص البرمجي مسودة رسالة إلكترونية في Gmail. يتم إرسال الرسالة الإلكترونية إلى الشخص الذي أرسل النموذج، وهي تتضمّن ردود النموذج ورسالة شكر عامة. يمكنك تعديل الرسالة الإلكترونية قبل إرسالها.

خدمات "برمجة تطبيقات Google"

يستخدم هذا الحل الخدمات التالية:

• خدمة البرامج النصية: تثبِّت المشغّل المستند إلى الأحداث الذي يتم تنشيطه عندما يرسل أحد المستخدمين نموذجًا.
• خدمة جداول البيانات: ترسل ردود النموذج إلى Gmail.
• خدمة Gmail: تنشئ مسودة الرسالة الإلكترونية التي تتضمّن رسالة الشكر وردود النموذج.

المتطلبات الأساسية

لاستخدام هذا النموذج، يجب استيفاء المتطلبات الأساسية التالية:

• حساب Google (قد تتطلّب حسابات Google Workspace موافقة المشرف).
• متصفّح ويب يمكنه الوصول إلى الإنترنت

إعداد النص البرمجي

انقر على الزر التالي لإنشاء نسخة من نموذج جدول بيانات الردّ على الملاحظات في "جداول بيانات Google":

إنشاء نسخة

تشغيل النص البرمجي

1. انقر على أداة الرد على النماذج > تفعيل الردود التلقائية على المسودات. قد تحتاج إلى إعادة تحميل الصفحة لتظهر هذه القائمة المخصّصة.
2. امنح الإذن للنصّ البرمجي عند مطالبتك بذلك. <<../_snippets/oauth.md>>
3. انقر على أداة الردود في النماذج > تفعيل الردود التلقائية المحفوظة كمسودات مرة أخرى.
4. انقر على الأدوات > إدارة النموذج > الانتقال إلى النموذج المباشر.
5. املأ النموذج وانقر على إرسال.
6. افتح Gmail واطّلِع على مسوداتك. من المفترض أن تتلقّى مسودّة جديدة تتضمّن ردّك على النموذج.

مراجعة الرمز البرمجي

لمراجعة رمز برمجة تطبيقات الخاص بهذا الحلّ، انقر على عرض الرمز المصدر:

عرض رمز المصدر

Code.gs

solutions/automations/course-feedback-response/Code.js

عرض على GitHub

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/course-feedback-response

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

/**
 * Creates custom menu for user to run scripts.
 */
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("Form Reply Tool")
    .addItem("Enable auto draft replies", "installTrigger")
    .addToUi();
}

/**
 * Installs a trigger on the Spreadsheet for when a Form response is submitted.
 */
function installTrigger() {
  ScriptApp.newTrigger("onFormSubmit")
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onFormSubmit()
    .create();
}

/**
 * Creates a draft email for every response on a form
 *
 * @param {Object} event - Form submit event
 */
function onFormSubmit(e) {
  const responses = e.namedValues;

  // parse form response data
  const timestamp = responses.Timestamp[0];
  const email = responses["Email address"][0].trim();

  // create email body
  const emailBody = createEmailBody(responses);

  // create draft email
  createDraft(timestamp, email, emailBody);
}

/**
 * Creates email body and includes feedback from Google Form.
 *
 * @param {string} responses - The form response data
 * @return {string} - The email body as an HTML string
 */
function createEmailBody(responses) {
  // parse form response data
  const name = responses.Name[0].trim();
  const industry = responses["What industry do you work in?"][0];
  const source = responses["How did you find out about this course?"][0];
  const rating =
    responses["On a scale of 1 - 5 how would you rate this course?"][0];
  const productFeedback =
    responses["What could be different to make it a 5 rating?"][0];
  const otherFeedback = responses["Any other feedback?"][0];

  // create email body
  const htmlBody = `Hi ${name},<br><br>Thanks for responding to our course feedback questionnaire.<br><br>It's really useful to us to help improve this course.<br><br>Have a great day!<br><br>Thanks,<br>Course Team<br><br>****************************************************************<br><br><i>Your feedback:<br><br>What industry do you work in?<br><br>${industry}<br><br>How did you find out about this course?<br><br>${source}<br><br>On a scale of 1 - 5 how would you rate this course?<br><br>${rating}<br><br>What could be different to make it a 5 rating?<br><br>${productFeedback}<br><br>Any other feedback?<br><br>${otherFeedback}<br><br></i>`;

  return htmlBody;
}

/**
 * Create a draft email with the feedback
 *
 * @param {string} timestamp Timestamp for the form response
 * @param {string} email Email address from the form response
 * @param {string} emailBody The email body as an HTML string
 */
function createDraft(timestamp, email, emailBody) {
  console.log("draft email create process started");

  // create subject line
  const subjectLine = `Thanks for your course feedback! ${timestamp}`;

  // create draft email
  GmailApp.createDraft(email, subjectLine, "", {
    htmlBody: emailBody,
  });
}

</section>

المساهمون

تم إنشاء هذا النموذج بواسطة "بن كولينز"، وهو مدرّب في benlcollins.com وخبير معتمد من Google.

• يمكنك العثور على "بن" على Twitter ‎@benlcollins.
• يمكنك الاطّلاع على مدونة "بن".

تحتفظ Google بهذا النموذج بمساعدة خبراء التطوير في Google.

الخطوات التالية

• المشغّلات المستندة إلى الأحداث
• القوائم المخصّصة في Google Workspace