Actions5
Overview
This node integrates with the TANSS API to manage employee data. It supports creating new employees, retrieving employee details, listing technicians, updating employee information, and fetching availability data. This node is useful in scenarios where you want to automate HR or workforce management tasks, such as onboarding new staff, updating employee roles, or synchronizing technician lists with other systems.
For example, you can use this node to:
- Automatically create a new employee record when a form is submitted.
- Retrieve detailed information about a specific employee for reporting.
- List all technicians to assign jobs dynamically.
- Update employee status or contact details based on external inputs.
- Check an employee’s availability before scheduling work.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Mitarbeiterfelder (Employee Fields) | Collection of employee attributes to set when creating or updating an employee. Includes: - Vorname (First name) - Nachname (Last name) - E-Mail (Email address) - Telefon (Phone number) - Abteilungs-ID (Department ID) - Rolle (Role): Administrator, Techniker, Benutzer, Manager - Aktiv (Active): Boolean indicating if the employee is active |
Output
The node outputs JSON data representing the response from the TANSS API for each executed operation. The structure depends on the operation:
- Mitarbeiter erstellen (Create Employee): Returns the created employee object with all provided fields and assigned IDs.
- Mitarbeiter abrufen (Get Employee): Returns detailed information about the specified employee.
- Techniker auflisten (List Technicians): Returns an array of technician employee objects.
- Mitarbeiter aktualisieren (Update Employee): Returns the updated employee object reflecting changes.
- Verfügbarkeit abrufen (Get Availability): Returns availability data related to the specified employee.
No binary data output is produced by this node.
Dependencies
- Requires an API token credential for authenticating with the TANSS API.
- The base URL for the TANSS API is obtained from the credentials configuration.
- Network access to the TANSS API endpoints is necessary.
Troubleshooting
- Missing Credentials: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API token is correctly configured in the node credentials.
- Empty Fields on Create/Update: When creating or updating an employee, if no employee fields are provided, the node throws errors like "Keine Felder für die Mitarbeitererstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Always provide at least one field to modify.
- Invalid Operation: If an unsupported operation is selected, the node will throw an error indicating the operation is not recognized.
- API Request Failures: Errors during HTTP requests to the TANSS API will be reported with messages including the operation name and the original error message. Check network connectivity, API token validity, and endpoint availability.
Links and References
- TANSS API Documentation (Replace with actual link if available)
- n8n Documentation on Creating Custom Nodes