Kodlama seviyesi: Başlangıç
Süre: 5 dakika
Proje türü: Özel menü ve
etkinliğe dayalı tetikleyici
Hedefler
- Çözümün ne işe yaradığını anlayın.
- Apps Komut Dosyası hizmetlerinin
çözümüne geçelim.
- Komut dosyasını ayarlayın.
- Komut dosyasını çalıştırın.
Bu çözüm hakkında
Uçtan uca etkinlik kayıt sistemi oluşturun. Bir etkinliğiniz varsa
bir konferans görüşmesi gibiyseniz, konferans için yeni bir takvim oluşturabilirsiniz
kayıt formu oluşturabilir ve katılımcılara otomatik olarak kişiselleştirilmiş e-posta gönderebilir
seyahat planları.
![E-Tablolar'daki bilgiler Formlar'a ve Takvim'e aktarılıyor.](https://developers.google.cn/static/apps-script/samples/images/event-signup.jpeg?authuser=7&hl=tr)
İşleyiş şekli
Bu çözüm, Google E-Tablolar'daki özel bir menüyü kullanarak otomatik bir
kayıt sistemidir. Komut dosyası, konferansla birlikte bir takvim oluşturur
etkinlikleri görebilirsiniz. Daha sonra komut dosyası
Katılımcıların kaydolabileceği etkinliklerin listesini içeren bir form. Katılımcılardan sonra
komut dosyası, katılımcıları takvim etkinliklerine ekler
bu kişiye seyahat planlarını gönderir.
Apps Komut Dosyası hizmetleri
Bu çözüm aşağıdaki hizmetleri kullanır:
- E-tablo hizmeti:
diğer hizmetlere taşımaz.
- Takvim hizmeti: Bir
etkinlik için yeni bir takvim oluşturur, takvime etkinlikler ekler ve katılımcıları ekler
takip eder.
- Mülkler hizmeti:
Takvim hizmeti tarafından oluşturulan takvimin kimliği. Kullanıcı
özel Konferans menüsünden Konferans ayarla'yı tıkladığında,
Özellikler hizmeti, etkinlik kayıt sisteminde
takvim kimliği özelliğinin olup olmadığı kontrol edilerek ayarlanmış olmalıdır. Bunu yapmak,
yinelenen formlar ve takvimler oluşturmaktan kaçının.
- Formlar hizmeti: Form oluşturur
kaydolmasına olanak tanıyan e-tablodaki bilgilerden
anlamına gelir.
- Komut dosyası hizmeti: Etkinleştiren bir tetikleyici oluşturur
Bir katılımcı formu doldurduğunda.
- Doküman hizmeti: Etkinliği alır
kaydolduğu tüm etkinliklerle ilgili bilgileri ekler ve etkinliğin
yeni bir dokümana ekleyebilirsiniz. Komut dosyası, katılımcıya düzenleme izni verir
kontrol edebilirsiniz.
- Posta hizmeti: Seyahat planı dokümanını e-posta ile şu adrese gönderir:
önemli bir adımdır.
Ön koşullar
Bu örneği kullanmak için aşağıdaki ön koşullara sahip olmanız gerekir:
- Google Hesabı (Google Workspace hesapları
(yönetici onayı gerektirir).
- İnternete erişimi olan bir web tarayıcısı.
Komut dosyasını ayarlama
- Create a sign up for
konferans oturumlarında örnek bir e-tablodan bahsedeceğiz. Apps Komut Dosyası
bu çözümün projesi e-tabloya eklenir.
Kopya oluştur
- Konferans > Kurulum'u tıklayın
konferans. Bu özel menünün şu işlemleri yapmak için sayfayı yenilemeniz gerekebilir:
görünür.
İstendiğinde komut dosyasını yetkilendirin.
OAuth izin ekranında Bu uygulama doğrulanmadı uyarısı gösteriliyorsa
Gelişmiş'i > seçerek devam edin
{Project Name} adlı projeye (güvenli değil) gidin.
Konferans > Kurulum'u tıklayın
konferansı tekrar tıklayın.
Komut dosyasını çalıştırma
- Araçlar > Formu Yönet'i tıklayın.
> Canlı forma gidin.
- Formu doldurup gönderin.
- calendar.google.com adresine gidin.
- Sol tarafta, Konferans Takvimi'nin yanındaki kutunun işaretli olduğundan emin olun.
- Kaydolduğunuz etkinliklerin tarihlerine gidin ve eklendiğinizi onaylayın
bir "katılım"dır.
(İsteğe bağlı) Çözümü sıfırlayın
Bu çözümü tekrar denemek isterseniz veya
oluşturmak için, oluşturulan bazı öğeleri sıfırlamanız
otomatik olarak seçim yapar. Çözümü sıfırlama adımlarını görüntülemek için
Aşağıda çözümü sıfırlayın:
Çözümü sıfırlayın
1. Adım: Depolanan komut dosyası özelliklerini sıfırlayın
Komut dosyasını bir defadan fazla çalıştırmayı denerseniz,
konferans zaten ayarlandı. Kayıt formunuz için Google Drive'a bakın.
Bunun nedeni Konferans Takvimi oluşturulduktan sonra takvim kimliğinin
bir komut dosyası özelliği olarak depolanır. Komut dosyası çalıştığında,
calendar ID özelliği zaten var ve varsa çalışmayı durduracak.
Mevcut takvim kimliği özelliğini kaldırmak için aşağıdaki adımları uygulayın:
- E-tabloda Uzantılar'ı tıklayın.
> Apps Komut Dosyası'na gidin.
- Apps Komut Dosyası düzenleyicisinde, açılır menüden
resetProperties
'i seçin.
işlev açılır listesinden Çalıştır'ı tıklayın.
2. Adım: Konferans Takvimi'ni silin
Komut dosyası her çalıştığında yeni bir takvim oluşturulur. Herhangi bir
oluşturulan orijinal takvimi korumak için aşağıdaki adımları uygulayın:
- calendar.google.com adresine gidin.
- Konferans Takvimi'nin yanında, Konferans Takvimi Seçenekleri'ni tıklayın.
>
Ayarlar ve paylaşım.
- Ayarlar altından Sil'i tıklayın.
Komut dosyası, form gönderimlerini her çalıştırdığınızda bir tetikleyici oluşturur. Alıcı:
yinelenen e-postalara neden olan birden fazla tetikleyiciden kaçının, orijinal dosyayı kaldırın
tetikleyici olur. Şu adımları uygulayın:
- E-tabloda Uzantılar'ı tıklayın.
> Apps Komut Dosyası'na gidin.
- Apps Komut Dosyası projesinde, soldaki Tetikleyiciler'i tıklayın.
.
- Tetikleyicinin yanında Diğer'i
tıklayın.
> Tetikleyiciyi sil'e dokunun.
Komut dosyasını her çalıştırdığınızda yeni bir form oluşturulur. Aşağıdaki adımları uygulayarak
formun e-tablonuzdan bağlantısını kaldırın ve formu silin:
- E-tabloda Form yanıtları sayfasını sağ tıklayın ve
Formun bağlantısını kaldır > Tamam'ı tıklayın.
- Form yanıtları sayfasını tekrar sağ tıklayın ve Sil'i tıklayın.
> Tamam.
- forms.google.com adresine gidin.
- Konferans Formu'nu sağ tıklayıp Kaldır'ı tıklayın
> Çöp kutusuna taşı'ya dokunun.
Çözümü sıfırladıktan sonra kendi verilerinizi ekleyebilir veya aşağıdaki adımları uygulayabilirsiniz:
örnek verileri kullanın ve komut dosyasını tekrar çalıştırın.
Kodu inceleyin
Bu çözüm için Apps Komut Dosyası kodunu incelemek üzere
Aşağıdaki kaynak kodu görüntüleyin:
Kaynak kodu göster
Code.gs
// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/event-session-signup
/*
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.
*/
/**
* Inserts a custom menu when the spreadsheet opens.
*/
function onOpen() {
SpreadsheetApp.getUi().createMenu('Conference')
.addItem('Set up conference', 'setUpConference_')
.addToUi();
}
/**
* Uses the conference data in the spreadsheet to create
* Google Calendar events, a Google Form, and a trigger that allows the script
* to react to form responses.
*/
function setUpConference_() {
let scriptProperties = PropertiesService.getScriptProperties();
if (scriptProperties.getProperty('calId')) {
Browser.msgBox('Your conference is already set up. Look in Google Drive for your'
+ ' sign-up form!');
return;
}
let ss = SpreadsheetApp.getActive();
let sheet = ss.getSheetByName('Conference Setup');
let range = sheet.getDataRange();
let values = range.getValues();
setUpCalendar_(values, range);
setUpForm_(ss, values);
ScriptApp.newTrigger('onFormSubmit').forSpreadsheet(ss).onFormSubmit()
.create();
}
/**
* Creates a Google Calendar with events for each conference session in the
* spreadsheet, then writes the event IDs to the spreadsheet for future use.
* @param {Array<string[]>} values Cell values for the spreadsheet range.
* @param {Range} range A spreadsheet range that contains conference data.
*/
function setUpCalendar_(values, range) {
let cal = CalendarApp.createCalendar('Conference Calendar');
// Start at 1 to skip the header row.
for (let i = 1; i < values.length; i++) {
let session = values[i];
let title = session[0];
let start = joinDateAndTime_(session[1], session[2]);
let end = joinDateAndTime_(session[1], session[3]);
let options = {location: session[4], sendInvites: true};
let event = cal.createEvent(title, start, end, options)
.setGuestsCanSeeGuests(false);
session[5] = event.getId();
}
range.setValues(values);
// Stores the ID for the Calendar, which is needed to retrieve events by ID.
let scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.setProperty('calId', cal.getId());
}
/**
* Creates a single Date object from separate date and time cells.
*
* @param {Date} date A Date object from which to extract the date.
* @param {Date} time A Date object from which to extract the time.
* @return {Date} A Date object representing the combined date and time.
*/
function joinDateAndTime_(date, time) {
date = new Date(date);
date.setHours(time.getHours());
date.setMinutes(time.getMinutes());
return date;
}
/**
* Creates a Google Form that allows respondents to select which conference
* sessions they would like to attend, grouped by date and start time in the
* caller's time zone.
*
* @param {Spreadsheet} ss The spreadsheet that contains the conference data.
* @param {Array<String[]>} values Cell values for the spreadsheet range.
*/
function setUpForm_(ss, values) {
// Group the sessions by date and time so that they can be passed to the form.
let schedule = {};
// Start at 1 to skip the header row.
for (let i = 1; i < values.length; i++) {
let session = values[i];
let day = session[1].toLocaleDateString();
let time = session[2].toLocaleTimeString();
if (!schedule[day]) {
schedule[day] = {};
}
if (!schedule[day][time]) {
schedule[day][time] = [];
}
schedule[day][time].push(session[0]);
}
// Creates the form and adds a multiple-choice question for each timeslot.
let form = FormApp.create('Conference Form');
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());
form.addTextItem().setTitle('Name').setRequired(true);
form.addTextItem().setTitle('Email').setRequired(true);
Object.keys(schedule).forEach(function(day) {
let header = form.addSectionHeaderItem().setTitle('Sessions for ' + day);
Object.keys(schedule[day]).forEach(function(time) {
let item = form.addMultipleChoiceItem().setTitle(time + ' ' + day)
.setChoiceValues(schedule[day][time]);
});
});
}
/**
* Sends out calendar invitations and a
* personalized Google Docs itinerary after a user responds to the form.
*
* @param {Object} e The event parameter for form submission to a spreadsheet;
* see https://developers.google.com/apps-script/understanding_events
*/
function onFormSubmit(e) {
let user = {name: e.namedValues['Name'][0], email: e.namedValues['Email'][0]};
// Grab the session data again so that we can match it to the user's choices.
let response = [];
let values = SpreadsheetApp.getActive().getSheetByName('Conference Setup')
.getDataRange().getValues();
for (let i = 1; i < values.length; i++) {
let session = values[i];
let title = session[0];
let day = session[1].toLocaleDateString();
let time = session[2].toLocaleTimeString();
let timeslot = time + ' ' + day;
// For every selection in the response, find the matching timeslot and title
// in the spreadsheet and add the session data to the response array.
if (e.namedValues[timeslot] && e.namedValues[timeslot] == title) {
response.push(session);
}
}
sendInvites_(user, response);
sendDoc_(user, response);
}
/**
* Add the user as a guest for every session he or she selected.
* @param {object} user An object that contains the user's name and email.
* @param {Array<String[]>} response An array of data for the user's session choices.
*/
function sendInvites_(user, response) {
let id = ScriptProperties.getProperty('calId');
let cal = CalendarApp.getCalendarById(id);
for (let i = 0; i < response.length; i++) {
cal.getEventSeriesById(response[i][5]).addGuest(user.email);
}
}
/**
* Creates and shares a personalized Google Doc that shows the user's itinerary.
* @param {object} user An object that contains the user's name and email.
* @param {Array<string[]>} response An array of data for the user's session choices.
*/
function sendDoc_(user, response) {
let doc = DocumentApp.create('Conference Itinerary for ' + user.name)
.addEditor(user.email);
let body = doc.getBody();
let table = [['Session', 'Date', 'Time', 'Location']];
for (let i = 0; i < response.length; i++) {
table.push([response[i][0], response[i][1].toLocaleDateString(),
response[i][2].toLocaleTimeString(), response[i][4]]);
}
body.insertParagraph(0, doc.getName())
.setHeading(DocumentApp.ParagraphHeading.HEADING1);
table = body.appendTable(table);
table.getRow(0).editAsText().setBold(true);
doc.saveAndClose();
// Emails a link to the Doc as well as a PDF copy.
MailApp.sendEmail({
to: user.email,
subject: doc.getName(),
body: 'Thanks for registering! Here\'s your itinerary: ' + doc.getUrl(),
attachments: doc.getAs(MimeType.PDF),
});
}
/**
* Removes the calId script property so that the 'setUpConference_()' can be run again.
*/
function resetProperties(){
let scriptProperties = PropertiesService.getScriptProperties();
scriptProperties.deleteAllProperties();
}
Katkıda bulunanlar
Bu örnek, Google Geliştirici Uzmanları'nın yardımıyla Google tarafından yönetilir.
Sonraki adımlar