TallyfyInstall

Overview

This node enables searching for processes within the Tallyfy workflow automation platform. Specifically, the "Search Processes" operation allows users to query and retrieve process instances based on a search string. This is useful when you want to find specific running or completed processes by keywords or identifiers.

Common scenarios include:

• Quickly locating a process instance by name or description.
• Filtering processes that match certain criteria without manually browsing the Tallyfy interface.
• Automating workflows that depend on retrieving process details dynamically.

For example, you could use this node to search for all processes related to a particular project or client by entering relevant keywords in the search query.

Properties

Output

The output is an array of JSON objects representing the search results for processes. Each item corresponds to a process instance matching the search query. The structure typically includes fields such as process ID, name, status, and other metadata returned by the Tallyfy API.

No binary data is output by this node.

Example output snippet (simplified):

[
  {
    "json": {
      "id": "process_123",
      "name": "Onboarding Process",
      "status": "active",
      ...
    }
  },
  {
    "json": {
      "id": "process_456",
      "name": "Project Launch",
      "status": "completed",
      ...
    }
  }
]

Dependencies

• Requires an API key credential for authenticating with the Tallyfy API.
• Needs the organization ID configured in the credentials.
• The node makes HTTP requests to the Tallyfy API endpoint (default: https://go.tallyfy.com/api).

Troubleshooting

• Empty results: Ensure the search query is correctly specified and matches existing processes.
• Authentication errors: Verify that the API key credential is valid and has access to the target organization.
• Rate limits or API errors: Check Tallyfy API usage limits and handle errors accordingly.
• Network issues: Confirm network connectivity to the Tallyfy API endpoint.

If the node throws errors related to missing parameters, double-check that the required "Search Query" property is provided.

Links and References

• Tallyfy API Documentation (for detailed API endpoints and parameters)
• Tallyfy Workflow Automation Platform