Bir dokümandan oluşturulan komut dosyaları, bağımsız komut dosyası olarak oluşturulmadıkları sürece Google E-Tablolar, Google Dokümanlar, Google Slaytlar veya Google Formlar dosyalarına bağlıdır. Bağlı bir komut dosyasının eklendiği dosyaya "kapsayıcı" adı verilir. 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ı Google Sites'a da bağlanabilir ancak bu komut dosyaları neredeyse her zaman web uygulamaları olarak dağıtılır. E-Tablolar, Dokümanlar, Slaytlar veya Formlar'a bağlı komut dosyaları da web uygulaması haline gelebilir ancak bu durum nadirdir.
Bağlı komut dosyaları, bağlı oldukları dosya için çalışan Google Workspace eklentileri olarak kabul edilir.
Bağlı komut dosyası oluşturma
Dokümanlar, E-Tablolar, Slaytlar ve Formlar'da bağlı komut dosyaları oluşturabilirsiniz.
Dokümanlar, E-Tablolar veya Slaytlar
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 veya 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ı işlemi yapın veya komut dosyasını Apps Komut Dosyası kontrol panelinden açın.
Formlar
Formlar'da bağlı bir komut dosyası oluşturmak için bir formu açın ve Diğer > Komut dosyası düzenleyicisi'ni tıklayın. Senaryoyu gelecekte yeniden açmak için aynı işlemi yapın veya senaryoyu Apps Komut Dosyası kontrol panelinden açın.
clasp aracı bağlı komut dosyaları oluşturamaz ancak bunları klonlayıp 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, vegetActiveFormbağ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.- E-Tablolar'da,
getActiveSheet,getActiveRange, vegetActiveCellkomut dosyasının kullanıcının geçerli sayfasını, seçili hücre aralığını veya seçili tek hücreyi belirlemesine olanak tanır.setActiveSheetvesetActiveRangekomut dosyasının bu seçimleri değiştirmesine izin verir. - Dokümanlar,
getActiveTab,getCursorvegetSelection'da komut dosyasının kullanıcının mevcut sekmesini, imlecinin konumunu veya seçili metni belirlemesine izin verin.setActiveTab,setCursorvesetSelectionkomut dosyasının bu seçimleri değiştirmesine izin verin.
Daha fazla bilgi için E-Tablolar'ı genişletme kılavuzu veya Dokümanlar'ı genişletme kılavuzu'na bakın.
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 Google Apps Komut Dosyası API kullanılarak çalıştırıldığında bu yöntemler kullanılamaz.
Özel menüler, iletişim kutuları ve kenar çubukları
Sınırlı komut dosyaları, özel menüler ve iletişim kutuları veya kenar çubukları ekleyerek E-Tablolar, Dokümanlar ve Formlar'ı özelleştirebilir. Bir komut dosyası yalnızca açık bir dosyanın mevcut örneğinin kullanıcı arayüzüyle etkileşimde bulunabilir. Bir dokümana bağlı olan komut dosyası, başka bir dokümanın kullanıcı arayüzünü etkileyemez.
Tetikleyiciler
Bağlı komut dosyaları, bir dosya düzenleme erişimi olan 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, bunlar da yüklenebilir tetikleyicileri kullanabilir.
Özel işlevler
Özel işlev, 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. Özel işlevler, E-Tablolar'daki AVERAGE veya SUM gibi yüzlerce yerleşik işleve benzer. Aralarındaki fark, özel işlevin davranışını sizin tanımlamanızdır.
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. Kapsayıcı dosyanın kopyasını oluşturursa kopyanın sahibi olur ve komut dosyasının kopyasını görebilir ve çalıştırabilir.
Bir komut dosyasının kapsayıcı dosyasını paylaşmayı öğrenmek için Drive'dan dosya paylaşma başlıklı makaleyi inceleyin.
Kapsayıcıya bağlı tüm 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.