إدارة طلبات معدات الموظفين الجدد

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

الأهداف

  • فهم ما يفعله الحل.
  • تعرّف على ما تفعله خدمات "برمجة التطبيقات" ضمن الحل.
  • أعِدّ النص البرمجي.
  • شغِّل النص البرمجي.

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

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

لقطة شاشة لنموذج طلب المعدّات

آلية العمل

يقوم النص بإنشاء نموذج طلب معدات. يمكنك تخصيص العناصر الواردة في النموذج في نموذج رمز النص البرمجي. عندما يرسل شخص النموذج، يرسل النص البرمجي إشعارًا عبر البريد الإلكتروني إلى جهة الاتصال المخصصة بشأن الطلبات. وبمجرد تغيير حالة الطلب في جدول البيانات إلى "مكتمل"، يرسل النص البرمجي رسالة تأكيد إلكترونية إلى الشخص الذي أرسل النموذج.

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

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

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

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

لاستخدام هذا النموذج، ستحتاج إلى المتطلّبات الأساسية التالية:

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

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

إنشاء مشروع "برمجة تطبيقات Google"

  1. انقر على الزر التالي لإنشاء نسخة من جدول بيانات إدارة طلبات معدات الموظفين. يتم إرفاق مشروع "برمجة تطبيقات Google" لهذا الحل بجدول البيانات.
    إنشاء نسخة
  2. انقر على الإضافات > برمجة التطبيقات.
  3. بجانب المتغيّر REQUEST_NOTIFICATION_EMAIL، استبدِل نموذج الرسالة الإلكترونية بعنوان بريدك الإلكتروني.
  4. انقر على "حفظ" رمز الحفظ.

إعداد جدول البيانات

  1. ارجع إلى جدول البيانات وانقر على طلبات المعدات > إعداد. قد تحتاج إلى تحديث الصفحة حتى تظهر هذه القائمة المخصصة.
  2. امنح الإذن للنصّ البرمجي عند مطالبتك بذلك. إذا عرضت شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التحذير، لم يتم التحقّق من هذا التطبيق، يمكنك المتابعة من خلال اختيار إعدادات متقدّمة > الانتقال إلى {Project Name} (غير آمن).

  3. انقر على طلبات المعدات > إعداد مرة أخرى.

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

  1. انقر على أدوات > إدارة النموذج > الانتقال إلى النموذج المباشر.
  2. املأ النموذج وأرسِله.
  3. تحقَّق من بريدك الإلكتروني بحثًا عن إشعار بشأن طلب المعدّات.
  4. ارجع إلى جدول البيانات وفي ورقة الطلبات في انتظار المراجعة، غيِّر حالة الطلب إلى مكتمل.
  5. في غضون 5 دقائق، يرسل النص البرمجي رسالة إلكترونية أخرى لإعلامك باكتمال الطلب. ينقل النص البرمجي الطلب من ورقة الطلبات في انتظار المراجعة إلى ورقة الطلبات المكتملة.

مراجعة الرمز

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

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

Code.gs

solutions/automations/equipment-requests/Code.js
// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/equipment-requests

/*
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.
*/

// Update this variable with the email address you want to send equipment requests to.
const REQUEST_NOTIFICATION_EMAIL = 'request_intake@example.com';

// Update the following variables with your own equipment options.
const AVAILABLE_LAPTOPS = [
  '15" high Performance Laptop (OS X)',
  '15" high Performance Laptop (Windows)',
  '15" high performance Laptop (Linux)',
  '13" lightweight laptop (Windows)',
];
const AVAILABLE_DESKTOPS = [
  'Standard workstation (Windows)',
  'Standard workstation (Linux)',
  'High performance workstation (Windows)',
  'High performance workstation (Linux)',
  'Mac Pro (OS X)',
];
const AVAILABLE_MONITORS = [
  'Single 27"',
  'Single 32"',
  'Dual 24"',
];

// Form field titles, used for creating the form and as keys when handling
// responses.
/**
 * Adds a custom menu to the spreadsheet.
 */
function onOpen() {
  SpreadsheetApp.getUi().createMenu('Equipment requests')
      .addItem('Set up', 'setup_')
      .addItem('Clean up', 'cleanup_')
      .addToUi();
}

/**
 * Creates the form and triggers for the workflow.
 */
function setup_() {
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  if (ss.getFormUrl()) {
    let msg = 'Form already exists. Unlink the form and try again.';
    SpreadsheetApp.getUi().alert(msg);
    return;
  }
  let form = FormApp.create('Equipment Requests')
      .setCollectEmail(true)
      .setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId())
      .setLimitOneResponsePerUser(false);
  form.addTextItem().setTitle('Employee name').setRequired(true);
  form.addTextItem().setTitle('Desk location').setRequired(true);
  form.addDateItem().setTitle('Due date').setRequired(true);
  form.addListItem().setTitle('Laptop').setChoiceValues(AVAILABLE_LAPTOPS);
  form.addListItem().setTitle('Desktop').setChoiceValues(AVAILABLE_DESKTOPS);
  form.addListItem().setTitle('Monitor').setChoiceValues(AVAILABLE_MONITORS);

  // Hide the raw form responses.
  ss.getSheets().forEach(function(sheet) {
    if (sheet.getFormUrl() == ss.getFormUrl()) {
      sheet.hideSheet();
    }
  });
  // Start workflow on each form submit
  ScriptApp.newTrigger('onFormSubmit_')
      .forForm(form)
      .onFormSubmit()
      .create();
  // Archive completed items every 5m.
  ScriptApp.newTrigger('processCompletedItems_')
      .timeBased()
      .everyMinutes(5)
      .create();
}

/**
 * Cleans up the project (stop triggers, form submission, etc.)
 */
function cleanup_() {
  let formUrl = SpreadsheetApp.getActiveSpreadsheet().getFormUrl();
  if (!formUrl) {
    return;
  }
  ScriptApp.getProjectTriggers().forEach(function(trigger) {
    ScriptApp.deleteTrigger(trigger);
  });
  FormApp.openByUrl(formUrl)
      .deleteAllResponses()
      .setAcceptingResponses(false);
}

/**
 * Handles new form submissions to trigger the workflow.
 *
 * @param {Object} event - Form submit event
 */
function onFormSubmit_(event) {
  let response = mapResponse_(event.response);
  sendNewEquipmentRequestEmail_(response);
  let equipmentDetails = Utilities.formatString('%s\n%s\n%s',
      response['Laptop'],
      response['Desktop'],
      response['Monitor']);
  let row = ['New',
    '',
    response['Due date'],
    response['Employee name'],
    response['Desk location'],
    equipmentDetails,
    response['email']];
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName('Pending requests');
  sheet.appendRow(row);
}

/**
 * Sweeps completed and cancelled requests, notifying the requestors and archiving them
 * to the completed sheet.
 *
 * @param {Object} event
 */
function processCompletedItems_() {
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  let pending = ss.getSheetByName('Pending requests');
  let completed = ss.getSheetByName('Completed requests');
  let rows = pending.getDataRange().getValues();
    for (let i = rows.length; i >= 2; i--) {
      let row = rows[i -1];
      let status = row[0];
      if (status === 'Completed' || status == 'Cancelled') {
          pending.deleteRow(i);
          completed.appendRow(row);
          console.log("Deleted row: " + i);
          sendEquipmentRequestCompletedEmail_({
            'Employee name': row[3],
            'Desk location': row[4],
            'email': row[6],
          });
        }
      };
}

/**
 * Sends an email notification that a new equipment request has been submitted.
 *
 * @param {Object} request - Request details
 */
function sendNewEquipmentRequestEmail_(request) {
  let template = HtmlService.createTemplateFromFile('new-equipment-request.html');
  template.request = request;
  template.sheetUrl = SpreadsheetApp.getActiveSpreadsheet().getUrl();
  let msg = template.evaluate();
  MailApp.sendEmail({
    to: REQUEST_NOTIFICATION_EMAIL,
    subject: 'New equipment request',
    htmlBody: msg.getContent(),
  });
}

/**
 * Sends an email notifying the requestor that the request is complete.
 *
 * @param {Object} request - Request details
 */
function sendEquipmentRequestCompletedEmail_(request) {
  let template = HtmlService.createTemplateFromFile('request-complete.html');
  template.request = request;
  let msg = template.evaluate();
  MailApp.sendEmail({
    to: request.email,
    subject: 'Equipment request completed',
    htmlBody: msg.getContent(),
  });
}

/**
 * Converts a form response to an object keyed by the item titles. Allows easier
 * access to response values.
 *
 * @param {FormResponse} response
 * @return {Object} Form values keyed by question title
 */
function mapResponse_(response) {
  let initialValue = {
    email: response.getRespondentEmail(),
    timestamp: response.getTimestamp(),
  };
  return response.getItemResponses().reduce(function(obj, itemResponse) {
    let key = itemResponse.getItem().getTitle();
    obj[key] = itemResponse.getResponse();
    return obj;
  }, initialValue);
}

new-equipment-request.html

solutions/automations/equipment-requests/new-equipment-request.html
<!DOCTYPE html>
<!--
 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

      http://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.
-->

<html>
  <body>
    <p>
    A new equipment request has been made by <?= request.email ?>.
    </p>

    <p>
    Employee name: <?= request['Employee name'] ?><br/>
    Desk location name: <?= request['Desk location'] ?><br/>
    Due date: <?= request['Due date'] ?><br/>
    Laptop model: <?= request['Laptop'] ?><br/>
    Desktop model: <?= request['Desktop'] ?><br/>
    Monitor(s): <?= request['Monitor'] ?><br/>
    </p>

    See <a href="<?= sheetUrl ?>">the spreadsheet</a> to take or assign this item.
  </body>
</html>

request-complete.html

solutions/automations/equipment-requests/request-complete.html
<!DOCTYPE html>
<!--
 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

      http://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.
-->

<html>
  <body>
    <p>
    An equipment request has been completed.
    </p>

    <p>
    Employee name: <?= request['Employee name'] ?><br/>
    Desk location name: <?= request['Desk location'] ?><br/>
    </p>
  </body>
</html>

المساهمون

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

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