Operation: GetTask | X4Documentation

With the GetTask operation of the Task Management adapter, you return a task for the logged-in user.

For more information on other operations of the Task Management adapter, see Task Management.

Parameters

`limit`	🔷 This parameter is optional. If the parameter is not set, all tasks are output. Page size for retrieving the task list Possible values: Any number `> 0`
`offset`	🔷 This parameter is optional. If the parameter is not set, all tasks are output. Offset for retrieving the task list Possible values: Any number `> 0`
`state`	✳️ This parameter is required. State filter for retrieving the task list Possible values: `OPEN`: Open tasks `IN_PROGRESS`: Tasks in progress `CLOSED`: Closed tasks
`taskUuid`	UUID of the task Note: You can identify the UUID of a task by executing the `GetAllTasks` operation. For more information, see Operation: GetAllTasks. Possible values: Valid UUID, such as `443c498a-5868-4110-891f-42e5cb8fc24e`
`userForDebugging`	User to be used for debugging when there is no login in X4 Web Apps Possible values: Valid user login, e.g. `admin`
`dataformatVersion`	Version of the data format used Possible values: `1.0`: Data format used up to version 7.0 `2.0`: Data format used as of version 7.0, see input examples

Status values

`1`	The operation was executed successfully.
`-1`	The operation failed due to a technical error.

Input

The adapter does not expect any specific input.

Output

The adapter issues an XML document with the following structure as output:

XML

<?xml version="1.0" encoding="UTF-8"?>
<Task created="2020-12-21T09:10:53Z" creator="System"
      id="81f4abb5-c2f5-418e-acf5-654304234bf4">
    <Title>humantask</Title>
    <Owner>admin</Owner>
    <Assignment type="USER">admin</Assignment>
    <State>OPEN</State>
    <KeyIdentifier/>
    <CaseId>00860a8a-12b9-45b8-b271-ec5d42573c59</CaseId>
    <Actions>
        <Action displayName="done" name="Accepted"/>
        <Action displayName="Declined" name="Declined"/>
    </Actions>
    <DecliningAllowed>false</DecliningAllowed>
    <ForwardingAllowed>false</ForwardingAllowed>
    <Comments/>
    <BusinessData>
        <Company>Max Mustermann Inc.</Lastname>
        <MarketValue>100 Mio. €</MarketValue>
        <Offer>150 Mio. €</Offer>
    </BusinessData>
</Task>