.. _user/services/deviation:

Deviation
=========

When the user chooses to :ref:`enable a service
<user/services/usage/enable-service>`, all resources should change their state
from *disabled* to *enabled*, or whatever other target state is specified in the
commissioning file. In other words, the commissioning file specifies the set of
resources and their expected target state which are needed to make the service
work correctly.

However, in real-life there are always conditions that can not fully be
controlled by the Connectware (such as a broken network cable), which can block
one or more resources to reach the desired target state (e.g. having a healthy
connection). This situation is called a *deviation*, and the corresponding
service is said to be *deviated*.

The occurrence of such a deviation is indicated in the Admin-UI by a small
yellow popup window message.

   .. figure:: ../../resources/service/deviation-popup.png
      :width: 250px

It is also shown in the :ref:`service overview page
<user/services/usage/index>`, in the :ref:`service details view
<user/services/usage/details>`, and in the list of the respective :ref:`resource
<user/resources/index>`. Clicking on the deviation warning messages will show a
list of resources whose actual state is different from the expected state:

   .. figure:: ../../resources/service/deviation-details.png
      :width: 400px

This indication should
express the difference (potentially caused by outside conditions) from the
expected behavior of an enabled service.