Kapsayıcıya Bağlı Komut Dosyaları

Bir komut dosyası, bağımsız komut dosyası olarak değil de bir Google E-Tablolar, Dokümanlar, Slaytlar veya Formlar dosyasından oluşturulmuşsa bu dosyaya bağlıdır. Bağlı bir komut dosyasının eklendiği dosyaya "kapsayıcı" denir. Bağlı komut dosyaları, Google Drive'da görünmemeleri, bağlı oldukları dosyadan ayrılamamaları ve üst dosyaya göre bazı özel ayrıcalıklar kazanmaları dışında genellikle bağımsız komut dosyaları gibi davranır.

Komut dosyalarının Google Sites'a da bağlanabileceğ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 web uygulaması haline gelebilir ancak bu durum nadir görülür.

Not: Bağlı komut dosyaları, bağlandıkları dosya için işlev gören, yayınlanmamış eklentilerdir.

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-tabloyu veya Slaytlar'da bir sunuyu açın ve Uzantılar > Apps Komut Dosyası'nı tıklayın. Senaryoyu gelecekte yeniden açmak için aynı işlemi yapın veya senaryoyu Apps Script kontrol panelinden açın.

Google Formlar

Google Formlar'da bağlı bir komut dosyası oluşturmak için bir formu açın ve Diğer > Komut Dosyası Düzenleyici'yi tıklayın. Senaryoyu gelecekte yeniden açmak için aynı işlemi yapın veya senaryoyu Apps Komut Dosyası kontrol panelinden açın.

Not: clasp aracı bağlı komut dosyaları oluşturamaz ancak bunları klonlayabilir ve düzenleyebilir.

Özel yöntemler

Bağlı komut dosyaları, bağımsız komut dosyalarının çağıramadığı birkaç yöntemi çağırabilir:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation(), ve getActiveForm() bağlı komut dosyalarının, dosyanın kimliğine başvurmadan üst dosyalarına başvurmasına olanak tanır.
• getUi, bağlı komut dosyalarının özel menüler, iletişim kutuları ve kenar çubukları eklemek için üst dosyasının kullanıcı arayüzüne erişmesine olanak tanır.
• Google E-Tablolar'da getActiveSheet(), getActiveRange(), ve getActiveCell() komut dosyası tarafından kullanıcının mevcut e-tablosu, seçili hücre aralığı veya seçili tek hücrenin belirlenmesine olanak tanır. setActiveSheet(sheet) ve setActiveRange(range) komut dosyasının bu seçimleri değiştirmesine izin verin.
• Google Dokümanlar'da getActiveTab(), getCursor() ve getSelection() komut dosyasına kullanıcının mevcut sekmesini, imlecinin konumunu veya seçili metni belirleme izni verir. setActiveTab(tabId), setCursor(position) ve setSelection(range) seçeneklerini belirleyerek komut dosyasının bu seçimleri değiştirmesine izin verin.

Daha fazla bilgi için Google E-Tablolar'ı genişletme rehberine veya Google Dokümanlar'ı genişletme rehberine bakın.

Not: Bu yöntemler yalnızca komut dosyası düzenleyiciden, menü öğelerinden, iletişim kutularından, kenar çubuklarından veya tetikleyicilerden çalıştırılan bağlı komut dosyalarında kullanılabilir. Bağlı bir komut dosyası web uygulaması olarak veya Apps Script API aracılığıyla çalıştırıldığında bu yöntemler kullanılamaz.

Ö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. Ancak bir komut dosyasının yalnızca açık bir dosyanın mevcut örneğinin kullanıcı arayüzüyle etkileşimde bulunabileceğini unutmayın. Yani bir dokümana bağlı bir komut dosyası, başka bir dokümanın kullanıcı arayüzünü etkileyemez.

Eklentiler özel menüler, iletişim kutuları ve kenar çubukları da ekleyebilir. Eklentileri bağımsız komut dosyaları kullanarak geliştirmeniz önerilir.

Tetikleyiciler

Bağlı komut dosyaları, düzenleme erişimi olan bir kullanıcı tarafından dosya 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 tetikleyiciler de kullanabilirler.

Özel işlevler

Özel işlev, Google E-Tablolar'a bağlı bir komut dosyasındaki işlevdir. Bu işlevi =myFunctionName() söz dizimini kullanarak doğrudan bir hücreden çağırırsınız. Bu nedenle özel işlevler, E-Tablolar'daki yüzlerce yerleşik işleve (ör. AVERAGE veya SUM) benzer ancak özel işlevin davranışını siz tanımlarsınız.

Bağlı komut dosyalarına erişim

Yalnızca bir kapsayıcıyı düzenleme izni olan kullanıcılar, kapsayıcının 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 kopyasını oluştururlarsa kopyanın sahibi olurlar ve komut dosyasının kopyasını görebilir ve çalıştırabilirler.

Bir komut dosyasının kapsayıcı dosyasını nasıl paylaşacağınızı öğrenmek için Google Drive'dan dosya paylaşma başlıklı makaleyi inceleyin.

Tüm kapsayıcıya bağlı komut dosyaları, kapsayıcı dosyası için tanımlanan aynı sahip, görüntüleyici ve düzenleyici erişim listesini kullanır. Kapsayıcı sahibi, kimin oluşturduğuna bakılmaksızın yeni bir komut dosyası projesinin sahipliğini alır.