Etkili Kullanım Örnekleri Nasıl Yazılır?

Yayınlanan: 2015-08-21

Etkili Kullanım Örnekleri Nasıl Yazılır?

Kullanım senaryoları, iş mantığını ve sistem süreçlerini belgelemek için yaygın olarak kullanılmaktadır. Ancak bunların yararlı olup olmadığı ve nasıl yapılandırılması gerektiği konusunda pek çok görüş var. Bazı projelerde geliştiriciler, ayrıntılı olduklarını veya onlardan pek bir şey anlamadıklarını söyleyen kullanım durumlarına asla bakmazlar. Bir iş analisti, kullanım senaryolarını gerçekten etkili kılmak için ne yapabilir?

Çoğumuz, kullanım senaryolarının iş sürecini tanımladığının ve belirli hedefler için sistem ile aktörler arasındaki etkileşimlerin özellikleri olduğunun farkındayız. Kullanım senaryosu belgesi, gereksinim belgesinden farklıdır ve tasarım belgesiyle aynı değildir.

Gereksinim için iki kullanım örneği örneğine bakalım. Sizce bunlardan hangisi daha iyi.

Örnek 1

Vaka ayrıntılarını kullanın Yorumlar

Kullanım senaryosu Adı – Bilet Siparişi

İsim iyi. Açıkça kullanım durumunun ne olduğuna dair bir gösterge verir

Hedef – Müşteri, web sitesinde futbol maçı için başarıyla bilet rezervasyonu yapar

Açıklama- Oyuncu web sitesini ziyaret eder,
program, maçı seçer
ve koltuklar, kitaplar
bilet ve futbol maçı için ödeme yapar

Amaç ve açıklama açıkça belirtilmiştir.
Bu tasarımcılara yardımcı olacak
ve geliştiriciler ne olduğunu anlıyor
tasarım belgelerinin ve kodlarının amacı

Aktörler – Müşteri, Müşteri Hizmetleri Temsilcisi
Ön koşullar – Sistem çalışıyor ve çalışıyor.
Tetik – Oyuncu, bilet rezervasyonu yapmak için sisteme erişti.
Durum Sonrası – Oyuncu bilet rezervasyonu yapabilir. Sistem bilgileri günceller.

Aktörler gibi diğer tüm kullanım durumu ayrıntıları ,
ön koşullar, posta koşulları ve
yardımcı olacak tetikleyiciden bahsedilmiştir.
uygulamanın tasarımı ve geliştirilmesi daha kolay.

Ana Akış - Adımlar

  1. Oyuncu web sitesine girer ve bilet rezervasyonu yapmayı seçer
  2. Sistem rezervasyon bilgilerini görüntüler
  3. Oyuncu maç detaylarını onaylar (Daha fazla detay kullanıcı arayüzü spesifikasyonunda)
  4. Oyuncu koltuk ayrıntılarını onaylar (Daha fazla ayrıntı UI Spesifikasyonunda)
  5. Sistem kullanılabilirliği onaylar
  6. Sistem kullanıcı bilgilerini almak için form sunar
  7. Oyuncu, kullanıcı bilgilerini verir (Ayrıntılar başka bir kullanım durumunda)
  8. Sistem ödeme bilgileri için form sunar
  9. Oyuncu ödeme bilgilerini verir (Ayrıntılar başka bir kullanım durumunda)
  10. Sistem ayrıntıları onaylar ve bir rezervasyon kimliği verir
  11. Oyuncu bileti kaydeder
  12. Oyuncu sistemden çıkar.

Dahil Kullanım durumları

- Ödeme yapmak

– Rezervasyon Kimliği Oluştur

Genişletilmiş Kullanım durumları

– Ödeme Hatası Notu Oluştur

– Bilet Yazdır

Ana akıştaki adımlar açıktır ancak
UI ayrıntıları dışarıda bırakılır. Kullanım durumunda kullanıcı arayüzü ayrıntıları
koltuk seçimi ve maç ile ilgili
seçim, kullanım durumunu hantal hale getirebilir.
Kullanım durumu , aktörün ne yapması gerektiğini ve sistemin ne yapacağını açıkça gösterir.
Ödeme süreci ayrıntılı olarak bir
görevlerin gerçekleştirilebilmesi için farklı kullanım durumu
farklı tasarım bileşenlerine kolayca ayrılabilir.
Dahil edilen ve Genişletilmiş kullanım durumları adlandırılır
böylece biri yapabilir
daha fazla ayrıntı için onlara başvurun.

Alternatif Akış

- Biletleri iptal et

  1. Aktör işlemi iptal ediyor
  2. Sistem işlemi iptal ediyor

İstisna Akışı

-Seçilen maç/seçilen koltuklar için biletler mevcut değil

1. Sistem bir hata mesajı görüntüler

Alternatif ve İstisna Akışları ayrıntılı olarak açıklanmıştır.

* Kullanım durumu, referanslar, alternatif ve istisna akışları açısından daha ayrıntılı olabilir. Bu örnek, iyi yazılmış bir kullanım durumunda nelerin kapsanması gerektiğini vurgulamak içindir.

Örnek – 2

Vaka ayrıntılarını kullanın Yorumlar

Kullanım senaryosu Adı – Bilet Siparişi

Ad, kullanıcı açısından değil ve bir iş süreci tanımı gibi görünüyor.

Açıklama – Oyuncu web sitesini ziyaret eder, programı görüntüler, maçı ve koltukları seçer, bilet rezervasyonu yapar ve futbol maçı için ödeme yapar

Kullanım senaryosunun amacı eksik. Tasarımcılar, Test Analistleri ve geliştiriciler bu işlevselliğin neden geliştirilmesi gerektiğini anlamayacaklar.

Aktörler – Müşteri, Müşteri Hizmetleri Temsilcisi
Tetik – Oyuncu, bilet rezervasyonu yapmak için sisteme erişti.
Durum Sonrası – Oyuncu bilet rezervasyonu yapabilir. Sistem bilgileri günceller.

Ön koşullar eksik.

Ana Akış Adımları

  1. Müşteri web sitesine girer ve bilet rezervasyonu yapmak için 'Bilet Rezervasyonu' seçeneğini seçer.
  2. Sistem, bir açılır menüde eşleşmelerin listesini görüntüler.
  3. Müşteri Hizmetleri Temsilcisi, açılır menüden seçim yapar
  4. Sistem koltuk detaylarını koltuk haritasında görüntüler.
  5. Oyuncu koltukları seçer. Koltuklar müsait değilse ve hata mesajı görüntülenirse.
  6. Oyuncu ödeme ayrıntılarını verir
  7. Oyuncu bileti alır, yoksa bileti iptal eder.
  8. Sistem, müşterinin adını ve rastgele oluşturulmuş 4 basamaklı bir sayıyı kullanarak bir rezervasyon kimliği oluşturur.

Dahil Kullanım durumları
- Ödeme yapmak

Kullanım senaryosu adımlarında, okuyucunun kafasını karıştırabilecek gerçek UI öğelerine bazı referanslar vardır. Alternatif akışlar, tüm sürecin anlaşılmasını zorlaştıran ana akış içinde yazılır.
Oyuncu birçok isimle anılıyor – 'Müşteri, Oyuncu ve Müşteri Hizmetleri Temsilcisi bu kafa karıştırıyor.
Rezervasyon kimliğinin oluşturulması, bilet siparişi ile ilgili aktörleri ilgilendirmese de burada açıklanmıştır.
Alternatif akışlar, istisna akışları ve ilgili tüm kullanım durumlarından bahsedilmiyor.

Bu kullanım durumu, netlik ve ayrıntıdan yoksundur ve ekibe işlevselliği düzgün bir şekilde geliştirmede yardımcı olmaz.

Bir kullanım durumunda ne olmalıdır Kullanım durumunda ne olmamalıdır
  1. İsim
  2. Açıklama/Hedef
  3. ön koşullar
  4. Tetiklemek
  5. Temel Akış ve Alternatif Akışlar
  6. İstisna Senaryoları
  7. Gönderi koşulları
  8. Varsa özel gereksinimler
  9. Kullanıcı arayüzü ayrıntılarına ve diğer ilgili modellere/şemalara bağlantı
  1. Uygulama ayrıntıları
  2. Dahili işleme
  3. İşlevsel olmayan gereksinimler
  4. Kullanıcı Arayüzü ayrıntıları, kullanım durumları ile aynı anda ancak ayrı bir belgede yapılmalıdır.

.

Yararlı kullanım senaryoları yazmak için izlenecek bazı ipuçları:

  1. Oyuncunun bakış açısından kullanım senaryosu adımlarını yazın.
  2. Kullanım senaryoları tasarım ve mimari detaylara sahip olmamalıdır. İş sürecine odaklanmalıdır.
  3. Kullanım durumundaki adımların zaman sıralı bir şekilde yazılması daha iyidir.
  4. Gereksinimlere ve karmaşıklığa bağlı olarak, CRUD (Oluştur, Oku, Güncelle ve Sil) işlemlerinin ayrı kullanım durumlarında mı tutulması gerekip gerekmediğine veya bunların bir arada birleştirilip birleştirilmeyeceğine karar verin.
  5. İş tasarımının tamamlanması için alternatif akışlara, istisna akışlarına, dahil edilen kullanım senaryolarına ve genişletilmiş kullanım senaryolarına referans vermek önemlidir.
  6. Bir şablon seçin (proje tanımlı, şirket tanımlı veya herhangi bir ayrıntılı) ve tüm kullanım durumları için yapıyı takip edin.
  7. Kullanım durumu diyagramlarına sahip olmak önemlidir.
  8. Agile'da gereksinimleri yakalayacak kullanıcı hikayelerimiz var. Kullanıcı hikayeleri, yinelemeli bir şekilde yalın kullanım durumları kullanılarak detaylandırılabilir.
  9. Doğrulamalar ayrıntılı olarak belirtilmelidir.

Bir kullanım senaryosu yazdıktan sonra şu soruları sorun ve tüm sorulara cevabınız “Evet” ise etkili bir kullanım örneğidir –

  1. Kullanıcı, kullanım senaryosunda mevcut olan iş akışının ne zaman yürütüldüğünü bilecek mi?
  2. Kullanım senaryosunun hangi adımını kimin gerçekleştireceği açık mı?
  3. İş mantığının tanımı, analiz, tasarım, geliştirme ve test için yeterli bilgi olacak şekilde mi?
  4. Ana akıştan alternatif ve istisna akışlarına uygun referanslar var mı?
  5. Mevcut bir kullanım durumu şeması var mı?

Kullanım senaryoları, iyi yazılmışlarsa gereksinimleri yakalamanın ve iş süreçlerini resmi olarak belgelemenin etkili bir yoludur. Tüm takıma, görevlerini yerine getirmek için kullanım senaryolarını kullanma konusunda koçluk yapılmalıdır. Kullanım senaryoları ve kullanım senaryosu diyagramları, müşterilerle iş süreçlerini tartışmanın harika bir yoludur. Kullanım senaryolarının yazılmasına ilişkin yönergeler içeren standart bir kullanım senaryosu şablonuna sahip olmak daha iyidir. Bu şekilde yazılan kullanım örnekleri, tüm proje ekibi üyeleri ve paydaşlar tarafından değerlendirilecektir.