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 device records in the TANSS system. This is useful for IT asset management workflows where automated synchronization or updates of device information are required.
Practical examples:
- Automatically add new computers or peripherals to the TANSS inventory when they are provisioned.
- Retrieve detailed information about a specific device by its ID.
- Update device details such as location, IP address, or description based on changes detected elsewhere.
- Remove decommissioned devices from the inventory.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device: "PC/Server", "Peripherie" (peripherals like printers/scanners), "Komponenten" (hardware components), or "Services" (software services). |
| API Token | API token from TANSS authentication used for authorization in API requests. |
| Geräte-ID | Numeric ID of the device to retrieve, update, or delete. |
| Gerätefelder | Collection of device fields for creation or update, 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:
- For createDevice and updateDevice, the output contains the updated or newly created device data.
- For getDevice, the output contains the detailed data of the requested device.
- For listDevices, the output contains an array of all devices of the selected type.
- For deleteDevice, the output typically contains confirmation of deletion or status message.
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 for authentication passed as a parameter.
- Needs n8n credentials configured with the TANSS API base URL and authentication details.
Troubleshooting
Error: Keine Anmeldedaten gefunden!
Means no credentials were found for the TANSS API. Ensure that the API credentials are properly set up in n8n.Error: Keine Felder für die Geräteerstellung angegeben.
When creating a device, at least one device field must be provided. Make sure to fill in the required fields.Error: Keine Felder zum Aktualisieren angegeben.
When updating a device, at least one field to update must be specified.Error: Die Operation "XYZ" wird nicht erkannt.
Indicates an unsupported operation was selected. Verify the operation name is correct.API request errors (e.g., network issues, invalid token)
These will be reported with the message "Fehler beim Ausführen von [operation]: [error message]". Check API token validity, network connectivity, and API endpoint correctness.
Links and References
- TANSS API documentation (not provided here; consult your TANSS API provider)
- n8n documentation on creating custom nodes and using HTTP Request helpers