Contoh skenario aturan kustom

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Artikel ini menyediakan contoh definisi aturan kustom. Tentukan semua aturan kustom untuk jenis item kerja. Artikel ini menyediakan contoh untuk model proses XML yang Diwariskan dan Lokal.

Sebelum Anda menambahkan aturan kustom, lihat Aturan dan evaluasi aturan dan Menambahkan aturan ke jenis item kerja (Proses warisan).

Tentukan bidang wajib yang bergantung

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

Proses pewarisan

Proses XML lokal

WHEN Tentukan 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 menunjukkan cara menentukan aturan kustom untuk menghapus nilai untuk Poin Cerita saat Anda mengubah Tanggal Mulai.

Proses pewarisan

Proses XML lokal

WHENCHANGED Tentukan 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 menunjukkan cara memetakan nilai bidang Ukuran bergantung pada nilai yang dipilih untuk bidang UkuranTee-Shirt kustom.

Proses pewarisan

Daftar pilihan UkuranTee-Shirt terdiri dari empat nilai: Kecil, Sedang, Besar, dan X-Besar. Empat aturan kustom menetapkan bidang Ukuran saat Anda mengubah bidang ukuranTee-Shirt menjadi nilai tertentu. Untuk menyederhanakan penggunaan, nilai default Ukuran Tee-Shirt adalah Kecil.

Dialog edit untuk bidang Ukuran T-Shirt

Aturan khusus

Empat aturan kustom

Proses XML lokal

Anda menentukan nilai bidang Ukuran di bagian FIELDS definisi jenis item kerja. Gunakan serangkaian WHEN pernyataan aturan untuk membuat pemetaan, mengatur nilai bidang Ukuran dengan 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 saat perubahan status

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

Proses pewarisan

Proses XML lokal

Saat Anda mengatur bidang Status untuk item kerja ke Aktif dan menyimpan item kerja, bidang Diaktifkan Oleh dan Ditetapkan Ke secara otomatis diperbarui ke nama pengguna saat ini. Pengguna harus menjadi anggota dari grup Valid Users di Team Foundation Server. Bidang Tanggal Diaktifkan juga diperbarui 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>

Hapus nilai kolom saat Status Ditutup

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

Proses pewarisan

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 melarang grup tersebut membuat item kerja jenis tersebut.

Proses pewarisan

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, cegah pengguna mengubah item kerja dengan mengatur izin tolak untuk grup di Jalur Area. Untuk proses XML Lokal, tempatkan pembatasan pada setiap status alur kerja untuk grup yang mencegah mereka menyimpan item kerja dalam status apa pun.

Proses pewarisan

Anda tidak dapat menentukan aturan kustom yang membatasi modifikasi item kerja dari jenis tertentu. Anda hanya dapat menentukan pembatasan menurut status. Jika pengguna tidak mengubah statusnya, mereka dapat mengubah kolom lain, kecuali semua kolom bersifat hanya-baca untuk grup.

Untuk membatasi sekelompok pengguna agar tidak memodifikasi item kerja tertentu dari jenis apa pun, tetapkan 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 informasi 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 tidak dapat 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>

Pembatasan Transisi Status

Untuk proses yang diwariskan, transisi status apa pun ditentukan secara otomatis. Definisi alur kerja ini memungkinkan pengguna untuk memajukan status alur kerja dari yang baru ke selesai, tetapi juga untuk bergerak mundur jika tindakan tersebut 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, tetapi tidak memindahkannya kembali.

Kiat

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.

Pembatasan perubahan pada item kerja yang ditutup

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

Proses pewarisan

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 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 kembali 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 kondisi Current user is a member of group... atau Current user is not a member of group..., Anda bisa menyembunyikan bidang, membuat bidang hanya dapat dibaca, atau mewajibkan pengisian bidang.

Misalnya, kondisi berikut menyembunyikan bidang Justifikasi 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 Caching 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 pewarisan

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

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

Kiat

Untuk menghindari masalah evaluasi aturan, tentukan grup keamanan Azure DevOps alih-alih ID Microsoft Entra atau grup keamanan Direktori Aktif. Untuk informasi 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 hanya baca untuk anggota grup Fabrikam Fiber\Voice. Saat pengguna dalam grup ini membuka Cerita Pengguna, mereka tidak dapat mengubah nilai di bidang Prioritas.

Proses XML lokal

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

• Membatasi siapa yang dapat membuat atau mengubah item kerja.
• Batasi 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 WORKFLOW (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 pada bidang dengan menentukan aturan yang memenuhi syarat dan membuatnya berlaku untuk grup tertentu. Aturan bersyarat dapat mencakup CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY, dan REQUIRED elemen.
• 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.

Konten terkait

• Menerapkan aturan ke status alur kerja (Proses pewarisan)
• Aturan dan evaluasi aturan