AppSheet'i Apps Komut Dosyası'na bağlama

1. Giriş

Bu codelab'de "Hello World" adlı bir Apps Komut Dosyası projesi oluşturacak ve ardından kendisine iletilen bir mesajı kaydeden basit bir işlev (logThis) ekleyeceksiniz. Ardından, bir AppSheet otomasyonu oluşturup komut dosyasını çağırmasını sağlarsınız. Komut dosyası çağrıldıktan sonra Apps Komut Dosyası düzenleyicisine döner ve yürütülmesini onaylarsınız.

Neler öğreneceksiniz?

  • Basit bir işlev içeren Apps Komut Dosyası projesi oluşturma
  • Mevcut bir Google E-Tablosu'nu temel alan basit bir AppSheet uygulaması oluşturma
  • Komut dosyası işlevini çağıran bir AppSheet Otomasyonu oluşturma
  • AppSheet'ten komut dosyasının başarılı bir şekilde yürütülüp yürütülmediğini kontrol etme

Gerekenler

  • AppSheet geliştirme ortamına (appsheet.com) erişim.
  • Apps Komut Dosyası geliştirme ortamına erişim (script.google.com).

2. Apps Komut Dosyası projesi oluşturma

Öncelikle "Hello World" adlı bir Apps Komut Dosyası projesi oluşturun ve ardından kendisine iletilen bir mesajı kaydeden basit bir işlev (logThis) ekleyin.

  1. Apps Komut Dosyası ana sayfasına gidip + Yeni Proje'yi tıklayın.
  2. Projenin başlığını Hello World. Projeyi Yeniden Adlandır iletişim kutusunda yeni ad. olarak değiştirme
  3. Düzenleyicideki komut dosyasını aşağıdaki gibi güncelleyin:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Projeyi kaydet'i tıklayın.

Daha fazla bilgi için Proje oluşturma ve silme başlıklı makaleyi inceleyin.

3. AppSheet uygulaması oluşturma

Ardından, kopyalanan örnek Google E-Tablosu'na dayalı yeni bir AppSheet uygulamasını hızlıca oluşturur ve daha önce oluşturduğunuz Apps Komut Dosyası projesini çağırmak için güncellersiniz.

  1. Shirt Orders Example (Gömlek Siparişleri Örneği) e-tablosunu açın ve ardından Kopyasını oluştur'u tıklayarak bir kopyasını indirip Google E-Tablolar'da açın. İsterseniz e-tablonun adını değiştirebilirsiniz (ör. "Gömlek Siparişleri").
  2. AppSheet'te oturum açın.
  3. Uygulamalarım sayfasında + Yeni uygulama oluştur'u tıklayın. Yeni uygulama oluştur iletişim kutusu gösterilir.
  4. Kendi verilerinizle başlayın'ı tıklayın. Yeni uygulama oluşturma iletişim kutusu.
  5. İsteğe bağlı olarak, uygulama adını düzenleyin ve bir kategori seçin.
  6. Verilerinizi seçin'i tıklayın.

Yeni uygulama oluşturma iletişim kutusunda "Verilerinizi seçin"i belirleyin.

  1. Google Drive'ınıza erişmek için google'ı tıklayın.
  2. Daha önce kopyaladığınız Shirt Orders (Gömlek Siparişleri) e-tablosuna gidin ve bu e-tabloyu seçin.

AppSheet, uygulamanızı oluşturur. Oluşturulan uygulama için ilk önizleme penceresi.

  1. Uygulamayı AppSheet Editor'da açmak için Uygulamanızı özelleştirin'i tıklayın.

4. Otomasyon oluşturma

Ardından, bir AppSheet otomasyonu oluşturup komut dosyasını çağırmasını sağlarsınız.

  1. Otomasyon > Botlar'ı seçin.
  2. + Yeni Bot'u tıklayın.
  3. Öneri listesindeki ilk öğeyi seçin: Shirt Orders kaydı oluşturulduğunda veya güncellendiğinde bildirim gönder.

5037cdd726e326e9.png

  1. Düzenlemek için Bildirim gönder adımını tıklayın.
  2. Adı Call a script olarak değiştirin.

Bir komut dosyasını çağırmak için otomasyon adımları.

  1. Ayarlar bölümünde görev türünü Komut dosyası çağırma olarak değiştirin.

Otomasyon ayarlarında "Komut dosyası çağırma" görev türünü seçme

  1. Apps Komut Dosyası Projesi alanında Göz at'ı (Dosya simgesi) tıklayın.
  2. Drive'ınızda Hello World Apps Komut Dosyası projesine gidin ve bu projeyi seçin.
  3. Seç'i tıklayın ve yetkilendirmeniz istenirse Yetkilendir'i tıklayıp istemleri uygulayın.

Apps Komut Dosyası projesi eklenir ve İşlev Adı alanı, kullanılabilir işlevlerin listesiyle doldurulur.

  1. İşlev Adı listesinden logThis(msg) seçeneğini belirleyin. Açılır listeden Apps Komut Dosyası işlevi "logThis()" seçilir.

İşlev Bağımsız Değişkenleri alanı gösterilir.

  1. msg bağımsız değişkeni için İfade Asistanı'nı kullanarak şu ifadeyi girin: "Hello from AppSheet"

Apps Komut Dosyası işlev çağrısına bağımsız değişken ekleme.

  1. Uygulamayı kaydetmek için Kaydet'i tıklayın.
  2. Önizleme panelinde, uygulama emülatörünü görüntülemek için mobil veya tablet simgesini tıklayın.

68471f4646fc8fbe.png

  1. Yeni bir gömlek siparişi ekleyin ve Kaydet'i tıklayın.
  2. Değişikliklerinizi senkronize etmek için Senkronize et'i tıklayın.

Veri kaynağıyla senkronize etmek için önizleme panelinin sağ üst kısmındaki senkronizasyon simgesini tıklayın.

5. Apps Komut Dosyası'nın yürütülmesini onaylama

Komut dosyası çağrıldıktan sonra Apps Komut Dosyası Düzenleyicisi'ne dönün ve yürütülmesini onaylayın.

  1. Apps Komut Dosyası ana sayfasına dönün ve Hello World projesini görüntüleyin.
  2. logThis işlevinin başarıyla tamamlandığını onaylamak için gezinme çubuğunda Yürütmeler'i tıklayın. Günlük görünmediyse Yenile'yi tıklayın.

Apps Komut Dosyası düzenleyici ortamında yürütme günlüklerini görüntüleyerek işlevin AppSheet çağrısından yürütülüp yürütülmediğini kontrol etme.

6. İsteğe bağlı ek adımlar

Bu atölye çalışmasında ek bir adım olarak Apps Komut Dosyası Örnekleri projesini inceleyin ve AppSheet'teki örneklerden bazılarını çalıştırın.

Apps Komut Dosyası örneklerini kullanmaya başlama

  1. Başlamak için önce Apps Komut Dosyası Örnekleri Projesi'nin bir kopyasını oluşturun.
  2. Kopyala simgesini tıklayın.
  3. Yeni projeyi kaydedin ve projedeki uygulamaları yetkilendirmek için Çalıştır'ı tıklayın.

Örneklerin birkaçıyla denemeler yapın

  • createCalendarEvent() - Yeni bir takvim etkinliği oluşturun.
  • createDoc() - Otomatik olarak yeni bir doküman oluşturun.
  • createSheet(): Yeni bir sayfa oluşturun.
  • createSlideDeck() - Resim ve metin kullanarak yeni bir slayt destesi oluşturun.

Bu önemli özellik hakkında daha fazla bilgi edinmek için Otomasyondan Apps Komut Dosyası'nı çağırma başlıklı makaleyi inceleyin. Bu makalede ayrıntılı bir genel bakış, özellik videosu, eğitimler ve birçok AppSheet-Apps Komut Dosyası çalışma örneği içeren, kopyalanabilir bir Apps Komut Dosyası projesi yer almaktadır.