etm.wccoa.exceptions

Bases: Exception

Exception wrapping a WinCC OA ErrClass error.

Carries the structured error information from the C++ ErrClass: priority, error type, numeric code, message catalogue and text.

• Variables:
  • priority – Severity level (fatal, severe, warning, info).
  • error_type – Error category (implementation, parametrization, …).
  • code – Numeric error identifier. An OaErrorCode member for the standard catalogue, a plain int otherwise.
  • catalog – Name of the message catalogue the code belongs to. Empty for the errors of WinCC OA itself; set e.g. when a CTRL script raised the error through makeError() with its own catalogue.
  • text – Human-readable error description.
  • time – Moment the error was raised, as local time.

Initialization

Initialize self. See help(type(self)) for accurate signature.

Bases: enum.IntEnum

Error codes reported by WinCC OA.

Mirrors the C++ enumerator ErrClass::ErrCode; the message texts are those of _errors.cat. Use these names instead of magic numbers when inspecting the code of an OaError:

except OaError as err:
    if err.code == OaErrorCode.DP_NOT_EXISTENT:
        ...

Defects detected by the Python binding itself are not reported through this enumeration; they raise the matching built-in exception instead (ValueError, TypeError, OverflowError, RuntimeError).

Initialization

Initialize self. See help(type(self)) for accurate signature.

Bases: enum.IntEnum

Severity level of a WinCC OA error.

Values match ErrClass::ErrPrio (C++) and ccm::ErrorPriority.

Initialization

Initialize self. See help(type(self)) for accurate signature.

Bases: enum.IntEnum

Category of a WinCC OA error.

Values match ErrClass::ErrType (C++) and ccm::ErrorType.

Initialization

Initialize self. See help(type(self)) for accurate signature.