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 creating, retrieving, listing, updating, and deleting device records within the TANSS system.
Typical use cases include:
- Automating inventory management by adding new devices automatically when they are procured.
- Synchronizing device data between TANSS and other systems.
- Updating device details like location or IP address in bulk.
- Removing obsolete devices from the system.
For example, you could use this node to create a new PC/server entry with detailed information like serial number and manufacturer ID, or list all peripherals currently registered in TANSS.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device to manage. Options: "PC/Server", "Peripherie" (peripherals), "Komponenten" (hardware components), "Services" (software services). |
| Operation | Action to perform on the device resource. 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 string used for authenticating requests against the TANSS API. |
| Geräte-ID | Numeric ID of the device (required for get, update, delete operations). |
| Gerätefelder | Collection of fields describing device attributes, used for create and update operations. Includes: - Name (string): Device name - Beschreibung (string): Description - Seriennummer (string): Serial number - Inventarnummer (string): Inventory number - Hersteller-ID (number): Manufacturer ID - Unternehmen-ID (number): Company ID - Standort (string): Location - IP-Adresse (string): IP address - MAC-Adresse (string): MAC address - Betriebssystem-ID (number): 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 object with its properties.
- Get: Returns the device object identified by the given device ID.
- List: Returns an array of device objects matching the selected device type.
- Delete: Returns confirmation or status of the deletion operation.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint, configured via credentials that provide the base URL and authentication.
- An API token must be supplied per execution to authenticate individual requests.
- The node uses HTTP methods (GET, POST, PUT, DELETE) to interact with the API.
Troubleshooting
- Missing Credentials: If no credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API credentials are properly set up in n8n.
- Empty Fields on Create/Update: Creating or updating a device without specifying any device fields results in an error indicating no fields were provided. Always supply at least one field when creating or updating.
- Invalid Operation: Selecting an unsupported operation will cause 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 the API token validity, network connectivity, and correct device IDs.
- Device ID Required: For get, update, and delete operations, a valid device ID must be provided; otherwise, the request will fail.
Links and References
- TANSS API Documentation (not provided here, but users should consult their official API docs for detailed endpoint info)
- n8n Documentation on creating custom nodes and using HTTP request helpers