Ho bisogno di scrivere requisiti / specifiche per un'interfaccia di servizio WCF tra il nostro sistema e un server BizTalk di terze parti. Non sono abbastanza sicuro di come farlo, quindi sto cercando un modello. Suppongo che dovrei per lo meno definire l'interfaccia stessa, la politica di autenticazione e la gestione degli errori. Sarebbe gradita qualsiasi risorsa relativa alla documentazione dei requisiti WCF / SOA.
Non sono riuscito a trovare modelli prontamente disponibili, ma suggerisco di consultare Documenti di controllo dell'interfaccia per ottenere alcune idee . Questo tipo di documento è progettato per descrivere il confine tra due o più sistemi e sembra essere esattamente quello che stai cercando. Esistono molte varianti, che vanno da specifiche formali in forma testuale a combinazioni di diagrammi sequenza, distribuzione e flusso di dati.
Puoi anche dare un'occhiata a un modello di specifica dei requisiti del software più generico. Il formato del documento non è la parte importante, ma quali informazioni vengono acquisite. Ciò include casi d'uso e requisiti funzionali e non funzionali.
Indipendentemente dal / i metodo / i scelto / i per acquisire i requisiti, la metodologia del processo probabilmente imporrà quale risultato sarebbe più utile per il team di sviluppo. In una metodologia guidata dal piano, l'output atteso sarebbe probabilmente costituito da documenti testuali con diagrammi appropriati inseriti. In metodologie più agili, i requisiti funzionali del sistema verrebbero probabilmente catturati come casi d'uso e storie utente e qualsiasi diagramma associato conterrebbe solo informazioni sufficienti per aumentare la comprensione del sistema.
Per quanto ne so, non c'è nulla di unico per le particolari tecnologie che hai menzionato - i requisiti e le specifiche esistono a un livello superiore rispetto alle tecnologie scelte per soddisfare tali requisiti.
Leggi altre domande sui tag requirements wcf