Data Management Skill

fx-api-cli
is the provided command line program, all operations are completed by executing the
fx-api-cli
command.

Interact with the data management system via

fx-api-cli data <interface name> '<json input parameters>'

API List

app.entry.data.get — Single Data Query Interface

bash

fx-api-cli data get '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_id": "59e9a2fe283ffa7c11b1ddbf"}'

With the single data query interface, you can query the specified data in the form. You need to specify the application ID, form ID and data ID.

app.entry.data.list — Multiple Data Query Interface

bash

fx-api-cli data list '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "limit": 100, "fields": ["_widget_1508400000001", "_widget_1508400000002"]}'

With the multiple data query interface, you can query multiple pieces of data in the form at one time. It supports pagination, field filtering and conditional filtering.

app.entry.data.create — Single Data Creation Interface

bash

fx-api-cli data create '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data": {"_widget_1432728651402": {"value": "Saas"}, "_widget_1432728651403": {"value": 100}}}'

With the single data creation interface, you can add a single piece of data to the specified form. You need to specify the application ID, form ID and data content.

app.entry.data.batch_create — Multiple Data Batch Creation Interface

bash

fx-api-cli data batch_create '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_list": [{"_widget_1432728651402": {"value": "Saas 1"}, "_widget_1432728651403": {"value": 100}}, {"_widget_1432728651402": {"value": "Saas 2"}, "_widget_1432728651403": {"value": 200}}]}'

With the multiple data batch creation interface, you can add multiple pieces of data to the specified form. You need to specify the application ID, form ID and data list.

app.entry.data.update — Single Data Update Interface

bash

fx-api-cli data update '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_id": "59e9a2fe283ffa7c11b1ddbf", "data": {"_widget_1432728651402": {"value": "Updated Saas"}, "_widget_1432728651403": {"value": 200}}}'

With the single data update interface, you can update the specified data in the form. You need to specify the application ID, form ID, data ID and the updated data content.

app.entry.data.batch_update — Batch Data Update Interface

bash

fx-api-cli data batch_update '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_list": [{"data_id": "59e9a2fe283ffa7c11b1ddbf", "data": {"_widget_1432728651402": {"value": "Updated Saas 1"}}}, {"data_id": "59e9a2fe283ffa7c11b1ddbe", "data": {"_widget_1432728651402": {"value": "Updated Saas 2"}}}]}'

With the batch data update interface, you can update multiple pieces of data in the form in batches. You need to specify the application ID, form ID and data list.

app.entry.data.delete — Single Data Deletion Interface

bash

fx-api-cli data delete '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_id": "59e9a2fe283ffa7c11b1ddbf"}'

With the single data deletion interface, you can delete the specified data in the form. You need to specify the application ID, form ID and data ID.

app.entry.data.batch_delete — Batch Data Deletion Interface

bash

fx-api-cli data batch_delete '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_id_list": ["59e9a2fe283ffa7c11b1ddbf", "59e9a2fe283ffa7c11b1ddbe"]}'

With the batch data deletion interface, you can delete multiple pieces of data in the form in batches. You need to specify the application ID, form ID and data ID list.

app.entry.data.batch_hard_delete — Batch Hard Data Deletion Interface

bash

fx-api-cli data batch_hard_delete '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd", "data_id_list": ["59e9a2fe283ffa7c11b1ddbf", "59e9a2fe283ffa7c11b1ddbe"]}'

With the batch hard data deletion interface, you can hard delete multiple pieces of data in the form in batches. You need to specify the application ID, form ID and data ID list.

Core Rules

Data ID Lookup Rules

When the user needs to operate data but does not provide the data ID:
1. Call
```
app.entry.data.list
```
  to get the data list (you need to confirm the application ID and form ID first)
2. Filter data according to the conditions provided by the user (such as keywords, time range, etc.)
3. Matching strategy:
  - Exact match with unique result: use directly
  - Fuzzy match with multiple results: display the candidate list for the user to choose
  - No matching result: inform the user that no data is found

Data Creation Rules

Required fields: Ensure all required fields have values according to the form configuration
Data format: Ensure the data format meets the requirements of the field type
Workflow trigger: If you need to trigger a workflow, set
```
is_start_workflow: true
```

Data Update Rules

Partial update: Only need to provide the fields that need to be updated
Data format: Ensure the updated data format meets the requirements of the field type

Data Deletion Rules

Soft delete: Soft delete is used by default, and the data can still be recovered in the recycle bin
Hard delete: Use the batch hard delete interface, the data will be permanently deleted and cannot be recovered
Deletion confirmation: You must confirm with the user before performing the deletion operation

Typical Workflows

Query Single Data

Example user query:

"Help me query the specified data"
"View the details of this data"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Confirm the
```
data_id
```
of the target data through Data ID Lookup Rules
Call
```
app.entry.data.get
```
to get the data details
Display all field values of the data

Query Multiple Data

Example user query:

"Help me query all data of the form"
"View the latest 10 pieces of data"
"Query data that meets the conditions"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Confirm query parameters (pagination, field filtering, conditional filtering)
Call
```
app.entry.data.list
```
to get the data list
Display the data list, including the key field values of each piece of data
If
```
has_more
```
is
```
true
```
, inform the user that there is more data available for further viewing

Create Single Data

Example user query:

"Help me add a piece of data to the form"
"Create new data"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Collect the data content provided by the user
Call
```
app.entry.data.create
```
to create the data
Display the creation result, including the ID of the new data

Batch Create Data

Example user query:

"Help me add multiple pieces of data in batches"
"Import data"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Collect the data list provided by the user
Call
```
app.entry.data.batch_create
```
to create data in batches
Display the creation result, including the number of successfully created data and the data ID list

Update Data

Example user query:

"Help me update this piece of data"
"Modify data content"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Confirm the
```
data_id
```
of the target data through Data ID Lookup Rules
Collect the updated content provided by the user
Call
```
app.entry.data.update
```
to update the data
Display the update result

Batch Update Data

Example user query:

"Help me update multiple pieces of data in batches"
"Modify data in batches"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Collect the data ID list and updated content provided by the user
Call
```
app.entry.data.batch_update
```
to update data in batches
Display the update result

Delete Data

Example user query:

"Help me delete this piece of data"
"Remove data"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Confirm the
```
data_id
```
of the target data through Data ID Lookup Rules
Confirm the deletion operation with the user
Call
```
app.entry.data.delete
```
to delete the data
Display the deletion result

Batch Delete Data

Example user query:

"Help me delete multiple pieces of data in batches"
"Remove data in batches"

Execution process:

Confirm the
```
app_id
```
of the target application through Application ID Lookup Rules
Confirm the
```
entry_id
```
of the target form through Form ID Lookup Rules
Collect the data ID list provided by the user
Confirm the deletion operation with the user
Call
```
app.entry.data.batch_delete
```
to delete data in batches
Display the deletion result

Error Handling

Data not found: Clearly inform the user that the corresponding data is not found
Field validation failed: Display specific field validation error information
API error: Display specific error information, retry if necessary
Network problem: Actively retry up to 3 times when HTTP error occurs

fxapi-data-management

NPX Install

Tags

SKILL.md Content (Chinese)

Data Management Skill

API List

app.entry.data.get — Single Data Query Interface

app.entry.data.list — Multiple Data Query Interface

app.entry.data.create — Single Data Creation Interface

app.entry.data.batch_create — Multiple Data Batch Creation Interface

app.entry.data.update — Single Data Update Interface

app.entry.data.batch_update — Batch Data Update Interface

app.entry.data.delete — Single Data Deletion Interface

app.entry.data.batch_delete — Batch Data Deletion Interface

app.entry.data.batch_hard_delete — Batch Hard Data Deletion Interface

Core Rules

Data ID Lookup Rules

Data Creation Rules

Data Update Rules

Data Deletion Rules

Typical Workflows

Query Single Data

Query Multiple Data

Create Single Data

Batch Create Data

Update Data

Batch Update Data

Delete Data

Batch Delete Data

Error Handling