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. This is useful in IT asset management scenarios where automated synchronization or management of device inventories is required. For example, you can automate updating device details after a hardware upgrade or retrieve device information for reporting purposes.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device to manage. Options: PC/Server, Peripherie (printers, scanners, etc.), Komponenten (hardware components), Services (software services). |
| API Token | API token from TANSS authentication used for authorization. |
| Geräte-ID | 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:
- Create / Update: Returns the created or updated device data.
- Get: Returns the device data for the specified device ID.
- List: Returns a list of devices of the selected type.
- Delete: Returns confirmation or status of deletion.
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
- Missing Credentials: If no credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure that the TANSS API credentials are properly set up in n8n.
- Empty Fields on Create/Update: Creating or updating a device without specifying any fields results in an error "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 throw an error 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: https://docs.n8n.io/integrations/creating-nodes/