TaxonWorks icon

TaxonWorks

TaxonWorks is an integrated web-based workbench for taxonomists and biodiversity scientists

Actions20

  • Asserted Distribution Actions
  • Biological Association Actions
  • Citation Actions
  • Collecting Event Actions
  • Collection Object Actions
  • Content Actions
  • Data Attribute Actions
  • Download Actions
  • Identifier Actions
  • Image Actions
  • Notes Actions
  • Observation Matrices Actions
  • Observations Actions
  • OTUs Actions
  • People Actions
  • Projects Actions
  • Sources Actions
  • Taxon Name Classifications Actions
  • Taxon Name Relationships Actions
  • Taxon Names Actions

Observation Matrices → Get

AI-generated

Overview

This node integrates with the TaxonWorks API, a web-based workbench for taxonomists and biodiversity scientists. Specifically, the "Observation Matrices" resource with the "Get" operation allows users to retrieve observation matrix data from a TaxonWorks server.

Typical use cases include:

  • Fetching specific observation matrices by ID or multiple IDs.
  • Paginating through large sets of observation matrices.
  • Integrating observation matrix data into workflows for further analysis or reporting.

For example, a researcher could use this node to pull observation matrices related to a particular study or project hosted on a TaxonWorks server, enabling automated data retrieval and processing within n8n.

Properties

Name Meaning
Server The URL of the TaxonWorks server to connect to (e.g., https://sfg.taxonworks.org).
Additional Fields Optional parameters to refine the query:
- ID Specific observation matrix ID to retrieve.
- Observation Matrix IDs Comma-separated list of observation matrix IDs to fetch (e.g., 1,2,3).
- Page Page number for paginated results (integer).
- Per Number of items per page for pagination (integer).

Output

The node outputs JSON data representing the requested observation matrices retrieved from the TaxonWorks API. The structure corresponds directly to the API's response for observation matrices, typically including fields such as matrix metadata, rows, columns, and associated observations.

No binary data output is produced by this node.

Dependencies

  • Requires access to a running TaxonWorks server.
  • Requires two credentials configured in n8n:
    • An API key credential for user authentication.
    • A project token credential for project-specific access.
  • The node makes HTTP GET requests to the TaxonWorks REST API endpoints.

Troubleshooting

  • Authentication errors: Ensure that valid API tokens are provided via the configured credentials. Invalid or expired tokens will cause authorization failures.
  • Connection issues: Verify the server URL is correct and accessible from the n8n environment.
  • Invalid parameter values: Check that IDs and pagination parameters are correctly formatted (e.g., comma-separated lists without spaces).
  • Empty responses: May indicate no matching observation matrices found; verify filter criteria.
  • API rate limits or server errors: If the TaxonWorks server enforces rate limits or experiences downtime, requests may fail temporarily.

Links and References

Discussion