Pe această pagină
O diagramă feroviară poate face schimbarea trenului evidentă dacă îndreaptă liniile și spațiază uniform stațiile. Poate face și două opriri să pară departe una de alta, deși le desparte o plimbare scurtă. Aceeași abstracție care ajută un călător să aleagă trenul îl poate induce în eroare când alege un traseu pe jos.
O istorie a unei diagrame de transport întreabă ce s-a întâmplat când o vedere schematică a fost folosită și pentru alte sarcini decât alegerea rutei. Relatarea Muzeului Transportului din New York confirmă că harta din 1972 îndrepta rutele și elimina majoritatea detaliilor topografice. Povestea amintește util că o imagine poate fi bună pentru o sarcină și totuși poate avea nevoie de o vedere complementară pentru alta. Istoria exactă a producției unor eventuale materiale complementare nu este necesară pentru această lecție.
Definește traseul pe care cititorul încearcă să îl găsească
Fiecare diagramă elimină informație. O schiță de arhitectură a sistemului lasă deoparte timpul. O diagramă de flux lasă deoparte valorile datelor. O hartă a direcțiilor de sincronizare poate omite cine are voie să autorizeze o scriere. Eliminarea este adesea motivul pentru care imaginea poate fi citită. Problema începe când proprietatea eliminată contează pentru alegerea cititorului.
Imaginează-ți o diagramă ilustrativă a sincronizării dintre magazin și sistemul de email, cu două casete și o săgeată: Magazin → Platformă de email. Ea ajută la răspunsul „care sistem trimite înregistrarea clientului?”. Nu poate răspunde dacă odată cu înregistrarea este transmis consimțământul, cum se tratează duplicatele sau dacă o cumpărare anulează un mesaj programat. Imaginea nu este greșită. Este incompletă pentru aceste decizii.
Înainte de a desena, scrie întrebarea cititorului într-o propoziție.
- Stația Apornirelegătură
- Schimbarealtă linielegătură
- Stația Bdestinație
„De unde provine acest câmp?” cere originea datelor. „Ce se întâmplă dacă sursa nu este disponibilă?” cere timp și stări de eșec. „Cine poate declanșa o campanie?” cere permisiuni. O pagină poate cuprinde mai multe vederi, dar o singură vedere nu ar trebui să pretindă că servește optim fiecare sarcină.
| Vedere | Legătura pe care o păstrează | Deformarea obișnuită |
|---|---|---|
| Hartă schematică a rutelor | Conexiunile și schimbările | Distanța și direcția fizică |
| Diagramă de flux al datelor | Sursele, consumatorii și direcția | Timpul și autoritatea |
| Diagramă secvențială | Ordinea apelurilor și răspunsurilor | Starea de durată și munca oamenilor |
| Matrice de permisiuni | Persoanele sau sistemele autorizate și acțiunile | Parcursul utilizatorului prin sistem |
Acestea sunt exemple conceptuale, nu evaluări ale unor produse sau hărți anume.
Arată omisiunea acolo unde este folosită harta
O notă „nu este la scară” poate ajuta călătorul să înțeleagă o hartă schematică. Pentru o diagramă de sincronizare, explicația ar putea spune „arată direcția normală a datelor; vezi traseul de eșec și tabelul permisiunilor pentru scrieri”. Este mai utilă decât o avertizare generică fiindcă numește decizia lipsă.
Vederea complementară trebuie aleasă după consecință. Dacă diagrama este folosită la revizuirea securității, permisiunile nu sunt context opțional. Dacă este folosită pentru a diagnostica înregistrări vechi, marcajele de timp și stările de reîncercare contează mai mult decât plasarea casetelor. Dacă este folosită pentru a planifica o integrare nouă, responsabilitatea asupra câmpurilor și traseele de corecție pot determina implementarea.
De aceea aspectul curat poate fi o capcană. O săgeată care nu se intersectează cu alte săgeți arată ordonat, dar poate ascunde un circuit de feedback. Casetele uniforme sugerează responsabilități echivalente chiar dacă un sistem deține adevărul, iar altul păstrează o proiecție care poate fi refăcută. Proiectarea trebuie să facă vizibilă această asimetrie operațională când contează.
Oferă vederea următoare acolo unde este necesară
O diagramă poate servi mai mulți cititori dacă oferă următoarea vedere în punctul în care decizia o cere. Începe cu vederea care răspunde întrebării imediate și adaugă alături un link sau o modalitate de a trece la vederea următoare. Păstrează etichetele consecvente între ele, ca cititorul să știe că „client” din flux este același obiect din tabelul permisiunilor.
O revizuire utilă îi cere cuiva care nu cunoaște sistemul să ia două decizii. Prima, să folosească diagrama pentru scopul ei. A doua, să răspundă unei întrebări care depinde de o proprietate omisă. Dacă cititorul trage cu încredere o concluzie greșită, omisiunea are nevoie de o etichetă sau de o vedere complementară. Dacă știe unde să privească apoi, abstracția își face treaba.
Ghidul despre responsabilitatea datelor tratează alegerile de integrare din spate. Harta acelor alegeri ar trebui să îl ajute pe cititor să facă pasul următor potrivit, nu doar să admire o arhitectură care pare completă.
O diagramă poate purta propriul caz de test. Pune o înregistrare normală și o excepție pe pagină și cere cititorului să le urmărească pe amândouă. Dacă excepția dispare într-o săgeată fără etichetă, diagrama a ascuns o decizie. O versiune pentru conducere poate omite numele câmpurilor, dar trebuie totuși să arate cine răspunde de un eșec. O versiune pentru implementatori poate arăta scheme și reîncercări, dar poate omite politica internă. Întrebarea este dacă fiecare omisiune păstrează sarcina. Când un cititor nou trebuie să ghicească, adaugă legătura lipsă sau indică vederea complementară, nu umple fiecare spațiu liber cu casete.
O hartă reușește lăsând lucruri pe dinafară cu grijă. Eșuează când lucrul lipsă este chiar lucrul pe care cititorul venise să îl decidă.
Întrebări Frecvente
Ce face sinceră o diagramă simplificată?
Identifică sarcina pe care o servește și proprietățile păstrate, apoi arată omisiunile importante. Nu ar trebui să sugereze că așezarea, distanța sau exhaustivitatea sunt literale atunci când nu sunt.
Când are o diagramă nevoie de o vedere complementară?
Când cititorii trebuie să decidă pe baza unui lucru eliminat intenționat, precum distanța fizică, accesul, latența sau un traseu de excepție.
Cum ar trebui echipa să revizuiască o hartă a sistemului?
Cere unui cititor să rezolve sarcina dorită cu ajutorul ei, apoi testează o a doua sarcină dependentă de detaliile omise. Revizuiește harta sau adaugă legătura către o vedere complementară unde omisiunea ar induce în eroare.