X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Operation: EditTask

With the EditTask operation of the Task Management adapter, you lock a task for other users and update features.

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 expects an XML document with the following structure as input:

<?xml version="1.0" encoding="UTF-8"?>
<EditTask>
	<Offer> 150 Mio. €</Offer>
</EditTask>

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>