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

Sources → Get

AI-generated

Overview

This node integrates with the TaxonWorks API, a web-based workbench for taxonomists and biodiversity scientists. Specifically, the "Sources" resource with the "Get" operation allows users to retrieve source records from a TaxonWorks server based on various filtering criteria.

Typical use cases include:

  • Fetching bibliographic sources or references related to taxonomic data.
  • Filtering sources by author, title, year, project, or other metadata.
  • Retrieving recent or specific sources for further processing or analysis in an n8n workflow.

For example, a user might want to get all sources authored by a particular scientist within a certain year range or fetch sources linked to a specific project.

Properties

Name Meaning
Server The URL of the TaxonWorks server (e.g., https://sfg.taxonworks.org)
Additional Fields A collection of optional filters and parameters to refine the source query:
- ID The source ID
- Author Filter by author name
- Author IDs Comma-separated list of author IDs (e.g., 1,2,3)
- Citations Filter by citations
- Documents Filter by documents
- Exact Author Filter by exact author name
- Exact Title Filter by exact title
- Identifier Filter by identifier
- Identifier Start Filter by start of identifier
- Identifier End Filter by end of identifier
- Identifier Exact Filter by exact identifier
- IDs Comma-separated list of source IDs (e.g., 1,2,3)
- In Project Boolean flag to filter sources that are in a project
- Keyword ID And Comma-separated keyword IDs where all must be present
- Keyword ID Or Comma-separated keyword IDs where any may be present
- Nomenclature Boolean flag to filter nomenclatural sources
- Notes Filter by notes
- Project ID Filter by project ID
- Recent Boolean flag to filter recent sources
- Roles Filter by roles
- Source Type Type of source; options: BibTex, Human, Verbatim
- Title Filter by title
- Topic IDs Comma-separated list of topic IDs
- With DOI Boolean flag to filter sources with DOI
- User Date Start Filter by user date start (date/time)
- User Date End Filter by user date end (date/time)
- Year Start Filter by starting year
- Year End Filter by ending year
- Page Pagination page number
- Per Number of items per page

Output

The node outputs a JSON array containing the retrieved source objects matching the specified filters. Each object corresponds to a source record as returned by the TaxonWorks API.

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.
    • An API key credential for project authentication.
  • The node makes HTTP GET requests to the TaxonWorks REST API endpoints.

Troubleshooting

  • Common issues:

    • Incorrect or missing API tokens will cause authentication failures.
    • Invalid server URL or network issues will prevent connection.
    • Using unsupported or malformed filter values may result in empty responses or errors.
    • Pagination parameters (page and per) should be set carefully to avoid large payloads or missing data.

  • Error messages:

    • Authentication errors typically indicate invalid or expired API tokens.
    • HTTP 404 errors suggest incorrect endpoint URLs or resource IDs.
    • HTTP 400 errors may indicate invalid query parameters.

  • Resolutions:

    • Verify API tokens and ensure they have proper permissions.
    • Confirm the server URL is correct and accessible.
    • Check filter values for correctness and format.
    • Use pagination to limit response size.

Links and References

Discussion