API docs by Redocly

adiutaOpt (v8.3.0)

Download OpenAPI specification:

adiutaByte GmbH: info@adiutabyte.de URL: https://adiutabyte.de

Introduction

Welcome to the adiutaOpt API documentation!

This document specifies all endpoints and schema requirements. If you notice an error, please contact us.

The typical process of an optimization request looks as follows:

  • Obtain authentication tokens
  • Use authentication tokens to post an input data set to the optimization request endpoint. If everything is in order, a key will be returned that has to be stored
    • If the request was rejected, check authentication details and schema. The return code and data will give some hints as to what needs to be fixed.
  • Use the authentication token and the key on the solution endpoint to request the solved data.
    • If the plan is still in calculation, wait until it's done
    • If the calculation has finished, store the solution
  • Check if the calculation could be carried out or if an error was returned (see ErrorPlan as possible return data of the solution endpoint)

The overview site can be found here.

Deployment Status

  • API Script Version: v2.3.13
  • Application Version: 2026-02-19_0
  • Schema Version: v8.3.0

Common Data Types

Types that are reused in different definitions.

Date

string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

A string consisting of three parts following the pattern "YYYY-MM-DD":

  • "YYYY" year AD: 0-9999
  • "MM" month: 1-12
  • "DD" day: 1-31

While the schema does not check for validity, the optimization algorithms do. Including invalid dates (e.g. 2020-02-31) leads to a validation error.

Examples:

  • "2020-04-10"
  • "2051-4-1"
  • "1953-04-10"
"2020-04-10"

Language Type

integer (Language Type) [ 0 .. 1 ]

Values are:

  • 0: German
  • 1: English
1

Time

string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

A string of either format "hh:mm" or "-hh:mm":

  • "hh": hours (24h format),
  • "mm": minutes

Times are always interpreted relative to a date in the same object as the Time field. This allows times to exceed 24h or even become negative, as the value gets "added" to midnight of the date. For example, the following times applied to the respective date (in Date format) are equivalent:

  • "2021-05-21" at "07:25"
  • "2021-05-20" at "31:25"
  • "2021-05-19" at "55:25"
  • "2021-05-22" at "-16:35"
  • "2021-05-23" at "-40:35"
"07:25"

Gender Type

integer (Gender Type) [ 0 .. 3 ]

Values are:

  • 0: not provided
  • 1: male
  • 2: female
  • 3: other
3

FieldPlacerVersion

string (FieldPlacerVersion) ^[0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]+(p[0-9]+)?$...

A version consisting of the date of release [0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]+, which can have a patch suffix p[0-9]+.

"1970-01-01_0p0"

SemanticVersion

string (SemanticVersion) ^(v)?(0|([1-9][0-9]{0,4}))(\.(0|([1-9][0-9]{0...

See https://semver.org/ for a full description of semantic versioning. The regex here is a subset of allowed semantic versions.

"v1.2.3"

Authentication

How to authenticate before any request.

AWS Cognito

The authentication is performed via AWS Cognito (Developer-Guide). It is recommended to use one of the SKDs provided by AWS to simplify the authentication process considerably. Examples for SDKs:

Configuration

  • Used protocol: Secure Remote Password Protocol
  • User pool data:
    • UserPoolId: eu-central-1_0nXRn1JFH
    • ClientId: 5n75tqsegshum2i9o0bgavmmuf
  • Username/Password are provided when signing up for an account. If you don't have an account, please contact us.

Tokens

Authentication provides three tokens: the access-token, the ID-token and the refresh-token. All three are JSON Web Tokens.

  • The access-token is currently not used in the API.
  • The ID-token has to be proposed in every request in the header as follows:

Authorization: 'ID-token'

  • The ID-token contains a timestamp when the token has been authorized (auth_time) and when it will expire (exp). Currently, an ID-token expires after one hour and requests with expired ID-tokens are rejected automatically. You can get a new ID-token by using the refresh-token without having to re-enter your credentials.

Request samples 

const user = "";        // your username
const pw = "";          // your password
const userPoolID = "";  // UserPoolID, see configuration details
const clientID = "";    // ClientId, see configuration details

const AmazonCognitoIdentity = require('amazon-cognito-identity-js');

module.exports.login = () => new Promise((resolve, reject) => {

  const userPool = new AmazonCognitoIdentity.CognitoUserPool({
    UserPoolId: userPoolID,
    ClientId: clientID
  });

  const authenticationDetails = new AmazonCognitoIdentity.AuthenticationDetails({
      Username: user,
      Password: pw,
  });

  const cognitoUser = new AmazonCognitoIdentity.CognitoUser({
      Username: user,
      Pool: userPool
  });

  cognitoUser.authenticateUser(authenticationDetails, {
    onSuccess: function (result) {
        const token = result.getIdToken().getJwtToken();
        resolve(token);
    },
    onFailure: function (err) {
        reject();
    }
  });
})

Optimization Request

Post an optimization request.

Optimization Request

Post a request to be solved.

If a new optimization request was received and was successfully processed, the endpoint will return 201 and the key with which the solution can be retrieved. This does not mean that calculating a solution will succeed, as logic errors, invalid ids and many other checks are performed later - these kinds of issues will result in an ErrorPlan, retrievable from the solution endpoint. Only schema violations are being checked in this request, they will result in the request being rejected with code 422.

Usually, if an optimization request was received but an identical request was already posted before, the endpoint will return 200 and the key with which the solution can be retrieved, which is identical to the key from the earlier request. This is not the case for certain errors which allow a repeat request (marked by the allowRepeat property of an ErrorPlan). Repeats for such requests are allowed after a certain amount of time has passed, trying to post before this cooldown has expired will result in rejection (code 429) where the retry-after header contains the remaining time in seconds until the request will be accepted again. If the repeat request was accepted, the endpoint returns code 201 and a new key to get the solution with.

Request to this endpoint have a content size limit which depends on the used content-type. Requests with content-type: application/json must contain a "plain-text" json payload which must be less than 6Mb in size. For sending larger requests, you must use content-type: application/vnd.adiutabyte.adiutaopt.json+[gzip,deflate,br]. These requests must contain the json data, compressed with gzip, deflate (zlib) or brotli, the payload size limit is 4.5Mb for the compressed data.

Authorizations:
BearerAuth
header Parameters
required
"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

The content-type of the payload. Invalid values result in status code 415.

adiutaopt-version
string

(optional) A specific version to process the request under. Valid versions can be retrieved with the /packages-list endpoint (Name).

Using a specific version is not recommended for "general" application but for testing, debugging or other developer actions. Versions represent a specific state of the application, they cannot be changed, bug-fixed or extended in any way. For that reason, support for these requests may be limited.

Request Body schema:
object (Client)

Contains information about the client which sends this request.

required
object (FloorPlannerMeta)

Meta information about what to consider in the optimization.

required
object (FloorPlannerOptimizationParameters)

Parameters for the optimizer.

required
Array of objects (FloorPlannerInputTask)

Array of tasks to be planned by the optimizer.

required
Array of objects (FloorPlannerInputWorker)

Array of available workers.

object (FloorPlannerHistory)

History data the optimizer can learn from to apply to the current request. History analysis is done differently for each of our customers, if you know what issues you want to address/ what results you want to see from such methods, please contact us so we can set up a solution.

recovery
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

This is a field only used for debugging by internal developers. Content in this field may change depending on the application, input-data and version. The output values can be used as input values.

Responses

Request samples

Content type
Example

Basic blueprint for an optimization data set

{
  • "meta": {
    },
  • "parameters": { },
  • "tasks": [
    ],
  • "workers": [
    ]
}

Response samples

Content type
application/json
"VGVzdEtleUZvckFQSURvY3VtZW50YXRpb24uYXNk=="

Optimization Request (Preflight)

Responses

Solution

Retrieve the optimization solution for any application

Retrieving Solution

Retrieve the solution from this endpoint with the key you got when posting the request. The solution can either be a solved request or an ErrorPlan.

Responses from this endpoint have a content size limit which depends on the used content-type of the response, which can be specified with the accept header. If the response size would exceed that limit, the endpoint returns code 409 instead. Responses of type application/json can include payloads of up to 6Mb, all other types can return up to 4.5Mb of (compressed) data.

Authorizations:
BearerAuth
path Parameters
planID
required
string

Key returned in the 200/201 response of the POST request

header Parameters
"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Responses

Request samples 

curl \
  --request GET \
  --url '[see url above]/[key obtained from POST request]' \
  --header 'Authorization: Bearer [ID-Token obtained from Authentication (JWT)]'

Response samples

Content type
Example
{
  • "requestID": "string",
  • "client": {
    },
  • "meta": {
    },
  • "parameters": {
    },
  • "tasks": [
    ],
  • "workers": [
    ],
  • "statistics": {
    },
  • "info": {
    },
  • "anomalies": [
    ],
  • "backendVersion": {
    },
  • "recovery": [
    ]
}

Get Solution (Preflight)

path Parameters
planID
required
string

Can be anything.

Responses

Get Solution (header-only)

Same behavior as the GET request but returns no content for any of the responses.

path Parameters
planID
required
string

Key returned in the 200/201 response of the POST request

header Parameters
"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Version

Retrieve currently deployed version data

Get Version

Get the currently deployed version.

Responses from this endpoint have a content size limit which depends on the used content-type of the response, which can be specified with the accept header. If the response size would exceed that limit, the endpoint returns code 409 instead. Responses of type application/json can include payloads of up to 6Mb, all other types can return up to 4.5Mb of (compressed) data.

Authorizations:
BearerAuth
header Parameters
adiutaopt-version
string

(optional) A specific version to process the request under. Valid versions can be retrieved with the /packages-list endpoint (Name).

Using a specific version is not recommended for "general" application but for testing, debugging or other developer actions. Versions represent a specific state of the application, they cannot be changed, bug-fixed or extended in any way. For that reason, support for these requests may be limited.

"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Responses

Request samples 

curl \
  --request GET \
  --url '[see url above]' \
  --header 'Authorization: Bearer [ID-Token obtained from Authentication (JWT)]'

Response samples

Content type
{
  • "schema": "v1.7.0",
  • "version": "2024-10-01_0",
  • "meta_data": "v19",
  • "api_scripts": "v1.6.2"
}

Get Version (Preflight)

Responses

Get Version (header-only)

Same behavior as the GET request but returns no content for any of the responses.

header Parameters
adiutaopt-version
string

(optional) A specific version to process the request under. Valid versions can be retrieved with the /packages-list endpoint (Name).

Using a specific version is not recommended for "general" application but for testing, debugging or other developer actions. Versions represent a specific state of the application, they cannot be changed, bug-fixed or extended in any way. For that reason, support for these requests may be limited.

"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Get List of Available Packages

Get a list of all available packages. The Name of each package can be used in a POST request in header adiutaopt-version, the algorithm will then run on the specified version.

Responses from this endpoint have a content size limit which depends on the used content-type of the response, which can be specified with the accept header. If the response size would exceed that limit, the endpoint returns code 409 instead. Responses of type application/json can include payloads of up to 6Mb, all other types can return up to 4.5Mb of (compressed) data.

Authorizations:
BearerAuth
header Parameters
"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Responses

Request samples 

curl \
  --request GET \
  --url '[see url above]' \
  --header 'Authorization: Bearer [ID-Token obtained from Authentication (JWT)]'

Response samples

Content type
[
  • {
    },
  • {
    }
]

Get List of Available Packages (Preflight)

Responses

Get List of Available Packages (header-only)

Same behavior as the GET request but returns no content for any of the responses.

header Parameters
"application/json" (string) or "application/vnd.adiutabyte.adiutaopt.json+gzip" (string) or "application/vnd.adiutabyte.adiutaopt.json+deflate" (string) or "application/vnd.adiutabyte.adiutaopt.json+br" (string)

(optional) The content-type of the response. Defaults to application/json if not set, invalid values result in status code 406.

"identity" (string) or "gzip" (string) or "deflate" (string)

(optional) The content-encode of the response. Only permitted for application/json responses.

Error IDs

The following list contains all error solution data used by the algorithm. The solution's language is determined by the input file's language setting, certain arguments will be inserted into the templates. "Internal errors" have an additional sentence attached at the end of the template, telling users to contact the developer team, as these are not fixable by adjusting input information alone.

errorID Name Internal error? Allow repeat request? Contains taskID? Contains workerID? Message template English Message template German
44 TravelNotPossible Travel between two points is not possible: {0}. Eine Fahrt zwischen zwei Punkten im Input ist nicht möglich: {0}.
45 PreparationValidationFailure Pre-validation failed: {0}. Vor-Validierung ist fehlgeschlagen: {0}.
46 PreparationError ✔ Error while while preparing data: {0}. You may try to repeat the request, if the issue persists, please contact the developers! Fehler bei der Vorbearbeitung der Daten: {0}. Sie können die Anfrage wiederholen - falls das Problem dauerhaft auftritt, kontaktieren Sie bitte die Entwickler!
47 ErrorPostRequest Error while posting request: {0}. Fehler beim Senden der Plananfrage: {0}.
48 ErrorGetRequest Error while getting solution: {0}. Fehler beim Abholen des gelösten Planes: {0}.
49 InvalidSchemaPostRequest Posted invalid data to endpoint! Errors: {0}. Ungültige Daten an Endpunkt gesendet! Fehler: {0}.
92 CannotCreateErrorBody ✔ Critical error while creating error notification. Kritischer Fehler beim Erzeugen einer Fehlermeldung.
93 SeverePreparationError ✔ Critical error while preparing data. Kritischer Fehler in der Datenvorbearbeitung.
94 SevereErrorPostRequest ✔ Critical error while posting request: {0}. Kritischer Fehler beim Senden der Plananfrage: {0}.
95 InvalidTimeoutCalculation ✔ Invalid remaining time for calculation. Ungültige Restzeit für Planberechnung.
96 SevereErrorGetRequest ✔ Critical error while getting solution: {0}. Kritischer Fehler beim Abholen eines gelösten Plans.
97 PlanHandlingTimeout ✔ Irregular timeout without solution. Irreguläre Zeitüberschreitung ohne Lösung.
98 MissingExecutable ✔ Cannot find optimizer data. Plandaten können nicht gefunden werden.
99 CriticalCalculationError ✔ Critical error while optimizing. Kritischer Fehler beim Optimieren der Plananfrage.
100 InvalidError ✔ Invalid error code in error solution: {0}. Ungültiger Fehlercode in Fehleroutput: {0}.
101 UncaughtException ✔ An uncaught error occurred: {0}. Ein Fehler konnte nicht abgefangen werden: {0}.
102 InvalidErrorSolutionSave ✔ Error while creating error solution. Fehler beim Erstellen einer Fehlermeldung.
103 DisjunctTimeout ✔ Timeout in an invalid optimizer state. Zeitüberschreitung in einem unzulässigen Stadium der Optimierung.
104 InvalidValidationData ✔ Invalid validation data while writing error message. Ungültige Validierungsdaten beim Schreiben einer Fehlermeldung.
105 SignalError ✔ Abnormal termination via signal {0} ({1}). Irregulärer Abbruch durch Signal {0} ({1}).
110 InvalidWorker A worker contains input data errors. Missing field: {0}. Bei einem Mitarbeiter ist ein Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
111 InvalidTask A task contains input data errors. Missing field: {0}. Bei einer Aufgabe ist ein Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
112 InvalidLocationSite A location site contains input data errors. Missing field: {0}. Bei einem Ort ist ein Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
113 InvalidObstacle An obstacle contains input data errors. Bei einem Hindernis sind Fehler in den Inputdaten vorhanden.
114 NoWorkersInInput There is no worker array in the input data file. Es ist kein Feld für Mitarbeiter in den Inputdaten angegeben.
115 NoTasksInInput There is no task array in the input data file. Es ist kein Feld für Aufgaben in den Inputdaten angegeben.
116 InvalidHistoryAssignment A historical assignment contains input data errors. Missing field: {0}. Bei einer historischen Zuweisung sind Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
117 InvalidHistoryWorker A historical worker contains input data errors. Missing field: {0}. Bei einem historischen Mitarbeiter sind Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
118 InvalidHistoryTask A historical task contains input data errors. Missing field: {0}. Bei einem historischen Auftrag sind Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
119 NoWorkersInHistory There is no worker array in the history of the input data file. Es ist kein Feld für Mitarbeiter in der Historie der Inputdaten angegeben.
120 TaskTimeGTShiftTime The sum of task duration exceeds the sum of available shift time. Es sind mehr reine Arbeitsminuten zu verteilen als durch Mitarbeiterschichten verfügbar.
121 DuplicateTaskID ✔ The input data contains two tasks with ID #{0}. In den Eingabedaten existieren zwei Aufgaben mit ID #{0}.
122 DuplicateWorkerID ✔ The input data contains two workers with ID #{0}. In den Eingabedaten existieren zwei Mitarbeiter mit ID #{0}.
123 TaskTimeWindowTooSmall ✔ The task #{0} with a duration of {1} min does not fit into the given timeslot ({2} - {3}). Die Aufgabe #{0} (Dauer: {1} min) passt nicht in den angegebenen Zeitslot ({2} - {3}).
124 InvalidRelationGroup A subset of tasks, which have to be assigned to a single worker, have no worker that can fulfill all of their requirements. Task ids: {0}. Eine Teilmenge der Aufgaben, die alle einem Mitarbeiter zugewiesen werden müssen, hat keinen Mitarbeiter, der deren Anforderungen erfüllen kann. Aufgaben IDs: {0}.
125 InvalidParameter Invalid parameter. Ungültiger Parameter.
126 ConflictingDontVaryReplacement ✔ Task #{0} and #{1} are part of a forced task chain but have different fixed/ order-fixed assignments. Aufgabe #{0} und #{1} sind Teil einer erzwungenen Kette von Aufgaben, haben aber einen unterschiedlichen Status bezüglich fixer/ Reihenfolgen-fixer Zuweisung.
127 TaskTimeWindowForMinTaskDurationTooSmall ✔ The task #{0} with a provided minimum task duration of {1} min does not fit into the given timeslot ({2} - {3}). Die Aufgabe #{0} (durch gesetzte Mindestaufgabendauer: {1} min) passt nicht in den angegebenen Zeitslot ({2} - {3}).
128 NegativeTimeWindowDuration ✔ The time window for task #{0} ends before it even begins (begin: {1}, end: {2}). Das Zeitfenster von Aufgabe #{0} endet bevor es beginnt (Start: {1}, Ende: {2}).
250 CSVPFileNotSet ✔ Input file for population maps cannot be read. Das Input-File für die Population-Map kann nicht gelesen werden.
251 CSVOFileNotSet ✔ Input file for obstacle maps cannot be read. Das Input-File für die Obstacle-Map kann nicht gelesen werden.
252 CSVCFileNotSet ✔ Input file for construction maps cannot be read. Das Input-File für die Baustellen-Map kann nicht gelesen werden.
253 InputPathNotValid ✔ Invalid filepath, file not found. Der angegebene Pfad enthält keine lesbare Datei.
254 InvalidClientMetaParameters ✔ The meta data contains conflicting parameters. Die Metadaten beinhalten widersprüchliche Parameter.
300 NoWorkerBeforeFBTP ✔ No worker available for planning. Kein Mitarbeiter zum Verplanen verfügbar.
301 NoTaskBeforeFBTP ✔ No task available for planning. Keine Aufgabe zum Verplanen verfügbar.
302 InvalidSVSInFBTP ✔ Missing worker in plan data for FBTP. Mitarbeiter fehlt in Plandaten für FBTP.
303 InvalidSVSSizeInFBTP ✔ Invalid svs size in FBTP. Ungültige Größe der SVS in FBTP.
304 InvalidMVSInFBTP ✔ Invalid mvs size in FBTP. Ungültige Größe der MVS in FBTP.
305 NoWorkersInGreedy ✔ Missing workers in GDY. Mitarbeiter fehlen in GDY.
306 MissingWorkerGreedy ✔ Missing worker in plan data for GDY. Mitarbeiter fehlen in Plandaten in GDY.
307 InvalidSVSSizeGreedy ✔ Invalid svs size in GDY. Ungültige Größe der SVS in GDY.
308 InvalidMVSGreedy ✔ Invalid mvs size in GDY. Ungültige Größe der MVS in GDY.
309 InvalidSVSInCLS ✔ Missing worker in plan data for clustering. Mitarbeiter fehlt in Plandaten für Clustering.
310 InvalidSVSSizeInCLS ✔ Invalid svs size in clustering. Ungültige Größe der SVS in Clustering.
311 InvalidMVSInCLS ✔ Invalid mvs size in clustering. Ungültige Größe der MVS in Clustering.
400 NoNeighbors ✔ Empty neighborhood. Leere Nachbarschaft.
401 InvalidFraction ✔ Invalid fraction of {0}. Ungültige Fraction von {0}.
500 LocationIDNotInList ✔ There is no location saved to ID {0}. Keine Koordinaten zu ID {0} gefunden.
501 WorkerUIDOutOfRange ✔ Worker uid request out of range: {0}. Mitarbeiter-UID Anfrage ungültig: {0}.
502 WorkerUIDNotFound ✔ No worker found with uid {0}. Mitarbeiter mit UID {0} existiert nicht.
503 TaskUIDOutOfRange ✔ Task uid request out of range: {0}. Aufgaben-UID Anfrage ungültig: {0}.
504 TaskUIDNotFound ✔ No task found with uid {0}. Aufgabe mit UID {0} existiert nicht.
505 FailedDeterminingDeadlines ✔ ✔ Can't calculate the deadline for task #{0}. Die Deadline von Aufgabe #{0} kann nicht berechnet werden.
506 InvalidDateString ✔ Invalid date: {0}. Ungültiges Datum: {0}.
507 InvalidSaturdaysSinceDate ✔ Requesting number of Saturdays on invalid date range: {0} to {1}. Abfrage der Samstage auf ungültigem Bereich: {0} bis {1}.
508 InvalidSundaysSinceDate ✔ Requesting number of Sundays on invalid date range: {0} to {1}. Abfrage der Sonntage auf ungültigem Bereich: {0} bis {1}.
509 InvalidMonth ✔ Invalid month: {0}. Ungültiger Monat: {0}.
510 DMInvalidConstruct ✔ Matrix construction of invalid size. Matrix-Konstruktion mit ungültiger Größe.
511 DMVectorSizeMismatchColumns ✔ Number of columns in matrix does not match vector size. Matrix-Spaltenzahl und Vectorgröße sind nicht gleich.
512 DMInvalidmatrixMult ✔ Invalid dimensions for matrix multiplication. Ungültige Dimensionen für Matrix-Multiplikation.
513 DMInvalidmatrixAdd ✔ Invalid dimensions for matrix addition. Ungültige Dimensionen für Matrix-Addition.
514 DMInvalidmatrixSubtract ✔ Invalid dimensions for matrix subtraction. Ungültige Dimensionen für Matrix-Subtraktion.
515 DMInvalidCG ✔ Solving with CG is not possible on this matrix. CG-Verfahren kann nicht auf Matrix angewendet werden.
516 DMInvalidCoordinates ✔ Invalid matrix access: {0} ({1}), {2} ({3}). Ungültiger Zugriff auf Matrix: {0} ({1}), {2} ({3}).
517 InvalidNodeID ✔ Node with ID {0} does not exist. Knoten mit ID {0} existiert nicht.
518 InvalidEdgeID ✔ Edge with ID {0} does not exist. Kante mit ID {0} existiert nicht.
519 SFOutOfRange ✔ Invalid parameters for scaling factor: {0}/{1}. Ungültige Parameter für Skalierungsfaktor: {0}/{1}.
520 PVInvalidConstruct ✔ Permutation vector construction of invalid size. Permutationsvektor-Konstruktion mit ungültiger Größe.
521 InvalidPointString ✔ Invalid coordinates: {0}. Ungültige Koordinaten: {0}.
522 DivisionByZero ✔ Division by zero. Division durch null.
523 QTEmptyPointList ✔ Cannot generate quadtree, empty coordinate list. Quadtree kann nicht erzeugt werden, Koordinatenliste leer.
524 QTInvalidBoundingBox ✔ Invalid bounding box for quadtree coordinate list. Ungültige BoundingBox für Quadtree-Koordinaten.
525 QTNotInitialized ✔ Quadtree not initialized. Quadtree nicht initialisiert.
526 QTInitialPointSearch ✔ Invalid coordinate search in Quadtree. Ungültige Suche nach Koordinaten in Quadtree.
527 QTCoordPairNotContained ✔ Coordinate pair not contained within quadtree. Koordinatenpaar nicht in Quadtree enthalten.
528 QTEmptyCell ✔ Empty quadtree cell. Leere Quadtree-Zelle.
529 QTInvalidSearch ✔ Cannot find quadtree cell. Quadtree-Zelle konnte nicht gefunden werden.
530 InvalidStringConversionToInt ✔ Number cannot be read from string: {0}. Zahl kann nicht aus string gelesen werden: {0}.
531 InitialTimeObject ✔ Invalid call on initial time object. Ungültiger Aufruf auf initialem Zeit-Objekt.
532 InvalidStringConversionToTime ✔ Invalid time format: {0}. Ungültiges Zeitformat: {0}.
533 TimerNotRunning ✔ Timer cannot be stopped. Timer kann nicht gestoppt werden.
534 MaldefinedPopMacros ✔ Population limit macros wrongly defined. Population-Limit-Macros fehlerhaft angelegt.
535 TSMInvalidMeta ✔ Invalid meta data in population file. Fehlerhafte Meta-Daten in Population-File.
536 FPVIncompatibleSize ✔ Invalid vector sizes for operator. Vektoren haben eine inkompatible Größe.
537 FPVNegativeElement ✔ Vector contains negative element. Vektor beinhaltet negatives Element.
538 FPVInvalidConstruction ✔ Invalid vector construction. Ungültige Vektor-Konstruktion.
539 FPVInvalidIndex ✔ Invalid index query: {0} ({1}). Ungültiger Index in Abfrage: {0} ({1}).
540 IONotANumber ✔ Expected number in field: {0}. Zahl in Feld erwartet: {0}.
541 IONotAnInteger ✔ Expected integer in field: {0}. Ganze Zahl in Feld erwartet: {0}.
542 IONotABoolean ✔ Expected boolean in field: {0}. Boolean in Feld erwartet: {0}.
543 IONotAString ✔ Expected text in field: {0}. Text in Feld erwartet: {0}.
544 IONotAVehicle ✔ Expected vehicle type in field: {0}. Fahrzeugtyp in Feld erwartet: {0}.
545 IONotAGenderType ✔ Expected gender type in field: {0}. Geschlechtertyp in Feld erwartet: {0}.
546 IONotALangType ✔ Expected language type in field: {0}. Sprachtyp in Feld erwartet: {0}.
547 IONotCoordinates ✔ Expected coordinates in field: {0}. Koordinaten in Feld erwartet: {0}.
548 IONotAnArray ✔ Expected array in field: {0}. Array in Feld erwartet: {0}.
549 IONotANumberArray ✔ Expected numbers in array: {0}. Zahlen in Array erwartet: {0}.
550 IONotAnIntegerArray ✔ Expected integers in array: {0}. Ganze Zahlen in Array erwartet: {0}.
551 IONotACoordinateArray ✔ Expected coordinates in array: {0}. Koordinaten in Array erwartet: {0}.
552 IONonexistantField ✔ Input data field does not exist: {0}. Inputdatenfeld existiert nicht: {0}.
553 IOInvalidArrayIterator ✔ Invalid index in data array. Ungültiger Index in Daten-Array.
554 UnexpectedNull ✔ Unexpected null reference. Unerwartete Null-Referenz.
555 IOConflictingType ✔ Input data field exists with a different type: {0}. Inputdatenfeld existiert bereits mit anderem Typ: {0}.
556 IOAlreadyExists ✔ Input data field already exists: {0}. Inputdatenfeld existiert bereits: {0}.
557 MalformedSwitchCase ✔ Invalid decision declaration. Ungültige Entscheidungsdefinition.
558 InvalidFPConversionLang ✔ Invalid configuration for converting number to text. Ungültige Einstellungen für Zahlenumwandlung in Text.
559 InvalidEnumFromString ✔ Enum cannot be read: {0}. Enum kann nicht gelesen werden: {0}.
560 InvalidRandBounds ✔ Invalid bounds for random value: {0} to {1}. Ungültige Grenzen für Zufallszahlen: {0} bis {1}.
561 FunctionCallNotAllowed ✔ Function call not allowed. Funktionsaufruf nicht erlaubt.
562 InvalidCOMEdge ✔ Invalid edge in COM-Graph. Ungültige Kante in COM-Graph.
563 KMCInvalidRange ✔ Invalid index range in KMC. Ungültige Index-Weite in KMC.
564 KMCInvalidNumClusters ✔ Invalid amount of clusters in KMC. Ungültige Menge an Clustern in KMC.
565 InvalidTimeDistPen ✔ Travel evaluation not possible. Fahrtevaluation nicht möglich.
566 InvalidMidDistance ✔ Invalid calculated mid distance. Ungültige berechnete Zwischendistanz.
567 HungarianTimeout ✔ Unexpected number of iterations in matching calculations. Unerwartete Zahl der Iterationen in Matching-Berechnung.
568 InvalidValidationStatus ✔ Overwriting validation status is not allowed. Überschreiben der Validierung nicht möglich.
569 SVSuidOutOfRange ✔ Couldn't find svs uid {0}. SVS-UID {0} nicht gefunden.
570 QTCoordNotContained ✔ Coordinate not contained in Quadtree. Koordinate nicht in Quadtree enthalten.
571 InvalidTimeStampRegex ✔ Invalid timestamp: {0}. Kein gültiger Zeitstempel: {0}.
572 RegrCoeffsNotCalculated ✔ Invalid amount of regressional coefficients. Ungültige Menge an Regressionskoeffizienten.
573 NoDataPointsForCalculation ✔ No data given for regression calculation. Keine Daten für Regressionsanalyse gegeben.
574 MeanEmptyVector ✔ Given vector for mean calculation is empty. Leerer Vektor für Mittelwertberechnung.
575 NodeAlreadyExists ✔ Existing node #{0} is being overwritten. Existierender Knoten #{0} wird überschrieben.
576 EdgeAlreadyExists ✔ Existing edge #{0} is being overwritten. Existierende Kante #{0} wird überschrieben.
577 InvalidProximityInitialCoords ✔ Invalid proximity due to undetermined coordinates. Ungültige Distanz auf Knoten mit unbestimmten Koordinaten.
578 InvalidNodeKMean ✔ Invalid node in clustering graph. Ungültiger Knoten in Clustering Graph.
579 InvalidStartingPositionKMean ✔ Unset initial position for clustering. Ungültige Startposition für Clustering.
580 InvalidCOMNode ✔ Invalid node in COM-Graph. Ungültiger Knoten in COM-Graph.
581 NoWorkersLeftForClustering ✔ Worker assignment to cluster failed: no clusters exist. Mitarbeiterzuweisung an Cluster gescheitert: Keine Cluster vorhanden.
582 InvalidPlanParts ✔ Plan parts are wrongly synched. Faulty id: {0}. Planteile sind fehlerhaft synchronisiert. Fehlerhafte ID: {0}.
583 InvalidTravelRequest ✔ Invalid travel data request. Ungültige Fahrtdatenanfrage.
584 InvalidAccessToTable ✔ Invalid table access. Ungültiger Zugriff auf Tabelle.
585 InvalidFinalMVS ✔ Error in finalized solution. Fehler in finaler Lösung.
586 AmbiguousNumberOfInputFieldsFound ✔ Number of encountered input fields is ambiguous (field names: {0}). Anzahl an gefunden Eingabefeldern uneindeutig (Felder: {0}).
587 ValidationFailInternalError ✔ Data adjustment corrupted some data. Nach Datenanpassung sind Fehler in den Daten vorhanden.
588 DisallowedThreadObjectReset ✔ Tried resetting a locked thread object storage. Versuchtes Zurücksetzen eines gesperrten Thread-Objekt-Speichers.
589 ThreadObjectAlreadyRegistered ✔ Tried re-registering an already registered thread (id: {0}). Ein bereits registrierter Thread (id: {0}) wurde erneut registriert.
590 ThreadObjectRegistrationOutOfRange ✔ Registering thread outside initialized range (position: {0}, size: {1}). Thread-Registrierung außerhalb des initialisierten Bereiches (Position: {0}, Größe: {1}).
591 ThreadObjectNotRegistered ✔ Thread {0} was not registered. Thread {0} wurde nicht registiert.
592 RequiredValueInOptional ✔ Required value in optional was not found. In field: {0}. Benötigter Wert konnte nicht ausgelesen werden. In Feld: {0}.
593 InvalidRangeParameter ✔ Range construction with invalid parameters. Range-Konstruktion mit ungültigen Parametern.
594 ConversionOutOfRange ✔ Conversion between types failed, value out of range. Umwandlung zwischen Typen fehlgeschlagen, ungültiger Wert.
595 InvalidUIDAccess ✔ Invalid access to uid-object with uid {0}. Ungültiger Zugriff auf UID-Object mit uid {0}.
596 MissingPlanDataWrapperSetup ✔ The plan data wrapper was not set up correctly. Der Plandata-Wrapper wurde nicht korrekt initialisiert.
597 IONotIterable ✔ List-operations can only be called on lists. In field: {0}. Listenfunktionen können nur auf Listen aufgerufen werden. In Feld: {0}.
598 UnresolvedWeakRestriction ✔ ✔ An impossible weak restriction on task #{0} was not properly cleaned up. Eine unerfüllbare weiche Restriktion auf Auftrag #{0} wurde nicht entfernt.
599 OutOfEnumRange ✔ Expected enum type in field: {0}. Enumtyp in Feld erwartet: {0}.
600 WriteOutOfEnumRange ✔ An attempt is made to write a value outside its enum range. Es wird versucht einen Wert außerhalb der Enumspanne zu schreiben.
601 ElementNotFound ✔ A required element was not found. Ein benötigtes Element wurde nicht gefunden.
602 KDTreeInvalidRadius ✔ Invalid radius for KD-Tree search. Ungültiger Radius für die KD-Baum-Suche.
603 IONotAStringArray ✔ Expected text in array: {0}. Text in Array erwartet: {0}.
900 NoTasksInHistory There is no task array in the history of the input data file. Es ist kein Feld für Aufgaben in der Historie der Inputdaten angegeben.
901 VehicleTypesNotUnique A distance matrix contains multiple identical vehicle types. Eine Distanzmatrix enthält mehrfach vorkommende Fahrzeugtypen.
902 VehicleTypesUsedMultipleTimes Multiple distance matrices set values for the same vehicle type. Mehrere Distanzmatrizen setzen Werte für denselben Fahrzeugtyp.
903 InvalidVectorSizesTravelOverride The data storage for a distance matrix has invalid size. Die Daten für eine Distanzmatrix haben eine ungültige Größe.
904 InvalidOptimizerOptions The meta data or parameters contain input data errors. Missing field: {0}. In den Metadaten oder Parametern sind Fehler in den Inputdaten vorhanden. Fehlendes Feld: {0}.
905 ImpossibleDate Invalid date: {0}. Ungültiges Datum: {0}.
906 ParameterOutOfRange Parameter out of range. Parameter nicht im Definitionsbereich.
907 InvalidDurationData Data for exactly one of duration in minutes or duration in seconds must exist. Es muss genau eine Angabe zu entweder Dauer in Minuten oder Dauer in Sekunden existieren.
908 InvalidTimeObjectSize Time limit for time object {0} was exceeded. Das Zeitlimit für Feld {0} wurde überschritten.
909 InputDataIssue There is an issue with the input data. In {0}: {1}. Es gibt ein Problem mit den Inputdaten. In {0}: {1}.
950 NoCorrespondingObject ✔ Output element to overwrite was not found in input data: {0}. Zu überschreibendes Output-Element wurde nicht in Input gefunden: {0}.
951 MissingOutputElement ✔ Input list contains a different number of elements than output list ({0} vs {1}). Input-Liste ungleich Output-Liste ({0} vs {1}).
952 MissingOutputField ✔ Missing field in output: {0}. Fehlendes Feld in Output: {0}.
953 FailedSolutionOutput ✔ Could not write output file. Output konnte nicht geschrieben werden.
954 InvalidWorkerStats ✔ Error while getting statistics. Fehler beim Berechnen der Statistiken.
955 OutputPathNotValid ✔ Invalid path for file output location. Der angegebene Pfad für das Speicherziel kann nicht gelesen werden.
1200 InitWorkerDoesNotExist ✔ The initially assigned worker #{1} for task #{0} is missing in the list of available workers. Der initial zugewiesene Mitarbeiter #{1} für Aufgabe #{0} befindet sich nicht in der Liste bereitgestellter Mitarbeiter.
1201 InitOrderButNotInitWorker ✔ The task #{0} has an initially assigned order but no initially or preassigned worker. In den Eingabedaten für Aufgabe #{0} ist eine initial zugewiesene Reihenfolge aber kein initial oder vorab zugewiesener Mitarbeiter angegeben.
1202 NoSuitableWorkerAvailable ✔ A suitable worker for task #{0} is missing in the list of available workers. In den Eingabedaten fehlt ein geeigneter Mitarbeiter für Aufgabe #{0} unter den verfügbaren Mitarbeitern.
1203 SelfPrecedingTask ✔ Task #{0} has itself assigned as preceding task. Aufgabe #{0} ist sich selbst als vorhergehende Aufgabe angegeben.
1204 PrecedingTaskDoesNotExist ✔ Task #{1} is requested as a preceding task to task #{0} but this task is not part of this plan at all. In den Eingabedaten ist Aufgabe #{1} als notwendiger Vorab-Auftrag zu Aufgabe #{0} angegeben, diese Aufgabe ist aber nicht Teil der Planung.
1205 SelfPredecessorTask ✔ Task #{0} has itself assigned as predecessor task. In den Eingabedaten ist für Aufgabe #{0} die Aufgabe selbst als unmittelbar vorhergehende Aufgabe angegeben.
1206 NegativeLengthShift ✔ A shift ends before it starts for Worker #{0}. In den Eingabedaten endet eine Schicht bevor sie startet für Mitarbeiter #{0}.
1207 OverlappingMultishifts ✔ Two shifts are overlapping for worker #{0}. Zwei Schichten von Mitarbeiter #{0} überlappen sich.
1208 InvalidMultishift ✔ Worker #{0} is fixed or order-fixed but has multi-shift. Mitarbeiter #{0} ist fix oder Reihenfolgen-fix und hat Mehrfachschicht.
1209 InvalidDontVary ✔ Worker #{0} has a multi-shift plan but is declared fix or order fix, without providing a shiftID. Mitarbeiter #{0} hat eine Mehrfachschicht und ist als fix oder Reihenfolgen-fix deklariert, ohne eine angegebene shiftID.
1210 NotUniquePredecessorTask The tasks #{0} and #{1} both have a single, identical task assigned as predecessor. Die Aufgaben #{0} und #{1} haben dieselbe Aufgabe als einzige unmittelbar vorhergehende Aufgabe.
1211 InconsistentDontVaryTask ✔ The task #{0} has an invalid assignment to a fixed/ order-fixed worker (conflicting information). Die Aufgabe #{0} ist ungültig einem fixen/ Reihenfolgen-fixen Mitarbeiter zugewiesen (widersprüchliche Information).
1212 NoInitAssignedOrderDontVary ✔ The task #{0} has a fixed/ order-fixed assignment but is missing information regarding assignment order. Die Aufgabe #{0} ist fix/ Reihenfolgen-fix zugewiesen, besitzt aber keine Information zur Reihenfolge.
1213 DontVaryInitassignedOrderNotUnique ✔ The assignment order on worker #{0} (fixed/ order-fixed worker) is not unique. Die Reihenfolge der Aufgaben auf dem fixen/ Reihenfolgen-fixen Mitarbeiter #{0} ist nicht eindeutig.
1214 InvalidMultishiftLength ✔ Worker #{0} has a shift duration of zero minutes. Mitarbeiter #{0} hat eine Schichtlänge von null Minuten.
1215 ConflictingDontVaryOrder ✔ Task #{0} has an invalid initial order within its fixed/ order-fixed assignment. Aufgabe #{0} hat eine ungültige Reihenfolge innerhalb der fixen/ Reihenfolgen-fixen Zuweisung.
1216 ConflictingDontAlterDontVary ✔ Worker #{0} has both fixed assignments and order-fixed assignments. Mitarbeiter #{0} hat sowohl fixe Zuweisung als auch Reihenfolgen-fixe Zuweisung.
1217 DuplicateShiftID ✔ The input data contains two workers with ID #{0} and shiftID #{1}. In den Eingabedaten existieren zwei Mitarbeiter mit ID #{0} und shiftID #{1}.
1218 InvalidPreassignWithDontVary ✔ ✔ Task #{0} is declared fix or order fix on multi-shift plan for Worker #{1}, the task is provided without a shiftID. Aufgabe #{0} ist fix oder Reihenfolgen-fix auf Mehrfachschicht von Mitarbeiter #{1} deklariert, der Aufgabe fehlt eine Angabe zur shiftID.
1219 InvalidPreassignTask ✔ ✔ Task #{0} is declared fix or order fix on multi-shift plan for Worker #{1}, the task is outside of the assigned worker's shift. Aufgabe #{0} ist fix oder Reihenfolgen-fix auf Mehrfachschicht von Mitarbeiter #{1} deklariert, die Aufgabe liegt außerhalb des Zeitfensters des Arbeiters.
1220 DateTimeStampExceedingLimits A given time ({0} {1}) exceeds the given time restraints. Eine Zeitangabe ({0} {1}) liegt außerhalb des angegebenen Zeitrahmens.
1221 PredecessorTaskDoesNotExist ✔ Task #{1} is requested as a predecessor task to task #{0} but this task is not part of this plan at all. In den Eingabedaten ist Aufgabe #{1} als notwendiger Unmittelbar-Vorab-Auftrag zu Aufgabe #{0} angegeben, diese Aufgabe ist aber nicht Teil der Planung.
1222 TooManyExclusiveSets The input data contains more exclusive sets than workers (number of sets: {0}, number of available workers: {1}). In den Eingabedaten sind mehr exklusive Sets angegeben als es Mitarbeiter gibt (Anzahl Sets: {0}, Anzahl verfügbarer Mitarbeiter: {1}).
1223 LinkedExclusiveSets Tasks of the exclusive sets {0} and {1} have to be assigned to the same worker. Aufgaben der exklusiven Sets {0} und {1} müssen von demselben Mitarbeiter ausgeführt werden.
1224 NoValidExclusiveSetAssignmentPossible Due to the given input data restrictions, it is not possible to assign the exclusive sets onto different workers. Durch die Restriktionen in den Inputdaten ist es nicht möglich, die exklusiven Sets auf unterschiedliche Mitarbeiter aufzuteilen.
1225 MultishiftIdenticalShiftStart ✔ Two or more shifts of worker #{0} start at the same time. Zwei oder mehr Schichten von Mitarbeiter #{0} beginnen zur selben Zeit.
1226 PredecessorCycle There is a logical cycle in the predecessor tasks (e.g. Task A precedes B, Task B precedes C and Task C precedes A). Affected tasks: {0}. Es existiert ein logischer Kreisschluss in den direkt-vorhergehenden Aufgaben (z.B. Aufgabe A muss vor B erledigt werden, Aufgabe B vor C und Aufgabe C vor A). Betroffene Aufgaben: {0}.
1227 StrictExclusiveSetMissingID ✔ Task {0} is supposed to be part of a strict exclusive set but hasn't been assigned an exclusive set id. Aufgabe {0} soll Teil eines strengen exklusiven Sets sein, ist aber keinem exklusiven Set zugeordnet.
1228 InconsistentStrictExclusiveSet Not all tasks of exclusive set {0} consider it a strict set. Nicht alle Aufgaben des exklusiven Sets {0} haben dieses als ein strenges Set angegeben.
1229 PrecedingCycle There is a logical cycle in the preceding tasks (e.g. Task A precedes B, Task B precedes C and Task C precedes A). Affected tasks: {0}. Es existiert ein logischer Kreisschluss in den vorhergehenden Aufgaben (z.B. Aufgabe A muss vor B erledigt werden, Aufgabe B vor C und Aufgabe C vor A). Betroffene Aufgaben: {0}.
1500 InvalidTaskLink ✔ Task #{0} contains multiple direct links to other tasks. Die Aufgabe #{0} hat mehrere direkte Verknüpfungen mit anderen Aufgaben.
1501 TaskLinkCycle Tasks with direct links form a cycle. Aufgaben mit Direkt-Verknüpfungen bilden einen Kreisschluss.
1502 InvalidLinkList Task replaces itself. Aufgabe ersetzt sich selber.
1503 WorkerBothPlannedAndHistorical ✔ Worker #{0} appears in both history and planning data. Mitarbeiter #{0} kommt sowohl in Planung als auch Historie vor.
1504 DuplicateWorkerHistory Worker #{0} appears multiple times in the history data. Mitarbeiter #{0} kommt mehrfach in der Historie vor.
1505 DuplicateTaskHistory Task #{0} appears multiple times in the history data. Auftrag #{0} kommt mehrfach in der Historie vor.
1506 HistoryAssignmentMissingWorker Historical assignment of task #{0} is missing its assigned worker in the input data. Einer historische Zuweisung von Auftrag #{0} fehlt der zugewiesene Mitarbeiter in den Inputdaten.
1507 DuplicateHistoryDate There are multiple entries on {1} for task #{0}. In der Historie für Auftrag #{0} gibt es mehrere Einträge am Tag {1}.
1508 FutureHistoryAssignments There are invalid dates on historical assignments for task #{0}. In der Historie für Auftrag #{0} gibt es Einträge mit ungültigem Datum.
1509 MissingHistoryTaskReference The history includes data to a task (#{0}) which appears neither in plan tasks nor in additional tasks. Zu einem Auftrag (#{0}), welcher nicht in Plan- oder zusätzlichen Aufträgen vorkommt, sind historische Daten angegeben.
1510 DuplicateAdditionalTaskHistory Task #{0} appears multiple times in the additional task set. Auftrag #{0} kommt mehrfach in den zusätzlichen Aufträgen vor.
1511 TaskBothAdditionalAndPlanTask ✔ Task #{0} appears in both planning data and additional task data. Auftrag #{0} kommt sowohl in Planung als auch in den zusätzlichen Aufträgen vor.
1650 NoAssignmentFBTP ✔ ✔ Task #{0} could not be assigned. Aufgabe #{0} konnte nicht zugewiesen werden.
1651 InvalidGreedyInsertion ✔ Invalid state in initial solution. Ungültiger Zustand in Initiallösung.
1700 InvalidWorkingTime ✔ Error while calculating working time. Fehler bei der Arbeitszeitberechnung.
1701 InvalidGroupSize ✔ Error while grouping tasks. Fehler in Gruppierung.
1750 AppliedInvalidPenalty ✔ Added invalid penalty: {1} ({0}). Ungültige Penalty hinzugefügt: {1} ({0}).
1751 UncheckedPredecessorOrPrecedingCycles ✔ A cycle of predecessors or precedings was not detected during validation. Ein Kreisschluss aus Direkt-Vorgängern oder Vorgängern wurde nicht in der Validierung erkannt.

Index

List of all schema definitions

Date

string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

A string consisting of three parts following the pattern "YYYY-MM-DD":

  • "YYYY" year AD: 0-9999
  • "MM" month: 1-12
  • "DD" day: 1-31

While the schema does not check for validity, the optimization algorithms do. Including invalid dates (e.g. 2020-02-31) leads to a validation error.

Examples:

  • "2020-04-10"
  • "2051-4-1"
  • "1953-04-10"
"2020-04-10"

Number_u64

number (Number_u64) [ 0 .. 1.7e+308 ]

Unsigned 64bit number with the upper limit of a signed 64bit number

1.7e+308

Language Type

integer (Language Type) [ 0 .. 1 ]

Values are:

  • 0: German
  • 1: English
1

Integer_u32_1

integer (Integer_u32_1) [ 1 .. 2147483647 ]

Unsigned 32 bit integer (not zero) with the upper limit of a signed 32bit integer

1

Integer_u32

integer (Integer_u32) [ 0 .. 2147483647 ]

Unsigned 32 bit integer with the upper limit of a signed 32bit integer

2147483647

FloorPlannerMeta

dateFrom
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

Planning horizon start.

dateTo
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

Planning horizon end.

resCategory
boolean
Default: false

Activate/Deactivate whether category types should be considered in the optimization.

resQualification
boolean
Default: false

Activate/Deactivate whether qualifications should be considered in the optimization.

accuracyMode
number (Number_u64) [ 0 .. 1.7e+308 ]
Default: 1

Manages a solution refinement process. An accuracy > 0.0 can improve the solution significantly but will take longer to calculate, effects increase with higher accuracyMode.

outputLanguage
integer (LanguageType) [ 0 .. 1 ]
Default: 0

Defines which language should be used in the output.

enablePlanSplitting
boolean
Deprecated
Default: true
allowUnassignedTasks
boolean
Default: false

If this flag is set to false, all tasks will be assigned by the algorithm (for exceptions regarding unassignable tasks, see removeInvalidTasks). If this flag is set to true, tasks can be left unassigned, if the algorithm cannot find a "good fit". The likelihood of this happening can be influenced with the value of assignmentPriority on the InputTask.

removeInvalidTasks
boolean

If this flag is set to false and the input data contains tasks that cannot be assigned to any worker (e.g. no worker has a qualification high enough for the task), an ErrorPlan with a corresponding error is returned. If the flag is set to true, these tasks simply won't get assigned but the optimization will be carried out for all valid tasks.

If this field is not set, it will assume the value of allowUnassignedTasks.

minConcurrentSolutions
integer (Integer_u32_1) [ 1 .. 2147483647 ]
Default: 1

Number of concurrently calculated solutions. Developer feature, use at your own risk!

minTaskDuration
integer (Integer_u32) [ 0 .. 2147483647 ]
Default: 0

Minimum value for an input task's duration. Task durations with a lower value are being overwritten before the optimization. Profit calculations (e.g. costsPerMinute), coverage, etc use adjusted values.

disableTaskTimeWindowRelaxation
boolean
Default: false

Per default, time windows of tasks are slightly relaxed before optimization depending on their timePriority. This usually creates better results as it is common that customer declared time windows are tighter than what they would actually accept as a good scheduling. However, if the time windows are indeed reliable and can be used without modification, the relaxation is no longer necessary or beneficial and can be turned off with this flag.

{
  • "dateFrom": "2020-04-10",
  • "dateTo": "2020-04-10",
  • "resCategory": false,
  • "resQualification": false,
  • "accuracyMode": 1.7e+308,
  • "outputLanguage": 1,
  • "enablePlanSplitting": true,
  • "allowUnassignedTasks": false,
  • "removeInvalidTasks": true,
  • "minConcurrentSolutions": 1,
  • "minTaskDuration": 2147483647,
  • "disableTaskTimeWindowRelaxation": false
}

FloorPlannerOptimizationParameters

fairDistribution
integer (Integer_0_9) [ 0 .. 9 ]
Default: 0

Distribute the tasks fairly among the workers.

workerPrefs
integer (Integer_0_9) [ 0 .. 9 ]
Default: 0

Optimize towards satisfying the time windows.

qualificationFitting
integer (Integer_0_9) [ 0 .. 9 ]
Default: 0

Avoid assignments where the worker has a higher qualification than the task. Tasks without qualification count as having a qualification of 0.

constancy
integer (Integer_0_9) [ 0 .. 9 ]
Default: 0

Prioritize data determined in history analysis.

groupPrefs
integer (Integer_0_9) [ 0 .. 9 ]
Default: 0

Keep tasks of the same groups on the same workers.

{
  • "fairDistribution": 9,
  • "workerPrefs": 9,
  • "qualificationFitting": 9,
  • "constancy": 9,
  • "groupPrefs": 9
}

Time

string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

A string of either format "hh:mm" or "-hh:mm":

  • "hh": hours (24h format),
  • "mm": minutes

Times are always interpreted relative to a date in the same object as the Time field. This allows times to exceed 24h or even become negative, as the value gets "added" to midnight of the date. For example, the following times applied to the respective date (in Date format) are equivalent:

  • "2021-05-21" at "07:25"
  • "2021-05-20" at "31:25"
  • "2021-05-19" at "55:25"
  • "2021-05-22" at "-16:35"
  • "2021-05-23" at "-40:35"
"07:25"

IDReferences

Array
integer (Integer_u32) [ 0 .. 2147483647 ]

Unsigned 32 bit integer with the upper limit of a signed 32bit integer

[
  • 2147483647
]

Gender Type

integer (Gender Type) [ 0 .. 3 ]

Values are:

  • 0: not provided
  • 1: male
  • 2: female
  • 3: other
3

FloorPlannerInputTask

taskID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of this task. IDs need to be unique among all Tasks.

externalID
string

A string to identify the task in the solution. Cannot be used for reference in the input data or the optimizer, it only serves as a helping tool for integrations.

clientID
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of the client this task is assigned to.

date
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date this task should be planned on.

duration
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in minutes it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

durationInSeconds
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in seconds it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

timeEarliest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The earliest possible starting time of this task.

This is a preference and can be violated for other preferences or restrictions.

timeLatest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The latest time at which this task should be finished.

This is a preference and can be violated for other preferences or restrictions.

timePriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

The priority of the time window:

  • 0 - irrelevant
  • 1 - not important (automatically extended by 30 minutes)
  • 2 - more important (automatically extended by 15 minutes)
  • 3 - important (no extension)
  • 4 - very important (no extension)
  • 5 - fixed time (no extension)

Tasks with high time priority are more likely to get scheduled inside their given time window. Tasks with time priority 0 completely ignore their given time window.

For tasks with a timePriority of 5, the time window is considered a strict restriction.

prefWorkers
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The IDs of preferred workers.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

qualification
integer (Integer_u32) [ 0 .. 2147483647 ]

The minimum qualification of the worker required to perform the task (e.g. years of experience). Workers without qualification are not allowed to perform tasks of any qualification.

This is a strict restriction and might fail validation if it is impossible to keep.

categories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

A suitable worker has to fulfill all of these categories.

This is a strict restriction and might fail validation if it is impossible to keep.

preassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

The workerID of the only worker that is allowed to carry out the task. This setting overrules any other strict restriction - for example, if the worker does not fulfil the qualification requirement, the task will still get assigned to them. The field can also be used for dontAlter and dontVary assignments. A preassignedWorker does not imply an assignmentPriority - if allowUnassignedTasks is active, the task being unassigned is not a violation of this restriction.

This is a strict restriction and might fail validation if it is impossible to keep.

initassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

A hint for large optimization data sets, e.g. solution data from a previous optimization request. The field can also be used for dontAlter and dontVary assignments.

initassignedOrder
integer (Integer_u32) [ 0 .. 2147483647 ]

The order within the initially assigned worker's tour. Requires preassignedWorker or initassignedWorker.

initassignedShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

A shiftID to compliment either initassignedWorker or preassignedWorker in case the workerID is not unique.

precedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

Tasks in this list and this task will be performed by the same worker and all listed tasks will have to be finished before this task starts.

This is a strict restriction and might fail validation if it is impossible to keep.

preferredPrecedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

If the tasks in this list together with this task are performed by the same worker, all listed tasks should be completed before this task begins. If the tasks in this list and this task are performed by different workers, the order does not have to be followed.

This is a preference and can be violated for other preferences or restrictions.

predecessorTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

One of these tasks has be carried out right before this task by the same worker. Putting multiple values in the array does not mean they are carried out in that order - if you want to have a predecessor-chain, you need to set the direct predecessor on each task in the chain (see examples). Do not put redundant values in here, as having more than one value in the array has negative impact on performance and solution quality.

This is a strict restriction and might fail validation if it is impossible to keep.

assignmentPriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

A priority for assignment (see allowUnassignedTasks):.

  • 0 - no preference regarding unassignment, whether or not the task is assigned does not matter and will depend solely on other factors
  • 1-4 - progressively higher assignment importance
  • 5 - task has to be assigned

If allowUnassignedTasks is set to false, this field has no effect.

For tasks with an assignmentPriority of 5, the task being assigned is considered a strict restriction.

preferredGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned to the same worker shift. It does not incentivize the optimizer to assign the tasks consecutively, if you want that to happen, you have to use desiredPredecessorGroup.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter groupPrefs.

desiredPredecessorGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned consecutively, if they are assigned to the same worker. It does not incentivize the optimizer to assign the tasks on the same worker, if you want that to happen, you have to use preferredGroup.

This is a preference and can be violated for other preferences or restrictions.

locationSiteID
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the position this task has to be carried out at.

prefGender
integer (GenderType) [ 0 .. 3 ]

The preferred gender for the assigned worker.

This is a preference and can be violated for other preferences or restrictions.

exclusiveSetID
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same exclusiveSetID form a "set". A worker can only carry out tasks of at most one set (and any number of tasks without an exclusiveSetID - see hasStrictExclusiveSet). Please note that this does not force tasks of the same set to be assigned to the same worker.

This is a strict restriction and might fail validation if it is impossible to keep.

hasStrictExclusiveSet
boolean
Default: false

If this field is set to true, the worker carrying out this task cannot carry out tasks without an exclusiveSetID. In other words, the worker will only carry out tasks with the exact same exclusiveSetID as this task.

{
  • "taskID": 2147483647,
  • "externalID": "string",
  • "clientID": 2147483647,
  • "date": "2020-04-10",
  • "duration": 2147483647,
  • "durationInSeconds": 2147483647,
  • "timeEarliest": "07:25",
  • "timeLatest": "07:25",
  • "timePriority": 5,
  • "prefWorkers": [
    ],
  • "qualification": 2147483647,
  • "categories": [
    ],
  • "preassignedWorker": 2147483647,
  • "initassignedWorker": 2147483647,
  • "initassignedOrder": 2147483647,
  • "initassignedShiftID": 2147483647,
  • "precedingTasks": [
    ],
  • "preferredPrecedingTasks": [
    ],
  • "predecessorTasks": [
    ],
  • "assignmentPriority": 5,
  • "preferredGroup": 2147483647,
  • "desiredPredecessorGroup": 2147483647,
  • "locationSiteID": 2147483647,
  • "prefGender": 3,
  • "exclusiveSetID": 2147483647,
  • "hasStrictExclusiveSet": false
}

FloorPlannerInputWorker

workerID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of the worker.

shiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

A second ID in case there are multiple workers with the same workerID. This one needs to be unique among all workers with the same workerID. It can be referenced whenever a unique reference to this worker object is required.

externalID
string

A string to identify the worker in the solution. Cannot be used for reference in the input data or the optimizer, it only serves as a helping tool for integrations.

shiftDate
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date of this shift.

shiftStart
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time this shift starts.

This is a preference and can be violated for other preferences or restrictions.

shiftEnd
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time this shift ends.

This is a preference and can be violated for other preferences or restrictions.

shiftPriority
integer (Integer_0_3) [ 0 .. 3 ]
Default: 1

The priority to keep the defined shift start and end times:

  • 0: irrelevant
  • 1: neutral
  • 2: important
  • 3: very important
qualification
integer (Integer_u32) [ 0 .. 2147483647 ]

The qualification of the worker. They are able to take over tasks with the same or lower qualification.

categories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker can only carry out tasks if he has each category the task requires.

preferredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker prefers tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

unpreferredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker has an aversion against tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

desiredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker strongly prefers tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions.

undesiredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker has a strong aversion against tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions.

dontVary
boolean
Default: false

A worker with dontVary set to true is "fixed" for the optimizer, meaning they get assigned all tasks (and only those tasks) that have this worker set as preassignedWorker or initassignedWorker in the order of initassignedOrder. That also means that initassignedOrder is required for these tasks, as well as shiftID on the worker and initassignedShiftID on the task if the workerID is not unique. All assignments will be considered in statistics and info.

This is a strict restriction and might fail validation if it is impossible to keep.

dontAlter
boolean
Default: false

Workers with dontAlter set to true behave similarly to workers with dontVary. The only difference is that a dontVary-worker cannot get assigned more tasks than specified in the input data, a dontAlter-worker will be assigned all tasks that have this worker as initassignedWorker or preassignedWorker, but can also have other tasks assigned. While the preassigned/initassigned tasks will be in order of initassignedOrder, other tasks can be inserted before, between or after those tasks; if there is no initassignedOrder set, the task will be ignored. Every other behavior and requirement is exactly as in dontVary.

This is a strict restriction and might fail validation if it is impossible to keep.

gender
integer (GenderType) [ 0 .. 3 ]

The gender of the worker.

{
  • "workerID": 2147483647,
  • "shiftID": 2147483647,
  • "externalID": "string",
  • "shiftDate": "2020-04-10",
  • "shiftStart": "07:25",
  • "shiftEnd": "07:25",
  • "shiftPriority": 3,
  • "qualification": 2147483647,
  • "categories": [
    ],
  • "preferredCategories": [
    ],
  • "unpreferredCategories": [
    ],
  • "desiredCategories": [
    ],
  • "undesiredCategories": [
    ],
  • "dontVary": false,
  • "dontAlter": false,
  • "gender": 3
}

FloorPlannerHistoryAssignment

date
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date of the assignment.

locationSiteID
integer (Integer_u32) [ 0 .. 2147483647 ]

The id for the location the task was carried out at at the time.

timeScheduled
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time the corresponding task was scheduled (meaning the time the final plan had this task scheduled on, not to be confused with actualStartTime)

assignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

The worker the corresponding task was assigned to in the final planned version.

assignedShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the assigned shift of the assigned worker.

assignedOrder
integer (Integer_u32) [ 0 .. 2147483647 ]

The order number this task was assigned to the worker shift.

timeScheduledAutomatically
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time the corresponding task was scheduled on by the optimizer at the time.

assignedWorkerAutomatically
integer (Integer_u32) [ 0 .. 2147483647 ]

The worker the corresponding task was assigned to by the optimizer at the time.

assignedShiftIDAutomatically
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the assigned shift of the assigned worker.

assignedOrderAutomatically
integer (Integer_u32) [ 0 .. 2147483647 ]

The order number this task was assigned to the worker shift.

actualWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

The worker the task was actually carried out by, for instance as determined by mobile tracking.

actualStartTime
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time the task was actually started, for instance as determined by mobile tracking.

actualShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the assigned shift of the assigned worker.

actualOrder
integer (Integer_u32) [ 0 .. 2147483647 ]

The order number this task was assigned to the worker shift.

{
  • "date": "2020-04-10",
  • "locationSiteID": 2147483647,
  • "timeScheduled": "07:25",
  • "assignedWorker": 2147483647,
  • "assignedShiftID": 2147483647,
  • "assignedOrder": 2147483647,
  • "timeScheduledAutomatically": "07:25",
  • "assignedWorkerAutomatically": 2147483647,
  • "assignedShiftIDAutomatically": 2147483647,
  • "assignedOrderAutomatically": 2147483647,
  • "actualWorker": 2147483647,
  • "actualStartTime": "07:25",
  • "actualShiftID": 2147483647,
  • "actualOrder": 2147483647
}

FloorPlannerHistoryTask

taskID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

Task ID for referencing task in planning tasks.

required
Array of objects (FloorPlannerHistoryAssignment)

All considered historical assignments of this task.

{
  • "taskID": 2147483647,
  • "scheduling": [
    ]
}

FloorPlannerHistoryWorker

workerID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

ID of a worker that is not present in the input data. Has to be unique among all History-Workers.

{
  • "workerID": 2147483647
}

FloorPlannerHistory

required
Array of objects (FloorPlannerHistoryTask)

All history tasks

required
Array of objects (FloorPlannerHistoryWorker)

All history workers

Array of objects (FloorPlannerInputTask)

All tasks that are relevant for the analysis but are not part of the optimization.

{
  • "tasks": [
    ],
  • "workers": [
    ],
  • "additionalTasks": [
    ]
}

FloorPlannerInputPlan

object (Client)

Contains information about the client which sends this request.

required
object (FloorPlannerMeta)

Meta information about what to consider in the optimization.

required
object (FloorPlannerOptimizationParameters)

Parameters for the optimizer.

required
Array of objects (FloorPlannerInputTask)

Array of tasks to be planned by the optimizer.

required
Array of objects (FloorPlannerInputWorker)

Array of available workers.

object (FloorPlannerHistory)

History data the optimizer can learn from to apply to the current request. History analysis is done differently for each of our customers, if you know what issues you want to address/ what results you want to see from such methods, please contact us so we can set up a solution.

recovery
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

This is a field only used for debugging by internal developers. Content in this field may change depending on the application, input-data and version. The output values can be used as input values.

{
  • "client": {
    },
  • "meta": {
    },
  • "parameters": {
    },
  • "tasks": [
    ],
  • "workers": [
    ],
  • "history": {
    },
  • "recovery": [
    ]
}

AjvError

keyword
required
string

Validation keyword.

instancePath
required
string

JSON Pointer to the location in the data instance (e.g., "/prop/1/subProp").

schemaPath
required
string

JSON Pointer to the location of the failing keyword in the schema

params
required
object

Params property is the object with the additional information about error. It can be used to generate error messages (e.g., using ajv-i18n package).

propertyName
string

Set for errors in propertyNames keyword schema. instancePath still points to the object in this case.

message
string

The error message.

schema
any

The value of the failing keyword in the schema.

parentSchema
object

The schema containing the keyword.

data
any

The data validated by the keyword.

{
  • "keyword": "string",
  • "instancePath": "string",
  • "schemaPath": "string",
  • "params": { },
  • "propertyName": "string",
  • "message": "string",
  • "schema": null,
  • "parentSchema": { },
  • "data": null
}

Integer_s32

integer (Integer_s32) [ -2147483648 .. 2147483647 ]

Signed 32 bit integer

-2147483648

FloorPlannerOutputTaskAssigned

taskID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of this task. IDs need to be unique among all Tasks.

externalID
string

A string to identify the task in the solution. Cannot be used for reference in the input data or the optimizer, it only serves as a helping tool for integrations.

clientID
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of the client this task is assigned to.

date
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date this task should be planned on.

duration
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in minutes it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

durationInSeconds
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in seconds it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

timeEarliest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The earliest possible starting time of this task.

This is a preference and can be violated for other preferences or restrictions.

timeLatest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The latest time at which this task should be finished.

This is a preference and can be violated for other preferences or restrictions.

timePriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

The priority of the time window:

  • 0 - irrelevant
  • 1 - not important (automatically extended by 30 minutes)
  • 2 - more important (automatically extended by 15 minutes)
  • 3 - important (no extension)
  • 4 - very important (no extension)
  • 5 - fixed time (no extension)

Tasks with high time priority are more likely to get scheduled inside their given time window. Tasks with time priority 0 completely ignore their given time window.

For tasks with a timePriority of 5, the time window is considered a strict restriction.

prefWorkers
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The IDs of preferred workers.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

qualification
integer (Integer_u32) [ 0 .. 2147483647 ]

The minimum qualification of the worker required to perform the task (e.g. years of experience). Workers without qualification are not allowed to perform tasks of any qualification.

This is a strict restriction and might fail validation if it is impossible to keep.

categories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

A suitable worker has to fulfill all of these categories.

This is a strict restriction and might fail validation if it is impossible to keep.

preassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

The workerID of the only worker that is allowed to carry out the task. This setting overrules any other strict restriction - for example, if the worker does not fulfil the qualification requirement, the task will still get assigned to them. The field can also be used for dontAlter and dontVary assignments. A preassignedWorker does not imply an assignmentPriority - if allowUnassignedTasks is active, the task being unassigned is not a violation of this restriction.

This is a strict restriction and might fail validation if it is impossible to keep.

initassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

A hint for large optimization data sets, e.g. solution data from a previous optimization request. The field can also be used for dontAlter and dontVary assignments.

initassignedOrder
integer (Integer_u32) [ 0 .. 2147483647 ]

The order within the initially assigned worker's tour. Requires preassignedWorker or initassignedWorker.

initassignedShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

A shiftID to compliment either initassignedWorker or preassignedWorker in case the workerID is not unique.

precedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

Tasks in this list and this task will be performed by the same worker and all listed tasks will have to be finished before this task starts.

This is a strict restriction and might fail validation if it is impossible to keep.

preferredPrecedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

If the tasks in this list together with this task are performed by the same worker, all listed tasks should be completed before this task begins. If the tasks in this list and this task are performed by different workers, the order does not have to be followed.

This is a preference and can be violated for other preferences or restrictions.

predecessorTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

One of these tasks has be carried out right before this task by the same worker. Putting multiple values in the array does not mean they are carried out in that order - if you want to have a predecessor-chain, you need to set the direct predecessor on each task in the chain (see examples). Do not put redundant values in here, as having more than one value in the array has negative impact on performance and solution quality.

This is a strict restriction and might fail validation if it is impossible to keep.

assignmentPriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

A priority for assignment (see allowUnassignedTasks):.

  • 0 - no preference regarding unassignment, whether or not the task is assigned does not matter and will depend solely on other factors
  • 1-4 - progressively higher assignment importance
  • 5 - task has to be assigned

If allowUnassignedTasks is set to false, this field has no effect.

For tasks with an assignmentPriority of 5, the task being assigned is considered a strict restriction.

preferredGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned to the same worker shift. It does not incentivize the optimizer to assign the tasks consecutively, if you want that to happen, you have to use desiredPredecessorGroup.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter groupPrefs.

desiredPredecessorGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned consecutively, if they are assigned to the same worker. It does not incentivize the optimizer to assign the tasks on the same worker, if you want that to happen, you have to use preferredGroup.

This is a preference and can be violated for other preferences or restrictions.

locationSiteID
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the position this task has to be carried out at.

prefGender
integer (GenderType) [ 0 .. 3 ]

The preferred gender for the assigned worker.

This is a preference and can be violated for other preferences or restrictions.

exclusiveSetID
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same exclusiveSetID form a "set". A worker can only carry out tasks of at most one set (and any number of tasks without an exclusiveSetID - see hasStrictExclusiveSet). Please note that this does not force tasks of the same set to be assigned to the same worker.

This is a strict restriction and might fail validation if it is impossible to keep.

hasStrictExclusiveSet
boolean
Default: false

If this field is set to true, the worker carrying out this task cannot carry out tasks without an exclusiveSetID. In other words, the worker will only carry out tasks with the exact same exclusiveSetID as this task.

timeScheduled
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The planned time to start this task by the assigned worker.

timeWindowViolation
integer (Integer_s32) [ -2147483648 .. 2147483647 ]

If the task is scheduled outside its time window, this value displays the discrepancy in minutes - the value is < 0 if the task was scheduled earlier than its time window and > 0 otherwise. If the task is scheduled within its time window, the field does not get added.

Examples:

  • A task of 30 minutes with timeLatest: 12:00 scheduled at 11:45 will have timeWindowViolation: 15.
  • A task with timeEarliest: 10:00 scheduled at 09:30 will have timeWindowViolation: -30.
assignedWorker
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID (workerID) of the assigned worker who will perform this task.

assignedShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

The shiftID to which the task is assigned to.

info
required
string

May contain some information about the task.

finalassignedOrder
required
integer (Integer_u32_1) [ 1 .. 2147483647 ]

The order number on the assigned worker.

allowedWorkers
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

A list of all workers (workerID) this task can be assigned to.

{
  • "taskID": 2147483647,
  • "externalID": "string",
  • "clientID": 2147483647,
  • "date": "2020-04-10",
  • "duration": 2147483647,
  • "durationInSeconds": 2147483647,
  • "timeEarliest": "07:25",
  • "timeLatest": "07:25",
  • "timePriority": 5,
  • "prefWorkers": [
    ],
  • "qualification": 2147483647,
  • "categories": [
    ],
  • "preassignedWorker": 2147483647,
  • "initassignedWorker": 2147483647,
  • "initassignedOrder": 2147483647,
  • "initassignedShiftID": 2147483647,
  • "precedingTasks": [
    ],
  • "preferredPrecedingTasks": [
    ],
  • "predecessorTasks": [
    ],
  • "assignmentPriority": 5,
  • "preferredGroup": 2147483647,
  • "desiredPredecessorGroup": 2147483647,
  • "locationSiteID": 2147483647,
  • "prefGender": 3,
  • "exclusiveSetID": 2147483647,
  • "hasStrictExclusiveSet": false,
  • "timeScheduled": "07:25",
  • "timeWindowViolation": -2147483648,
  • "assignedWorker": 2147483647,
  • "assignedShiftID": 2147483647,
  • "info": "string",
  • "finalassignedOrder": 1,
  • "allowedWorkers": [
    ]
}

FloorPlannerOutputTaskUnassigned

taskID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of this task. IDs need to be unique among all Tasks.

externalID
string

A string to identify the task in the solution. Cannot be used for reference in the input data or the optimizer, it only serves as a helping tool for integrations.

clientID
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of the client this task is assigned to.

date
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date this task should be planned on.

duration
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in minutes it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

durationInSeconds
integer (Integer_u32) [ 0 .. 2147483647 ]

The time in seconds it takes to complete this task. Exactly one of duration and durationInSeconds must be set, it can be set to zero though.

timeEarliest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The earliest possible starting time of this task.

This is a preference and can be violated for other preferences or restrictions.

timeLatest
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The latest time at which this task should be finished.

This is a preference and can be violated for other preferences or restrictions.

timePriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

The priority of the time window:

  • 0 - irrelevant
  • 1 - not important (automatically extended by 30 minutes)
  • 2 - more important (automatically extended by 15 minutes)
  • 3 - important (no extension)
  • 4 - very important (no extension)
  • 5 - fixed time (no extension)

Tasks with high time priority are more likely to get scheduled inside their given time window. Tasks with time priority 0 completely ignore their given time window.

For tasks with a timePriority of 5, the time window is considered a strict restriction.

prefWorkers
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The IDs of preferred workers.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

qualification
integer (Integer_u32) [ 0 .. 2147483647 ]

The minimum qualification of the worker required to perform the task (e.g. years of experience). Workers without qualification are not allowed to perform tasks of any qualification.

This is a strict restriction and might fail validation if it is impossible to keep.

categories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

A suitable worker has to fulfill all of these categories.

This is a strict restriction and might fail validation if it is impossible to keep.

preassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

The workerID of the only worker that is allowed to carry out the task. This setting overrules any other strict restriction - for example, if the worker does not fulfil the qualification requirement, the task will still get assigned to them. The field can also be used for dontAlter and dontVary assignments. A preassignedWorker does not imply an assignmentPriority - if allowUnassignedTasks is active, the task being unassigned is not a violation of this restriction.

This is a strict restriction and might fail validation if it is impossible to keep.

initassignedWorker
integer (Integer_u32) [ 0 .. 2147483647 ]

A hint for large optimization data sets, e.g. solution data from a previous optimization request. The field can also be used for dontAlter and dontVary assignments.

initassignedOrder
integer (Integer_u32) [ 0 .. 2147483647 ]

The order within the initially assigned worker's tour. Requires preassignedWorker or initassignedWorker.

initassignedShiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

A shiftID to compliment either initassignedWorker or preassignedWorker in case the workerID is not unique.

precedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

Tasks in this list and this task will be performed by the same worker and all listed tasks will have to be finished before this task starts.

This is a strict restriction and might fail validation if it is impossible to keep.

preferredPrecedingTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

If the tasks in this list together with this task are performed by the same worker, all listed tasks should be completed before this task begins. If the tasks in this list and this task are performed by different workers, the order does not have to be followed.

This is a preference and can be violated for other preferences or restrictions.

predecessorTasks
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

One of these tasks has be carried out right before this task by the same worker. Putting multiple values in the array does not mean they are carried out in that order - if you want to have a predecessor-chain, you need to set the direct predecessor on each task in the chain (see examples). Do not put redundant values in here, as having more than one value in the array has negative impact on performance and solution quality.

This is a strict restriction and might fail validation if it is impossible to keep.

assignmentPriority
integer (Integer_0_5) [ 0 .. 5 ]
Default: 1

A priority for assignment (see allowUnassignedTasks):.

  • 0 - no preference regarding unassignment, whether or not the task is assigned does not matter and will depend solely on other factors
  • 1-4 - progressively higher assignment importance
  • 5 - task has to be assigned

If allowUnassignedTasks is set to false, this field has no effect.

For tasks with an assignmentPriority of 5, the task being assigned is considered a strict restriction.

preferredGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned to the same worker shift. It does not incentivize the optimizer to assign the tasks consecutively, if you want that to happen, you have to use desiredPredecessorGroup.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter groupPrefs.

desiredPredecessorGroup
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same value in this field will preferably be assigned consecutively, if they are assigned to the same worker. It does not incentivize the optimizer to assign the tasks on the same worker, if you want that to happen, you have to use preferredGroup.

This is a preference and can be violated for other preferences or restrictions.

locationSiteID
integer (Integer_u32) [ 0 .. 2147483647 ]

An id for the position this task has to be carried out at.

prefGender
integer (GenderType) [ 0 .. 3 ]

The preferred gender for the assigned worker.

This is a preference and can be violated for other preferences or restrictions.

exclusiveSetID
integer (Integer_u32) [ 0 .. 2147483647 ]

Tasks with the same exclusiveSetID form a "set". A worker can only carry out tasks of at most one set (and any number of tasks without an exclusiveSetID - see hasStrictExclusiveSet). Please note that this does not force tasks of the same set to be assigned to the same worker.

This is a strict restriction and might fail validation if it is impossible to keep.

hasStrictExclusiveSet
boolean
Default: false

If this field is set to true, the worker carrying out this task cannot carry out tasks without an exclusiveSetID. In other words, the worker will only carry out tasks with the exact same exclusiveSetID as this task.

info
required
string

May contain some information about the task, will give a reason as to why this task is unassigned.

allowedWorkers
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

A list of all workers (workerID) this task can be assigned to.

{
  • "taskID": 2147483647,
  • "externalID": "string",
  • "clientID": 2147483647,
  • "date": "2020-04-10",
  • "duration": 2147483647,
  • "durationInSeconds": 2147483647,
  • "timeEarliest": "07:25",
  • "timeLatest": "07:25",
  • "timePriority": 5,
  • "prefWorkers": [
    ],
  • "qualification": 2147483647,
  • "categories": [
    ],
  • "preassignedWorker": 2147483647,
  • "initassignedWorker": 2147483647,
  • "initassignedOrder": 2147483647,
  • "initassignedShiftID": 2147483647,
  • "precedingTasks": [
    ],
  • "preferredPrecedingTasks": [
    ],
  • "predecessorTasks": [
    ],
  • "assignmentPriority": 5,
  • "preferredGroup": 2147483647,
  • "desiredPredecessorGroup": 2147483647,
  • "locationSiteID": 2147483647,
  • "prefGender": 3,
  • "exclusiveSetID": 2147483647,
  • "hasStrictExclusiveSet": false,
  • "info": "string",
  • "allowedWorkers": [
    ]
}

FloorPlannerOutputWorker

workerID
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The ID of the worker.

shiftID
integer (Integer_u32) [ 0 .. 2147483647 ]

A second ID in case there are multiple workers with the same workerID. This one needs to be unique among all workers with the same workerID. It can be referenced whenever a unique reference to this worker object is required.

externalID
string

A string to identify the worker in the solution. Cannot be used for reference in the input data or the optimizer, it only serves as a helping tool for integrations.

shiftDate
required
string (Date) ^[0-9]{4}-(0?[1-9]|1[0-2])-(0?[1-9]|[1-2][0-9...

The date of this shift.

shiftStart
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time this shift starts.

This is a preference and can be violated for other preferences or restrictions.

shiftEnd
required
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The time this shift ends.

This is a preference and can be violated for other preferences or restrictions.

shiftPriority
integer (Integer_0_3) [ 0 .. 3 ]
Default: 1

The priority to keep the defined shift start and end times:

  • 0: irrelevant
  • 1: neutral
  • 2: important
  • 3: very important
qualification
integer (Integer_u32) [ 0 .. 2147483647 ]

The qualification of the worker. They are able to take over tasks with the same or lower qualification.

categories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker can only carry out tasks if he has each category the task requires.

preferredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker prefers tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

unpreferredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker has an aversion against tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions. Its importance depends on the parameter workerPrefs.

desiredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker strongly prefers tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions.

undesiredCategories
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

The worker has a strong aversion against tasks that have any of these categories. Categories listed here are automatically considered valid as if they're listed in categories.

This is a preference and can be violated for other preferences or restrictions.

dontVary
boolean
Default: false

A worker with dontVary set to true is "fixed" for the optimizer, meaning they get assigned all tasks (and only those tasks) that have this worker set as preassignedWorker or initassignedWorker in the order of initassignedOrder. That also means that initassignedOrder is required for these tasks, as well as shiftID on the worker and initassignedShiftID on the task if the workerID is not unique. All assignments will be considered in statistics and info.

This is a strict restriction and might fail validation if it is impossible to keep.

dontAlter
boolean
Default: false

Workers with dontAlter set to true behave similarly to workers with dontVary. The only difference is that a dontVary-worker cannot get assigned more tasks than specified in the input data, a dontAlter-worker will be assigned all tasks that have this worker as initassignedWorker or preassignedWorker, but can also have other tasks assigned. While the preassigned/initassigned tasks will be in order of initassignedOrder, other tasks can be inserted before, between or after those tasks; if there is no initassignedOrder set, the task will be ignored. Every other behavior and requirement is exactly as in dontVary.

This is a strict restriction and might fail validation if it is impossible to keep.

gender
integer (GenderType) [ 0 .. 3 ]

The gender of the worker.

info
string

Some textual information about the worker.

tourStart
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The actual time this worker starts their tour. The value is set only if the worker has a task assigned. If the worker has a task assigned and tourStartsOnShiftStart is set to true, it will always be equal to shiftStart.

tourEnd
string (Time) ^[-]?([0-9]{1,9}):([0-5][0-9]|[0-9])$

The actual time this worker ends their tour, including travel to its endLocation and any capacity resets.

totalTaskTime
required
integer (Integer_u32) [ 0 .. 2147483647 ]

The sum of all task durations on this worker.

{
  • "workerID": 2147483647,
  • "shiftID": 2147483647,
  • "externalID": "string",
  • "shiftDate": "2020-04-10",
  • "shiftStart": "07:25",
  • "shiftEnd": "07:25",
  • "shiftPriority": 3,
  • "qualification": 2147483647,
  • "categories": [
    ],
  • "preferredCategories": [
    ],
  • "unpreferredCategories": [
    ],
  • "desiredCategories": [
    ],
  • "undesiredCategories": [
    ],
  • "dontVary": false,
  • "dontAlter": false,
  • "gender": 3,
  • "info": "string",
  • "tourStart": "07:25",
  • "tourEnd": "07:25",
  • "totalTaskTime": 2147483647
}

Fraction

number (Fraction) [ 0 .. 1 ]
1

FloorPlannerStatistics

required
Array of objects

Contains all restriction types and gives a percentage (0.0-1.0) evaluation of each restriction's final influence on the algorithmic optimization and plan result.

timeWindowViolationTaskIDs
Array of integers (Integer_u32) [ items [ 0 .. 2147483647 ] ]

taskIDs of all tasks not assigned within their given time window

unassignedTaskIDs
Array of integers (Integer_u32) [ items [ 0 .. 2147483647 ] ]

taskIDs of all tasks that were not assigned during optimization.

unassignableTaskIDs
Array of integers (Integer_u32) [ items [ 0 .. 2147483647 ] ]

taskIDs of all tasks that were not assigned during optimization because there is no assignment possible (meaning they would fail input validation if unassigned tasks were not allowed).

object

All data determined from the history.

{
  • "impact": [
    ],
  • "timeWindowViolationTaskIDs": [
    ],
  • "unassignedTaskIDs": [
    ],
  • "unassignableTaskIDs": [
    ],
  • "history": {
    }
}

FloorPlannerInfo

feasible
required
boolean

Set to false if any restrictions are violated in the solution.

{
  • "feasible": true
}

FieldPlacerVersion

string (FieldPlacerVersion) ^[0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]+(p[0-9]+)?$...

A version consisting of the date of release [0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]+, which can have a patch suffix p[0-9]+.

"1970-01-01_0p0"

SemanticVersion

string (SemanticVersion) ^(v)?(0|([1-9][0-9]{0,4}))(\.(0|([1-9][0-9]{0...

See https://semver.org/ for a full description of semantic versioning. The regex here is a subset of allowed semantic versions.

"v1.2.3"

BackendVersion

version
any
Deprecated
Value: "v1.0.0"
optVersion
string (FieldPlacerVersion) ^[0-9]{4}-[0-9]{2}-[0-9]{2}_[0-9]+(p[0-9]+)?$...

The version of the algorithm used for calculating the result.

rev
string >= 7 characters

An internal identifier for the algorithm version.

schema
required
string (SemanticVersion) ^(v)?(0|([1-9][0-9]{0,4}))(\.(0|([1-9][0-9]{0...

The version of the schema used for validating both request data sent via the PUT request as well as response data gotten from the GET request.

{
  • "version": "v1.0.0",
  • "optVersion": "1970-01-01_0p0",
  • "rev": "strings",
  • "schema": "v1.2.3"
}

FloorPlannerOutputPlan

requestID
string

The identifier that allows finding input/output data, logs and more. This ID will be asked for in most non-trivial support cases so it should be stored when receiving the data.

object (Client)

Contains information about the client which sends this request.

required
object (FloorPlannerMeta)

Meta information about what to consider in the optimization.

required
object (FloorPlannerOptimizationParameters)

Parameters for the optimizer.

required
Array of FloorPlannerOutputTaskAssigned (object) or FloorPlannerOutputTaskUnassigned (object) (FloorPlannerOutputTask)

Array of assigned and unassigned tasks.

required
Array of objects (FloorPlannerOutputWorker)

Array of available Workers.

required
object (FloorPlannerStatistics)

Some statistics about the plan.

required
object (FloorPlannerInfo)

Some textual information about the plan.

Array of objects (Anomalies) non-empty

List of all anomalies found in solution.

required
object (BackendVersion)

Used validation/ calculation version.

recovery
Array of integers (IDReferences) [ items [ 0 .. 2147483647 ] ]

This is a field only used for debugging by internal developers. Content in this field may change depending on the application, input-data and version. The output values can be used as input values.

{
  • "requestID": "string",
  • "client": {
    },
  • "meta": {
    },
  • "parameters": {
    },
  • "tasks": [
    ],
  • "workers": [
    ],
  • "statistics": {
    },
  • "info": {
    },
  • "anomalies": [
    ],
  • "backendVersion": {
    },
  • "recovery": [
    ]
}

VersionInfo

schema
string

Schema version against which input and output data are validated

version
string

Version of the application that calculates solutions

meta_data
string

Meta data version

api_scripts
string

Version of the scripts handling requests

{
  • "schema": "v1.7.0",
  • "version": "2024-10-01_0",
  • "meta_data": "v19",
  • "api_scripts": "v1.6.2"
}

PackagesList

Array
Name
required
string

Package name to use in the adiutaopt-version header

LastModified
string

Modification timestamp of the package, usually of the time it was uploaded at

object (VersionInfo)
[
  • {
    },
  • {
    }
]

Changelog

v8.3.0

  • In FloorPlannerOutputTaskAssigned: Added timeWindowViolation

v8.1.0

  • In FloorPlannerInputTask: Added preferredPrecedingTasks.

v7.18.2

  • In FloorPlannerInputPlan: Updated description for history.
  • In FloorPlannerInputTask: Updated description for preassignedWorker, initassignedWorker, predecessorTasks.
  • Added example PredecessorChain for POST /floor-description endpoint

v7.17.0

  • Added accept and accept-encoding headers to GET /version, GET /packages-list endpoints, added 406 response code
  • Added 409 response code to all GET endpoints

v7.16.0

  • In FloorPlannerInputTask: Added desiredPredecessorGroup

v7.15.1

  • In Client: Updated description for clientID, added examples

v7.14.1

  • Updated descriptions to include whether a field is a restriction or a preference and optionally, if the latter, what parameter influences it.

v7.12.0

  • In OutputTaskAssigned, OutputTaskUnassigned: Added allowedWorkers

v7.11.0

  • In AnomalyEntry:
    • Added severity
    • Changed text to required

v7.10.0

  • In OutputPlan: Added anomalies

v7.9.0

  • In FloorPlannerInputTask: Added hasStrictExclusiveSet.

v7.8.0

  • Added section Index which contains all major schema defintions

v7.7.0

  • Updated 4xx and 5xx http responses with content documentation
  • Added description for PackagesList and VersionInfo component

v7.6.0

  • Added missing HEAD request documentation to GET endpoints

v7.5.0

  • Added response code 405 to all endpoints

v7.4.1

  • Updated changelog to only include changes related to the corresponding site.

v7.3.0

  • Added definition FloorPlannerOutput:
    • Combines FloorPlannerOutputPlan and ErrorPlan into one definition to use as schema in /plan GET response

v7.1.0

  • Added response code 429 to all POST requests
  • In ErrorPlan: Added allowRepeat

v5.1.0

  • Added new content-type options in POST requests:
    • application/vnd.adiutabyte.adiutaopt.json+gzip
    • application/vnd.adiutabyte.adiutaopt.json+deflate
    • application/vnd.adiutabyte.adiutaopt.json+br
  • Updated description for POST request, added explanations to response codes, compression and returned key
  • Added header accept-encoding in GET requests with allowed values:
    • identity
    • deflate
    • gzip
  • Added header accept in GET requests with allowed values:
    • application/json
    • application/vnd.adiutabyte.adiutaopt.json+gzip
    • application/vnd.adiutabyte.adiutaopt.json+deflate
    • application/vnd.adiutabyte.adiutaopt.json+br
  • Renamed header version to adiutaopt-version

v5.0.0

  • Restored compatibility to v3 schemata
  • In BackendVersion:
    • Changed version to be constant "v1.0.0", marked as deprecated
    • Added optVersion, has the same properties as version did in v4

v4.0.1

  • Added response codes to OPTIONS requests
  • Removed incorrect authentication details from OPTIONS requests

v4.0.0

  • Changed FieldPlacerVersion pattern to ^d{4}-d{2}-d{2}_d+(pd+)?$.

v2.9.0

  • Added header parameter Version to paths /floor-description and /floor-version
    • Updated curl/nodejs code examples to include one with the new header
  • Added path /floor-packages-list

v2.8.1

  • Fixed response content type for status 200, 201 for endpoint /floor-description

v2.2.0

  • In FloorPlannerMeta:
    • Added disableTaskTimeWindowRelaxation

v2.0.0

  • Added Number_s64

v1.14.0

  • In ErrorPlan
    • Added recovery

v1.13.0

  • In FloorPlannerInputPlan, FloorPlannerOutputPlan:
    • Added recovery

v1.11.0

  • In FloorPlannerMeta:
    • Added new field removeInvalidTasks

v1.9.0

  • Added some missing default values

v1.8.1

  • Added missing return codes 400, 413 to endpoints for posting new optimization requests

v1.8.0

  • In FloorPlannerInputTask:
    • Added exclusiveSetID
  • In FloorPlannerInputWorker:
    • Added preferredCategories
    • Added unpreferredCategories
    • Added desiredCategories
    • Added undesiredCategories

v1.7.3

  • Added missing return code 401 to all endpoints

v1.7.1

  • Minor (non-functional) rework of ErrorEntry
  • Minor (non-functional) rework of FloorPlannerInputTask, FloorPlannerInputWorker
  • Fixed unevaluated properties being allowed in:
    • ErrorPlan
  • Fixed unevaluated properties being allowed in:
    • FloorPlannerOutputTaskAssigned
    • FloorPlannerOutputTaskUnassigned
    • FloorPlannerOutputWorker

v1.7.0

  • In FloorPlannerInputTask:
    • Added property durationInSeconds
    • Removed duration from required properties