Actions8
Overview
The node "TANSS Tickets" manages ticket operations via the TANSS API. It allows users to perform various actions on tickets such as updating, creating comments, retrieving details, searching, merging, and deleting tickets. This node is beneficial in scenarios where you want to automate or integrate ticket management workflows within the TANSS system, for example:
- Automatically updating ticket details based on external triggers.
- Adding comments to tickets programmatically.
- Searching tickets with specific criteria to generate reports or trigger further automation.
- Merging duplicate tickets or cleaning up old tickets.
Specifically, the "Ticket aktualisieren" (Update Ticket) operation updates an existing ticket with new information provided by the user.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Ticket-ID | The unique identifier of the ticket to update. |
| Update Fields | Collection of fields to update on the ticket. These include: |
| - Company ID (number) | |
| - Remitter ID (number) | |
| - Title (string) | |
| - Content (string) | |
| - External Ticket ID (string) | |
| - Assigned to Employee ID (number) | |
| - Assigned to Department ID (number) | |
| - Status ID (number) | |
| - Type ID (number) | |
| - Deadline Date (timestamp as number) | |
| - Due Date (timestamp as number) | |
| - Attention (options): No, Yes, Resubmission, Mail | |
| - Installation Fee (options): No, Yes, No Project Installation Fee | |
| - Relationship Link Type ID (number) | |
| - Relationship Link ID (number) | |
| - Resubmission Date (timestamp as number) | |
| - Estimated Minutes (number) | |
| - Phase ID (number) | |
| - Order Number (string) |
Output
The output is a JSON object representing the response from the TANSS API after attempting to update the ticket. This typically includes the updated ticket data or confirmation of the update operation. The structure depends on the API's response but generally contains ticket properties reflecting the new state.
No binary data output is produced by this operation.
Dependencies
- Requires an active TANSS API credential with a valid API token.
- The node uses the base URL from the credentials to construct API requests.
- Network access to the TANSS backend API endpoint is necessary.
Troubleshooting
Error: "Keine Felder für die Ticket-Erstellung angegeben."
This error occurs if no update fields are provided when trying to update a ticket. Ensure at least one field is set in the "Update Fields" collection.Error: "No credentials returned!"
Indicates missing or invalid API credentials. Verify that the API token credential is correctly configured and accessible.Error: "Fehler beim Ausführen von updateTicket: ..."
General error during the update request. Check the API token validity, ticket ID correctness, and network connectivity. Also, verify that the fields being updated conform to expected types and values accepted by the TANSS API.Unrecognized Operation Error
If the operation name is incorrect or unsupported, the node will throw an error. Confirm the operation is set to "updateTicket".
Links and References
- TANSS API Documentation (not provided here; consult your TANSS API provider for official docs)
- n8n Documentation on creating custom nodes: https://docs.n8n.io/integrations/creating-nodes/