Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node interacts with the Tallyfy workflow automation platform, specifically focusing on managing process instances and their tasks. The "Get Tasks" operation under the "Process" resource retrieves all tasks associated with a specified process instance.

Typical use cases include:

  • Fetching all tasks within a particular workflow run to monitor progress.
  • Integrating task data from Tallyfy into other systems for reporting or automation.
  • Triggering subsequent actions based on the status or details of tasks in a process.

For example, you might use this node to get all tasks of a process to check which tasks are still pending or to gather task details for a dashboard.

Properties

Name Meaning
Process ID The unique identifier of the process instance whose tasks you want to retrieve. This is required.

Output

The output is an array of JSON objects, each representing a task within the specified process. Each task object contains detailed information as returned by the Tallyfy API, such as task ID, title, status, assignees, deadlines, and other metadata related to the task.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "json": {
      "id": "task_id_123",
      "title": "Review Document",
      "status": "active",
      "assignees": [...],
      "deadline": "2024-07-01T12:00:00Z",
      ...
    }
  },
  {
    "json": {
      "id": "task_id_456",
      "title": "Approve Budget",
      "status": "completed",
      ...
    }
  }
]

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • The node uses the base URL https://go.tallyfy.com/api by default unless overridden in credentials.
  • Requires the organization ID configured in the credentials to scope API requests properly.

Troubleshooting

  • Common issues:

    • Invalid or missing Process ID will cause the API request to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Network connectivity issues can prevent successful API calls.

  • Error messages:

    • Authentication errors typically indicate invalid API keys or insufficient permissions; verify and update credentials.
    • "Not Found" errors may mean the provided Process ID does not exist or is inaccessible; double-check the ID.
    • Rate limiting or server errors from Tallyfy should be retried after some delay.

  • To resolve errors, ensure that:

    • The Process ID is correct and belongs to the authenticated organization.
    • API credentials are valid and have necessary permissions.
    • Network access to the Tallyfy API endpoint is available.

Links and References

Discussion