Update All Zammad Roles to Default Values

This n8n workflow is designed to interact with the Zammad API, specifically to retrieve information about roles. It provides a basic framework for fetching role data, which can then be extended to perform updates or other operations.

Description

This workflow acts as a starting point for managing Zammad roles. It triggers manually, makes an API request to Zammad to list all roles, and then processes this data. While the current implementation only fetches data, it's structured to allow easy expansion for bulk updates or other administrative tasks on Zammad roles.

What it does

1. Manual Trigger: The workflow starts when manually executed.
2. HTTP Request to Zammad: It makes an HTTP GET request to the Zammad API to retrieve a list of all configured roles.
3. Conditional Logic (If Node): It includes an "If" node, which is currently configured to pass all items through its "True" branch. This node serves as a placeholder for adding conditional logic, such as filtering roles based on specific criteria.
4. Edit Fields (Set Node): A "Set" node is included, which can be used to modify or add fields to the incoming data. This is useful for preparing data before further processing or updating.
5. Zammad Node: A Zammad node is present, likely intended for further interactions with Zammad, such as updating roles or users, but it's not actively connected in this basic flow.
6. Convert to File: A "Convert to File" node is included, suggesting the capability to export the retrieved role data into various file formats, though it's not actively connected to receive data in this initial setup.

Prerequisites/Requirements

• n8n Instance: A running instance of n8n.
• Zammad Instance: Access to a Zammad instance.
• Zammad API Token: A Zammad API token with sufficient permissions to read roles (and potentially update them if the workflow is extended). This token would be configured in an n8n Zammad credential.
• HTTP Request Configuration: The "HTTP Request" node needs to be configured with the correct Zammad API endpoint for listing roles and authentication headers (e.g., using the Zammad API token).

Setup/Usage

1. Import the Workflow: Import the provided JSON into your n8n instance.
2. Configure Zammad Credentials:
   • Create or select an existing Zammad credential in n8n.
   • Ensure the credential has the necessary API token for your Zammad instance.
3. Configure HTTP Request Node (ID: 19):
   • Set the URL to your Zammad API endpoint for listing roles (e.g., https://your-zammad-instance.com/api/v1/roles).
   • Configure the Authentication method (e.g., Header Auth or Bearer Token) using your Zammad API token.
4. Customize Conditional Logic (If Node - ID: 20):
   • If you need to filter roles, modify the conditions in the "If" node. For example, you could filter roles by name, ID, or other attributes.
5. Customize Data Transformation (Edit Fields Node - ID: 38):
   • If you need to modify the role data before further processing (e.g., setting default values for certain fields), configure the "Edit Fields" node.
6. Extend Zammad Node (ID: 552):
   • To update roles, connect the output of the "Edit Fields" or "If" node to the "Zammad" node.
   • Configure the "Zammad" node to perform the desired update operation (e.g., "Update Role") and map the fields accordingly.
7. Execute the Workflow: Click "Execute workflow" in the "Manual Trigger" node to run the workflow.