Saltar al contenido principal

postFormsData

Creando un objeto de datos de formulario que guarda información.

Descripción​

Este método devuelve un objeto FormDataEntity creado. Si deseas cambiar el idioma, simplemente pásalo como segundo argumento.

Los métodos con una solicitud POST aceptan como cuerpo de la solicitud un objeto con el campo de datos del formulario, que corresponde al tipo de información que se está enviando. A continuación se presentan ejemplos de objetos de datos de formulario para diferentes tipos de datos.

FormData.postFormsData(

body, body.formIdentifier, body.formModuleConfigId, body.moduleEntityIdentifier, body.replayTo, body.status, body.formData, body.fileQuery, langCode

);

Esquema de parámetros​

Esquema (cuerpo)

body(requerido): IBodyPostFormData
Cuerpo de la solicitud
ejemplo:

  {
    "formIdentifier": "test-form",
    "formModuleConfigId": 2,
    "moduleEntityIdentifier": "blog",
    "replayTo": null,
    "status": "sent",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ]
  }

body.formIdentifier(requerido): string
Identificador de texto (marcador) del formulario.
ejemplo: "form"

body.formModuleConfigId(requerido): number
El identificador único de la configuración del módulo del formulario.
ejemplo: 2

body.moduleEntityIdentifier(requerido): string
Identificador de texto (marcador) de la entidad del módulo.
ejemplo: "blog"

body.replayTo(requerido): string | null
Correo electrónico para responder.
ejemplo: "some@email.com"

body.status(requerido): string
Estado del formulario.
ejemplo: "sent"

body.formData(requerido): FormDataType[]
Array de objetos de datos del formulario.
ejemplo:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Jack"
  }
]

body.fileQuery: IUploadingQuery
Consulta de archivo opcional para subir archivos.
ejemplo:

{
  "type": "page",
  "entity": "editor",
  "id": 3787
}

langCode: string
Código de idioma. Predeterminado: "en_US"
ejemplo: "en_US"

body.formIdentifier: string
El identificador del formulario
ejemplo: "contact-form"

body.formData: string
**
ejemplo:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Jack"
  }
]

body.formData.marker: string
Marcador de atributo del formulario
ejemplo: "name"

body.formData.type: string
Tipo de atributo del formulario
ejemplo: "string"

body.formData.value: string
Valor del atributo del formulario
ejemplo: "Jack"

Ejemplos​

Ejemplo mínimo​

const body = {
"formIdentifier": "contact_us",
"formData": [
{
"marker": "last_name",
"type": "string"
"value": "Andrey"
}
]
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "string", "number", "float"​

const body = {
  "marker": "last_name",
  "type": "string",
  "value": "Username"
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "date", "dateTime", "time"​

const body = {
  "marker": "birthday",
  "type": "date",
  "value": {
    "fullDate": "2024-05-07T21:02:00.000Z",
    "formattedValue": "08-05-2024 00:02",
    "formatString": "DD-MM-YYYY HH:mm"
  }
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "text"​

const body = {
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Hola mundo</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "textWithHeader"​

const body = {
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Título",
    "htmlValue": "<p>Hola Mundo</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "image" o "groupOfImages"​

const body = {
  "marker": "avatar",
  "type": "image",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585,
      "previewLink": "",
      "params": {
        "isImageCompressed": true
      }
    }
  ]
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "files"​

const body = {
  "marker": "picture",
  "type": "file",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585
    }
  ]
};

const response = await FormData.postFormsData(body);

Ejemplo con un atributo de tipo simple "radioButton" o "list"​

const body = {
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "rojo",
      "value": "1",
      "extended": {
        "value": "rojo",
        "type": "string"
      }
    }
  ]
};

const response = await FormData.postFormsData(body);

Ejemplo con atributo de tipo "entity" (lista anidada)​

const body = {
  "formIdentifier": "entity_form",
  "formData": {
    "en_US": [
      {
        "marker": "entity-marker",
        "type": "entity",
        "value": [25, 32, 24]
      }
    ]
  }
};

const response = await FormData.postFormsData(body);

Valor - identificadores numéricos para páginas e identificadores de cadena para productos. Los identificadores de productos deben incluir el prefijo 'p-', por ejemplo, 'p-1-', 'p-2-', etc. p-[parentId]-[productId]

Ejemplo con atributo de tipo "timeInterval"​

const body = {
  "formIdentifier": "reg",
  "formData": {
    "en_US": [
      {
        "marker": "interval",
        "type": "timeInterval",
        "value": [
          [
            "2025-02-11T16:00:00:000Z",
            "2025-02-13T16:00:00:000Z",
          ]
        ]
      }
    ]
  }
};

const response = await FormData.postFormsData(body);

valor — array de intervalos en formato ISO 8601. por ejemplo 2025-02-11T16:00:00:000Z

2025 — año; 02 — mes; 11 — día del mes; T — separador entre fecha y hora; 16:00:00 — hora en formato horas:minutos:segundos; 000Z — milisegundos e indicación de zona horaria. Z significa que la hora está especificada en formato UTC.

Ejemplo de retorno:​

{
  "formData": {
    "formIdentifier": "test-form",
    "time": "2025-07-21T09:40:06.587Z",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "id": 286
  },
  "actionMessage": ""
}

Esquema de respuesta​

Esquema: IPostFormResponse

actionMessage: string | null
Mensaje de acción para los datos del formulario.
ejemplo: "Formulario enviado con éxito"

formData: object
Datos del formulario.
ejemplo:


formData.id: number
El identificador único de la página del formulario.
ejemplo: 12345

formData.formIdentifier: string
El identificador del formulario.
ejemplo: "contact_form"

time: Date | string
La hora de la presentación del formulario.
ejemplo: "2023-10-01T12:00:00Z"

entityIdentifier: string | null
El identificador de la entidad.
ejemplo: "blog"

isUserAdmin: boolean
¿Es el usuario administrador?
ejemplo: false

formModuleId: number
El identificador del módulo del formulario.
ejemplo: 2

parentId: any
El identificador del padre.
ejemplo: null

userIdentifier: number
El identificador del usuario.
ejemplo: null

formData.formData: FormDataType[]
Datos de los campos del formulario.
ejemplo:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Test"
  }
]