> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codenullapp.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Submit Datasource (Graphql)
> A submit datasource allows a Form component to save the data.
A submit datasource allows a Form component to save the data.
You can perform two types of actions
* Create
* Update
## Automatic generation
This feature is helpful if you don't want to start from scratch to configure your submit datasource
**Entities**: Choose the entity you want to save/update
**Fields**: Choose the fields you want to save in the submit datasource
**Query type**: choose ***create*** or ***update***
Then click on the **Generate** button. This will generate the basic submit datasource configuration for you
## Configure a submit datasource manually
There are two main configurations needed to configure a submit action
* Query
* Variables
### Query
Here, you should define the GraphQL mutation you want to execute during the submit action
```graphql theme={null}
mutation createPersona($data: PersonaInput) {
createPersona(data: $data) {
Id
Foto
Identificacion
NombreCompleto
Edad
Sexo
Telefono
Email
}
}
```
### Datasource variables
**Generate Variables Using Context Value**: If true, the datasource will take all values in the form context and submit them
**Variables List**: Here, you can add all data values you want to send in the request. You can combine this option with the Generate variables using context value.
### **Other settings**
**Refetch Queries:** Allows to execute a query, which is helpful, for instance, when you want to refresh the datasource of the form and get the data from the server after the submit is completed
**Data Path**: This is useful when you want to use the Generate Variables Using Context Value
**On Completed Configurations:** This will determine the behaviour after the submit action is completed
## Mutation examples
### Submit a single entity
```graphql theme={null}
mutation createPersona($data: PersonaInput) {
createPersona(data: $data) {
Id
Foto
Identificacion
NombreCompleto
Edad
Sexo
Telefono
Email
}
}
```
### Submit an entity with child entities (Array)
Codenull allows the creation of multiple entities in the same request. You need to make sure to send all data in the same way as the tables are related to each other.
In the next example, a Seguimiento has multiple Etapas
```graphql theme={null}
# This mutation will create a Seguimiento but also the Etapas child´s entity
mutation createSeguimiento($data: SeguimientoInput) {
createSeguimiento(data: $data) {
Id
Nombre
IglesiaId
Etapas {
Id
SeguimientoId
Nombre
Descripcion
}
}
}
```
The list of variables should have the Etapas field
The variable data.Etapas should have the array of Etapas that will be created among the Seguimiento
This is how the **request data** should look
The next is a full example of a subimt with a parent and child entities:
```javascript theme={null}
// Query
mutation createUsuario($data: UsuarioInput) {
createUsuario(data: $data){
Id
Nombre
Apellidos
Correo
IglesiaId
PersonaId
RolesxUsuarios{
Id
UsuarioId
RoleId
}
}
}
// Variables
[
{
"type": "nested",
"name": "data",
"variables": [
{
"type": "context",
"name": "Nombre",
"value": "Nombre"
},
{
"type": "context",
"name": "Apellidos",
"value": "Apellidos"
},
{
"type": "context",
"name": "Identificacion",
"value": "Identificacion"
},
{
"type": "session",
"name": "IglesiaId",
"value": "user.IglesiaId"
},
{
"type": "context",
"name": "PersonaId",
"value": "PersonaId"
},
{
"type": "context",
"name": "Correo",
"value": "Correo"
},
{
"type": "context",
"name": "Clave",
"value": "Clave"
},
{
"type": "context",
"name": "RolesxUsuarios",
"value": "RolesxUsuarios"
}
]
}
],
}
```
### Submit an entity with a parent entity
**Query**
```graphql theme={null}
mutation createUser($data: UsuarioInput) {
signUp(data: $data) {
Id
IglesiaId
Correo
Iglesia {
Id
Nombre
Telefono
Direccion
Pais
Personas{
Id
IglesiaId
Identificacion
NombreCompleto
Clasificacion
Perfil
FechaNacimiento
Edad
Email
}
}
RolesxUsuarios {
Id
RoleId
}
}
}
```
**Variables List**
