Get a user task list

Use this resource to retrieve a list of all tasks available for a specific user. The user is identified by the provided authentication.

Request

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

URL: /task/tasks

Method: GET

Authorization: required

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

Query Parameters

The following table lists the parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`start`	Enter the start row in the result (starts at 0).	no	Any positive integer
`count`	Enter the number of rows to return.	no	Any positive integer
`lang`	Enter the language code.	no (default: `de`)	`de` or `en`
`enableDIN5007Sort`	Specify if umlaut sort should be enabled.	no	`true` or `false`
`{field}Sorting`	Enter the sorting direction.	no	`ascending` or `descending`
`{field}FieldSorting`	Enter the field sorting direction. Use this parameter for custom task list entries.	no	`ascending` or `descending`
`{field}Filter`	Enter the filter value.	no	Any string
`{field}FilterComparison`	Enter the comparison value.	no	`LIKE` \| `=` \| `<` \| `>` \| `⇐` \| `>0`
`{field}FilterCaseSensitive`	Specify if case-sensitive comparison should be applied.	no	`true` or `false`
`{field}FieldFilterComparison`	Enter the field filter comparison value.	no	`LIKE` \| `=` \| `<` \| `>` \| `⇐` \| `>0`
`{field}FieldFilterCaseSensitive`	Specify if field filter case-sensitive comparison should be applied.	no	`true` or `false`
`{field}FieldFilter`	Enter the field filter value.	no	Any string
`{field}FilterTo`	Enter the filter field for ranges. Do not use this parameter together with comparison.	no	Any string

start

Enter the start row in the result (starts at 0).

Any positive integer

count

Enter the number of rows to return.

Any positive integer

lang

Enter the language code.

no (default: de)

de or en

enableDIN5007Sort

Specify if umlaut sort should be enabled.

true or false

{field}Sorting

Enter the sorting direction.

ascending or descending

{field}FieldSorting

Enter the field sorting direction. Use this parameter for custom task list entries.

ascending or descending

{field}Filter

Enter the filter value.

Any string

{field}FilterComparison

Enter the comparison value.

LIKE | = | < | > | ⇐ | >0

{field}FilterCaseSensitive

Specify if case-sensitive comparison should be applied.

true or false

{field}FieldFilterComparison

Enter the field filter comparison value.

LIKE | = | < | > | ⇐ | >0

{field}FieldFilterCaseSensitive

Specify if field filter case-sensitive comparison should be applied.

true or false

{field}FieldFilter

Enter the field filter value.

Any string

{field}FilterTo

Enter the filter field for ranges. Do not use this parameter together with comparison.

Any string

Response

The response contains the list of tasks.

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

<Tasklist user="root" total="7" portletUrl="[5]">
    <Task id="e9c47c0c-82b8-481d-8343-b883da299c0a" process="32361" creation="1261055573295" expiration="1261059173295" action="Form" wait="0" test="true" popup="false">
        <Name xml:lang="de">zwei zusätzliche felder</Name>
        <Description xml:lang="de">qa_task_portal_9</Description>
        <Unit name="Administrator" type="Role"/>
        <Field xml:lang="de" name="zwei" index="2" type="String">test wert 2</Field>
        <Field xml:lang="de" name="eins" index="1" type="String">1261055573277</Field>
    </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.