Scoro icon

Scoro

Interact with the Scoro API
Join our community

Actions50

Overview

This node integrates with the Scoro API to retrieve multiple Project records based on user-defined criteria. It is designed to fetch many projects at once, supporting filtering, pagination, and batching options to efficiently handle large datasets.

Common scenarios include:

  • Synchronizing project data from Scoro into another system.
  • Generating reports or dashboards that require bulk project information.
  • Automating workflows that depend on up-to-date project lists filtered by modification date or other attributes.

For example, a user might want to get all projects modified since January 1, 2023, excluding deleted ones, and process them in batches to avoid hitting API rate limits.

Properties

Name Meaning
Options Collection of options to customize the retrieval of projects:
- Filter A JSON object used to filter results, e.g., by modified date.
- Include Deleted Boolean flag indicating whether to include projects deleted in the last 30 days.
- Pagination Controls how many results to return:
-- Return All Whether to return all matching projects or limit the number returned.
-- Page Limit Maximum number of projects to return if not returning all.
- Batching Controls batch request behavior to manage rate limits:
-- Pages per Batch Number of pages requested concurrently in each batch.
-- Batch Interval (ms) Time in milliseconds to wait between batches of requests.

Output

The node outputs an array of project objects in the json field of each item. Each object represents a project record retrieved from Scoro, containing fields as defined by the Scoro API for projects.

If binary data were involved (not indicated here), it would be summarized accordingly, but this operation focuses on JSON data representing projects.

Dependencies

  • Requires an active connection to the Scoro API via an API key credential.
  • The node expects configuration of the base URL and authentication details through credentials.
  • No additional external dependencies beyond the Scoro API are required.

Troubleshooting

  • Unsupported Operation Error: If the selected operation-resource combination is not supported, the node throws an error indicating this. Ensure "Get Many" is selected under the "Project" resource.
  • Invalid Filter JSON: Providing malformed JSON in the filter option will cause parsing errors. Validate JSON syntax before input.
  • API Rate Limits: Fetching large datasets without batching may hit API rate limits. Use batching options (Pages per Batch and Batch Interval) to mitigate this.
  • Include Deleted Flag Misuse: Setting Include Deleted to true includes projects deleted in the last 30 days; ensure this matches your intent to avoid unexpected results.

Links and References

Discussion