
3.2 Definition of Service Sequence
Diagrams
Before proceeding to a logical design of how a
telematic service will work in terms of software
components, its behaviour is necessary to be exam-
ined and defined as a black box. In this way, service
behaviour is considered as a description of what the
telematic service does, without explaining how it
does it. One part of that description is service se-
quence diagrams.
A service sequence diagram should be done for
the typical course of events of each use case and
sometimes for the most important alternative
courses. It depicts, for a particular course of events
within a use case, the external actors that interact
directly with the telematic service, the telematic ser-
vice (as a black box), and the service events that the
actors generate. Time proceeds downwards and the
ordering of events should follow their order in the
use case. Service events (and their associated service
operations) should be expressed in an abstract way,
emphasising their intention, and not in an imple-
mentation specific manner.
Taking into account the above mentioned guide-
lines and remarks, this activity consists mainly of the
following steps:
Step 1:
Draw a vertical line representing the tele-
matic service as a black box.
Step 2:
Identify each actor that directly operates on
(or interacts with) the telematic service.
Step 3:
Draw a vertical line for each actor.
Step 4:
Identify the (external) service events that
each actor generates by examining the use case typi-
cal course of events text.
Step 5:
Illustrate the identified service events in the
correct order on the diagram.
Step 6:
Include (fragments of) the use case text to
the left of the diagram (optionally).
3.3 Definition of Service Operation
Contracts
The behaviour of a telematic service is further de-
fined by service operation contracts (or service con-
tracts), as they describe the effect of service opera-
tions upon the telematic service. A service sequence
diagram depicts the external events that an actor
generates, but it does not elaborate on the details of
the functionality associated with the service opera-
tions invoked. All the details that are necessary to
understand the service response (and thus the actual
service behaviour) are missing. These details are
included in service operation contracts, which de-
scribe changes in the state of the overall telematic
service when a service operation is invoked.
The creation of service operation contracts is de-
pendent on the prior development of use cases and
service sequence diagrams, and on the identification
of service operations (see Figure 3) in the following
order:
use cases Æ service sequence diagrams Æ service
operations Æ service operation contracts
More specifically, the use cases suggest the ser-
vice events and lead to the construction of the ser-
vice sequence diagrams. The service operations can
then be identified. The effect of the service opera-
tions is described in service operation contracts.
UML contains support for defining service contracts
by allowing the definition of pre- and post-condi-
tions of service operations (Evits, 2000).
The most important section is the “Post-condi-
tions” section which declaratively describes the state
changes that occur to service IOs in the service con-
ceptual model, using a number of suitably selected
statements (instance creation, instance deletion, at-
tribute modification, association formed, association
broken, and user interface activation). This section
reveals how the telematic service has changed as a
result of a specific service operation.
3.4 Definition of Service State
Diagrams
Service state diagrams can successfully describe the
legal sequence of external service events that are
recognised and handled by a telematic service in the
context of a specific use case. These are UML state
diagrams, which illustrate the interesting and signifi-
cant service events and the states of a telematic ser-
vice, together with the behaviour of the service in
reaction to a particular service event.
A service state diagram which depicts the
(overall) service events and their desired sequence
within a use case is called a use case service state
diagram, and can be created for a specific use case at
varying levels of detail depending on the exact mod-
elling needs. The real value of use case service state
diagrams is appreciated when they model complex
use cases with many service events, because then
they help considerably the service developer(s) dur-
ing the service design to avoid out-of-sequence ser-
vice events and the corresponding error conditions.
However, use case service state diagrams are not
necessary if there is no significant service event or-
dering. Therefore, their definition in the service
analysis phase is optional. In such cases, another
(optional again) alternative is the creation of a global
service state diagram, which illustrates, for the entire
telematic service, all the transitions for service
events across all the use cases. It is a union of all the
use case service state diagrams and is useful as long
INTEGRATING REQUIREMENTS & SPECIFICATIONS IN THE TELECOMMUNICATIONS SERVICE CREATION
PROCESS
141