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 integrates with the Jiandaoyun API to manage data records within Jiandaoyun apps. Specifically, the Create Many Data Records operation allows users to batch-create multiple data records in a specified app and entry (form). This is useful when you need to insert large sets of structured data into Jiandaoyun forms efficiently.

Common scenarios include:

Importing bulk data from external sources into Jiandaoyun forms.
Automating the creation of multiple related records in workflows.
Synchronizing datasets between Jiandaoyun and other systems.

For example, if you have a list of customer orders stored externally, you can use this operation to create all those order records at once inside a Jiandaoyun form.

Properties

Name	Meaning
App ID	The identifier of the Jiandaoyun app where the data records will be created.
Entry ID	The identifier of the specific entry (form) within the app where the data records belong.
Data Record List (JSON)	A JSON array representing the list of data records to create. Each record is an object mapping widget keys to their values. Must be a valid JSON array.
Additional Fields	Optional extra parameters: • Data Creator: Member number who submits the data. • Is Start Workflow: Boolean flag to indicate whether to initiate workflows after creation (only for workflow forms). • Transaction ID: Used to bind uploaded files; must match the transaction ID used in file upload APIs if attachments are included.

Output

The output json field contains the response from the Jiandaoyun API after creating the batch of data records. Typically, this includes details about the created records such as their IDs and status.

No binary data output is produced by this operation.

Dependencies

Requires an active Jiandaoyun API credential configured in n8n with appropriate permissions.
The node communicates with the Jiandaoyun server endpoint specified in the credentials.
If data records include attachments or images, the transactionId must correspond to the one used during file upload operations to correctly associate files.

Troubleshooting

Error: "dataRecordJson must be an array"
Occurs if the provided JSON for data records is not an array. Ensure that the "Data Record List (JSON)" property contains a valid JSON array of objects.
Invalid App ID or Entry ID
If the app or entry identifiers are incorrect or missing, the API will fail. Verify these IDs are correct and exist in your Jiandaoyun account.
Missing or invalid API credentials
Authentication errors may occur if the API key or token is not set up properly in n8n credentials.
Transaction ID mismatch
When uploading files along with data records, ensure the transactionId matches the one used during file upload to avoid attachment binding issues.
Workflow initiation flags ignored
The Is Start Workflow option only works if the target form supports workflows.