postFormsData

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

FormData.postFormsData(data, langCode)

Post isteği ile birlikte kullanılan yöntemler, gönderilen bilgi türüne karşılık gelen form veri alanı ile bir nesne alır. Aşağıda, farklı veri türleri için form veri nesnelerine örnekler verilmiştir.

---

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

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

---

Basit tür niteliği "date", "dateTime", "time" 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"
  }
}

---

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

{
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Merhaba dünya</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

Basit tür niteliği "textWithHeader" ile örnek

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

---

Basit tür niteliği "image" veya "groupOfImages" 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
      }
    }
  ]
}

---

Basit tür niteliği "files" 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
    }
  ]
}

---

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

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

---

"Nesne" türü niteliği 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 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]

---

Zaman aralığı türü 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 dizisi. ö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 veri
ö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 FormDataEntity nesnesini döndürür. Dili değiştirmek isterseniz, ikinci argümanla birlikte 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 veri
örnek:

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