Saltar al contenido principal

postFormsData

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

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

FormData.postFormsData( body, langCode );

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.

Ejemplo mínimo​

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

const value = await FormData.postFormsData(body)

Esquema de parámetros​

Esquema (cuerpo)

body(required): object
Cuerpo de la solicitud
ejemplo:

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

langCode: string
Código de idioma. Por defecto: "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"

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

{
  "marker": "last_name",
  "type": "string",
  "value": "Username"
}

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

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

Ejemplo con un atributo de tipo simple "text"​

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

Ejemplo con un atributo de tipo simple "textWithHeader"​

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

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

{
  "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
      }
    }
  ]
}

Ejemplo con un atributo de tipo simple "files"​

{
  "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
    }
  ]
}

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

{
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "rojo",
      "value": "1",
      "extended": {
        "value": "red",
        "type": "string"
      }
    }
  ]
}

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

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

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"​

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

valor — array de arrays 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: IFormDataEntity

formIdentifier: string
El identificador de la página.
ejemplo: "contact_form"

time: Date | string
El identificador del formulario.
ejemplo:

"2023-10-01T12:00:00Z"

formData: FormDataType[]
Datos del formulario.
ejemplo:

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

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

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

attributeSetIdentifier: string | null
Identificador de texto (marcador) del conjunto de atributos utilizado.
ejemplo: "product_attributes"