getFormsDataByMarker

Buscando datos de formularios por identificador de texto (marcador).

Descripción

Este método recupera un objeto de datos de formulario específico por su marcador desde la API. Acepta un parámetro de marcador como el marcador de los datos del formulario. Devuelve una Promesa que se resuelve en un array de objetos del tipo FormDataEntity.

FormData.getFormsDataByMarker(

marker*, formModuleConfigId*, body, isExtended, langCode, offset, limit

);

Esquema de parámetros

Esquema

marker(requerido): string
Marcador del formulario
ejemplo: "contact_form"

formModuleConfigId(requerido): number
ID de configuración del módulo de formulario
ejemplo: 4

body: object
Cuerpo de la solicitud
ejemplo:

{
  "entityIdentifier": 14,
  "entityparentIdentifier": 167,
  "userIdentifier": "",
  "status": [
    "new",
    "approved"
  ],
  "dateFrom": "2025-01-01",
  "dateTo": ""
}

isExtended: number
Indicador para obtener campos adicionales
ejemplo: 1

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

offset: number
Parámetro para paginación. Predeterminado: 0
ejemplo: 0

limit: number
Parámetro para paginación. Predeterminado: 30
ejemplo: 30

Por defecto, puedes recuperar 10 objetos. Esto se debe al límite de registros en la configuración de permisos del módulo.
Para que la paginación funcione correctamente, necesitas configurar Permisos del módulo de acuerdo a tus necesidades en la sección correspondiente.

Ejemplos

Ejemplo mínimo

const response = await FormData.getFormsDataByMarker('my-marker');

Ejemplo con atributos

const response = await FormData.getFormsDataByMarker('my-marker', 'en_US', 0, 30);

Ejemplo de respuesta

{
  "items": [
    {
      "id": 3464,
      "formIdentifier": "test-form",
      "time": "2026-01-07T04:10:50.809Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 3447,
      "formIdentifier": "test-form",
      "time": "2026-01-07T02:09:20.987Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 3430,
      "formIdentifier": "test-form",
      "time": "2026-01-07T00:05:59.818Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    "..."
  ],
  "total": 518
}

Esquema de respuesta

Esquema: IFormsDataEntity

items: IFormByMarkerDataEntity[]
Array de objetos de datos de formulario.
ejemplo:

[
  {
    "id": 42,
    "parentId": null,
    "formIdentifier": "test-form",
    "depth": 0,
    "ip": null,
    "status": null,
    "userIdentifier": null,
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "attributeSetIdentifier": "form",
    "time": "2025-03-03T15:51:17.458Z",
    "entityIdentifier": "blog",
    "isUserAdmin": false,
    "formModuleConfigId": 2
  }
]

total: number
Número total de registros encontrados.
ejemplo: 100

---