Actions26
- Repositories Actions
- Resource Actions
- Resources Actions
- Favorites Actions
- Exports Actions
- Image Actions
- Account Actions
- Graphics Actions
- Recents Actions
Overview
This node interacts with the iTwin Projects API to retrieve resources from a specific repository within an iTwin project. It is designed to fetch repository resources based on provided identifiers and optional search criteria. This node is useful when you want to programmatically access and filter resources stored in an iTwin repository, such as models, documents, or other project assets.
Practical examples include:
- Automating retrieval of all resources in a given repository for further processing.
- Searching for resources by name or partial name within a repository.
- Integrating iTwin repository data into workflows for reporting or synchronization.
Properties
| Name | Meaning |
|---|---|
| iTwin ID | The unique identifier of the iTwin project to query. |
| Repository ID | The unique identifier of the repository within the iTwin project from which to get resources. |
| Search | A case-insensitive search string to filter resources by their display name. Returns any resource containing this substring. |
Output
The output is an array of JSON objects representing the resources retrieved from the specified repository. Each object corresponds to a single resource and contains its details as returned by the iTwin Projects API.
If multiple resources are returned, each will be an individual item in the output array.
No binary data output is indicated by the source code.
Dependencies
- Requires an API authentication token credential for the iTwin OAuth2 API to authorize requests.
- Depends on the
ProjectsOpenApiInterpretermodule to interpret and execute API operations. - The node expects the environment to have network access to the iTwin Projects API endpoints.
Troubleshooting
Common issues:
- Invalid or missing iTwin ID or Repository ID parameters will cause the operation to fail.
- Network connectivity problems or invalid API credentials can result in authorization errors.
- If the search string is malformed or too restrictive, it may return no results.
Error messages:
"Unknown operation: <operation>": Indicates that the specified operation is not recognized by the interpreter. Ensure the operation name matches exactly.- Errors related to API calls typically include messages about authentication failure or resource not found; verify credentials and IDs.
- On failure, if "Continue On Fail" is enabled, the node outputs an error object with the message and node info instead of stopping execution.
Links and References
- iTwin Developer Documentation
- Refer to the iTwin Projects API documentation for detailed information on repository resources and search capabilities.