.. _label-uc-service-add:

Use-Case: Add a Service
***********************************************************************

Short Description
-----------------------------------------------------------------------

A service is added.

Actor(s)
-----------------------------------------------------------------------

Officer


Trigger(s)
-----------------------------------------------------------------------

- Imports (adding existing data)
- Web form(s) submitted by authorized user


Result(s)
-----------------------------------------------------------------------

- A new service is available for customers/officers.

- Contracts can be created from the new service.


Incoming Data
-----------------------------------------------------------------------

- Title
- Description
- Service terms (various data about what special options the new
  service provides, constraints, etc.).


Outgoing Data
-----------------------------------------------------------------------

- Message about service creation
- Log message


Precondition(s)
-----------------------------------------------------------------------

- Submitting user must be authorized to perform the operation.


Postcondition(s)
-----------------------------------------------------------------------

- The new service is able to create contracts.


Invariant(s)
-----------------------------------------------------------------------


Essential Steps
-----------------------------------------------------------------------

- System receives customer ID, service ID and any optional parameters
  specifying the contract to create.
- System creates a unique service ID.
- Passed in terms, title, and description are validated.
- If passed-in parameters are invalid, user is offered a possibility
  to fix the invalid data.
- System creates the new service.


Open Issues
-----------------------------------------------------------------------



Remarks
-----------------------------------------------------------------------


.. raw:: latex

      \