Actions54
- Resource Actions
- Userpermissions Actions
- Baselinefile Actions
- Locks Actions
- Briefcases Actions
- Checkpoint Actions
- Thumbnail Actions
- Extendeddata Actions
- Changesets Actions
- Changesetgroups Actions
- Permissions Actions
- Recents Actions
- Namedversions Actions
- Shares Actions
- Rolepermissions Actions
- Users Actions
- Favorites Actions
- Fork Actions
- Clone Actions
- Create Actions
Overview
This node interacts with the iTwin Platform's iModels API, specifically to retrieve extended data about changesets for a given iModel. It is useful in scenarios where users need detailed metadata or audit information about changes made to an iModel over time. For example, it can be used to track version history, analyze modifications, or integrate change data into other workflows.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the iModel for which the changesets' extended data will be retrieved. This is a required string input. |
Output
The node outputs JSON data representing the extended data of changesets associated with the specified iModel. The structure typically includes detailed metadata about each changeset, such as timestamps, authorship, and possibly custom attributes related to the changes. If multiple changesets are returned, the output is an array of JSON objects, each corresponding to one changeset's extended data.
No binary data output is indicated by the source code.
Dependencies
- Requires an API authentication token credential to access the iTwin Platform iModels API.
- The node depends on an internal interpreter module (
IModelsOpenApiInterpreter) that handles the API operations. - Proper configuration of the API credentials within n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Providing an invalid or empty iModel ID will likely cause the API call to fail.
- Missing or incorrect API authentication credentials will prevent access to the iTwin Platform.
- Network connectivity problems may result in request timeouts or failures.
Error messages:
"Unknown operation: get-imodel-changesets-extended-data"indicates the operation name was not recognized; ensure the correct operation is selected.- Errors containing
"iTwin IModels execution failed"suggest issues during API interaction; check credentials and input parameters.
Resolution tips:
- Verify the iModel ID is correct and exists in the iTwin Platform.
- Confirm that the API key or OAuth2 token is valid and has sufficient permissions.
- Enable "Continue On Fail" if you want the workflow to proceed despite individual errors.
Links and References
- iTwin Platform Developer Documentation
- n8n documentation on creating custom nodes