New manip modify invocation effective timeout (#69)

Add a manipulation that triggers the
device to set @InvocationEffectiveTimeout less than or equal to the
requested threshold.

# Checklist

The following aspects have been respected by the author of this pull
request, confirmed by both pull request assignee **and** reviewer:

* Changelog update (necessity checked and entry added or not added
respectively)
  * [x] Pull Request Assignee
  * [x] Reviewer
* README update (necessity checked and entry added or not added
respectively)
  * [x] Pull Request Assignee
  * [x] Reviewer

---------

Co-authored-by: Staeck, Philipp <[email protected]>

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- manipulation SetInvocationEffectiveTimeoutLessThanOrEqualToThreshold for operations
 - manipulation SetModeOfOperationAndSetOperatingMode for combined settings
 - manipulation ConveyMetricDemoValues for metrics
 - manipulation SetAlertConditionAndAlertSignalActivationState for alert activation states

src/t2iapi/operation/operation_requests.proto

@@ -10,6 +10,7 @@ syntax = "proto3";
 package t2iapi.operation;
 
 import "t2iapi/operation/types.proto";
+import "google/protobuf/duration.proto";
 
 option java_package = "com.draeger.medical.t2iapi.operation";
 option java_outer_classname = "OperationRequests";
@@ -20,4 +21,17 @@ Request to change the devices state, which results in setting the requested Oper
 message SetOperatingModeRequest {
     string handle = 1;
     OperatingMode operating_mode = 2;
-}
+}
+
+/*
+Request to set the @InvocationEffectiveTimeout of the pm:AbstractOperationDescriptor with the given handle to a value
+that is less than or equal to the requested threshold.
+*/
+message SetInvocationEffectiveTimeoutLessThanOrEqualToThresholdRequest {
+    string handle = 1;  // handle of the pm:AbstractOperationDescriptor for which the @InvocationEffectiveTimeout
+                        // shall be set
+    google.protobuf.Duration threshold = 2;  // threshold value for which applies that the @InvocationEffectiveTimeout
+                                             // is less than or equal to this threshold value
+                                             // threshold value is represented as a count of seconds and fractions of
+                                             // seconds at nanosecond resolution
+}

src/t2iapi/operation/service.proto

@@ -29,4 +29,11 @@ service OperationService {
     rpc SetOperatingMode (t2iapi.operation.SetOperatingModeRequest)
         returns (BasicResponse);
 
+    /*
+    Set the @InvocationEffectiveTimeout of the pm:AbstractOperationDescriptor with the given handle to a value that is
+    less than or equal to the requested threshold.
+    */
+    rpc SetInvocationEffectiveTimeoutLessThanOrEqualToThreshold (
+        SetInvocationEffectiveTimeoutLessThanOrEqualToThresholdRequest)
+        returns (BasicResponse);
 }