Mga Solusyon sa Paningin


Suporta
Magrehistro
Mag-login
Simulan ang Libreng Pagsubok

Paano Sumulat ng Mga Mahusay na Kinakailangan

Paano Sumulat ng Mga Mahusay na Kinakailangan

Talaan ng nilalaman

Ang isa sa pinakamahalagang bahagi ng anumang proyekto sa pagbuo ng software ay ang paglikha ng mga detalyado at tumpak na kinakailangan. Kung walang malinaw na pag-unawa sa kung ano ang kailangang itayo, imposibleng lumikha ng isang de-kalidad na produkto ng pagtatapos. Sa kasamaang palad, ang pagsulat ng magagandang kinakailangan ay kadalasang mas madaling sabihin kaysa gawin. Ang pangunahing dahilan kung bakit sumusulat ang mga tao ng mahihirap na pangangailangan ay dahil wala silang pagsasanay o karanasan sa pagsusulat ng magagandang pangangailangan. Kung ikaw o ang iyong mga tauhan ay may mga problema sa pagsusulat ng mahusay na mga kinakailangan, maaari kang makinabang mula sa patnubay sa kung paano magsulat ng mahusay na mga kinakailangan. Sa pamamagitan ng paglalaan ng oras upang matutunan kung paano magsulat ng mas mahusay na mga kinakailangan, maaari mong pagbutihin ang pangkalahatang kalidad ng iyong mga proyekto sa pagbuo ng software – at iligtas ang iyong sarili sa maraming sakit ng ulo sa hinaharap.

Ano ang Pagtukoy sa Mga Kinakailangan?

Ang pagtutukoy ng mga kinakailangan ay isang proseso kung saan ang mga kinakailangan ay tinukoy, naidokumento, at sinusuri. Ito ay isang mahalagang bahagi ng software development dahil tinitiyak nito na ang lahat ng stakeholder ay sumasang-ayon sa functionality ng software bago magsimula ang development. Sa paggawa nito, binabawasan ang posibilidad ng hindi pagkakaunawaan at muling gagawin sa susunod.

Ang pagtutukoy ng kinakailangan, na kilala rin bilang dokumentasyon, ay isang proseso ng pagsusulat o pagsusulat ng lahat ng system at mga kinakailangan ng user sa anyo ng isang dokumento. Ang mga kinakailangang ito ay dapat na malinaw, kumpleto, komprehensibo, at pare-pareho.

Bakit mahalagang magsulat ng magagandang pangangailangan?

Maraming mga benepisyo ng pagkakaroon ng mahusay na mga pagtutukoy ng mga kinakailangan. Ang ilan sa mga ito ay nakalista sa ibaba:

  • Tumutulong upang matiyak na ang lahat ng mga stakeholder ay may isang karaniwang pag-unawa sa sistema na bubuuin. Iniiwasan nito ang anumang hindi pagkakaunawaan sa mga susunod na yugto ng pag-unlad.
  • Nagsisilbing reference point para sa lahat ng stakeholder sa panahon ng proseso ng development.
  • Tumutulong upang matukoy ang anumang mga puwang sa mga kinakailangan sa isang maagang yugto.
  • Binabawasan ang kabuuang gastos at oras ng pagpapaunlad dahil iniiwasan nito ang muling paggawa dahil sa mga pagbabago sa mga kinakailangan.

Ano ang nakakamit natin sa pamamagitan ng pagsulat ng mahusay na mga kinakailangan?

Mayroong maraming mga bagay na mahusay na mga kinakailangan ay makakatulong sa pagkamit. Ang ilan sa mga ito ay nakalista sa ibaba:

  • Nakakatulong ang mga mahuhusay na kinakailangan upang matiyak na natutugunan ng binuong sistema ang mga pangangailangan ng mga gumagamit.
  • Ang mga ito ay nagsisilbing batayan para sa pagsubok sa system upang matiyak na ito ay gumagana gaya ng inaasahan.
  • Tumutulong sila na bawasan ang kabuuang gastos at oras ng pag-unlad sa pamamagitan ng pag-iwas sa muling paggawa dahil sa mga pagbabago sa mga kinakailangan.
  • Ang mga mahuhusay na kinakailangan ay nakakatulong upang gawing mas mahusay at epektibo ang proseso ng pagbuo.

Mga Hamon sa Pagsusulat ng Mga Kinakailangan

Mayroong iba't ibang mga hamon na kinakaharap ng mga tao kapag nagsusulat ng mga kinakailangan.

Kawawang Papel – Sa ilang mga organisasyon, ang dokumentasyon ng mga proseso ay alinman sa wala o hindi hanggang sa par. Sa kasong ito, ang pagkolekta ng mga kinakailangan ay nagiging isang dalawang-hakbang na proseso: unang i-reverse engineering ang kasalukuyang proseso, at pagkatapos ay pagtukoy sa mga lugar na nangangailangan ng pagpapabuti at pag-optimize. Upang kumpirmahin na ang mga kinakailangan ay fleshed out at tumpak, ito ay susi upang matukoy ang mga pangunahing stakeholder at mga eksperto sa paksa, direktang nakikipag-ugnayan sa kanila. Ang pagguhit ng mga mapa ng proseso ng negosyo at pagpapakita ng mga daloy ng trabaho ay dalawang mahusay na paraan upang gawin ito. Nakakatulong ito sa pag-aalis ng mga maling pagpapalagay habang nagbibigay din ng kumpletong larawan. Ang pagguhit ng mga mapa ng proseso at pagpapakita ng mga proseso ay dalawang kapaki-pakinabang na diskarte para sa layuning ito.

Mga Salungat na Kinakailangan – Kapag ang mga stakeholder ay may iba't ibang priyoridad para sa kanilang mga layunin sa negosyo, humahantong ito sa mga kinakailangan na sumasalungat sa isa't isa. Sa mga ganitong kaso, ang responsibilidad ng isang business analyst ay idokumento ang lahat ng mga kinakailangan nang detalyado, tukuyin kung aling mga kahilingan ang sumasalungat sa isa't isa, at bigyang-daan ang mga stakeholder ng pagkakataon na magpasya kung ano ang uunahin.

Hindi ka makakagawa ng mga desisyon nang hindi naririnig ang input ng mga stakeholder, at bilang isang business analyst, maaari kang magkaroon ng ilang ideya tungkol sa kung ano ang dapat unahin. Mahalaga pa rin na marinig ang pananaw ng mga stakeholder. Ang pagse-set up ng poll ay maaaring isa sa mga paraan upang makakuha ng kalinawan sa kung ano ang pinakamahalaga sa karamihan ng mga stakeholder.

Unavailability ng User Input – Maaaring mag-ambag ang ilang dahilan sa hindi pagiging available ng mga end user, at bawat isa ay nangangailangan ng sarili nitong resolusyon. Halimbawa, kung minsan ang mga end user ay sobrang abala sa kanilang pang-araw-araw na gawain na hindi nila gustong makibahagi sa mga aktibidad sa pangangalap ng mga kinakailangan.

Sa ganitong mga kaso, ang pinakamahusay na magagawa ng isang business analyst ay limitahan ang bilang at haba ng mga pakikipag-ugnayan. Bago ang pulong, ang paggawa ng maraming pananaliksik hangga't maaari ay makakatulong upang gawing mas organisado at nagbibigay-kaalaman ang talakayan. Ito ay halos tulad ng paggawa ng pangangalap ng mga kinakailangan sa mga sesyon ng pagpapatunay ng mga kinakailangan. pagtukoy sa mga focus group at pagtukoy sa mga pinakaangkop na end-user para sa bawat grupo

Pagtuon sa Interface Sa halip na Karanasan – Maraming stakeholder at end-user ang may malinaw na pananaw kung paano dapat lumabas ang bagong solusyon, ngunit hindi nila alam kung ano ang dapat nitong gawin. Ang user interface ng anumang system ay mahalaga, ngunit hindi ito dapat tukuyin o makagambala sa functionality.

Dapat laging tandaan ng mga business analyst na panatilihing hiwalay ang disenyo at functional na mga kinakailangan sa kanilang dokumentasyon. Sa pamamagitan ng paggamit ng mas pangkalahatang mga tool gaya ng mga diagram, kwento ng user, o low-fi na prototype sa halip na mga draft ng disenyo, maaari nilang mapanatili ang pagtuon sa mga functional na aspeto ng pangangalap ng kinakailangan.

Mga Input ng Stakeholder – Kapag sinubukan ng mga stakeholder o end-user na sabihin sa mga designer kung paano dapat gumana ang system sa halip na kung ano ang dapat gawin ng system, maaari itong humantong sa mga suboptimal na disenyo. Upang maiwasan ito, patunayan ang bawat potensyal na 'maling kinakailangan' sa pamamagitan ng pagtatanong ng 'bakit?' hanggang sa makarating ka sa tunay na problema na kailangang lutasin.

Isyu sa Komunikasyon – Kabilang sa mga isyu na maaaring humantong sa miscommunication sa pagitan ng isang business analyst at iba pang mga partido ay ang mga hadlang sa wika, mga maling pagpapalagay, hindi sapat na ipinaliwanag na bokabularyo, at labis na paggamit ng mga teknikal na termino.

Ang perpektong diskarte upang maiwasan ang problemang ito ay ang madalas na pakikipag-ugnayan at bumuo ng dalawang-daan na pag-uusap. Idokumento ang mga pangangailangan na iyong natuklasan at isumite ang mga ito para sa peer review at pagpuna sa iba't ibang mga espesyalista sa paksa, lumikha ng isang glossary ng jargon, at i-double-check ang mga lugar.

Mga Panuntunan Para sa Hanay ng Tamang Mga Kinakailangan

Mayroong ilang mga patakaran na dapat sundin ng mga kinakailangan upang matawag na "Tama".

  • Matapos – Ang dokumento ng mga kinakailangan ay dapat magsama ng sapat na impormasyon para sa iyong development team at mga tester upang makumpleto ang produkto at matiyak na natutugunan nito ang mga kinakailangan ng user nang walang mga bug.
  • Hindi pagbabago – Panatilihin ang pare-parehong antas ng detalye. Halimbawa, para sa mga kinakailangan ng user, isang end-user ang dapat maging paksa ng bawat pangungusap. Katulad nito, para sa mga kinakailangan ng system, isang sistema ang dapat na paksa ng bawat pangungusap.
  • Pagbabago – Maaaring magbago ang mga kinakailangan sa buong ikot ng buhay ng proyekto. Ang log ng mga kinakailangan ay dapat na naka-imbak at ang pagsusuri ng epekto ng mga pagbabagong ginawa dito sa iba pang mga kinakailangan at mga elemento ng proyekto ay dapat na posible.
  • Pagpapahalagahan – Ang mga kinakailangan ay dapat na uriin mula sa pananaw ng kahalagahan. Hindi lahat ng katangiang ninanais para sa isang sistema ay pantay na mahalaga. Para diyan, makatutulong na magtatag ng panuntunan upang tukuyin ang mga priyoridad ng kinakailangan sa antas ng organisasyon at iakma ito sa bawat proyekto. At makipagtulungan sa mga gumagamit upang ma-prioritize nila ang mga kinakailangan.

20 Mga Tip Para Magsulat ng Mas Mahusay na Mga Kinakailangan

Ang bawat organisasyon ay may iba't ibang paraan ng pagtatrabaho, samakatuwid, iba't ibang hanay ng mga kinakailangan. Samakatuwid, ang proseso ng pamamahala ng mga kinakailangan ay maaaring mag-iba din. Ngunit ang isang bagay na nananatiling pare-pareho ay ang mga batayan ng mga kinakailangan sa pagsulat. Nasa ibaba ang 20 mga tip upang magsulat ng mas mahusay na mga kinakailangan.

  1. Paisa-isa – Ang bawat kinakailangan ay dapat ituring bilang isang discrete test case. Ang mga pang-ugnay tulad ng at, o, at iba pa ay hindi dapat gamitin dahil maaari silang humantong sa pagkawala ng mga kinakailangan. Ito ay partikular na mahalaga dahil ang mga tuntuning tulad nito ay maaaring maging sanhi ng mga developer ng software at mga tagasubok na makaligtaan ang mga kinakailangan. Ang paghahati sa mga kumplikadong pangangailangan sa mas maliliit na bahagi hanggang sa masuri ang bawat isa nang hiwalay ay isang paraan upang maiwasang mangyari ito.

  1. Pag-usapan ang "Ano" Hindi "Paano" – Ang focus ay dapat sa kung ano ang gagawin ng system, hindi kung paano ito ginagawa. Bukod pa rito, iwasang masyadong malalim ang pagsasaliksik sa mga paksa ng disenyo gaya ng mga pangalan ng field, programming language object, at software object. Kung nakita mo ang iyong sarili na tinatalakay ang mga paksang ito sa Dokumento ng Pagtutukoy ng Mga Kinakailangan, bumalik sa isang hakbang – malamang na nangangahulugan ito na nagiging masyadong partikular ka.

  1. Mapapatunayan – Ang isa pang bagay na dapat tandaan kapag nag-oorganisa ng mga kinakailangan ay dapat silang palaging masusubok. Nangangahulugan ito na kailangang posible na i-verify na natutugunan ng system ang kinakailangan na pinag-uusapan. Ito rin ay nagli-link sa aming susunod na punto - ang kakayahang masubaybayan. Kung ang isang kinakailangan ay puno ng hindi malinaw na mga termino, magiging mas mahirap na pag-aralan at i-verify kung talagang natutugunan ng system ang mga pamantayang ito sa Performance-wise. Samakatuwid, hangga't maaari, maghangad ng kalinawan at katumpakan sa iyong wika upang ang pagtitipon ng Mga Kinakailangan ay hindi isang hindi malinaw na proseso.

  1. Traceability – Ang kakayahang masubaybayan sa pamamahala ng proyekto ay tumutukoy sa pagtiyak na ang mga kinakailangan ay nakaugnay sa iba pang mga bahagi sa proyekto. Nagbibigay-daan ito sa mga project manager, developer, at stakeholder na subaybayan ang buong lifecycle ng isang kinakailangan mula simula hanggang katapusan sa lahat ng direksyon pati na rin sa iba pang bahagi ng system. Kung maayos mong pinamamahalaan ang traceability, maiiwasan mo ang code na hindi tumutugma sa anumang kinakailangan ('stray' code), at matiyak na ang bawat test case ay sumasaklaw ng kahit isang kinakailangan. Magagawa mong masubaybayan ang mga kinakailangan sa pamamagitan ng pag-label sa kanila ng isang natatanging identifier at pagbibigay ng impormasyon tungkol sa kanilang pinagmulan sa isang sentral na repository na maa-access ng lahat ng miyembro ng team.

  1. Magagawa – Tiyakin na ang badyet at timeline ng proyekto ay magagawa, kasama ang mga magagamit na mapagkukunan. Kung masusuportahan ng mga kundisyong ito ang kinakailangan, posible na magpatuloy sa plano.

  1. Hindi pagbabago – Panatilihin ang pare-parehong antas ng detalye. Halimbawa, para sa mga kinakailangan ng user, isang end-user ang dapat maging paksa ng bawat pangungusap. Katulad nito, para sa mga kinakailangan ng system, isang sistema ang dapat na paksa ng bawat pangungusap.

  1. Exceptions – Ang isang kinakailangan ay hindi dapat magkaroon ng escape clause. Halimbawa, "Dapat matukoy ng system ang bilang ng mga pagtatangka sa pag-log in, maliban kung malinaw na naipasok ng user ang isang maling username".

  1. Aktibong Boses – Palaging sumulat sa isang aktibong boses, siguraduhing isa sa mga aktor ang paksa ng bawat pangungusap.

  1. Sabihin ang hindi sa "let-out" clause – Subukang lumayo sa mga salitang binibitawan tulad ng ngunit, maliban, at kung kinakailangan lamang.

  1. Walang mga pagdadaglat – Ang bawat pangangailangan ay dapat na isang buong pangungusap na walang anumang acronym o jargon.

  1. Paksa at panaguri – Para sa bawat pangangailangan, dapat mayroong isang paksa (user/system) at isang panaguri (inilaan na resulta, aksyon, o kundisyon). 

  1. Kaliwanagan – Iwasan ang kalabuan na dulot ng paggamit ng mga acronym tulad ng, atbp, humigit-kumulang. at iba pa.

  1. Gumamit ng Tamang Mga Tuntunin – Ang mga hindi kilalang termino tulad ng user-friendly, versatile, at matatag ay maaaring lumikha ng mga kahirapan kapag sinusubukang tukuyin ang mga kaso ng pagsubok. Ang mga salitang ito ay kadalasang may iba't ibang kahulugan para sa iba't ibang tao.

  1. Ang mga haka-haka ay maaaring magdulot ng Pinsala - Huwag hulaan; huwag gumawa ng mga listahan ng mga feature na wala sa tanong. Ang pagsasabi na gusto mo ng isang system na pangasiwaan ang lahat ng hindi inaasahang kabiguan ay purong pantasya dahil walang sistema ang magiging 100 porsiyento kung ano ang gusto mo. Iwasan ang pagdoble at magkasalungat na mga pahayag.

  1. Iwasan ang mga Opsyon – Huwag mag-alok ng mga ideya o opsyon. Maaari mong makita ang mga ito sa anumang pahayag na kinabibilangan ng mga pariralang maaaring, maaaring, maaari, o nararapat.

  1. Ang Organised Paperwork ay gumagawa ng Wonders – Panatilihing organisado ang mga kinakailangan sa isang lugar upang mapahusay ang pagiging madaling mabasa ng iyong dokumento at maiwasan ang pag-aaksaya ng oras sa pag-cross-referencing sa maraming mapagkukunan.

  1. Makipag-usap sa Kung Ano ang Nasa Amin – Huwag sumangguni sa isang pa-tutukoy na pangangailangan. Ang iyong layunin ay gawing kaaya-ayang basahin ang dokumento hangga't maaari.

  1. Ano ang dapat gamitin At Saan? – Dapat gamitin ang “Dapat” kung saan nakasaad ang mga kinakailangan, dapat gamitin ang “Will” upang kumatawan sa mga pahayag ng mga katotohanan; & "Dapat" upang kumatawan sa isang layunin na makakamit.

  1. Tamang – Tiyaking kumpleto ang bawat pangungusap at wasto ang gramatika na may wastong paksa, pandiwa, at panaguri.

  1. Pokus – Magtatag ng pokus sa pamamagitan ng pag-aalis ng mga rambling, overlong mga parirala, at mga sanggunian sa mga hindi napapanahong papel.

Mga Kinakailangan sa Visure ALM Platform

Mga Kinakailangan sa Visure ALM Platform ay isa sa mga pinakapinagkakatiwalaang platform ng pamamahala ng lifecycle ng application na dalubhasa sa pamamahala ng mga kinakailangan para sa mga organisasyon sa lahat ng laki sa buong mundo. Kabilang sa mga pangunahing kasosyo ng Visure ang mga kumpanyang kritikal sa negosyo at kritikal sa kaligtasan. Sumasama ang kumpanya sa buong proseso ng Pamamahala ng Lifecycle ng Application kabilang ang pamamahala sa peligro, pagsubaybay sa isyu at depekto, pamamahala sa traceability, pamamahala sa pagbabago, at iba't ibang bahagi tulad ng pagsusuri sa kalidad, pag-bersyon ng mga kinakailangan, at mahusay na pag-uulat.

Kung naghahanap ka ng tool sa pamamahala ng mga kinakailangan na tutulong sa iyo sa parehong mga kinakailangan sa functional at non-functional, tingnan ang Mga Kinakailangan sa Visure. Sa platform na ito, madali kang makakagawa, makakapamahala at masusubaybayan ang lahat ng mga kinakailangan ng iyong proyekto sa isang lugar.

Konklusyon

Upang makabuo ng mahusay na software, mahalagang magkaroon ng isang mahusay na nakasulat na detalye ng mga kinakailangan. Binabalangkas ng dokumentong ito ang mga pangangailangan ng customer at kung ano ang dapat gawin ng system upang matugunan ang kanilang mga inaasahan. Gayunpaman, ang pagsusulat ng magagandang kinakailangan ay maaaring maging mahirap. Maraming pamantayan at alituntunin ang dapat sundin, at maraming iba't ibang paraan para isulat ang mga ito depende sa wika at mga tool na iyong ginagamit. Mga Kinakailangan sa Visure Ang ALM Platform ay nag-aalok ng kursong nagtuturo sa iyo kung paano magsulat ng mga mabisang detalye ng kinakailangan gamit ang pinakamahuhusay na kagawian at mga pamantayan sa industriya. Sinasaklaw ng kurso ang lahat ng mahahalagang bahagi ng isang dokumentong kinakailangan, mula sa istraktura hanggang sa pag-format, pati na rin kung paano gumamit ng iba't ibang wika para sa mga kinakailangan sa pagsulat. Itinatampok din nito ang mga katangian ng mahuhusay na kinakailangan para makagawa ka ng mga dokumentong gustong-gustong magtrabaho kasama ng iyong team. Kung gusto mong matuto nang higit pa tungkol sa pagsusulat ng mga epektibong kinakailangan, subukan ang Kurso sa Pagtutukoy ng mga Kinakailangan sa pamamagitan ng Visure Requirements ALM Platform ngayon!

Huwag kalimutang ibahagi ang post na ito!

tuktok

Pag-streamline ng mga Pangangailangan sa Pamamahala at Pagpapatunay

Hulyo 11th, 2024

10 am EST | 4 pm CET | 7 am PST

Louis Arduin

Louis Arduin

Senior Consultant, Visure Solutions

Thomas Dirsch

Senior Software Quality Consultant, Razorcat Development GmbH

Isang Pinagsanib na Diskarte sa Visure Solutions at Razorcat Development TESSY

Matutunan kung paano i-streamline ang pamamahala ng mga kinakailangan at pagpapatunay para sa pinakamahusay na mga resulta.