DataWorks'te çalışma alanı düzeyinde zorunlu kod incelemesini etkinleştirebilirsiniz. Bu özellik etkinleştirildiğinde, bir Geliştirici'nin gönderdiği düğüm kodunun dağıtımdan önce bir inceleyici tarafından onaylanması gerekir. Yüksek öncelikli görevlerin kod kalitesini sağlamak ve dağıtım hatalarının diğer görevleri engellemesini önlemek için kod incelemesi kapsamını belirtebilirsiniz. Bu konuda kod incelemesi özelliğinin nasıl kullanılacağı açıklanmaktadır.
Ön koşullar
DataWorks Professional Edition veya daha üst bir sürüm etkinleştirilmiş olmalıdır. Farklı DataWorks sürümlerindeki özelliklerin karşılaştırması için bkz. DataWorks sürümleri. DataWorks'ü etkinleştirmek için bkz. Faturalama.
Workspace Administrator rolüne sahip olmanız gerekir. Daha fazla bilgi için bkz. Kullanıcılar, roller ve izinler.
Veri geliştirme için bir düğüm oluşturmuş olmanız gerekir. Daha fazla bilgi için bkz. DataStudio'da veri geliştirme (eski).
Arka plan bilgileri
DataWorks'te birden çok görev eş zamanlı çalıştığında yüksek öncelikli görevler kaynaklara öncelikli erişir. Yüksek öncelikli görevler için kod incelemesini zorunlu kılmanızı öneririz. Bu yaklaşım, uyumsuz kodların kaynakları boşa harcamasına ve diğer görevleri engellemesine neden olan hataları önler. Bu görevleri zorunlu kod inceleme kapsamına ekleyerek inceleyiciler kod kalitesini doğrulayabilir ve hataların üretim ortamına dağıtılmasını engelleyebilir.
Aşağıdaki tabloda zorunlu kod incelemesinin etkinleştirilmesinin düğüm gönderme ve dağıtım sürecini nasıl etkilediği açıklanmaktadır.
|
Zorunlu kod inceleme durumu |
Açıklama |
İşlemler üzerindeki etkisi |
|
Devre dışı |
Bir düğümü gönderirken değişiklik hakkında bilgilendirmek üzere isteğe bağlı olarak inceleyicileri belirtebilirsiniz. Not
Bu yöntemi, rollerinden bağımsız olarak çalışma alanındaki herhangi bir üyeyi düğüm değişiklikleri hakkında bilgilendirmek için kullanabilirsiniz. |
Bu ayar düğümün gönderme ve dağıtım sürecini etkilemez. Düğümü normal şekilde gönderebilir ve dağıtabilirsiniz. |
|
Etkin |
Bir düğümü gönderirken kod kalitesini sağlamak amacıyla kod incelemesi yapmak üzere nitelikli bir inceleyici seçmeniz gerekir. Not
Bir düğüm silme işleminin gönderilmesi kod incelemesini tetiklemez. |
Bu işlem, kod incelemesi beklenirken düğümün gönderme ve dağıtım sürecini engeller.
|
Sınırlamalar
Kod incelemesi özelliği yalnızca DataWorks Professional Edition veya daha üst bir sürümde kullanılabilir.
Bir çalışma alanı için kod incelemesini yalnızca Workspace Administrator rolüne sahip kullanıcılar etkinleştirebilir veya devre dışı bırakabilir.
Bileşik düğümler (örneğin for-each ve döngü düğümleri) ve Python olmayan kaynak dosyaları gibi belirli düğüm türleri için kod incelemesi desteklenmez.
İş akışı
Aşağıdaki tabloda zorunlu kod incelemesini kullanma iş akışı açıklanmaktadır.
|
Adım |
Rol |
Açıklama |
|
Zorunlu kod incelemesini etkinleştirin ve inceleme ayarlarını yapılandırın |
Workspace Administrator |
Workspace Administrator, iş gereksinimlerine göre zorunlu kod incelemesini etkinleştirir; inceleyicileri ve inceleme kapsamını yapılandırır. Özellik yalnızca etkinleştirildikten sonra çalışır. Not
Zorunlu kod incelemesinin etkinleştirilmesi etkilenen düğümlerin gönderme ve dağıtım sürecini engeller. |
|
Geliştirici |
Bir Geliştirici, bir düğümü gönderirken kod incelemesini tetikler. Bir inceleyici seçildikten sonra sistem bir kod inceleme bileti oluşturur. Not
Standart moddaki bir çalışma alanında Geliştiriciler Deploy sayfasında toplu olarak kod incelemeleri başlatabilir. Daha fazla bilgi için bkz. Düğümleri dağıtma. |
|
|
Düğüm göndereni ve kod inceleyicileri Code Review sayfasından başlatılan ve bekleyen incelemeleri görüntüleyip yönetebilir. |
Zorunlu kod incelemesini etkinleştirme ve yapılandırma
DataWorks konsolu adresine gidin. Hedef bölgede sol gezinme bölmesinde seçeneğine tıklayın. Açılır listeden bir çalışma alanı seçin ve Go to Data Development öğesine tıklayın.
-
Security Settings and Others sayfasına gidin.
DataStudio sayfasında Configure sayfasına gitmek için sol alt köşedeki
simgesine tıklayın.Configure sayfasında Security Settings and Others sekmesine tıklayarak Security Settings and Others sayfasına gidin.
-
Zorunlu kod incelemesini etkinleştirin ve yapılandırın.
Code Review bölümünde Force to review code anahtarını açın ve ardından inceleyicileri ile temel çizgi kapsamını yapılandırın.
Parametre
Açıklama
Force to review code
Geçerli çalışma alanındaki belirtilen kapsam dahilindeki düğümler için kod incelemesini zorunlu kılar.
-
Open: Bu çalışma alanındaki düğümlerin kodu dağıtımdan önce zorunlu kod incelemesi gerektirir. İnceleyicileri belirtmeniz gerekir ve kod ancak incelemeyi geçtikten sonra dağıtılabilir. Bu işlem düğümün gönderme ve dağıtım sürecini engeller.
NotCode reviewers ve Baseline scopes for code review seçeneklerini yalnızca Force to review code anahtarını açtıktan sonra yapılandırabilirsiniz.
-
Close: Bu çalışma alanındaki düğümlerin kodunu kod incelemesi olmadan dağıtabilirsiniz. Bir düğümü gönderirken inceleyicileri isteğe bağlı olarak seçmeye devam edebilirsiniz; ancak bu yalnızca bir bildirim işlevi görür ve dağıtım sürecini engellemez.
Code reviewers
Bir düğüm gönderilirken inceleyici seçimi için ilkeyi ayarlar.
-
Any Developer Role: Kod incelemesi başlatıldıktan sonra çalışma alanındaki Developer rolüne sahip herhangi bir kullanıcı değişikliği onaylayabilir. Düğümü gönderen kullanıcı belirli inceleyiciyi seçer.
-
Specify development role users: Kod incelemesi başlatıldıktan sonra yalnızca belirtilen Developer rolüne sahip kullanıcılar değişikliği onaylayabilir. DataWorks bir düğümü gönderdiğinizde burada yapılandırılan inceleyicileri varsayılan olarak seçer.
Not-
İnceleyici olarak yalnızca geçerli çalışma alanındaki Developer rolüne sahip kullanıcıları seçebilirsiniz.
-
Birden çok inceleyici yapılandırırsanız onay mantığı seçtiğiniz ilkeye bağlıdır.
Baseline scopes for code review
Gönderim sırasında hangi düğümlerin kod incelemesi gerektirdiğini tanımlar.
Temel çizgi önceliğine göre zorunlu kod incelemesi gerektiren düğümleri seçebilirsiniz. Mantık şu şekildedir:
-
İnceleme kapsamını temel çizgi dışı görevler olarak ayarlarsanız çalışma alanında yeni oluşturulan görevler onay gerektirir.
-
İnceleme kapsamını belirli bir temel çizgi düzeyindeki görevler olarak ayarlarsanız o temel çizgideki düğümler gönderim sırasında onay gerektirir.
-
Daha yüksek bir temel çizgi numarası daha yüksek öncelik anlamına gelir. Temel çizgi görevleri temel çizgi dışı görevlere göre daha yüksek önceliğe sahiptir.
Temel çizgilerin görev önceliğini nasıl kontrol ettiği hakkında daha fazla bilgi için bkz. Smart Baseline genel bakış.
-
Kod incelemesi başlatma
Bir Geliştirici bir düğümü gönderirken bir veya daha fazla inceleyici belirtebilir. Kod inceleme süreci aşağıdaki tabloda gösterildiği gibi çalışma alanı moduna göre değişir.
Zaten devam eden bir incelemesi olan bir düğüm için yeni bir inceleme başlatılırsa DataWorks önceki incelemeyi otomatik olarak geçersiz kılar.
Bir düğüm silme işleminin gönderilmesi kod incelemesini tetiklemez.
|
Çalışma alanı modu |
İnceleme süreci |
Kod inceleme giriş noktaları |
|
Standard mode |
Zorunlu kod incelemesi etkinse inceleme başarılı olana kadar gönderme ve dağıtım süreci engellenir. Onaylandıktan sonra düğüm gönderilir ve dağıtmak için Deploy sayfasına ilerleyebilirsiniz. |
|
|
Simple mode |
Zorunlu kod incelemesi etkinse bir düğümü gönderirken Only Initiate Code Review seçeneğini belirleyin. İnceleme başarılı olduktan sonra düğüm kodunu üretim ortamına dağıtmak için düğümü tekrar göndermeniz gerekir. |
|
Kod inceleme biletlerini görüntüleme ve onaylama
-
Code Review sayfasına gidin.
Code Review sayfasına aşağıdaki yollardan biriyle gidebilirsiniz:
DataStudio sayfasının sol üst köşesindeki
simgesine tıklayın ve seçeneğini belirleyin.Hedef düğümün düzenleme sayfasında araç çubuğundaki
Kod İncelemesi simgesine tıklayın.
-
Kod inceleme biletini görüntüleyin ve işleme alın.
Code Review sayfasında başlattığınız veya size atanan incelemelerin listesini görüntüleyebilir ve gerektiğinde işleme alabilirsiniz.
Alan
Açıklama
1 (Sekmeler)
Bu alanda aşağıdaki işlemleri yapabilirsiniz:
-
İnceleyiciler Review by Me sekmesinde kendilerine atanan inceleme görevlerini görüntüleyip işleme alabilir.
-
Gönderenler Submitted by Me sekmesinde başlattıkları inceleme görevlerini görüntüleyebilir.
2
Bu alanda kod inceleme biletlerini inceleme durumu, bilet adı, türü, gönderen ve gönderim zamanı gibi ölçütlere göre filtreleyebilirsiniz.
3
Bu alanda sürüm ve inceleme durumu gibi bir kod inceleme biletinin temel bilgilerini görüntüleyebilir veya incelemeyi işlemek üzere ayrıntılarını açabilirsiniz.
Temel işlemler şunlardır:
-
Sürüm karşılaştırması: Değişiklikleri hızlıca anlamak için düğüm sürümleri arasındaki kod farklarını karşılaştırın.
-
Bir bilet üzerinde inceleyici işlemleri:
-
Write a comment: Düğüm sürümüne bir yorum ekleyin.
-
Passed: Bu işlem kod inceleme denetleyicisini tetikler. Denetim başarılı olduktan sonra gönderen görevi Deploy sayfasından dağıtabilir.
NotBir görevin nasıl dağıtılacağı hakkında daha fazla bilgi için bkz. Düğümleri dağıtma.
-
Not through: Sonuç zorunlu kod incelemesinin etkin olup olmadığına bağlıdır. Etkinse gönderme ve dağıtımı engeller. Devre dışıysa düğümü yine de gönderebilir ve dağıtabilirsiniz.
-
Abandoned: Geçerli inceleme sürecini terk eder. Süreç terk edildikten sonra düğüm sürümünü gönderebilir ve dağıtabilirsiniz.
-
Reopen: Terk edilmiş bir inceleme sürecini yeniden incelemeniz gerekirse Reopen seçeneğini kullanabilirsiniz.
-
-