Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node integrates with the Jiandaoyun API to manage workflow-related tasks within the Jiandaoyun platform. Specifically, for the Workflow resource and the Submit Workflow Task operation, it allows users to submit or approve a workflow task by providing necessary identifiers and optional comments.

Typical use cases include automating approval processes, submitting user responses to workflow tasks, or progressing workflows programmatically based on external triggers. For example, after a form submission or an event in another system, this node can be used to approve a pending task in a Jiandaoyun workflow, optionally adding an approval comment.

Properties

Name Meaning
App ID The identifier of the application (app) in Jiandaoyun where the workflow resides.
Entry ID The identifier of the entry (form or data structure) related to the workflow.
User Name The user number (User No.) from Contacts who is submitting or approving the workflow task.
Instance ID The instance ID of the workflow task; corresponds to the data_id of the workflow instance.
Task ID The specific task ID within the workflow that should be submitted or approved.
Comment Optional approval comment to accompany the submission of the workflow task.

Output

The node outputs JSON data representing the response from the Jiandaoyun API after submitting the workflow task. This typically includes confirmation of the task submission status and any relevant metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Jiandaoyun API via an API key credential configured in n8n.
  • The node uses the Jiandaoyun server URL obtained from the credentials.
  • Proper permissions and valid identifiers (App ID, Entry ID, Instance ID, Task ID, User Name) are required to successfully submit a workflow task.

Troubleshooting

  • Common Issues:

    • Missing or incorrect identifiers (App ID, Entry ID, Instance ID, Task ID, User Name) will cause the API call to fail.
    • Invalid or expired API credentials will prevent authentication.
    • Providing an empty or malformed comment is allowed but ensure it is a string if used.
  • Error Messages:

    • Errors thrown by the node typically indicate missing parameters or unsupported operations.
    • If the error message states "Not implemented yet," it means the selected operation or resource combination is not supported by this node version.
    • JSON parsing errors may occur if input fields expecting JSON are incorrectly formatted.
  • Resolution Tips:

    • Double-check all required fields are filled correctly.
    • Verify API credentials and permissions.
    • Use valid JSON syntax for any JSON inputs.
    • Consult Jiandaoyun API documentation for correct parameter usage.

Links and References

Discussion