Overview
This node integrates with the TANSS API to manage PC or server records. It supports creating, updating, retrieving by ID, and deleting PCs or servers within the TANSS system. This is useful for IT asset management workflows where automated synchronization or manipulation of PC inventory data is required.
Typical use cases include:
- Automatically adding new PC records when provisioning hardware.
- Updating existing PC details such as location, software, or hardware specs.
- Fetching detailed information about a specific PC by its ID.
- Removing PC entries when decommissioned.
For example, an IT department could use this node to create a new PC record with all relevant hardware and software details after receiving a new machine.
Properties
| Name | Meaning |
|---|---|
| API Token | The API token used to authenticate requests to the TANSS API. |
| PC Data | A collection of fields describing the PC or server to create or update. Fields include: Inventory Number, Active status, Company ID, Name, Service Technician ID, Employee ID, Date (timestamp), Location, Manufacturer ID, Model, Serial Number, OS ID, Software, Remark, Show Remark (boolean), Mainboard Manufacturer ID, Mainboard Manufacturer Revision, Mainboard Serial Number, BIOS, BIOS Release, CPU Manufacturer ID, CPU Type ID, CPU Frequency, CPU Number, Mouse Serial Number, Keyboard Serial Number, Server (boolean), Internal Remark, Billing Number, Article Number, Manufacturer Number, Host ID, Purchase Price, Selling Price, Ownage Type (Own, Foreign, Own Rent, Foreign Rent), Storage ID, TeamViewer ID and Password, AnyDesk ID and Password, Reserved RAM, Reserved Hard Disk, Reserved CPU, Description. |
| PC ID | The numeric identifier of the PC or server, used for fetching, updating, or deleting a specific PC. |
| Operation | The action to perform: "Get PC by ID", "Update PC", "Create PC", or "Delete PC". |
Output
The node outputs an array of JSON objects representing the response from the TANSS API for each input item processed. The structure of the JSON depends on the operation:
- For Create PC and Update PC, the output JSON contains the newly created or updated PC record details as returned by the API.
- For Get PC by ID, the output JSON contains the PC or server details fetched from the API.
- For Delete PC, the output JSON typically contains confirmation of deletion or related status information.
No binary data is output by this node.
Dependencies
- Requires access to the TANSS API endpoint.
- Requires an API token credential for authenticating requests.
- The base URL for the TANSS API is obtained from the configured credentials.
- The node uses HTTP methods GET, POST, PUT, and DELETE to interact with the API.
Troubleshooting
- No credentials returned!: Indicates that the API token credential was not provided or not properly configured. Ensure the API token is set in the node credentials.
- No data provided for creating/updating the PC.: When performing create or update operations, the PC Data collection must contain at least one field; otherwise, the node throws an error.
- Failed to execute [operation]: [error message]: Generic error indicating the API request failed. Check the API token validity, network connectivity, and that the PC ID exists for operations requiring it.
- The operation "[operation]" is not recognized.: The specified operation is invalid or unsupported. Verify the operation parameter is correctly set.
Links and References
- TANSS API documentation (not provided here, but users should refer to their official API docs for detailed field descriptions and API behavior).