Task Repository

Manage tasks in onOffice. The resource type is task.

Querying Tasks

use Innobrain\OnOfficeAdapter\Facades\TaskRepository;

$tasks = TaskRepository::query()->get();
$task = TaskRepository::query()->first();
$task = TaskRepository::query()->find(5);

Selecting & Filtering

$tasks = TaskRepository::query()
    ->select(['Betreff', 'Status', 'Prio', 'Verantwortung'])
    ->where('Status', 1)
    ->get();

Filtering by Related Records

Tasks can be filtered by the address, estate, or project they belong to:

$tasks = TaskRepository::query()->relatedAddress(42)->get();
$tasks = TaskRepository::query()->relatedEstate(99)->get();
$tasks = TaskRepository::query()->relatedProject(7)->get();

Creating Tasks

The related record methods also work for create and modify — the ids are sent alongside the task data:

TaskRepository::query()
    ->relatedAddress(7)
    ->relatedEstate(42)
    ->create([
        'Betreff' => 'Call back',
        'Prio' => 3,
    ]);

Modifying Tasks

TaskRepository::query()
    ->addModify('Status', 4)
    ->modify(99);

Field Gotchas

• Art is mandatory on create, but the field metadata reports no permitted values for it — read an existing task to find a valid key.
• Status is written with numeric keys but read back as German labels (In Bearbeitung).
• Status and erledigt are stored independently; the API does not sync them, so complete a task by setting both.
• Deadline is stored but stays inactive unless Deadline_strikt is also set.
• Verantwortung and Bearbeiter accept any string verbatim — a typo produces a task with no functional assignee, without an error.
• The endpoint rejects sortby, so results cannot be ordered server-side; orderBy() has no effect.

Count & Chunked

$count = TaskRepository::query()->relatedEstate(42)->count();

TaskRepository::query()->each(function (array $tasks) {
    // Process chunk
});

WARNING

The task endpoint reports cntabsolute as the number of returned rows, not a true total. count() works around this by requesting the maximum page size, so it is capped at 500 — more matching tasks than that still return 500.