Get tasks by filter

Use this resource to retrieve tasks based on sort and filter configurations. You must provide these configurations in the request body.

Request

To retrieve the tasks, send a GET request to the endpoint defined below.

URL: /task/taskfilter

Method: GET

Authorization: required

GET /ibis/rest/task/taskfilter HTTP/1.1
Accept: application/xml
Host: localhost:8080

Path Parameters

This request does not require any additional parameters.

Request Body

Provide the filter and sort criteria in the request body.

<TaskListRequest>
    <Sorting>
        <SortField>
            <Field>NAME</Field>
            <Order>DESCENDING</Order>
        </SortField>
    </Sorting>
</TaskListRequest>

Response

The response contains a list of tasks that match the specified filter criteria.

HTTP/1.1 200 OK
Content-Type: application/xml

<Tasklist user="admin" total="11">
    <Task id="8cc6cf92-d532-4f79-bc2f-40078162d52d" process="20002" creation="1719745444852" expiration="1719749044852" action="Form" wait="0" test="true" client="admin">
        <Name xml:lang="de">TextFIeld</Name>
        <Description xml:lang="de"></Description>
        <Unit name="admin" type="Role" />
    </Task>
    <Task id="47f63300-c17d-4b10-938a-cd0be2fcb25b" process="20001" creation="1719737716026" expiration="1719996916026" action="Form" wait="0" test="true" client="admin" delegateRuleSetId="7efed0e6-7f00-0101-218f-31c46b1f3241" locked="admin">
        <Name xml:lang="de">Task_Delegate_to_all</Name>
        <Description xml:lang="de">Task_Delegate_to_all</Description>
        <Unit name="admin" type="Role" />
    </Task>
    <Task id="569ae6dc-0371-4203-9263-ec5294ac1d5c" process="20002" creation="1719745445096" expiration="1719749045096" action="Form" wait="0" test="true" client="admin">
        <Name xml:lang="de">Radio Button Task</Name>
        <Description xml:lang="de">Radio Button Task Desc</Description>
        <Unit name="admin" type="Role" />
    </Task>
    <Task id="8aa7369a-aac1-49cc-a25d-8584ffaae0df" process="20002" creation="1719745444948" expiration="1719749044948" action="Form" wait="0" test="true" client="admin">
        <Name xml:lang="de">List Task</Name>
        <Description xml:lang="de">List Task Desc</Description>
        <Unit name="admin" type="Role" />
    </Task>
    <Task id="4c3162e9-47e6-4124-a502-8f52ae2ba95b" process="20002" creation="1719745445111" expiration="1719749045111" action="Info" wait="0" test="true" client="admin">
        <Name xml:lang="de">InformationTask</Name>
        <Description xml:lang="de">This is an information task</Description>
        <Unit name="admin" type="Role" />
    </Task>
</Tasklist>

Errors

This request might return one of the following error codes:

Authorization Failed (401): Authorization with the given username and password failed. Please revisit both values and provide valid credentials.

<html>

    <head>
        <title>Status page</title>
    </head>

    <body style="font-family: sans-serif;">
        <p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
        <p>The request requires user authentication</p>
        <p>You can get technical details <a
                href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
            Please continue your visit at our <a href="/">home page</a>.
        </p>
    </body>
</html>

Server Error (500): Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.
Service Unavailable (503): In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.