Actions5
Overview
This node integrates with the TANSS API to manage employee data. It supports operations such as creating a new employee, retrieving employee details, listing all technicians, updating employee information, and fetching availability data for an employee. This node is useful in scenarios where you need to automate HR or workforce management tasks, synchronize employee records, or integrate employee availability into scheduling workflows.
Practical examples:
- Automatically create new employees in TANSS when onboarding staff.
- Retrieve detailed employee information for reporting or validation.
- List all technicians to assign jobs dynamically.
- Update employee contact details or roles based on external changes.
- Fetch availability data to optimize resource allocation.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Mitarbeiter-ID | Employee ID; required for operations that target a specific employee (get, update, availability). |
Output
The node outputs JSON data corresponding to the response from the TANSS API for each executed operation. The structure depends on the operation:
- Create Employee: Returns the created employee's data as JSON.
- Get Employee: Returns detailed information about the specified employee.
- Get Technicians: Returns a list of all technicians.
- Update Employee: Returns the updated employee data.
- Get Availability: Returns availability information for the specified employee.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the TANSS API endpoint.
- Needs an API token credential for authentication.
- The base URL for the TANSS API is obtained from the node credentials.
- No additional environment variables are required beyond the API token and base URL.
Troubleshooting
- Missing Credentials Error: If no API credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure the API token credential is configured correctly.
- Empty Fields for Create/Update: When creating or updating an employee, if no 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.
- Unknown Operation: If an unsupported operation is selected, the node throws an error indicating 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.
- Employee ID Required: For operations requiring an employee ID, ensure a valid numeric ID is provided.
Links and References
- TANSS API Documentation (Replace with actual link if available)
- n8n Documentation on Creating Custom Nodes
- General REST API usage in n8n: HTTP Request Node