Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node integrates with the Jiandaoyun API to manage data records within Jiandaoyun apps. Specifically, the "Update a Data Record" operation allows users to update an existing data record in a specified app and entry by providing the data record ID and new data content.

Common scenarios for this node include:

  • Automating updates to form data stored in Jiandaoyun after processing or validation.
  • Synchronizing external system data changes back into Jiandaoyun forms.
  • Triggering workflows or automations based on updated data records.

For example, you might use this node to update a customer record's status field after a payment is confirmed, or to modify inventory quantities in a Jiandaoyun app when stock levels change.

Properties

Name Meaning
App ID The unique identifier of the Jiandaoyun app where the data record exists.
Entry ID The identifier of the specific entry (form) within the app that contains the data record.
Data ID The unique identifier of the data record to be updated.
Using JSON Boolean flag indicating whether the data record is provided in JSON format. Currently, only JSON input is supported.
Data Record (JSON) The actual data to update the record with, expressed as a JSON object. This should follow Jiandaoyun's data record structure, typically mapping widget keys to their values.
Additional Fields Optional extra parameters:
Is Start Trigger: Whether to trigger Jiandaoyun Automations upon updating the record.
Transaction ID: A string used to bind uploaded files in batch operations; must match upload credentials if attachments are included.

Output

The node outputs the response from the Jiandaoyun API after attempting to update the data record. The output is a JSON object representing the updated record or the API's confirmation message.

If the operation fails, the output will contain an error message describing the issue.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Jiandaoyun API credential configured in n8n to authenticate requests.
  • The node communicates with the Jiandaoyun server endpoint specified in the credential.
  • The user must provide valid App ID, Entry ID, and Data ID corresponding to existing resources in Jiandaoyun.

Troubleshooting

  • Error: "dataRecordJson must be an array" — This error occurs if the JSON provided for multiple records is not an array. For single record updates, ensure the JSON is an object, not an array.
  • Invalid or missing IDs — Ensure that App ID, Entry ID, and Data ID are correctly specified and correspond to existing entities in Jiandaoyun.
  • Using JSON flag set to false — Currently, only JSON input is supported. Setting this flag to false will cause an error.
  • API authentication errors — Verify that the Jiandaoyun API credentials are correctly configured and have sufficient permissions.
  • Trigger Automations not working — If "Is Start Trigger" is enabled but automations do not run, check Jiandaoyun automation settings and transaction ID consistency if attachments are involved.

Links and References

Discussion