Webclient'te Önceden doldurulmuş değerleri Düzenleme
Düzenle, proje katmanında saklanan önceden doldurulmuş değeri günceller — aynı şablondan oluşturulan her yeni Belgeleme için varsayılan olarak kullanılır. Düzenle tek başına mevcut Belgelemeleri yeniden yazmaz; bu Uygula'nın işidir.
Sparkify'ın Önceden doldurulmuş değerler özelliği, belgeleme alanı varsayılanlarını bir kez ayarlamanıza ve uygulanan her yerde otomatik olarak doldurulmalarını sağlamanıza olanak tanır. Düzenle, Webclient'in proje katmanında, proje düzeyindeki önceden doldurulmuş değerin kendisini güncellemek istediğinizde ulaştığınız eylemdir — mevcut önceden doldurmayı bir kalem simgesi aracılığıyla açın, yeni değeri yazın ve onaylayın. Yeni değer, proje düzeyindeki önceden doldurma olarak saklanır ve bundan sonra aynı şablondan oluşturulan her yeni Belgeleme için varsayılan haline gelir.
Düzenle, projedeki mevcut Belgelemeleri yeniden yazmaz. Yalnızca proje katmanında saklanan önceden doldurmayı günceller. Yeni değeri projede zaten bulunan Belgelemelere de yaymak için — yani her birinde alanı yeniden yazmak için — bir Sahip veya Yönetici, Uygula'yı ayrı bir adım olarak çalıştırmalıdır.
Kim kullanabilir
Webclient'te Düzenle, Sahipler, Yöneticiler ve Kullanıcılar için kullanılabilir. Üçü de şimşek simgesini ve proje bilgi kartındaki Önceden doldurulmuş değerler düğmesini görür ve açılır menünün içinde Önceden doldurulmuş değerleri düzenle seçeneğini bulur. Yalnızca Misafirler hariç tutulur. Düzenle, Kullanıcı rolüne açıktır çünkü eylemin kendisi düşük etkilidir: yalnızca proje düzeyindeki önceden doldurma değerini günceller; mevcut Belgelemeleri yeniden yazmaz. (O ikinci adım, Sahipler ve Yöneticilerle sınırlı olan Uygula'dır.) Misafirseniz ve proje düzeyinde bir önceden doldurulmuş değerin düzenlenmesi gerekiyorsa, bir Sahip, Yönetici veya Kullanıcıdan bunu çalıştırmasını isteyin.
Düzenle nerede görünür
Webclient'in proje katmanındaki Düzenle, üst çubuktaki şimşek simgesi veya proje bilgi kartındaki Önceden doldurulmuş değerler düğmesi aracılığıyla ulaşılır — her ikisi de iki seçenekli aynı açılır menüyü açar: Önceden doldurulmuş değerleri uygula ve Önceden doldurulmuş değerleri düzenle. Workspace katmanı da workspace kapsamında aynı şeyi yapan bir Düzenle seçeneğine sahiptir: bundan sonraki yeni Belgelemeler için varsayılan olarak kullanılan workspace genelindeki önceden doldurma değerini günceller. Ne Workspace katmanındaki Düzenle ne de proje katmanındaki Düzenle mevcut Belgelemeleri yeniden yazar — bu Uygula'nın işidir.
Giriş noktalarının adım adım açıklamaları ve ekran görüntüleri için ana makaleye bakın: Önceden doldurulmuş değerler.
Düzenle ne yapar
Düzenle, mevcut proje düzeyindeki önceden doldurmayı bir kalem simgesi aracılığıyla açmanıza ve doğrudan yeni bir değer yazmanıza olanak tanır. Onayladığınızda, yeni değer proje katmanında saklanır ve bundan sonra aynı şablondan oluşturulan her yeni Belgeleme için varsayılan olarak kullanılır. Projedeki mevcut Belgelemelere bir Düzenle ile dokunulmaz; oluşturulduklarında sahip oldukları değeri korurlar.
Onay adımı
Düzenle'nin onayı basit bir başarı bildirimidir. Yeni değeri yazdıktan ve onayladıktan sonra Önceden doldurulmuş değer güncellendi mesajını göreceksiniz — ve bu kadar. Kapsam önizlemesi yok, toplu yeniden yazma yok, yayılma adımı yok. Yeni değer artık proje düzeyindeki önceden doldurmadır, aynı şablondan oluşturulan her yeni Belgeleme için varsayılan olarak kullanılır.
Projedeki mevcut Belgelemelerin de yeni değerle yeniden yazılmasını istiyorsanız, bu ayrı bir eylemdir: bir Sahip veya Yönetici, Uygula'yı çalıştırmalıdır; bu, kendi kapsam-önizlemeli onayı ile proje geneli yeniden yazmayı tetikler.
Düzenle mi, Uygula mı?
Düzenle ve Uygula farklı etkilere sahip iki ayrı akıştır.
- Düzenle, yeni bir değeri proje düzeyindeki önceden doldurma olarak saklar. Onayladıktan sonra "Önceden doldurulmuş değer güncellendi" onayını alırsınız — ve bu kadar. Bundan sonra şablondan oluşturulan yeni Belgelemeler yeni değerle başlar, ancak projedeki mevcut Belgelemelere dokunulmaz.
- Uygula, seçilen şablonu kullanan projedeki her mevcut Belgelemede değeri yeniden yazandır. Bir Sahip veya Yönetici, Uygula akışını açar, Belgeleme Şablonunu seçer, alanları ve değerleri seçer ve onaylar — bu noktada proje geneli yeniden yazma gerçekleşir.
Düzenle ve Uygula farklı akışlardır. Önceden doldurulmuş değerleri proje düzeyinde Düzenlemek ve önceden doldurulmuş değerleri Uygulamak bağımsız adımlardır. Yalnızca ileriye dönük varsayılanı değiştirmeniz gerekiyorsa Düzenle yeterlidir; mevcut Belgelemeleri de yeniden yazmak için bir Sahip veya Yöneticiden Uygula'yı çalıştırmasını isteyin (Kullanıcılar Düzenle'yi çalıştırabilir ancak Uygula'yı çalıştıramaz).
Düzenle mi, Uygula mı: hangi adım yüksek etkili olan?
Düzenle tek başına düşük etkilidir — yalnızca bundan sonra yeni Belgelemeler için varsayılan olarak kullanılan proje düzeyindeki önceden doldurulmuş değeri günceller. Mevcut Belgelemelere dokunulmaz, bu yüzden bir düzenleme hatasını geri almak kolaydır: sadece Düzenle'yi tekrar açın ve önceki değeri yazın.
Yüksek etkili adım, seçilen şablonu kullanan projedeki her mevcut Belgelemede aynı alanı yeniden yazan Uygula'dır. Uygula'nın geri al düğmesi yoktur — bir Uygula onayı yazıldıktan sonra geri dönüşün tek yolu Uygula'yı önceki değerle yeniden çalıştırmaktır. (Bir Sahip veya Yönetici olarak) bir Düzenle'yi bir Uygula ile zincirlemeyi planlıyorsanız, bir yazım hatasını yakalama anı, Uygula'nın kapsam-önizlemeli onayındadır, sonradan değil.