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.
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: - 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 corresponding to the response from the TANSS API for each operation:
- For Mitarbeiter erstellen (createEmployee) and Mitarbeiter aktualisieren (updateEmployee), the output contains the created or updated employee object.
- For Mitarbeiter abrufen (getEmployee), it returns the employee details.
- For Techniker auflisten (getTechnicians), it returns a list of technician employee objects.
- For Verfügbarkeit abrufen (getAvailability), it returns availability data for the specified employee.
No binary data 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 node credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials: If no API token credential is provided, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found). Ensure the API token is configured correctly.
- Empty Employee Fields: When creating or updating an employee, if no fields are provided, the node throws an error indicating that no fields were specified. Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node throws an error stating the operation is not recognized.
- API Request Failures: Errors during API calls include the operation name and the original error message. Check network connectivity, API token validity, and correct employee IDs.
Links and References
- TANSS API Documentation (Replace with actual link if available)
- n8n Documentation on Creating Custom Nodes