Contoh skenario aturan kustom

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Artikel ini menyediakan contoh definisi aturan kustom. Semua aturan kustom ditentukan untuk jenis item kerja. Contoh disediakan untuk model proses XML Warisan dan Lokal.

Sebelum menambahkan aturan kustom, baca Aturan dan evaluasi aturan dan Tambahkan aturan ke jenis item kerja (Proses warisan).

Tentukan bidang yang diperlukan dependen

Anda dapat menentukan bahwa bidang hanya diperlukan ketika bidang lain berisi nilai tertentu. Dalam contoh berikut, ketika pelanggan melaporkan masalah, bidang Pelanggan Yang Dilaporkan kustom diatur ke True, dan bidang Tingkat Keparahan menjadi diperlukan. Jika masalah tidak dilaporkan oleh pelanggan, nilai untuk bidang Tingkat Keparahan tidak diperlukan.

Proses warisan

Proses XML lokal

Anda menentukan WHEN pernyataan aturan untuk definisi bidang di dalam bagian FIELDS definisi jenis item kerja.

<FIELDS>
   ...
   <FIELD refname="MyCorp.Severity" name="Customer Severity" type="String">  
       <ALLOWEDVALUES>  
           <LISTITEM value="Blocking" />  
           <LISTITEM value="Major" />  
           <LISTITEM value="Minor" />  
       </ALLOWEDVALUES>  
       <WHEN field="MyCorp.CustomerReported" value="true">  
           <REQUIRED />  
       </WHEN>  
   </FIELD> 
   ...
</FIELDS>     

Menghapus nilai bidang dependen

Contoh berikut mengilustrasikan penentuan aturan kustom untuk menghapus nilai untuk Poin Cerita saat perubahan dilakukan pada Tanggal Mulai.

Proses warisan

Proses XML lokal

Anda menentukan WHENCHANGED pernyataan aturan untuk definisi bidang di dalam bagian FIELDS definisi jenis item kerja.

<FIELDS>
 ...
   <FIELD name="Story Points" refname="Microsoft.VSTS.Scheduling.StoryPoints" type="Double" reportable="measure" formula="sum">
       <HELPTEXT>The size of work estimated for implementing this user story</HELPTEXT>
       <WHENCHANGED field="Microsoft.VSTS.Scheduling.StartDate">  
           <EMPTY />  
       </WHENCHANGED>
   </FIELD>
   ...
</FIELDS>     

Mengatur nilai bidang dependen

Contoh berikut mengilustrasikan cara memetakan nilai bidang Ukuran bergantung pada nilai yang dipilih untuk bidang kustom, bidang Ukuran Tee-Shirt.

Proses warisan

Daftar pilih Ukuran Tee-Shirt terdiri dari empat nilai Kecil, Sedang, Besar, dan X-Besar. Empat aturan kustom didefinisikan untuk menetapkan bidang Ukuran saat bidang Ukuran Tee-Shirt diubah menjadi nilai tertentu. Untuk menyederhanakan penggunaan, nilai default Ukuran Tee-Shirt adalah Kecil.

Dialog edit bidang untuk bidang Ukuran Tee-Shirt

Aturan kustom

Empat aturan kustom

Proses XML lokal

Anda menentukan nilai bidang Ukuran di bagian FIELDS definisi jenis item kerja. Anda menggunakan serangkaian WHEN pernyataan aturan untuk membuat pemetaan, mengatur nilai bidang Ukuran menggunakan COPY value="value" aturan.

<FIELDS>
   ...
   <FIELD name="Tee-Shirt Size" refname="Fabrikam.TShirt.Size" type="String">
        <HELPTEXT>Estimate of overall size for work to be done; Small (2), Medium (6), Large (18), X-Large (30).</HELPTEXT>
        <ALLOWEDVALUES expanditems="true">
          <LISTITEM value="Large" />
          <LISTITEM value="Medium" />
          <LISTITEM value="Small" />
          <LISTITEM value="X-Large" />
        </ALLOWEDVALUES>
   </FIELD> 
   <FIELD name="Size" refname="Fabrikam.Size" type="Integer">
        <HELPTEXT>Integer estimate of overall size for work to be done; Automatically fill in based on Tee-Shirt Size. Allow any value.</HELPTEXT>
        <WHEN field="Fabrikam.TShirt.Size" value="Small">
          <COPY value="2" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="Medium">
          <COPY value="6" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="Large">
          <COPY value="18" />
        </WHEN>
        <WHEN field="Fabrikam.TShirt.Size" value="X-Large">
          <COPY value="30" />
        </WHEN>
   </FIELD>
   ...
 </FIELDS> 

Memerlukan nilai bidang setelah perubahan Status

Contoh berikut menunjukkan bagaimana Anda bisa memerlukan spesifikasi bidang Sisa Kerja saat Status alur kerja tugas berubah menjadi Aktif.

Proses warisan

Proses XML lokal

Saat nilai bidang Status untuk item kerja diatur ke Aktif dan item kerja disimpan, nilai bidang Diaktifkan Oleh dan Ditetapkan Ke secara otomatis diatur ke nama pengguna saat ini. Pengguna tersebut harus menjadi anggota grup Pengguna Valid Server Team Foundation. Nilai bidang Tanggal Diaktifkan juga diatur secara otomatis. Contoh berikut menunjukkan elemen yang memberlakukan aturan ini:

<WORKFLOW>
. . .  
    <STATE value="Active">
        <FIELDS>
            <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
              <REQUIRED />
            </FIELD>
        </FIELDS>
    </STATE>
. . .  
</WORKFLOW>

Menghapus nilai bidang saat status tutup

Untuk mengotomatiskan menghapus bidang Sisa Pekerjaan saat menutup tugas, tentukan aturan kustom seperti yang ditunjukkan.

Proses warisan

Proses XML lokal

<WORKFLOW>
. . .  
      <STATE value="Closed">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Scheduling.RemainingWork">
              <EMPTY />
            </FIELD>
          </FIELDS>
      </STATE>
. . .  
</WORKFLOW>

Membatasi pembuatan item kerja menurut grup

Aturan kustom yang membatasi transisi ke kategori status Yang diusulkan dari jenis item kerja secara efektif melarang pembuatan item kerja dari jenis tersebut. Dengan menerapkan aturan ke grup tertentu, Anda secara efektif melarang grup tersebut membuat item kerja jenis tersebut.

Proses warisan

Aturan kustom berikut membatasi tim proyek untuk membuat item kerja sebagai peta kategori status Yang diusulkan ke status Alur kerja baru .

Proses XML lokal

Aturan kustom berikut membatasi Fabrikam Review Team (untuk atribut) agar tidak membuat item kerja dengan melarang transisi ke status Alur kerja baru .

<WORKFLOW>
... 
<TRANSITION from=" " to="New"  
   for="[Project]\Developers" 
   not="[Project]\Fabrikam Review Team"  
   . . .  
</TRANSITION> 
...  
</WORKFLOW>

Membatasi modifikasi item kerja menurut grup

Untuk proses Warisan, Anda dapat mencegah pengguna mengubah item kerja dengan mengatur izin tolak untuk grup di Jalur Area. Untuk proses XML Lokal, Anda dapat menempatkan pembatasan pada setiap status alur kerja untuk grup yang mencegah mereka menyimpan item kerja dalam status apa pun.

Proses warisan

Tidak dimungkinkan untuk menentukan aturan kustom yang membatasi modifikasi item kerja dari jenis tertentu. Anda hanya dapat menentukan pembatasan menurut status. Jika pengguna tidak mengubah status, maka mereka dapat mengubah bidang lain, kecuali semua bidang dibuat baca-saja untuk grup.

Sebagai gantinya, jika Anda ingin membatasi sekelompok pengguna untuk memodifikasi item kerja tertentu dari jenis apa pun, Anda dapat menetapkan item kerja tersebut ke Jalur Area. Tentukan grup keamanan, lalu atur batasan untuk mengedit item kerja untuk Jalur Area untuk grup tersebut seperti yang ditunjukkan pada gambar berikut. Untuk mempelajari selengkapnya, lihat Mengatur izin dan akses untuk pelacakan kerja, Membuat simpul turunan, dan memodifikasi item kerja di bawah jalur area

Proses XML lokal

Aturan kustom berikut membatasi Tim Tinjauan Fabrikam (untuk atribut) agar tidak mengubah cerita pengguna dengan melarang semua status alur kerja yang ditentukan untuk jenis item kerja cerita pengguna. Karena tidak ada status alur kerja yang valid untuk tim tertentu, anggota tim tersebut dicegah untuk menyimpan item kerja dengan perubahan apa pun.

<WORKFLOW>
... 
 <STATE value="New">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Active">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Resolved">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
<STATE value="Closed">  
   not="[Project]\Fabrikam Review Team"  
</STATE>  
...  
</WORKFLOW>

Membatasi transisi status

Untuk proses yang diwariskan, transisi status apa pun ditentukan secara otomatis. Ini memungkinkan pengguna untuk memajukan status alur kerja dari yang baru ke selesai, tetapi juga untuk bergerak mundur jika diperlukan. Saat menentukan aturan kustom untuk membatasi transisi, perlu diingat bahwa jika pengguna membuat kesalahan dalam memperbarui alur kerja, mereka mungkin tidak dapat memperbaikinya. Misalnya, mereka dapat memperbarui status dengan memindahkan kartu item kerja ke tahap selanjutnya di papan Kanban, tetapi tidak memindahkannya kembali.

Tip

Pertimbangkan untuk membatasi transisi status untuk beberapa tetapi tidak semua pengguna. Dengan begitu, jika pengguna membuat kesalahan, mereka dapat meminta anggota tim lain untuk mengatur ulang nilai Status untuk melewati pembatasan.

Sebelum menentukan aturan transisi status, tinjau Aturan dan evaluasi aturan, Aturan yang dihasilkan secara otomatis, dan Bagaimana status alur kerja dan kategori status digunakan dalam Backlog dan Papan.

Membatasi modifikasi item kerja tertutup

Bergantung pada proses bisnis, Anda mungkin ingin mencegah pengguna terus memodifikasi atau memperbarui item kerja yang telah ditutup atau diselesaikan. Anda dapat menambahkan aturan ke jenis item kerja untuk mencegah pengguna membuka kembali item kerja tertutup.

Proses warisan

Untuk proses Yang diwariskan, Anda dapat menambahkan aturan yang membatasi transisi status. Misalnya, aturan berikut membatasi transisi dari tertutup ke dua Status lainnya, Baru dan Aktif.

Catatan

Kondisi A work item state moved from ... ini tersedia untuk Azure DevOps Server 2020 dan versi yang lebih baru.

Catatan

Bergantung pada tindakan aturan yang Anda tentukan, tombol Simpan pada formulir item kerja dapat dinonaktifkan, atau pesan kesalahan ditampilkan saat pengguna terbatas mencoba mengubah item kerja.

Proses XML lokal

Untuk penyebaran lokal, Anda dapat menambahkan aturan ke jenis item kerja untuk mencegah pembukaan ulang setelah item kerja ditutup. Misalnya, aturan transisi alur kerja berikut memungkinkan Penguji membuka kembali item kerja, tetapi bukan anggota grup Pengembang.

<WORKFLOW>
. . .  
<TRANSITION from="Closed" to="New"  
   for="[Project]\Testers"  
   not="[Project]\Developers" 
   . . .  
</TRANSITION 
<TRANSITION from="Closed" to="Active"  
   for="[Project]\Testers"  
   not="[Project]\Developers" 
   . . .  
</TRANSITION 
. . .  
</WORKFLOW>

Menyembunyikan atau membatasi modifikasi bidang berdasarkan pengguna atau grup

Saat Anda memilih Current user is a member of group... atau Current user is not a member of group..., Anda bisa menyembunyikan bidang, membuat bidang baca-saja, atau membuat bidang yang diperlukan.

Misalnya, kondisi berikut menunjukkan bahwa bidang Justifikasi disembunyikan untuk anggota yang bukan milik grup Fabrikam Fiber\Voice.

Catatan

Item kerja tunduk pada aturan yang diterapkan padanya. Aturan kondisional berdasarkan keanggotaan pengguna atau grup di-cache untuk browser web Anda. Jika Anda merasa dibatasi untuk memperbarui item kerja, Anda mungkin telah menemukan salah satu aturan ini. Jika Anda yakin mengalami masalah yang tidak berlaku untuk Anda, lihat Masalah penembolokan formulir item kerja IndexDB.

Membatasi modifikasi bidang tertentu berdasarkan pengguna atau grup

Anda bisa mengkustomisasi tipe item kerja untuk membatasi siapa yang bisa mengubah bidang tertentu untuk jenis item kerja.

Proses warisan

Dengan menggunakan salah satu dari dua kondisi berikut, Anda dapat membuat bidang tertentu yang diperlukan untuk pengguna grup keamanan atau yang bukan anggota grup keamanan.

• current user is a member of a group...
• current user is not a member of a group...

Tip

Untuk menghindari masalah evaluasi aturan yang mungkin muncul, tentukan grup keamanan Azure DevOps dan bukan ID Microsoft Entra atau grup keamanan Direktori Aktif. Untuk mempelajari selengkapnya, lihat Aturan default dan mesin aturan.

Misalnya, Anda dapat membuat Judul atau bidang Status Baca-saja untuk pengguna atau grup tertentu.

Misalnya, bidang Prioritas , untuk jenis item kerja Cerita Pengguna, menjadi baca-saja untuk anggota grup Fabrikam Fiber\Voice. Saat pengguna grup ini membuka Cerita Pengguna, mereka tidak dapat mengubah nilai pada bidang Prioritas.

Proses XML lokal

Untuk model proses XML lokal, Anda dapat menyesuaikan jenis item kerja untuk mendukung permintaan pembatasan ini:

• Membatasi siapa yang bisa membuat atau mengubah item kerja
• Membatasi siapa yang dapat membuat jenis item kerja tertentu, seperti Epik atau Fitur

Misalnya, Anda dapat membatasi modifikasi item kerja dengan menambahkan aturan ke jenis item kerja, biasanya di dalam bagian ALUR KERJA.

Anda membatasi akses ke objek pelacakan kerja dengan salah satu dari dua cara:

• Atur aturan bidang kondisi, aturan bidang berbasis kondisi atau kombinasi keduanya yang berlaku untuk grup. Anda dapat membatasi perubahan agar tidak dilakukan pada bidang dengan menentukan aturan yang memenuhi syarat dan membuatnya berlaku untuk grup tertentu. Aturan bersyarat dapat mencakup elemen CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, dan REQUIRED .
• Dengan menambahkan WIT ke grup Kategori Tersembunyi, Anda dapat mencegah sebagian besar kontributor proyek membuatnya. Anda bisa membuat hyperlink ke templat yang membuka formulir item kerja dan membagikan tautan tersebut dengan anggota tim yang ingin Anda buat.

Artikel terkait

• Menerapkan aturan ke status alur kerja (Proses warisan)
• Evaluasi aturan dan aturan