Actions58
- Address Actions
- Agentslog Actions
- Appointment Actions
- E-Mail Actions
- Estate Actions
- File Actions
- Relation Actions
- Search Criterion Actions
- Setting Actions
- Task Actions
- Template Actions
Task → Read
AI-generatedOverview
This node reads task data from the onOffice system. It can retrieve a specific task by its ID or multiple tasks filtered by various criteria. Users can specify which data fields to retrieve, limit the number of tasks returned, and include additional details such as mobile URLs, related address, estate, or project IDs, and effort information. This node is useful for integrating task management data from onOffice into workflows, such as fetching task details for reporting, monitoring, or automation purposes.
Use Case Examples
- Fetch a specific task by its ID to display detailed information in a dashboard.
- Retrieve multiple tasks filtered by related project IDs to generate a project status report.
- Get tasks with effort details included to analyze workload and progress.
Properties
| Name | Meaning |
|---|---|
| Task ID | Specific task ID to read. Leave empty to read multiple tasks with filters. |
| Data Fields | Comma-separated list of fields to retrieve (e.g., Betreff, Aufgabe, Status, Deadline). |
| Add Mobile URL | Whether to include mobile URL in response. |
| List Limit | Maximum number of tasks to return (max: 500). |
| Related Address ID | Address ID linked with the task. |
| Related Estate ID | Estate ID linked with the task. |
| Related Project IDs | Project IDs linked with the task. |
| Show Efforts | Whether to show actual efforts and remaining workload. |
Output
JSON
taskId- The unique identifier of the task.fields- The requested data fields for the task.mobileUrl- Mobile URL of the task if requested.relatedAddressId- ID of the related address linked to the task.relatedEstateId- ID of the related estate linked to the task.relatedProjectIds- IDs of related projects linked to the task.efforts- Details about actual efforts and remaining workload if requested.
Dependencies
- An API key credential for onOffice API authentication
Troubleshooting
- Ensure the Task ID is valid and exists in the onOffice system to avoid errors when reading a specific task.
- Verify that the API key credential is correctly configured and has sufficient permissions to access task data.
- If no tasks are returned when filtering, check that the filter criteria such as related address, estate, or project IDs are correct and correspond to existing data.
- The maximum list limit is 500; requesting more may result in errors or truncated results.