Jiandaoyun

Consume Jiandaoyun API

Actions16

App Actions
- Get Apps
- Get Entries
Data Actions
Entry Actions
- Get Fields
File Actions
- Get Upload Token
- Upload File
Workflow Actions

Overview

This node interacts with the Jiandaoyun API to manage workflow-related data and tasks. Specifically, for the Workflow resource and the Get Workflow Tasks operation, it retrieves the current workflow tasks assigned to a specified user. This is useful in scenarios where you want to automate or monitor task progress within Jiandaoyun workflows, such as fetching pending approvals or tasks that require user action.

Practical examples include:

Automatically retrieving all pending tasks for a user to display in a dashboard.
Triggering follow-up actions based on the status of workflow tasks.
Integrating Jiandaoyun workflow tasks into other automation processes.

Properties

Name	Meaning
User Name	The user identifier (User No.) in Contacts whose current workflow tasks are to be fetched.
Return Count	The number of task records to retrieve in a single request (maximum 100).
Skip Count	The number of task records to skip before starting to return results (for pagination).

Output

The node outputs a JSON array containing the list of workflow tasks for the specified user. Each item in the array represents a task object returned by the Jiandaoyun API, including details such as task ID, instance ID, status, and other metadata related to the workflow task.

No binary data output is involved in this operation.

Dependencies

Requires an API key credential for authenticating with the Jiandaoyun API.
Needs the base URL of the Jiandaoyun server, which is obtained from the configured credentials.
Uses HTTP POST requests to interact with the Jiandaoyun API endpoints.

Troubleshooting

Common issues:
- Incorrect or missing user identifier (username) will result in no tasks being returned or an error.
- Exceeding the maximum Return Count (over 100) may cause the API to reject the request.
- Network or authentication errors if the API key credential is invalid or expired.
Error messages:
- "Not implemented yet": Indicates that the selected operation or resource combination is not supported by the node.
- Errors related to JSON parsing or invalid input parameters usually mean the input format is incorrect.
Resolutions:
- Verify that the username corresponds exactly to the User No. in Jiandaoyun Contacts.
- Ensure returnCount is between 1 and 100.
- Confirm that the API key credential is correctly set up and has necessary permissions.
- Check network connectivity and Jiandaoyun service availability.