Kodlama seviyesi: Başlangıç
Süre: 5 dakika
Proje türü: Özel işlev
Hedefler
- Çözümün ne işe yaradığını anlayın.
- Apps Komut Dosyası hizmetlerinin çözüm kapsamında neler yaptığını anlayın.
- Komut dosyasını ayarlayın.
- Komut dosyasını çalıştırın.
Bu çözüm hakkında
Bir e-tablodaki birden fazla sayfada benzer şekilde yapılandırılmış verileriniz varsa (ör. ekip üyeleri için müşteri desteği metrikleri) her sayfanın özetini oluşturmak için bu özel işlevi kullanabilirsiniz. Bu çözüm müşteri destek biletlerine odaklanıyor ancak çözümü ihtiyaçlarınıza göre özelleştirebilirsiniz.
İşleyiş şekli
getSheetsData()
adlı özel işlev, e-tablodaki her bir sayfadaki verileri, sayfanın Durum sütununa göre özetler. Komut dosyası, ReadMe ve Özet sayfaları gibi toplama işlemine dahil edilmemesi gereken sayfaları yoksayar.
Apps Komut Dosyası hizmetleri
Bu çözüm aşağıdaki hizmeti kullanır:
- E-tablo hizmeti - Özetlenmesi gereken sayfaları alır ve belirtilen bir dizeyle eşleşen öğeleri sayar. Ardından komut dosyası, hesaplanan bilgileri özel işlevin e-tabloda çağrıldığı yere göre bir aralığa ekler.
Ön koşullar
Bu örneği kullanmak için aşağıdaki önkoşullara ihtiyacınız vardır:
- Google Hesabı (Google Workspace hesapları için yönetici onayı gerekebilir).
- İnternete erişimi olan bir web tarayıcısı.
Komut dosyasını kurma
E-tablo verilerini özetle özel işlevi e-tablosunun kopyasını oluşturmak için aşağıdaki düğmeyi tıklayın. Bu çözüm için Apps Komut Dosyası projesi e-tabloya eklendi.
Kopya oluştur
Komut dosyasını çalıştırma
- Kopyalanan e-tablonuzda Özet sayfasına gidin.
A4
hücresini tıklayın.getSheetsData()
işlevi bu hücrede yer alır.- Sayfa sahibi sayfalarından birine gidin ve sayfayı güncelleyin veya e-tabloya veri ekleyin. Deneyebileceğiniz işlemlerden bazıları şunlardır:
- Örnek bilet bilgilerini içeren yeni bir satır ekleyin.
- Durum sütununda, mevcut bir kaydın durumunu değiştirin.
- Durum sütununun konumunu değiştirin. Örneğin, Owner1 sayfasında Owner1 sütununu C sütunundan D sütununa taşıyın.
- Özet sayfasına gidin ve
getSheetsData()
tarafındanA4
hücresinden oluşturulan güncellenmiş özet tablosunu inceleyin. Özel işlevin önbelleğe alınmış sonuçlarını yenilemek için 10. satırdaki onay kutusunu işaretlemeniz gerekebilir. Google, performansı optimize etmek için özel işlevleri önbelleğe alır.- Satır eklediyseniz veya güncellediyseniz komut dosyası bileti ve durum sayılarını günceller.
- Durum sütununun konumunu taşıdıysanız komut dosyası, yeni sütun dizininde beklendiği gibi çalışmaya devam eder.
Kodu inceleyin
Bu çözümün Apps Komut Dosyası kodunu incelemek için aşağıdaki Kaynak kodu görüntüle'yi tıklayın:
Kaynak kodu göster
Code.gs
Değişiklikler
Özel işlevi ihtiyaçlarınıza uyacak şekilde düzenleyebilirsiniz. Aşağıda, özel işlev sonuçlarını manuel olarak yenilemek için isteğe bağlı bir ekleme yer almaktadır.
Önbelleğe alınan sonuçları yenile
Yerleşik işlevlerin aksine Google, performansı optimize etmek için özel işlevleri önbelleğe alır. Diğer bir deyişle, özel işlevinizde bir şeyi (ör. hesaplanmakta olan bir değer) değiştirirseniz güncelleme hemen zorunlu kılınmayabilir. İşlev sonucunu manuel olarak yenilemek için aşağıdaki adımları uygulayın:
- Ekle > Onay kutusu'nu tıklayarak boş bir hücreye onay kutusu ekleyin.
- Özel işlevin parametresi olarak onay kutusu bulunan hücreyi ekleyin (örneğin,
getSheetsData(B11)
). - Özel işlev sonuçlarını yenilemek için onay kutusunu işaretleyin veya kutunun işaretini kaldırın.
Katılımcılar
Bu örnek, Google Geliştirici Uzmanlarının yardımıyla Google tarafından sağlanmaktadır.