Skip to content

Commit

Permalink
feat(openapi): add historic identity link endpoints
Browse files Browse the repository at this point in the history
* adds all historic identity link logs endpoints
* adds default date format link where missing for other endpoints

related to CAM-11561
  • Loading branch information
tmetzke authored May 5, 2021
1 parent f1f7487 commit 522182a
Show file tree
Hide file tree
Showing 12 changed files with 325 additions and 30 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -95,14 +95,14 @@
"type": "string",
"format": "date-time",
"desc": "Restrict to instances that were evaluated before the given date.
By default*, the date must have the format `yyyy-MM-
By [default](${docsUrl}/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-
dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`."
},
"evaluatedAfter": {
"type": "string",
"format": "date-time",
"desc": "Restrict to instances that were evaluated after the given date.
By default*, the date must have the format `yyyy-MM-
By [default](${docsUrl}/reference/rest/overview/date-format/), the date must have the format `yyyy-MM-
dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`."
},
"userId": {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@
'"incidentState"'
]>

<#assign dateDefault = "By [default](${docsUrl}/reference/rest/overview/date-format/), the date must have the format
`yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`.">

<#assign params = {
"incidentId": {
"type": "string",
Expand Down Expand Up @@ -66,34 +69,22 @@
"createTimeBefore": {
"type": "string",
"format": "date-time",
"desc": "Restricts to incidents that have a createTime date before the given date.
By default*, the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`,
e.g.,
`2013-01-23T14:42:45.000+0200`."
"desc": "Restricts to incidents that have a createTime date before the given date. ${dateDefault}"
},
"createTimeAfter": {
"type": "string",
"format": "date-time",
"desc": "Restricts to incidents that have a createTime date after the given date.
By default*, the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`,
e.g.,
`2013-01-23T14:42:45.000+0200`."
"desc": "Restricts to incidents that have a createTime date after the given date. ${dateDefault}"
},
"endTimeBefore": {
"type": "string",
"format": "date-time",
"desc": "Restricts to incidents that have an endTimeBefore date before the given date.
By default*, the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`,
e.g.,
`2013-01-23T14:42:45.000+0200`."
"desc": "Restricts to incidents that have an endTimeBefore date before the given date. ${dateDefault}"
},
"endTimeAfter": {
"type": "string",
"format": "date-time",
"desc": "Restricts to incidents that have an endTimeAfter date after the given date.
By default*, the date must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`,
e.g.,
`2013-01-23T14:42:45.000+0200`."
"desc": "Restricts to incidents that have an endTimeAfter date after the given date. ${dateDefault}"
},
"activityId": {
"type": "string",
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
<#-- Generated From File: camunda-docs-manual/public/reference/rest/history/identity-links/get-identity-link-query/index.html -->

<#assign sortByValues = [
'"time"',
'"type"',
'"userId"',
'"groupId"',
'"taskId"',
'"processDefinitionId"',
'"processDefinitionKey"',
'"operationType"',
'"assignerId"',
'"tenantId"'
]>

<#assign params = {
"type": {
"type": "string",
"desc": "Restricts to identity links that have the given type (candidate/assignee/owner)."
},
"userId": {
"type": "string",
"desc": "Restricts to identity links that have the given user id."
},
"groupId": {
"type": "string",
"desc": "Restricts to identity links that have the given group id."
},
"dateBefore": {
"type": "string",
"format": "date-time",
"desc": "Restricts to identity links that have the time before the given time."
},
"dateAfter": {
"type": "string",
"format": "date-time",
"desc": "Restricts to identity links that have the time after the given time."
},
"taskId": {
"type": "string",
"desc": "Restricts to identity links that have the given task id."
},
"processDefinitionId": {
"type": "string",
"desc": "Restricts to identity links that have the given process definition id."
},
"processDefinitionKey": {
"type": "string",
"desc": "Restricts to identity links that have the given process definition key."
},
"operationType": {
"type": "string",
"desc": "Restricts to identity links that have the given operationType (add/delete)."
},
"assignerId": {
"type": "string",
"desc": "Restricts to identity links that have the given assigner id."
},
"tenantIdIn": {
"type": "array",
"itemType": "string",
"desc": "Filter by a comma-separated list of tenant ids."
},
"withoutTenantId": {
"type": "boolean",
"desc": "Only include historic identity links that belong to no tenant. Value may only be
`true`, as `false` is the default behavior."
}
}>
Original file line number Diff line number Diff line change
Expand Up @@ -56,15 +56,17 @@
location = "query"
type = "string"
format = "date-time"
desc = "Restricts to incidents that have an incidentTimestamp date before the given date. By default, the date
desc = "Restricts to incidents that have an incidentTimestamp date before the given date.
By [default](${docsUrl}/reference/rest/overview/date-format/), the date
must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`." />

<@lib.parameter
name = "incidentTimestampAfter"
location = "query"
type = "string"
format = "date-time"
desc = "Restricts to incidents that have an incidentTimestamp date after the given date. By default*, the date
desc = "Restricts to incidents that have an incidentTimestamp date after the given date.
By [default](${docsUrl}/reference/rest/overview/date-format/), the date
must have the format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, e.g., `2013-01-23T14:42:45.000+0200`." />

<@lib.parameter
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@
{"name": "Historic Decision Requirements Definition"},
{"name": "Historic Detail"},
{"name": "Historic External Task Log"},
{"name": "Historic Identity Link Log"},
{"name": "Historic Incident"},
{"name": "Historic Job Log"},
{"name": "Historic Process Definition"},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,15 +42,16 @@
name = "createTime"
type = "string"
format = "date-time"
desc = "The time the variable was inserted. Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
desc = "The time the variable was inserted.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "removalTime"
type = "string"
format = "date-time"
desc = "The time after which the entry should be removed by the History Cleanup job.
Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,16 @@
name = "evaluationTime"
type = "string"
format = "date-time"
desc = "The time the instance was evaluated. Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
desc = "The time the instance was evaluated.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "removalTime"
type = "string"
format = "date-time"
desc = "The time after which the instance should be removed by the History Cleanup job.
Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,15 +61,16 @@
name = "createTime"
type = "string"
format = "date-time"
desc = "The time the variable was inserted. Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
desc = "The time the variable was inserted.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "removalTime"
type = "string"
format = "date-time"
desc = "The time after which the entry should be removed by the History Cleanup job.
Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
<#-- Generated From File: camunda-docs-manual/public/reference/rest/history/identity-links/get-identity-link-query/index.html -->
<#macro dto_macro docsUrl="">
<@lib.dto >

<@lib.property
name = "id"
type = "string"
desc = "Id of the Historic identity link entry."
/>

<@lib.property
name = "time"
type = "string"
format = "date-time"
desc = "The time when the identity link is logged.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "type"
type = "string"
desc = "The type of identity link (candidate/assignee/owner)."
/>

<@lib.property
name = "userId"
type = "string"
desc = "The id of the user/assignee."
/>

<@lib.property
name = "groupId"
type = "string"
desc = "The id of the group."
/>

<@lib.property
name = "taskId"
type = "string"
desc = "The id of the task."
/>

<@lib.property
name = "processDefinitionId"
type = "string"
desc = "The id of the process definition."
/>

<@lib.property
name = "processDefinitionKey"
type = "string"
desc = "The key of the process definition."
/>

<@lib.property
name = "operationType"
type = "string"
desc = "Type of operation (add/delete)."
/>

<@lib.property
name = "assignerId"
type = "string"
desc = "The id of the assigner."
/>

<@lib.property
name = "tenantId"
type = "string"
desc = "The id of the tenant."
/>

<@lib.property
name = "removalTime"
type = "string"
format = "date-time"
desc = "The time after which the identity link should be removed by the History Cleanup job.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "rootProcessInstanceId"
type = "string"
desc = "The process instance id of the root process instance that initiated the process
containing this identity link."
last = true
/>

</@lib.dto>
</#macro>
Original file line number Diff line number Diff line change
Expand Up @@ -43,23 +43,24 @@
name = "createTime"
type = "string"
format = "date-time"
desc = "The time this incident happened. Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
desc = "The time this incident happened.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "endTime"
type = "string"
format = "date-time"
desc = "The time this incident has been deleted or resolved. Default format* `yyyy-MM-
dd'T'HH:mm:ss.SSSZ`."
desc = "The time this incident has been deleted or resolved.
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
name = "removalTime"
type = "string"
format = "date-time"
desc = "The time after which the incident should be removed by the History Cleanup job.
Default format* `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
[Default format](${docsUrl}/reference/rest/overview/date-format/) `yyyy-MM-dd'T'HH:mm:ss.SSSZ`."
/>

<@lib.property
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
<#-- Generated From File: camunda-docs-manual/public/reference/rest/history/identity-links/get-identity-link-query-count/index.html -->
<#macro endpoint_macro docsUrl="">
{
<@lib.endpointInfo
id = "getHistoricIdentityLinksCount"
tag = "Historic Identity Link Log"
summary = "Get Identity Link Log Count"
desc = "Queries for the number of historic identity link logs that fulfill the given
parameters. Takes the same parameters as the
[Get Identity-Link-Logs](${docsUrl}/reference/rest/history/identity-links/get-identity-link-query/)
method."
/>

"parameters" : [

<#assign last = true >
<#include "/lib/commons/history-identity-link.ftl" >
<@lib.parameters
object = params
last = last
/>

],

"responses": {

<@lib.response
code = "200"
dto = "CountResultDto"
desc = "Request successful."
examples = ['"example-1": {
"summary": "GET `/history/identity-link-log/count?taskId=aTaskId`",
"description": "GET `/history/identity-link-log/count?taskId=aTaskId`",
"value": {
"count": 2
}
}']
/>

<@lib.response
code = "400"
dto = "ExceptionDto"
desc = "Returned if some of the query parameters are invalid, for example if a `sortOrder`
parameter is supplied, but no `sortBy`. See the
[Introduction](${docsUrl}/reference/rest/overview/#error-handling)
for the error response format."
last = true
/>

}

}
</#macro>
Loading

0 comments on commit 522182a

Please sign in to comment.