Overview
This node integrates with the TANSS API to manage various types of devices such as PCs, servers, peripherals, hardware components, and software services. It supports operations like listing devices, creating new devices, retrieving device details, updating existing devices, and deleting devices.
Typical use cases include:
- Automatically syncing device inventories from TANSS into workflows.
- Creating or updating device records based on external triggers.
- Fetching detailed information about specific devices for reporting or monitoring.
- Cleaning up obsolete device entries by deleting them programmatically.
For example, you could list all PCs and servers in your organization or update the IP address of a specific peripheral device.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device to manage. Options: - PC/Server (Computers and servers) - Peripherie (Peripherals like printers, scanners) - Komponenten (Hardware components) - Services (Software services) |
| Operation | Action to perform on the selected device type. Options: - Gerät erstellen (Create a new device) - Gerät abrufen (Get device details) - Geräte auflisten (List all devices) - Gerät aktualisieren (Update device data) - Gerät löschen (Delete a device) |
| API Token | API token obtained from TANSS authentication, required for authorization. |
| Geräte-ID | Numeric ID of the device; required for get, update, and delete operations. |
| Gerätefelder | Collection of fields used when creating or updating a device, including: - Name - Beschreibung (Description) - Seriennummer (Serial number) - Inventarnummer (Inventory number) - Hersteller-ID (Manufacturer ID) - Unternehmen-ID (Company ID) - Standort (Location) - IP-Adresse (IP address) - MAC-Adresse (MAC address) - Betriebssystem-ID (Operating system ID) |
Output
The node outputs an array of JSON objects representing the response from the TANSS API for each input item processed. The structure depends on the operation:
- listDevices: Returns a list of devices matching the selected device type.
- getDevice: Returns detailed information about a single device.
- createDevice: Returns the created device's data.
- updateDevice: Returns the updated device's data.
- deleteDevice: Returns confirmation of deletion or related status.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint.
- Needs an API token credential from TANSS authentication.
- The base URL for the TANSS API must be configured in the node credentials.
- Uses HTTP requests with JSON payloads and expects JSON responses.
Troubleshooting
- Missing Credentials: If no API token or credentials are provided, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API token is correctly set.
- Empty Fields on Create/Update: When creating or updating a device, if no device fields are specified, the node throws errors indicating missing fields. Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node will throw an error stating the operation is not recognized.
- API Request Failures: Errors during API calls return messages prefixed with "Fehler beim Ausführen von [operation]:". Check network connectivity, API token validity, and correct device IDs.
- Device ID Required: For get, update, and delete operations, ensure a valid device ID is provided; otherwise, the request will fail.
Links and References
- TANSS API documentation (not included here, but recommended to consult for detailed API usage)
- n8n HTTP Request node documentation for understanding request options and error handling
- General REST API best practices for managing device inventories