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

People → Get

AI-generated

Overview

This node integrates with the TaxonWorks API, a web-based workbench for taxonomists and biodiversity scientists. Specifically, the "People" resource with the "Get" operation allows users to retrieve information about people involved in taxonomic and biodiversity projects. This can include collectors, determiners, authors, verifiers, and other roles related to biological data.

Typical use cases include:

  • Fetching lists of people who contributed to a project or dataset.
  • Filtering people by activity periods (e.g., born or active within certain years).
  • Searching for people by name or role.
  • Integrating people metadata into biodiversity workflows or reports.

For example, a user might query all collectors active after 1950 or find all people whose last names start with "Smith".

Properties

Name Meaning
Server The URL of the TaxonWorks server to connect to (e.g., https://sfg.taxonworks.org).
Additional Fields Optional filters and parameters to refine the search query. These include:
- Active After Year Filter people active after this year.
- Active Before Year Filter people active before this year.
- Born After Year Filter people born after this year.
- Born Before Year Filter people born before this year.
- Died After Year Filter people who died after this year.
- Died Before Year Filter people who died before this year.
- First Name Filter by first name (exact match).
- Last Name Filter by last name (exact match).
- Last Name Starts With Filter people whose last name starts with the given string.
- Levenshtein Cutoff Numeric cutoff for fuzzy matching on names using Levenshtein distance.
- Person Wildcard Wildcard search terms for person fields.
- Role Filter by one or more roles the person has had. Possible roles include: Accession Provider, Attribution Copyright Holder, Attribution Creator, Attribution Editor, Attribution Owner, Collector, Deaccession Recipient, Determiner, Extractor, Georeferencer, Loan Recipient, Loan Supervisor, Source Author, Source Editor, Source Source, Taxon Name Author, Verifier.
- Source ID Filter by source identifier associated with the person.
- Page Pagination page number (for paged results).
- Per Number of results per page.

Output

The node outputs a JSON array containing the retrieved people records from the TaxonWorks API. Each record corresponds to a person object with fields as returned by the API, including metadata such as names, roles, dates, and associated sources.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to a 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 uses HTTP GET requests to the TaxonWorks REST API endpoints.
  • The server URL must be correctly specified in the "Server" property.

Troubleshooting

  • Authentication errors: Ensure that valid API tokens are provided via credentials. Invalid or expired tokens will cause authorization failures.
  • Connection issues: Verify the server URL is reachable and correct. Network issues or incorrect URLs will cause request failures.
  • Invalid filter parameters: Using unsupported or incorrectly formatted filter values may result in empty responses or API errors.
  • Pagination: If expecting many results, ensure "Page" and "Per" parameters are set appropriately to paginate through all data.
  • Role filtering: Roles must be selected from the predefined list; misspelled or invalid roles will not filter correctly.

Links and References

If you need details on other resources or operations, feel free to ask!

Discussion