Ana içeriğe geç

postFormsData

Form verilerini kaydetme bilgilerini içeren bir nesne oluşturma.

Bu yöntem, oluşturulan bir FormDataEntity nesnesini döndürür. Dili değiştirmek istiyorsanız, sadece ikinci argüman olarak geçirin.

FormData.postFormsData( body, langCode );

Post isteği ile birlikte kullanılan yöntemler, gönderilen bilginin türüne karşılık gelen form verisi alanına sahip bir nesneyi istek gövdesi olarak kabul eder. Aşağıda farklı veri türleri için form veri nesnelerine örnekler verilmiştir.

Minimal örnek​

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

const value = await FormData.postFormsData(body)

Parametreler şeması​

Şema (body)

body(required): nesne
İstek gövdesi
örnek:

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

langCode: string
Dil kodu. Varsayılan: "en_US"
örnek: "en_US"

body.formIdentifier: string
Formun tanımlayıcısı
örnek: "contact-form"

body.formData: string
**
örnek:

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

body.formData.marker: string
Form niteliği işaretleyicisi
örnek: "name"

body.formData.type: string
Form niteliği türü
örnek: "string"

body.formData.value: string
Form niteliği değeri
örnek: "Jack"

"string", "number", "float" basit tür niteliği ile örnek​

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

"date", "dateTime", "time" basit tür niteliği ile örnek​

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

"text" basit tür niteliği ile örnek​

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

"textWithHeader" basit tür niteliği ile örnek​

{
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Başlık",
    "htmlValue": "<p>Hello World</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

"image" veya "groupOfImages" basit tür niteliği ile örnek​

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

"files" basit tür niteliği ile örnek​

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

"radioButton" veya "list" basit tür niteliği ile örnek​

{
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "kırmızı",
      "value": "1",
      "extended": {
        "value": "red",
        "type": "string"
      }
    }
  ]
}

"entity" niteliği türü ile örnek (iç içe liste)​

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

Değer - sayfa için sayısal tanımlayıcılar ve ürünler için string tanımlayıcılar. Ürün tanımlayıcıları 'p-' ön ekini içermelidir, örneğin, 'p-1-', 'p-2-', vb. p-[parentId]-[productId]

"timeInterval" niteliği türü ile örnek​

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

değer — ISO 8601 formatında aralık dizileri. örneğin 2025-02-11T16:00:00:000Z

2025 — yıl; 02 — ay; 11 — ayın günü; T — tarih ve saat arasındaki ayırıcı; 16:00:00 — saat:dakika:saniye formatında zaman; 000Z — milisaniye ve zaman dilimi belirtimi. Z, zamanın UTC formatında belirtildiğini gösterir.

Örnek dönüş:​

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

Yanıt şeması​

Şema: IFormDataEntity

formIdentifier: string
Sayfanın tanımlayıcısı.
örnek: "contact_form"

time: Date | string
Formun tanımlayıcısı.
örnek:

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

formData: FormDataType[]
Form verisi.
örnek:

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

id: number
Form sayfasının benzersiz tanımlayıcısı.
örnek: 12345

actionMessage: string | null
Form verisi için eylem mesajı.
örnek: "Form başarıyla gönderildi"

attributeSetIdentifier: string | null
Kullanılan nitelik setinin metin tanımlayıcısı (işaretleyici).
örnek: "product_attributes"