Jiandaoyun icon

Jiandaoyun

Consume Jiandaoyun API

Overview

This node integrates with the Jiandaoyun API to manage data records within Jiandaoyun apps. Specifically, the Create a Data Record operation allows users to add new data entries to a specified app and entry (form) in Jiandaoyun.

Common scenarios for this node include:

  • Automating form submissions by programmatically creating new records.
  • Integrating external data sources or workflows that generate data needing to be stored in Jiandaoyun.
  • Triggering downstream workflows or automations upon data creation in Jiandaoyun.

For example, you might use this node to create a new customer record in a Jiandaoyun app whenever a new lead is captured from a web form or CRM system.

Properties

Name Meaning
App ID The identifier of the Jiandaoyun app where the data record will be created. This is required.
Entry ID The identifier of the specific entry (form) within the app where the data record belongs. This is required.
Using JSON Boolean flag indicating whether the data record is provided as raw JSON. Currently, only true (using JSON) is supported.
Data Record (JSON) The actual data record content in JSON format. It should follow Jiandaoyun's API specification for creating data records. Example: { "_widget_xxxx": { "value": 42 } }.
Additional Fields Optional collection of extra parameters:
Data Creator: Member number of the user submitting the data.
Is Start Workflow: Whether to initiate workflows (only works in workflow forms).
Is Start Trigger: Whether to trigger automations.
Transaction ID: Used to bind uploaded files; must match the transaction ID used when obtaining upload credentials if attachments/images are included.

Output

The output is a JSON object representing the response from the Jiandaoyun API after creating the data record. This typically includes details about the newly created record such as its ID and any metadata returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Jiandaoyun API credential configured in n8n, which provides the necessary authentication token and server URL.
  • Relies on the Jiandaoyun REST API endpoints for data record creation.
  • The node expects valid JSON input for the data record content according to Jiandaoyun's API schema.

Troubleshooting

  • Invalid JSON Format: If the "Data Record (JSON)" property contains malformed JSON, the node will throw an error. Ensure the JSON is well-formed and matches Jiandaoyun's expected structure.
  • Missing Required Fields: Omitting required properties like App ID or Entry ID will cause errors. Always provide these mandatory fields.
  • Unsupported Options: The node currently supports only JSON input for data records (Using JSON must be true). Attempting other input methods will result in an error.
  • Transaction ID Mismatch: When uploading files along with data, the transaction ID must match the one used during file upload credential acquisition. Otherwise, file attachments may not link correctly.
  • API Errors: Any errors returned by the Jiandaoyun API (e.g., permission issues, invalid IDs) will be surfaced by the node. Check the error message for guidance.

Links and References

Discussion