Se usó la API de Cloud Translation para traducir esta página.

Gestionar las solicitudes de equipamiento para empleados nuevos

Nivel de programación: Principiante
Duración: 10 minutos
Tipo de proyecto: Automatización con un activador basado en eventos y un activador basado en el tiempo

Objetivos

Comprender qué hace la solución
Comprender qué hacen los servicios de Apps Script dentro de la solución
Configura la secuencia de comandos.
Ejecuta la secuencia de comandos.

Acerca de esta solución

Los empleados nuevos suelen necesitar acceso al sistema y equipos de TI. Para administrar estas solicitudes, puedes crear un formulario con Formularios de Google para que los usuarios indiquen qué acceso y qué dispositivos necesitan los empleados. Una vez que el equipo de TI completa la solicitud y actualiza su estado, los solicitantes reciben una notificación por correo electrónico.

Captura de pantalla del formulario de solicitud de equipo

Cómo funciona

La secuencia de comandos crea un formulario de solicitud de equipo. Puedes personalizar los elementos del formulario en el código de la secuencia de comandos de ejemplo. Cuando alguien envía el formulario, la secuencia de comandos envía una notificación por correo electrónico al punto de contacto designado para las solicitudes. Una vez que el estado de la solicitud en la hoja de cálculo cambie a “Completada”, la secuencia de comandos enviará un correo electrónico de confirmación a la persona que envió el formulario.

Servicios de Apps Script

En esta solución, se usan los siguientes servicios:

Servicio de formularios: Crea el formulario para las solicitudes de TI.
Servicio de hoja de cálculo: Verifica si el formulario de solicitud ya existe para mitigar los duplicados. Administra las respuestas del formulario moviéndolas a las hojas Pendientes y Completadas según sea necesario.
Servicio de correo electrónico: Crea y envía los correos electrónicos de solicitud y notificación de finalización.
Servicio de secuencia de comandos: Crea los activadores. Uno se activa cuando se envía un formulario y el otro se activa cada cinco minutos para verificar si el estado de una solicitud está marcado como “Completada”.

Requisitos previos

Para usar esta muestra, debes cumplir con los siguientes requisitos previos:

Una Cuenta de Google (es posible que las cuentas de Google Workspace requieran aprobación del administrador)
Un navegador web con acceso a Internet

Configura la secuencia de comandos

Crea el proyecto de Apps Script

Haz clic en el siguiente botón para crear una copia de la hoja de cálculo Administrar solicitudes de equipos de los empleados. El proyecto de Apps Script para esta solución está adjunto a la hoja de cálculo.
Crear una copia
Haz clic en Extensiones > Apps Script.
Junto a la variable REQUEST_NOTIFICATION_EMAIL, reemplaza el correo electrónico de muestra por el tuyo.
Haz clic en Guardar .

Configura la hoja de cálculo

Regresa a la hoja de cálculo y haz clic en Solicitudes de equipos > Configurar. Es posible que debas actualizar la página para que aparezca este menú personalizado.
Cuando se te solicite, autoriza la secuencia de comandos. Si la pantalla de consentimiento de OAuth muestra la advertencia Esta app no está verificada, continúa seleccionando Avanzado > Ir a {nombre del proyecto} (no seguro).
Haz clic en Solicitudes de equipos > Configurar de nuevo.

Ejecuta la secuencia de comandos:

Haz clic en Tools > Manage form > Go to live form.
Completa y envía el formulario.
Revisa tu correo electrónico para ver si recibiste una notificación sobre la solicitud de equipo.
Regresa a la hoja de cálculo y, en la hoja Solicitudes pendientes, cambia el estado de la solicitud a Completada.
En un plazo de 5 minutos, la secuencia de comandos te enviará otro correo electrónico para notificarte que se completó la solicitud. La secuencia de comandos mueve la solicitud de la hoja Solicitudes pendientes a la hoja Solicitudes completadas.

Revisa el código

Para revisar el código de Apps Script de esta solución, haz clic en Ver código fuente a continuación:

Ver el código fuente

Code.gs

solutions/automations/equipment-requests/Code.js

Ver en GitHub

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

Ver en GitHub

<!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

Ver en GitHub

<!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>

Colaboradores

Google mantiene este ejemplo con la ayuda de expertos en desarrollo de Google.

Gestionar las solicitudes de equipamiento para empleados nuevos

Objetivos

Acerca de esta solución

Cómo funciona

Servicios de Apps Script

Requisitos previos

Configura la secuencia de comandos

Crea el proyecto de Apps Script

Configura la hoja de cálculo

Ejecuta la secuencia de comandos:

Revisa el código

Ver el código fuente

Code.gs

new-equipment-request.html

request-complete.html

Colaboradores

Próximos pasos