Overview
This node manages devices (such as PCs, servers, peripherals, hardware components, and software services) via the TANSS API. It supports creating, retrieving, listing, updating, and deleting devices in the TANSS system. This is useful for IT administrators or automation workflows that need to synchronize device inventories, update device information, or remove obsolete devices programmatically.
Practical examples:
- Automatically adding new computers or printers to the TANSS inventory when they are provisioned.
- Fetching detailed information about a specific device for reporting or auditing.
- Updating device details like location or IP address after relocation.
- Removing devices that are decommissioned or no longer in use.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device. Options: PC/Server, Peripherie (peripherals like printers, scanners), Komponenten (hardware components), Services (software services). |
| Operation | Action to perform on the device. Options: Gerät erstellen (create device), Gerät abrufen (get device), Geräte auflisten (list devices), Gerät aktualisieren (update device), Gerät löschen (delete device). |
| API Token | API token from TANSS authentication used for authorization. |
| Geräte-ID | ID of the device to get, update, or delete. |
| Gerätefelder | Collection of fields for 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 JSON data representing the response from the TANSS API for the requested operation. The structure depends on the operation:
- For createDevice, it returns the created device's data.
- For getDevice, it returns the details of the specified device.
- For listDevices, it returns an array of devices.
- For updateDevice, it returns the updated device data.
- For deleteDevice, it returns confirmation of deletion or related status.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint with a valid base URL configured in credentials.
- Requires an API token from TANSS authentication provided as an input property.
- Needs proper n8n credential setup to store the TANSS API base URL securely.
Troubleshooting
- Missing Credentials: If no credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure the TANSS API credentials are properly configured in n8n.
- Empty Fields for Create/Update: When creating or updating a device, if no device fields are provided, the node throws errors like "Keine Felder für die Geräteerstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Errors: Any HTTP request failure will result in an error message prefixed with "Fehler beim Ausführen von [Operation]:", followed by the API error message. Check the API token validity, network connectivity, and correct device IDs.
- Device ID Required: For operations that require a device ID (get, update, delete), ensure a valid numeric ID is provided.
Links and References
- TANSS API documentation (not included here; refer to your organization's internal API docs)
- n8n documentation on creating custom nodes: https://docs.n8n.io/integrations/creating-nodes/
- General REST API usage best practices