TaskFieldDefaultValueSources

Introduction

TaskFieldDefaultValueSources define prefilled values for TaskFields.

[Adm.] Create

Definition

POST /api/administration/tasks-2/templates/fields/default-value-sources

Request Keys

Key	Type	Default	Description
source_type*	string	-	Allowed values: formFieldValue, systemVariable.
form_field_id*	integer	-	Target TaskField ID.
config	object	type default	Source-specific configuration.
source_entity_type	string | null	null	Morph alias of source entity (typically formField for field-value source).
source_entity_id	integer | null	null	Source entity ID (required with source_entity_type).
sort_number	integer	auto	Evaluation order per field.

Keys with * are required.

Example Request

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/administration/tasks-2/templates/fields/default-value-sources', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'form_field_id' => 33,
        'source_type' => 'systemVariable',
        'config' => [
            'variable_key' => 'system.user.id',
            'variable_filter' => null
        ]
    ]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 52,
    "form_field_id": 33,
    "source_type": "systemVariable",
    "config": {
      "variable_key": "system.user.id",
      "variable_filter": null
    },
    "source_entity_type": null,
    "source_entity_id": null,
    "sort_number": 1
  }
}

[Adm.] Update

Definition

PUT /api/administration/tasks-2/templates/fields/default-value-sources/{defaultValueSource}

Request Keys

Key	Type	Description
source_type	string	New source type (formFieldValue, systemVariable).
form_field_id	integer	New target field ID.
config	object	Updated source configuration.
source_entity_type	string | null	New source entity type.
source_entity_id	integer | null	New source entity ID.
sort_number	integer	New evaluation order.

Example Request

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('PUT', '/api/administration/tasks-2/templates/fields/default-value-sources/52', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'source_type' => 'formFieldValue',
        'source_entity_type' => 'formField',
        'source_entity_id' => 33
    ]
]);

Example Response

{
  "status": "success",
  "data": {
    "id": 52,
    "form_field_id": 33,
    "source_type": "formFieldValue",
    "config": {},
    "source_entity_type": "formField",
    "source_entity_id": 33,
    "sort_number": 1
  }
}

[Adm.] Delete

Definition

DELETE /api/administration/tasks-2/templates/fields/default-value-sources/{defaultValueSource}

Request Keys

No additional request keys.

Example Request

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('DELETE', '/api/administration/tasks-2/templates/fields/default-value-sources/52', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "status": "success",
  "data": null
}

Runtime default values for task executions

Resolved default values for a specific execution are returned by:

Definition

GET /api/tasks-2/executions/{taskExecution}/default-values

Request Keys

Key	Type	Default	Description
taskExecution	integer	-	Task execution ID

Example Request

$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/tasks-2/executions/812/default-values', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);

Example Response

{
  "33": {
    "value": "2"
  }
}