zeebe-client 0.13.2 → 0.14.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6a0afe36c2868f955e28238c6e5f406e8eb2a985c9a8a464566940fa5010c731
4
- data.tar.gz: 480bf5f843560e583428a3f5e3147ad948ddfbfd056916a1f250581597fb9146
3
+ metadata.gz: 1dbf1b8be6bc6352e6d77a9a2b06f9e9f48d8eef1841c62081ebffd769cfbf64
4
+ data.tar.gz: a6ca9262c4295a8db23b11bbdb91c086dbf8928105d3f85470d66c76af1863c4
5
5
  SHA512:
6
- metadata.gz: c1079c7ae7834e47dcf05da685466e790c384ba1ab3bbcd37f6f89e9baf6fb665b592017e2e6e0b2ff226037c88e4b0ee818fbf9e23404150b7ce35e6fe58f0d
7
- data.tar.gz: 535b6dddf3323fa6b3ea7859879ff011ac97eb174a6973a74d31fd63d04f894b0479945faf7efcedabc1a4b024d62e30642560b3f4ec10c06746fa1b07463266
6
+ metadata.gz: 52fc1ece0c404e4c1befd56ec0c99c0230856245bf0176e49aaba03b8bd2a1b97a80a5bd27823d9f6dcb273ed639ce17e7a43056aeaa3dffed8a8b2ca426259b
7
+ data.tar.gz: 4e333c196bae5df1454e35c4d1519e52b5293365d5b88d29a47811cbfc67ccc652eefedd3e0cad933979e9ba7c907a73b7096f034c75dda39d7a03ef3cfdfa93
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.14.0 (May 17, 2021)
4
+
5
+ - add support for [Zeebe 1.0.0](https://github.com/zeebe-io/zeebe/releases/tag/1.0.0), thanks [@EugeneIstomin](https://github.com/zeebe-io/zeebe-client-ruby/pull/69)
6
+
3
7
  ## 0.13.2 (March 30, 2021)
4
8
 
5
9
  - add support for [Zeebe 0.26.2](https://github.com/zeebe-io/zeebe/releases/tag/0.26.2)
@@ -11,7 +15,7 @@
11
15
 
12
16
  ## 0.13.0 (February 3, 2021)
13
17
 
14
- - add support for [Zeebe 0.26.0](https://github.com/zeebe-io/zeebe/releases/tag/0.26.0), thanks []@rusterholz](https://github.com/zeebe-io/zeebe-client-ruby/pull/62)
18
+ - add support for [Zeebe 0.26.0](https://github.com/zeebe-io/zeebe/releases/tag/0.26.0), thanks [@rusterholz](https://github.com/zeebe-io/zeebe-client-ruby/pull/62)
15
19
 
16
20
  ## 0.12.1 (December 11, 2020)
17
21
 
data/README.md CHANGED
@@ -13,7 +13,7 @@ Install the gem:
13
13
  Run a Zeebe instance locally:
14
14
 
15
15
  ```sh
16
- docker run -it --rm -p 26500:26500 camunda/zeebe:0.26.2
16
+ docker run -it --rm -p 26500:26500 camunda/zeebe:1.0.0
17
17
  ```
18
18
 
19
19
  And then try the available [demo script](examples/demo.rb).
data/Rakefile CHANGED
@@ -13,7 +13,7 @@ task ci: ['zeebe:start', :default, 'zeebe:stop']
13
13
 
14
14
  desc 'Starts Zeebe Docker container'
15
15
  task 'zeebe:start' do
16
- sh 'docker run -d --name zeebe --rm -p 26500:26500 camunda/zeebe:0.26.2'
16
+ sh 'docker run -d --name zeebe --rm -p 26500:26500 camunda/zeebe:1.0.0'
17
17
  sleep(10)
18
18
  end
19
19
 
@@ -19,10 +19,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
19
19
  add_message "gateway_protocol.ActivatedJob" do
20
20
  optional :key, :int64, 1
21
21
  optional :type, :string, 2
22
- optional :workflowInstanceKey, :int64, 3
22
+ optional :processInstanceKey, :int64, 3
23
23
  optional :bpmnProcessId, :string, 4
24
- optional :workflowDefinitionVersion, :int32, 5
25
- optional :workflowKey, :int64, 6
24
+ optional :processDefinitionVersion, :int32, 5
25
+ optional :processDefinitionKey, :int64, 6
26
26
  optional :elementId, :string, 7
27
27
  optional :elementInstanceKey, :int64, 8
28
28
  optional :customHeaders, :string, 9
@@ -31,10 +31,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
31
31
  optional :deadline, :int64, 12
32
32
  optional :variables, :string, 13
33
33
  end
34
- add_message "gateway_protocol.CancelWorkflowInstanceRequest" do
35
- optional :workflowInstanceKey, :int64, 1
34
+ add_message "gateway_protocol.CancelProcessInstanceRequest" do
35
+ optional :processInstanceKey, :int64, 1
36
36
  end
37
- add_message "gateway_protocol.CancelWorkflowInstanceResponse" do
37
+ add_message "gateway_protocol.CancelProcessInstanceResponse" do
38
38
  end
39
39
  add_message "gateway_protocol.CompleteJobRequest" do
40
40
  optional :jobKey, :int64, 1
@@ -42,51 +42,45 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
42
42
  end
43
43
  add_message "gateway_protocol.CompleteJobResponse" do
44
44
  end
45
- add_message "gateway_protocol.CreateWorkflowInstanceRequest" do
46
- optional :workflowKey, :int64, 1
45
+ add_message "gateway_protocol.CreateProcessInstanceRequest" do
46
+ optional :processDefinitionKey, :int64, 1
47
47
  optional :bpmnProcessId, :string, 2
48
48
  optional :version, :int32, 3
49
49
  optional :variables, :string, 4
50
50
  end
51
- add_message "gateway_protocol.CreateWorkflowInstanceResponse" do
52
- optional :workflowKey, :int64, 1
51
+ add_message "gateway_protocol.CreateProcessInstanceResponse" do
52
+ optional :processDefinitionKey, :int64, 1
53
53
  optional :bpmnProcessId, :string, 2
54
54
  optional :version, :int32, 3
55
- optional :workflowInstanceKey, :int64, 4
55
+ optional :processInstanceKey, :int64, 4
56
56
  end
57
- add_message "gateway_protocol.CreateWorkflowInstanceWithResultRequest" do
58
- optional :request, :message, 1, "gateway_protocol.CreateWorkflowInstanceRequest"
57
+ add_message "gateway_protocol.CreateProcessInstanceWithResultRequest" do
58
+ optional :request, :message, 1, "gateway_protocol.CreateProcessInstanceRequest"
59
59
  optional :requestTimeout, :int64, 2
60
60
  repeated :fetchVariables, :string, 3
61
61
  end
62
- add_message "gateway_protocol.CreateWorkflowInstanceWithResultResponse" do
63
- optional :workflowKey, :int64, 1
62
+ add_message "gateway_protocol.CreateProcessInstanceWithResultResponse" do
63
+ optional :processDefinitionKey, :int64, 1
64
64
  optional :bpmnProcessId, :string, 2
65
65
  optional :version, :int32, 3
66
- optional :workflowInstanceKey, :int64, 4
66
+ optional :processInstanceKey, :int64, 4
67
67
  optional :variables, :string, 5
68
68
  end
69
- add_message "gateway_protocol.DeployWorkflowRequest" do
70
- repeated :workflows, :message, 1, "gateway_protocol.WorkflowRequestObject"
69
+ add_message "gateway_protocol.DeployProcessRequest" do
70
+ repeated :processes, :message, 1, "gateway_protocol.ProcessRequestObject"
71
71
  end
72
- add_message "gateway_protocol.WorkflowRequestObject" do
72
+ add_message "gateway_protocol.ProcessRequestObject" do
73
73
  optional :name, :string, 1
74
- optional :type, :enum, 2, "gateway_protocol.WorkflowRequestObject.ResourceType"
75
- optional :definition, :bytes, 3
74
+ optional :definition, :bytes, 2
76
75
  end
77
- add_enum "gateway_protocol.WorkflowRequestObject.ResourceType" do
78
- value :FILE, 0
79
- value :BPMN, 1
80
- value :YAML, 2
81
- end
82
- add_message "gateway_protocol.DeployWorkflowResponse" do
76
+ add_message "gateway_protocol.DeployProcessResponse" do
83
77
  optional :key, :int64, 1
84
- repeated :workflows, :message, 2, "gateway_protocol.WorkflowMetadata"
78
+ repeated :processes, :message, 2, "gateway_protocol.ProcessMetadata"
85
79
  end
86
- add_message "gateway_protocol.WorkflowMetadata" do
80
+ add_message "gateway_protocol.ProcessMetadata" do
87
81
  optional :bpmnProcessId, :string, 1
88
82
  optional :version, :int32, 2
89
- optional :workflowKey, :int64, 3
83
+ optional :processDefinitionKey, :int64, 3
90
84
  optional :resourceName, :string, 4
91
85
  end
92
86
  add_message "gateway_protocol.FailJobRequest" do
@@ -169,19 +163,18 @@ module Zeebe::Client::GatewayProtocol
169
163
  ActivateJobsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ActivateJobsRequest").msgclass
170
164
  ActivateJobsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ActivateJobsResponse").msgclass
171
165
  ActivatedJob = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ActivatedJob").msgclass
172
- CancelWorkflowInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CancelWorkflowInstanceRequest").msgclass
173
- CancelWorkflowInstanceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CancelWorkflowInstanceResponse").msgclass
166
+ CancelProcessInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CancelProcessInstanceRequest").msgclass
167
+ CancelProcessInstanceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CancelProcessInstanceResponse").msgclass
174
168
  CompleteJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CompleteJobRequest").msgclass
175
169
  CompleteJobResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CompleteJobResponse").msgclass
176
- CreateWorkflowInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateWorkflowInstanceRequest").msgclass
177
- CreateWorkflowInstanceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateWorkflowInstanceResponse").msgclass
178
- CreateWorkflowInstanceWithResultRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateWorkflowInstanceWithResultRequest").msgclass
179
- CreateWorkflowInstanceWithResultResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateWorkflowInstanceWithResultResponse").msgclass
180
- DeployWorkflowRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.DeployWorkflowRequest").msgclass
181
- WorkflowRequestObject = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.WorkflowRequestObject").msgclass
182
- WorkflowRequestObject::ResourceType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.WorkflowRequestObject.ResourceType").enummodule
183
- DeployWorkflowResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.DeployWorkflowResponse").msgclass
184
- WorkflowMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.WorkflowMetadata").msgclass
170
+ CreateProcessInstanceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateProcessInstanceRequest").msgclass
171
+ CreateProcessInstanceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateProcessInstanceResponse").msgclass
172
+ CreateProcessInstanceWithResultRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateProcessInstanceWithResultRequest").msgclass
173
+ CreateProcessInstanceWithResultResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.CreateProcessInstanceWithResultResponse").msgclass
174
+ DeployProcessRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.DeployProcessRequest").msgclass
175
+ ProcessRequestObject = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ProcessRequestObject").msgclass
176
+ DeployProcessResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.DeployProcessResponse").msgclass
177
+ ProcessMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ProcessMetadata").msgclass
185
178
  FailJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.FailJobRequest").msgclass
186
179
  FailJobResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.FailJobResponse").msgclass
187
180
  ThrowErrorRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("gateway_protocol.ThrowErrorRequest").msgclass
@@ -8,7 +8,7 @@ module Zeebe::Client::GatewayProtocol
8
8
  module Gateway
9
9
  class Service
10
10
 
11
- include GRPC::GenericService
11
+ include ::GRPC::GenericService
12
12
 
13
13
  self.marshal_class_method = :encode
14
14
  self.unmarshal_class_method = :decode
@@ -26,12 +26,12 @@ module Zeebe::Client::GatewayProtocol
26
26
  # - maxJobsToActivate is less than 1
27
27
  rpc :ActivateJobs, ::Zeebe::Client::GatewayProtocol::ActivateJobsRequest, stream(::Zeebe::Client::GatewayProtocol::ActivateJobsResponse)
28
28
  #
29
- # Cancels a running workflow instance
29
+ # Cancels a running process instance
30
30
  #
31
31
  # Errors:
32
32
  # NOT_FOUND:
33
- # - no workflow instance exists with the given key
34
- rpc :CancelWorkflowInstance, ::Zeebe::Client::GatewayProtocol::CancelWorkflowInstanceRequest, ::Zeebe::Client::GatewayProtocol::CancelWorkflowInstanceResponse
33
+ # - no process instance exists with the given key
34
+ rpc :CancelProcessInstance, ::Zeebe::Client::GatewayProtocol::CancelProcessInstanceRequest, ::Zeebe::Client::GatewayProtocol::CancelProcessInstanceResponse
35
35
  #
36
36
  # Completes a job with the given variables, which allows completing the associated service task.
37
37
  #
@@ -45,41 +45,40 @@ module Zeebe::Client::GatewayProtocol
45
45
  # the job can be activated again and completed.
46
46
  rpc :CompleteJob, ::Zeebe::Client::GatewayProtocol::CompleteJobRequest, ::Zeebe::Client::GatewayProtocol::CompleteJobResponse
47
47
  #
48
- # Creates and starts an instance of the specified workflow. The workflow definition to use to
48
+ # Creates and starts an instance of the specified process. The process definition to use to
49
49
  # create the instance can be specified either using its unique key (as returned by
50
- # DeployWorkflow), or using the BPMN process ID and a version. Pass -1 as the version to use the
51
- # latest deployed version. Note that only workflows with none start events can be started through
50
+ # DeployProcess), or using the BPMN process ID and a version. Pass -1 as the version to use the
51
+ # latest deployed version. Note that only processes with none start events can be started through
52
52
  # this command.
53
53
  #
54
54
  # Errors:
55
55
  # NOT_FOUND:
56
- # - no workflow with the given key exists (if workflowKey was given)
57
- # - no workflow with the given process ID exists (if bpmnProcessId was given but version was -1)
58
- # - no workflow with the given process ID and version exists (if both bpmnProcessId and version were given)
56
+ # - no process with the given key exists (if processDefinitionKey was given)
57
+ # - no process with the given process ID exists (if bpmnProcessId was given but version was -1)
58
+ # - no process with the given process ID and version exists (if both bpmnProcessId and version were given)
59
59
  #
60
60
  # FAILED_PRECONDITION:
61
- # - the workflow definition does not contain a none start event; only workflows with none
61
+ # - the process definition does not contain a none start event; only processes with none
62
62
  # start event can be started manually.
63
63
  #
64
64
  # INVALID_ARGUMENT:
65
65
  # - the given variables argument is not a valid JSON document; it is expected to be a valid
66
66
  # JSON document where the root node is an object.
67
- rpc :CreateWorkflowInstance, ::Zeebe::Client::GatewayProtocol::CreateWorkflowInstanceRequest, ::Zeebe::Client::GatewayProtocol::CreateWorkflowInstanceResponse
67
+ rpc :CreateProcessInstance, ::Zeebe::Client::GatewayProtocol::CreateProcessInstanceRequest, ::Zeebe::Client::GatewayProtocol::CreateProcessInstanceResponse
68
68
  #
69
- # Behaves similarly to `rpc CreateWorkflowInstance`, except that a successful response is received when the workflow completes successfully.
70
- rpc :CreateWorkflowInstanceWithResult, ::Zeebe::Client::GatewayProtocol::CreateWorkflowInstanceWithResultRequest, ::Zeebe::Client::GatewayProtocol::CreateWorkflowInstanceWithResultResponse
69
+ # Behaves similarly to `rpc CreateProcessInstance`, except that a successful response is received when the process completes successfully.
70
+ rpc :CreateProcessInstanceWithResult, ::Zeebe::Client::GatewayProtocol::CreateProcessInstanceWithResultRequest, ::Zeebe::Client::GatewayProtocol::CreateProcessInstanceWithResultResponse
71
71
  #
72
- # Deploys one or more workflows to Zeebe. Note that this is an atomic call,
73
- # i.e. either all workflows are deployed, or none of them are.
72
+ # Deploys one or more processes to Zeebe. Note that this is an atomic call,
73
+ # i.e. either all processes are deployed, or none of them are.
74
74
  #
75
75
  # Errors:
76
76
  # INVALID_ARGUMENT:
77
77
  # - no resources given.
78
78
  # - if at least one resource is invalid. A resource is considered invalid if:
79
- # - it is not a BPMN or YAML file (currently detected through the file extension)
80
79
  # - the resource data is not deserializable (e.g. detected as BPMN, but it's broken XML)
81
- # - the workflow is invalid (e.g. an event-based gateway has an outgoing sequence flow to a task)
82
- rpc :DeployWorkflow, ::Zeebe::Client::GatewayProtocol::DeployWorkflowRequest, ::Zeebe::Client::GatewayProtocol::DeployWorkflowResponse
80
+ # - the process is invalid (e.g. an event-based gateway has an outgoing sequence flow to a task)
81
+ rpc :DeployProcess, ::Zeebe::Client::GatewayProtocol::DeployProcessRequest, ::Zeebe::Client::GatewayProtocol::DeployProcessResponse
83
82
  #
84
83
  # Marks the job as failed; if the retries argument is positive, then the job will be immediately
85
84
  # activatable again, and a worker could try again to process it. If it is zero or negative however,
@@ -95,7 +94,7 @@ module Zeebe::Client::GatewayProtocol
95
94
  # - the job is already in a failed state, i.e. ran out of retries
96
95
  rpc :FailJob, ::Zeebe::Client::GatewayProtocol::FailJobRequest, ::Zeebe::Client::GatewayProtocol::FailJobResponse
97
96
  #
98
- # Reports a business error (i.e. non-technical) that occurs while processing a job. The error is handled in the workflow by an error catch event. If there is no error catch event with the specified errorCode then an incident will be raised instead.
97
+ # Reports a business error (i.e. non-technical) that occurs while processing a job. The error is handled in the process by an error catch event. If there is no error catch event with the specified errorCode then an incident will be raised instead.
99
98
  #
100
99
  # Errors:
101
100
  # NOT_FOUND:
@@ -122,7 +121,7 @@ module Zeebe::Client::GatewayProtocol
122
121
  # - no incident with the given key exists
123
122
  rpc :ResolveIncident, ::Zeebe::Client::GatewayProtocol::ResolveIncidentRequest, ::Zeebe::Client::GatewayProtocol::ResolveIncidentResponse
124
123
  #
125
- # Updates all the variables of a particular scope (e.g. workflow instance, flow element instance)
124
+ # Updates all the variables of a particular scope (e.g. process instance, flow element instance)
126
125
  # from the given JSON document.
127
126
  #
128
127
  # Errors:
@@ -1,6 +1,6 @@
1
1
 
2
2
  module Zeebe
3
3
  module Client
4
- VERSION = '0.13.2'.freeze
4
+ VERSION = '0.14.0'.freeze
5
5
  end
6
6
  end
data/proto/gateway.proto CHANGED
@@ -2,11 +2,11 @@ syntax = 'proto3';
2
2
  package gateway_protocol;
3
3
 
4
4
  option java_multiple_files = false;
5
- option java_package = "io.zeebe.gateway.protocol";
6
- option go_package = "pb";
5
+ option java_package = "io.camunda.zeebe.gateway.protocol";
6
+ option go_package = "./;pb";
7
7
 
8
8
  // For a more complete documentation, refer to Zeebe documentation at:
9
- // https://docs.zeebe.io/grpc/reference.html
9
+ // https://docs.camunda.io/docs/reference/grpc
10
10
 
11
11
  message ActivateJobsRequest {
12
12
  // the job type, as defined in the BPMN process (e.g. <zeebe:taskDefinition
@@ -38,18 +38,18 @@ message ActivatedJob {
38
38
  int64 key = 1;
39
39
  // the type of the job (should match what was requested)
40
40
  string type = 2;
41
- // the job's workflow instance key
42
- int64 workflowInstanceKey = 3;
43
- // the bpmn process ID of the job workflow definition
41
+ // the job's process instance key
42
+ int64 processInstanceKey = 3;
43
+ // the bpmn process ID of the job process definition
44
44
  string bpmnProcessId = 4;
45
- // the version of the job workflow definition
46
- int32 workflowDefinitionVersion = 5;
47
- // the key of the job workflow definition
48
- int64 workflowKey = 6;
45
+ // the version of the job process definition
46
+ int32 processDefinitionVersion = 5;
47
+ // the key of the job process definition
48
+ int64 processDefinitionKey = 6;
49
49
  // the associated task element ID
50
50
  string elementId = 7;
51
51
  // the unique key identifying the associated task, unique within the scope of the
52
- // workflow instance
52
+ // process instance
53
53
  int64 elementInstanceKey = 8;
54
54
  // a set of custom headers defined during modelling; returned as a serialized
55
55
  // JSON document
@@ -65,13 +65,13 @@ message ActivatedJob {
65
65
  string variables = 13;
66
66
  }
67
67
 
68
- message CancelWorkflowInstanceRequest {
69
- // the workflow instance key (as, for example, obtained from
70
- // CreateWorkflowInstanceResponse)
71
- int64 workflowInstanceKey = 1;
68
+ message CancelProcessInstanceRequest {
69
+ // the process instance key (as, for example, obtained from
70
+ // CreateProcessInstanceResponse)
71
+ int64 processInstanceKey = 1;
72
72
  }
73
73
 
74
- message CancelWorkflowInstanceResponse {
74
+ message CancelProcessInstanceResponse {
75
75
  }
76
76
 
77
77
  message CompleteJobRequest {
@@ -84,102 +84,91 @@ message CompleteJobRequest {
84
84
  message CompleteJobResponse {
85
85
  }
86
86
 
87
- message CreateWorkflowInstanceRequest {
88
- // the unique key identifying the workflow definition (e.g. returned from a workflow
89
- // in the DeployWorkflowResponse message)
90
- int64 workflowKey = 1;
91
- // the BPMN process ID of the workflow definition
87
+ message CreateProcessInstanceRequest {
88
+ // the unique key identifying the process definition (e.g. returned from a process
89
+ // in the DeployProcessResponse message)
90
+ int64 processDefinitionKey = 1;
91
+ // the BPMN process ID of the process definition
92
92
  string bpmnProcessId = 2;
93
93
  // the version of the process; set to -1 to use the latest version
94
94
  int32 version = 3;
95
95
  // JSON document that will instantiate the variables for the root variable scope of the
96
- // workflow instance; it must be a JSON object, as variables will be mapped in a
96
+ // process instance; it must be a JSON object, as variables will be mapped in a
97
97
  // key-value fashion. e.g. { "a": 1, "b": 2 } will create two variables, named "a" and
98
98
  // "b" respectively, with their associated values. [{ "a": 1, "b": 2 }] would not be a
99
99
  // valid argument, as the root of the JSON document is an array and not an object.
100
100
  string variables = 4;
101
101
  }
102
102
 
103
- message CreateWorkflowInstanceResponse {
104
- // the key of the workflow definition which was used to create the workflow instance
105
- int64 workflowKey = 1;
106
- // the BPMN process ID of the workflow definition which was used to create the workflow
103
+ message CreateProcessInstanceResponse {
104
+ // the key of the process definition which was used to create the process instance
105
+ int64 processDefinitionKey = 1;
106
+ // the BPMN process ID of the process definition which was used to create the process
107
107
  // instance
108
108
  string bpmnProcessId = 2;
109
- // the version of the workflow definition which was used to create the workflow instance
109
+ // the version of the process definition which was used to create the process instance
110
110
  int32 version = 3;
111
- // the unique identifier of the created workflow instance; to be used wherever a request
112
- // needs a workflow instance key (e.g. CancelWorkflowInstanceRequest)
113
- int64 workflowInstanceKey = 4;
111
+ // the unique identifier of the created process instance; to be used wherever a request
112
+ // needs a process instance key (e.g. CancelProcessInstanceRequest)
113
+ int64 processInstanceKey = 4;
114
114
  }
115
115
 
116
- message CreateWorkflowInstanceWithResultRequest {
117
- CreateWorkflowInstanceRequest request = 1;
118
- // timeout (in ms). the request will be closed if the workflow is not completed
116
+ message CreateProcessInstanceWithResultRequest {
117
+ CreateProcessInstanceRequest request = 1;
118
+ // timeout (in ms). the request will be closed if the process is not completed
119
119
  // before the requestTimeout.
120
120
  // if requestTimeout = 0, uses the generic requestTimeout configured in the gateway.
121
121
  int64 requestTimeout = 2;
122
- // list of names of variables to be included in `CreateWorkflowInstanceWithResultResponse.variables`
122
+ // list of names of variables to be included in `CreateProcessInstanceWithResultResponse.variables`
123
123
  // if empty, all visible variables in the root scope will be returned.
124
124
  repeated string fetchVariables = 3;
125
125
  }
126
126
 
127
- message CreateWorkflowInstanceWithResultResponse {
128
- // the key of the workflow definition which was used to create the workflow instance
129
- int64 workflowKey = 1;
130
- // the BPMN process ID of the workflow definition which was used to create the workflow
127
+ message CreateProcessInstanceWithResultResponse {
128
+ // the key of the process definition which was used to create the process instance
129
+ int64 processDefinitionKey = 1;
130
+ // the BPMN process ID of the process definition which was used to create the process
131
131
  // instance
132
132
  string bpmnProcessId = 2;
133
- // the version of the workflow definition which was used to create the workflow instance
133
+ // the version of the process definition which was used to create the process instance
134
134
  int32 version = 3;
135
- // the unique identifier of the created workflow instance; to be used wherever a request
136
- // needs a workflow instance key (e.g. CancelWorkflowInstanceRequest)
137
- int64 workflowInstanceKey = 4;
135
+ // the unique identifier of the created process instance; to be used wherever a request
136
+ // needs a process instance key (e.g. CancelProcessInstanceRequest)
137
+ int64 processInstanceKey = 4;
138
138
  // JSON document
139
139
  // consists of visible variables in the root scope
140
140
  string variables = 5;
141
141
 
142
142
  }
143
143
 
144
- message DeployWorkflowRequest {
145
- // List of workflow resources to deploy
146
- repeated WorkflowRequestObject workflows = 1;
144
+ message DeployProcessRequest {
145
+ // List of process resources to deploy
146
+ repeated ProcessRequestObject processes = 1;
147
147
  }
148
148
 
149
- message WorkflowRequestObject {
150
- enum ResourceType {
151
- // FILE type means the gateway will try to detect the resource type
152
- // using the file extension of the name field
153
- FILE = 0;
154
- BPMN = 1; // extension 'bpmn'
155
- YAML = 2; // extension 'yaml'
156
- }
157
-
149
+ message ProcessRequestObject {
158
150
  // the resource basename, e.g. myProcess.bpmn
159
151
  string name = 1;
160
- // the resource type; if set to BPMN or YAML then the file extension
161
- // is ignored
162
- ResourceType type = 2;
163
152
  // the process definition as a UTF8-encoded string
164
- bytes definition = 3;
153
+ bytes definition = 2;
165
154
  }
166
155
 
167
- message DeployWorkflowResponse {
156
+ message DeployProcessResponse {
168
157
  // the unique key identifying the deployment
169
158
  int64 key = 1;
170
- // a list of deployed workflows
171
- repeated WorkflowMetadata workflows = 2;
159
+ // a list of deployed processes
160
+ repeated ProcessMetadata processes = 2;
172
161
  }
173
162
 
174
- message WorkflowMetadata {
163
+ message ProcessMetadata {
175
164
  // the bpmn process ID, as parsed during deployment; together with the version forms a
176
- // unique identifier for a specific workflow definition
165
+ // unique identifier for a specific process definition
177
166
  string bpmnProcessId = 1;
178
167
  // the assigned process version
179
168
  int32 version = 2;
180
- // the assigned key, which acts as a unique identifier for this workflow
181
- int64 workflowKey = 3;
182
- // the resource name (see: WorkflowRequestObject.name) from which this workflow was
169
+ // the assigned key, which acts as a unique identifier for this process
170
+ int64 processDefinitionKey = 3;
171
+ // the resource name (see: ProcessRequestObject.name) from which this process was
183
172
  // parsed
184
173
  string resourceName = 4;
185
174
  }
@@ -300,7 +289,7 @@ message UpdateJobRetriesResponse {
300
289
  }
301
290
 
302
291
  message SetVariablesRequest {
303
- // the unique identifier of a particular element; can be the workflow instance key (as
292
+ // the unique identifier of a particular element; can be the process instance key (as
304
293
  // obtained during instance creation), or a given element, such as a service task (see
305
294
  // elementInstanceKey on the job message)
306
295
  int64 elementInstanceKey = 1;
@@ -338,13 +327,13 @@ service Gateway {
338
327
  }
339
328
 
340
329
  /*
341
- Cancels a running workflow instance
330
+ Cancels a running process instance
342
331
 
343
332
  Errors:
344
333
  NOT_FOUND:
345
- - no workflow instance exists with the given key
334
+ - no process instance exists with the given key
346
335
  */
347
- rpc CancelWorkflowInstance (CancelWorkflowInstanceRequest) returns (CancelWorkflowInstanceResponse) {
336
+ rpc CancelProcessInstance (CancelProcessInstanceRequest) returns (CancelProcessInstanceResponse) {
348
337
  }
349
338
 
350
339
  /*
@@ -363,48 +352,47 @@ service Gateway {
363
352
  }
364
353
 
365
354
  /*
366
- Creates and starts an instance of the specified workflow. The workflow definition to use to
355
+ Creates and starts an instance of the specified process. The process definition to use to
367
356
  create the instance can be specified either using its unique key (as returned by
368
- DeployWorkflow), or using the BPMN process ID and a version. Pass -1 as the version to use the
369
- latest deployed version. Note that only workflows with none start events can be started through
357
+ DeployProcess), or using the BPMN process ID and a version. Pass -1 as the version to use the
358
+ latest deployed version. Note that only processes with none start events can be started through
370
359
  this command.
371
360
 
372
361
  Errors:
373
362
  NOT_FOUND:
374
- - no workflow with the given key exists (if workflowKey was given)
375
- - no workflow with the given process ID exists (if bpmnProcessId was given but version was -1)
376
- - no workflow with the given process ID and version exists (if both bpmnProcessId and version were given)
363
+ - no process with the given key exists (if processDefinitionKey was given)
364
+ - no process with the given process ID exists (if bpmnProcessId was given but version was -1)
365
+ - no process with the given process ID and version exists (if both bpmnProcessId and version were given)
377
366
 
378
367
  FAILED_PRECONDITION:
379
- - the workflow definition does not contain a none start event; only workflows with none
368
+ - the process definition does not contain a none start event; only processes with none
380
369
  start event can be started manually.
381
370
 
382
371
  INVALID_ARGUMENT:
383
372
  - the given variables argument is not a valid JSON document; it is expected to be a valid
384
373
  JSON document where the root node is an object.
385
374
  */
386
- rpc CreateWorkflowInstance (CreateWorkflowInstanceRequest) returns (CreateWorkflowInstanceResponse) {
375
+ rpc CreateProcessInstance (CreateProcessInstanceRequest) returns (CreateProcessInstanceResponse) {
387
376
  }
388
377
 
389
378
  /*
390
- Behaves similarly to `rpc CreateWorkflowInstance`, except that a successful response is received when the workflow completes successfully.
379
+ Behaves similarly to `rpc CreateProcessInstance`, except that a successful response is received when the process completes successfully.
391
380
  */
392
- rpc CreateWorkflowInstanceWithResult (CreateWorkflowInstanceWithResultRequest) returns (CreateWorkflowInstanceWithResultResponse) {
381
+ rpc CreateProcessInstanceWithResult (CreateProcessInstanceWithResultRequest) returns (CreateProcessInstanceWithResultResponse) {
393
382
  }
394
383
 
395
384
  /*
396
- Deploys one or more workflows to Zeebe. Note that this is an atomic call,
397
- i.e. either all workflows are deployed, or none of them are.
385
+ Deploys one or more processes to Zeebe. Note that this is an atomic call,
386
+ i.e. either all processes are deployed, or none of them are.
398
387
 
399
388
  Errors:
400
389
  INVALID_ARGUMENT:
401
390
  - no resources given.
402
391
  - if at least one resource is invalid. A resource is considered invalid if:
403
- - it is not a BPMN or YAML file (currently detected through the file extension)
404
392
  - the resource data is not deserializable (e.g. detected as BPMN, but it's broken XML)
405
- - the workflow is invalid (e.g. an event-based gateway has an outgoing sequence flow to a task)
393
+ - the process is invalid (e.g. an event-based gateway has an outgoing sequence flow to a task)
406
394
  */
407
- rpc DeployWorkflow (DeployWorkflowRequest) returns (DeployWorkflowResponse) {
395
+ rpc DeployProcess (DeployProcessRequest) returns (DeployProcessResponse) {
408
396
  }
409
397
 
410
398
  /*
@@ -425,7 +413,7 @@ service Gateway {
425
413
  }
426
414
 
427
415
  /*
428
- Reports a business error (i.e. non-technical) that occurs while processing a job. The error is handled in the workflow by an error catch event. If there is no error catch event with the specified errorCode then an incident will be raised instead.
416
+ Reports a business error (i.e. non-technical) that occurs while processing a job. The error is handled in the process by an error catch event. If there is no error catch event with the specified errorCode then an incident will be raised instead.
429
417
 
430
418
  Errors:
431
419
  NOT_FOUND:
@@ -461,7 +449,7 @@ service Gateway {
461
449
  }
462
450
 
463
451
  /*
464
- Updates all the variables of a particular scope (e.g. workflow instance, flow element instance)
452
+ Updates all the variables of a particular scope (e.g. process instance, flow element instance)
465
453
  from the given JSON document.
466
454
 
467
455
  Errors:
data/zeebe-client.gemspec CHANGED
@@ -22,10 +22,10 @@ Gem::Specification.new do |s|
22
22
  s.add_runtime_dependency 'grpc', '~> 1.32'
23
23
 
24
24
  s.add_development_dependency 'bundler'
25
- s.add_development_dependency 'bundler-audit', '~> 0.7.0'
25
+ s.add_development_dependency 'bundler-audit', '~> 0.8.0'
26
26
  s.add_development_dependency 'grpc-tools', '~> 1.32'
27
27
  s.add_development_dependency 'rake'
28
28
  s.add_development_dependency 'rspec'
29
- s.add_development_dependency 'rubocop', '~> 1.11.0'
29
+ s.add_development_dependency 'rubocop', '~> 1.13.0'
30
30
  s.add_development_dependency 'solargraph'
31
31
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: zeebe-client
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.2
4
+ version: 0.14.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Christian Nicolai
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-03-30 00:00:00.000000000 Z
11
+ date: 2021-05-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: grpc
@@ -44,14 +44,14 @@ dependencies:
44
44
  requirements:
45
45
  - - "~>"
46
46
  - !ruby/object:Gem::Version
47
- version: 0.7.0
47
+ version: 0.8.0
48
48
  type: :development
49
49
  prerelease: false
50
50
  version_requirements: !ruby/object:Gem::Requirement
51
51
  requirements:
52
52
  - - "~>"
53
53
  - !ruby/object:Gem::Version
54
- version: 0.7.0
54
+ version: 0.8.0
55
55
  - !ruby/object:Gem::Dependency
56
56
  name: grpc-tools
57
57
  requirement: !ruby/object:Gem::Requirement
@@ -100,14 +100,14 @@ dependencies:
100
100
  requirements:
101
101
  - - "~>"
102
102
  - !ruby/object:Gem::Version
103
- version: 1.11.0
103
+ version: 1.13.0
104
104
  type: :development
105
105
  prerelease: false
106
106
  version_requirements: !ruby/object:Gem::Requirement
107
107
  requirements:
108
108
  - - "~>"
109
109
  - !ruby/object:Gem::Version
110
- version: 1.11.0
110
+ version: 1.13.0
111
111
  - !ruby/object:Gem::Dependency
112
112
  name: solargraph
113
113
  requirement: !ruby/object:Gem::Requirement