postFormsData

Form verisi bilgilerini kaydetmek için bir nesne oluşturma

FormData.postFormsData(data, langCode)

POST isteği kullanan yöntemler, gönderilen bilgi türüne karşılık gelen form veri alanlarını içeren bir nesneyi istek gövdesinde kabul eder. Aşağıda farklı veri türleri için form veri nesnelerine örnekler bulunmaktadır.

const value = await FormData.postFormsData(data, langCode);

---

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

{
  "marker": "last_name",
  "type": "string",
  "value": "Kullanıcı Adı"
}

---

"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": "GG-AA-YYYY SS:mm"
  }
}

---

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

{
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Merhaba dünya</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>Merhaba Dünya</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": "kırmızı",
        "type": "string"
      }
    }
  ]
}

---

"entity" (iç içe liste) niteliği ile örnek

{
  "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 metin 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 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

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

const value = await FormData.postFormsData(body)

Şema (gövde)

formIdentifier: string
Form nesnesinin metin tanımlayıcısı (marker)
örnek: my-form

formData: FormDataLangType
Form tarafından gönderilen veriler
örnek:

[
  {
    "marker": "name_field",
    "type": "string",
    "value": "İsim"
  }
]

fileQuery: object
Form ile dosya yüklemek için fileQuery
örnek:

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

Bu yöntem, oluşturulan bir FormDataEntity nesnesi döndürür. Dili değiştirmek isterseniz, ikinci argüman olarak geçirin.

Örnek dönüş:

{
  "id": 1764,
  "formIdentifier": "my-form",
  "time": "2025-05-09T18:32:46.834Z",
  "formData": {
    "marker": "name_1",
    "value": "İsim",
    "type": "string"
  }
}

Şema

id: number
nesne tanımlayıcısı
örnek: 1764

formIdentifier: string
Form nesnesinin metin tanımlayıcısı (marker)
örnek: my-form

time: Date
Formun değiştirilme tarihi ve saati
örnek: 2025-05-09T18:32:46.834Z

formData: FormDataLangType
Form tarafından gönderilen veriler
örnek:

[
  {
    "marker": "marker_1",
    "value": "İsim"
  }
]