Ana içeriğe geç

postFormsData

Form verilerini kaydeden bir nesne oluşturma.

Açıklama​

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.

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

FormData.postFormsData(

body, body.formIdentifier, body.formModuleConfigId, body.moduleEntityIdentifier, body.replayTo, body.status, body.formData, body.fileQuery, langCode

);

Parametreler şeması​

Şema (body)

body(gerekli): IBodyPostFormData
İstek gövdesi
örnek:

  {
    "formIdentifier": "test-form",
    "formModuleConfigId": 2,
    "moduleEntityIdentifier": "blog",
    "replayTo": null,
    "status": "sent",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ]
  }

body.formIdentifier(gerekli): string
Formun metin tanımlayıcısı (işaretçi).
örnek: "form"

body.formModuleConfigId(gerekli): number
Form modülü yapılandırmasının benzersiz tanımlayıcısı.
örnek: 2

body.moduleEntityIdentifier(gerekli): string
Modül varlığının metin tanımlayıcısı (işaretçi).
örnek: "blog"

body.replayTo(gerekli): string | null
Yanıt verilecek e-posta.
örnek: "some@email.com"

body.status(gerekli): string
Formun durumu.
örnek: "sent"

body.formData(gerekli): FormDataType[]
Form veri nesneleri dizisi.
örnek:

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

body.fileQuery: IUploadingQuery
Dosya yüklemek için isteğe bağlı dosya sorgusu.
örnek:

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

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şaretçisi
örnek: "name"

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

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

Örnekler​

Minimal örnek​

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

const response = await FormData.postFormsData(body);

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

const body = {
  "marker": "last_name",
  "type": "string",
  "value": "Username"
};

const response = await FormData.postFormsData(body);

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

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

const response = await FormData.postFormsData(body);

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

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

const response = await FormData.postFormsData(body);

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

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

const response = await FormData.postFormsData(body);

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

const body = {
  "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
      }
    }
  ]
};

const response = await FormData.postFormsData(body);

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

const body = {
  "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
    }
  ]
};

const response = await FormData.postFormsData(body);

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

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

const response = await FormData.postFormsData(body);

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

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

const response = await FormData.postFormsData(body);

Değer - sayısal tanımlayıcılar sayfalar için 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" tür niteliği ile örnek​

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

const response = await FormData.postFormsData(body);

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 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: IPostFormResponse

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

formData: object
Form verileri.
örnek:


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

formData.formIdentifier: string
Formun tanımlayıcısı.
örnek: "contact_form"

time: Date | string
Formun gönderilme zamanı.
örnek: "2023-10-01T12:00:00Z"

entityIdentifier: string | null
Varlık tanımlayıcısı.
örnek: "blog"

isUserAdmin: boolean
Kullanıcı admin mi.
örnek: false

formModuleId: number
Form modülü tanımlayıcısı.
örnek: 2

parentId: any
Üst tanımlayıcı.
örnek: null

userIdentifier: number
Kullanıcı tanımlayıcısı.
örnek: null

formData.formData: FormDataType[]
Form alanları verileri.
örnek:

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