Az SSADM termékek leírását SSADM szakembereknek kell elkészíteniük és a projektvezetésnek kell jóváhagynia. A termékek felhasználóit be kell vonni ebbe a tevékenységbe.
Egy termékleírás az alábbi részekbõl épül fel:
Megnevezés
Minden terméknek és alkotóelemnek kell rendelkeznie névvel és azonosítási lehetõséggel.Mivel bármely terméket használhat nem-szakember is, a név rövid legyen, egyértelmû és írja le a termék tartalmát vagy célját.
Az azonosítókat fõleg szakemberek használják és egy bonyolultabb osztályozást tükrözhet. A termékeket egy szervezeten belül ellentmondásmentesen kell elnevezni és azonosítani. Ez függhet a szervezeti elõírásoktól és meg kell felelnie az irányítási és ellenõrzési eljárásrendnek.
Cél
Ez megmagyarázza, hogy miért van szükség a termékre.
Tartalom
A termék minõségi vagy konkrét tartalmi kérdésein kívüli jellemzõit lehet itt leírni, hogy a termékrõl teljes képet nyerjünk.Ez lehet felépítési vagy szerkezeti információ, ami jelenthet egy szerkezeti ábrát a termékfelépítés ábrázolására, illetve szükség esetén a szabványos formalapot, vagy egyszerû felsorolást.
Terjedelmi okokból itt a termékek leírása nem tartalmaz sem formalapot, sem termékfelépítési ábrákat. A formalapokat meg lehet találni a megfelelõ technika leírásának végén.
Származtatás
Ez a rész azonosítja a termék kifejlesztésének (létrehozásának vagy módosításának) helyét. Minden helyhez fel kell sorolni a szükséges kiindulási termékeket.
Minõség
Általában az itt leírt minõségi feltételeket (kritériumokat) a termék fejlesztése során kell figyelembe venni. Fel lehet használni õket a minõségi szemléken is, a teljesség és ellentmondásmentesség ellenõrzésére. Az SSADM összes moduljának végtermékét formális szemlén kell megvizsgálni mielõtt átadnák az információáramlási útnak, ld. strukturális modell. A köztes munkatermékeket esetleg soha nem szemlézik formálisan, de mindegyiket meg kellene vizsgálni nem formális módon.Egy termék minõségi kritériuma csak a termék alkotóelemeire vonatkozhat, nem alkalmazható a termék semmilyen környezetére. Ez azt jelenti, hogy a termék minõségét érintõ tényezõk háromféle módon dokumentálhatók:
A problémák akkor merülnek fel, amikor egy terméket máshol található részletekkel kell összevetni. Ahol lehetséges, az ilyen típusú minõségi kritériumot a termékfelépítési szerkezet felsõbb szintjén kell alkalmazni (az összevetendõ részeket összefogó termékre).
- minõségi kritériumként a termékleírásban,
- feladataként a strukturális modellben,
- részletes leírásként a megfelelõ technika leírásában.
Lehetnek a dokumentumok elõállítására vonatkozó általános minõségi kritériumok, olyan ésszerû elõírásokkal, mint:
A minõségi kritériumok mellett meg lehet adni a minõségi szemle módszerét is, ami általában formális vagy nem formális lehet. Ahol a formális szemle elengedhetetlen, ott azt a termékleírásban jelezni kell, a többi esetben a szervezeti elõírásokra kell hagyatkozni. A szemlék végrehajtásának módjáról a projektirányítóknak kell adniuk elõírásokat, betartva a szervezeti elõírásokat. Néhány általános tevékenység lehet:
- betûhibák elkerülése,
- helyes nyelvtan,
- helyes elválasztás és tagolás,
- helyi elõírások alkalmazása (a stílusra és kinézetre vonatkozóan),
- a mondatokat pontosan és érthetõen megfogalmazni, ellentmondások nélkül,
- rövidítési szabályok alkalmazása.
Amint a termék hibalistája elkészült, a lehetõ legrövidebb idõn belül el át kell adni a termék készítõjének, hogy a hibákat ki tudja javítani.
- a termékleírás ellenõrzése és a termék szemlézése az ott leírt minõségi kritériumok szerint,
- a termék kiinduló dokumentumainak a vizsgálata,
- koncentrálás a leírt minõségi kritériumokra,
- a termék ellenõrzése a teljesség, hibák, kiegészítések, ellentmondások, szabványoktól való eltérések, illetve a szabványok megsértése szempontjából.
Külsõ feltételek
Nem minden terméket lehet egyszerûen más termékekbõl elõállítani. Sokszor lesz szükség olyan más információforrásokra, mint például a felhasználók vagy szakértõk. Ezeket az igényeket kell itt felsorolni.
Hivatkozási pontok
Ez a módszer azon helyeit jelöli, ahol a termék valamilyen szempontból érdekes. Ez általában a termék keletkezésére illetve felhasználására utal, megnevezve a technikákat és a lépéseket, ahol a terméket érintik valamilyen módon.
A leírt termékek felsorolása
Ebben a kiadványban az SSADM fontosabb termékeinek leírása szerepel, ami nagyjából az alkalmazási termékek felépítési szerkezetének megfelelõ termékek leírásait jelenti, a rendszertechnikai alternatívák szakaszának termékeivel bezárólag, mivel a technikákat leíró fejezet is odáig terjed ki. Az SSADM kézikönyv ennél több terméket ír le, ezeket terjedelmi okokból nem tartalmazza ez a rész.
- Adatfolyam-modell
- Adatjegyzék
- Alkalmazásszintû fejlesztési szabványok
- Alkalmazásszintû környezeti útmutató
- Alkalmazásszintû névkonvenció
- Alsó szintû adatfolyam-ábra
- Attribútum-, adatelem-leírások
- B/K adatszerkezet leírása
- B/K adatszerkezetek (az összes funkcióhoz)
- B/K adatszerkezeti ábra
- B/K-leírások
- Egyed-élettörténetek
- Egyedleírások
- Elemi folyamat leírása
- Esemény-egyed táblázat
- Eseményhatás-ábrák
- Feldolgozások részletes leírása
- Felhasználói szerepkör-funkció táblázat
- Felhasználói szerepkörök
- Felhasználójegyzék
- Felsõ szintû adatfolyam-ábra
- Funkcióleírás
- Funkcióleírások
- Jelenlegi szolgáltatások leírása
- Kapcsolatleírások
- Kontextusábra
- Követelmény-specifikáció
- Követelmények elemzése
- Követelményjegyzék
- Közös tartományok leírásai
- Külsõ egyed leírása
- Lekérdezési út
- Logikai adatmodell
- Logikai adatszerkezet
- Logikai adattár-egyed megfeleltetés
- Megvalósíthatósági alternatívák
- Megvalósíthatósági tanulmány
- Relációs adatelemzési munkalap
- Rendszerszervezési alternatívák
- Rendszertechnikai alternatívák
- SSADM általános struktúra-ábra
- Technikai környezet leírása
- Választott rendszerszervezési alternatíva
- Választott rendszertechnikai alternatíva