You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 11
Next »
Form API can interact with form data of the specified form.
| Name | Description |
|---|
| 1 | Form |
Select any form present in the current app, for interaction with API.
|
| 2 | Short Description | |
| 3 | |
Add a new record to the specified form.
Name | Description |
|---|
| URL | /form/*yourFormId* | | HTTP Method | POST | | Body Parameters | The parameters required here is highly dependent on the form data schema of the specified form. For example, for "Expense Claim Form" in Expenses Claim app found in most default Joget installations, it may look like this:
{
"id": "string",
"sfD": {
"ref": "string",
"title": "string",
"remark": "string",
"SelectApprover": "string",
"claimant": "string",
"username": "string",
"status": "string",
"id": "string"
},
"spECD": [
{
"id": "string",
"category": "string",
"date": "string",
"purpose": "string",
"amount": "string"
}
],
"total": "string",
"receipt": "string",
"CreatedDate": "string",
"dateCreated": "2019-08-28",
"dateModified": "2019-08-28",
"createdBy": "string",
"createdByName": "string",
"modifiedBy": "string",
"modifiedByName": "string"
}
| | Sample Response | A uniquely generated form record ID will be returned as the success response.
{
"id": "d6cc05e4-c0a86310-60e35ca0-9dd035a0",
"errors": {}
}
|
|
| 4 | |
Delete a record of the specified form, via record ID.
Name | Description |
|---|
| URL | /form/*yourFormId*/{recordId} | | HTTP Method | DELETE | | Path Parameters | | Parameter | Description |
|---|
| recordId | Form record ID. |
| | Sample Response |
{
"date": "Wed Aug 28 14:07:37 SGT 2019",
"code": "200",
"message": "Successful operation"
}
|
|
| 5 | Get form data by record ID |
Retrieve data of a record from the specified form, via record ID.
Name | Description |
|---|
| URL | /form/*yourFormId*/{recordId} | | HTTP Method | GET | | Path Parameters | | Parameter | Description |
|---|
| recordId | Form record ID. |
| | Query String Parameters | | Parameter | Description |
|---|
| includeSubformData | Include all subform(s) data present in the specified form, into the response. | | includeReferenceElements | Include all referenced elements present in the specified form, into the response. (e.g: select box element referencing a datalist record) | | flattenData | Option to flatten all JSON objects to a single-level key-value map. |
| | Sample Response |
{
"createdByName": "Admin Admin",
"dateModified": "2019-08-15 15:43:35.0",
"remark": "",
"title": "Spend everything",
"SelectApprover": "admin",
"ref": "0001",
"total": "0.00",
"modifiedByName": "Admin Admin",
"dateCreated": "2019-04-25 20:14:28.0",
"createdBy": "admin",
"CreatedDate": "2019-08-15",
"modifiedBy": "admin",
"receipt": "",
"id": "44_expenseclaim_process1",
"claimant": "Admin Admin",
"status": "Submitted",
"username": "admin"
}
|
|
| 6 | |
Update a record of the specified form.
Name | Description |
|---|
| URL | /form/*yourFormId* | | HTTP Method | PUT | | Body Parameters | The parameters required here is highly dependent on the form data schema of the specified form. The record ID specified must be of an existing record of the form, to update its records successfully. | | Sample Response | The same form record ID as specified in the body parameters will be returned as the success response.
{
"id": "d6cc05e4-c0a86310-60e35ca0-9dd035a0",
"errors": {}
}
|
|