Bir komut dosyası, bağımsız bir komut dosyası olarak değil de bir Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar dosyasına bağlıdır. Bağlı bir komut dosyasının eklendiği dosyaya "kapsayıcı" adı verilir. Bağlı komut dosyaları genellikle bağımsız komut dosyaları gibi davranır ancak Google Drive'da görünmezler, bağlı oldukları dosyadan ayrılamazlar ve üst dosyaya göre birkaç özel ayrıcalık elde ederler.
Komut dosyalarının Google Sites'a da bağlı olabileceğini, ancak bu komut dosyalarının neredeyse her zaman web uygulamaları olarak dağıtıldığını unutmayın. Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar'a bağlı komut dosyaları da nadiren web uygulamaları haline gelebilir.
Bağlı komut dosyası oluşturma
Google Dokümanlar, E-Tablolar veya Slaytlar
Google Dokümanlar, E-Tablolar veya Slaytlar'da bağlı bir komut dosyası oluşturmak için Dokümanlar'da bir doküman, E-Tablolar'da bir e-tablo ya da Slaytlar'da bir sunu açın ve Uzantılar > Apps Komut Dosyası'nı tıklayın. Komut dosyasını ileride yeniden açmak için aynı şeyi yapın veya Apps Komut Dosyası kontrol panelinden komut dosyasını açın.
Google Forms
Google Formlar'da bağlı bir komut dosyası oluşturmak için bir form açıp Diğer > Komut dosyası düzenleyicisi'ni tıklayın. Komut dosyasını ileride yeniden açmak için aynı şeyi yapın veya Apps Komut Dosyası kontrol panelinden komut dosyasını açın.
Özel yöntemler
Bağlı komut dosyaları, bağımsız komut dosyalarının yapamayacağı birkaç yöntemi çağırabilir:
getActiveSpreadsheet()
,getActiveDocument()
,getActivePresentation()
vegetActiveForm()
bağlı komut dosyalarının, dosya kimliğine bakmadan üst dosyaya başvurmasına izin verir.getUi
, bağlı komut dosyalarının özel menüler, iletişim kutuları ve kenar çubukları eklemek için üst dosyalarının kullanıcı arayüzüne erişmesine izin verir.- Google E-Tablolar'da
getActiveSheet()
,getActiveRange()
vegetActiveCell()
komut dosyasının kullanıcının mevcut sayfasını, seçilen hücre aralığını veya seçilen tek bir hücreyi belirlemesine izin verir.setActiveSheet(sheet)
vesetActiveRange(range)
komut dosyasının bu seçimleri değiştirmesine izin verin. - Google Dokümanlar'da
getCursor()
vegetSelection()
komut dosyası, kullanıcının imlecinin veya seçilen metnin yerini belirler.setCursor(position)
vesetSelection(range)
komut dosyasının bu konumları değiştirmesine izin verin.
Daha fazla bilgi için Google E-Tablolar'ı genişletme kılavuzuna veya Google Dokümanlar'ı genişletme kılavuzuna bakın.
Özel menüler, iletişim kutuları ve kenar çubukları
Bağlı komut dosyaları, özel menüler ve iletişim kutuları veya kenar çubukları ekleyerek Google E-Tablolar, Dokümanlar ve Formlar'ı özelleştirebilir. Bununla birlikte, bir komut dosyasının yalnızca açık bir dosyanın geçerli örneğinin kullanıcı arayüzüyle etkileşim kurabileceğini unutmayın. Yani bir belgeye bağlı komut dosyası, başka bir dokümanın kullanıcı arayüzünü etkileyemez.
Eklentiler
Eklentiler; Gmail, Google E-Tablolar, Dokümanlar, Slaytlar ve Formlar'da çalışır. Bağlanmış veya bağımsız bir komut dosyası geliştirdiyseniz ve bunu tüm dünyayla paylaşmak istiyorsanız Apps Komut Dosyası, diğer kullanıcıların eklenti mağazasından yükleyebileceği bir eklenti olarak komut dosyanızı publish olanak tanır.
Tetikleyiciler
Bağlı komut dosyaları, bir dosya düzenleme erişimine sahip bir kullanıcı tarafından her açıldığında otomatik olarak çalışan özel onOpen()
işlevi gibi basit tetikleyiciler kullanabilir. Tüm komut dosyası türleri gibi yüklenebilir tetikleyicileri de kullanabilirler.
Özel işlevler
Özel işlev, Google E-Tablolar'a bağlı bir komut dosyasında bulunan ve =myFunctionName()
söz dizimini kullanarak doğrudan bir hücreden çağırdığınız bir işlevdir. Bu nedenle özel işlevler, E-Tablolar'daki AVERAGE
veya SUM
gibi yüzlerce yerleşik işleve benzer. Tek fark, özel işlevin davranışını sizin tanımlamanızdır.
Bağlı komut dosyalarına erişim
Yalnızca kapsayıcıyı düzenleme izni olan kullanıcılar bağlı komut dosyasını çalıştırabilir. Yalnızca görüntüleme erişimi olan ortak çalışanlar, komut dosyası düzenleyiciyi açamaz. Ancak, kapsayıcı dosyanın bir kopyasını oluştururlarsa kopyanın sahibi olurlar ve komut dosyasının bir kopyasını görüp çalıştırabilirler.
Komut dosyasının kapsayıcı dosyasını nasıl paylaşacağınızı öğrenmek için Google Drive'dan dosya paylaşma bölümüne bakın.