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 bilgilere 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.

FormData.postFormsData(

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

);

Parametreler şeması​

Şema (body)

body(required): 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(required): string
Formun metin tanımlayıcısı (işaretçi).
örnek: "form"

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

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

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

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

body.formData(required): 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"

Örnekler​

Minimal örnek​


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "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 = {
  "formIdentifier": "test-form",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "string_marker",
      "type": "string",
      "value": "Username"
    },
    {
      "marker": "number_marker",
      "type": "number",
      "value": 1
    },
    {
      "marker": "float_marker",
      "type": "float",
      "value": 2.256
    }
  ]
};

const response = await FormData.postFormsData(body);

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


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "date_marker",
      "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 (Sadece htmlValue, plainValue veya mdValue'dan biri sağlanabilir)​


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "about_marker",
      "type": "text",
      "value": [
        {
          "htmlValue": "<p>Hello world</p>",
          "params": {
            "isImageCompressed": true,
            "editorMode": "html"
          }
        }
      ]
    }
  ]
};

const response = await FormData.postFormsData(body);

Basit tür niteliği "textWithHeader" ile örnek (Sadece htmlValue, plainValue veya mdValue'dan biri sağlanabilir)​


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      marker: "textwithheader_marker",
      type: "textWithHeader",
      value: [
        {
          "header": "Başlık",
          "htmlValue": "<p>Hello World</p>",
          "params": {
            "isImageCompressed": true,
            "editorMode": "html"
          }
        }
      ]
    }
  ]
};

const response = await FormData.postFormsData(body);

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


const testImageUrl = 'https://your-project.oneentry.cloud/cloud-static/files/project/product/2954/image/7e0a6a70-a23d-410f-8b6a-f8b4f7483244.png';
const filename = 'test-image.png';

/* Gerçek dünyada, URL'den dosya oluşturmak için File API kullanılmalıdır, ancak basitlik açısından, önceden tanımlanmış dosya URL'sini kullanacağız ve bu örnek için createFileFromUrl yöntemini kullanacağız */
const file = await FileUploading.createFileFromUrl(testImageUrl, filename);

const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      marker: "image_marker",
      type: "image",
      value: [
        file
      ]
    }
  ]
};

const response = await FormData.postFormsData(body);

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


const testImageUrl = 'https://your-project.oneentry.cloud/cloud-static/files/project/product/2954/image/7e0a6a70-a23d-410f-8b6a-f8b4f7483244.png';
const filename = 'test-image.png';

/* Gerçek dünyada, URL'den dosya oluşturmak için File API kullanılmalıdır, ancak basitlik açısından, önceden tanımlanmış dosya URL'sini kullanacağız ve bu örnek için createFileFromUrl yöntemini kullanacağız */
const file = await FileUploading.createFileFromUrl(testImageUrl, filename);

const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      marker: "groupofimages_marker",
      type: "groupOfImages",
      value: [
        file
      ]
    }
  ]
};

const response = await FormData.postFormsData(body);

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


const testImageUrl = 'https://your-project.oneentry.cloud/cloud-static/files/project/product/2954/image/7e0a6a70-a23d-410f-8b6a-f8b4f7483244.png';
const filename = 'test-image.png';

/* Gerçek dünyada, URL'den dosya oluşturmak için File API kullanılmalıdır, ancak basitlik açısından, önceden tanımlanmış dosya URL'sini kullanacağız ve bu örnek için createFileFromUrl yöntemini kullanacağız */
const file = await FileUploading.createFileFromUrl(testImageUrl, filename);

const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "picture_marker",
      "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);

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


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "selector_marker",
      "type": "list",
      "value": [
        {
          "marker": "list",
          "type": "list",
          "value": ["1"]
        }
      ]
    }
  ]
};

const response = await FormData.postFormsData(body);

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


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      "marker": "entity_marker",
      "type": "entity",
      "value": [25, 32, 24]
    }
  ]
};

const response = await FormData.postFormsData(body);

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" tür niteliği ile örnek​


const body = {
  "formIdentifier": "contact_us",
  "formModuleConfigId": 2,
  "moduleEntityIdentifier": "blog",
  "replayTo": null,
  "status": "sent",
  "formData": [
    {
      marker: 'timeinterval_marker',
      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. ö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-11-06T09:28:00.915Z",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "entityIdentifier": "blog",
    "fingerprint": "UQ_ue7gas",
    "isUserAdmin": false,
    "formModuleId": 2,
    "userIdentifier": null,
    "parentId": null,
    "id": 843
  },
  "actionMessage": ""
}

Yanıt şeması​

Şema: IPostFormResponse

formData: object
Form verisi.
örnek:

{
  "id": 42,
  "formIdentifier": "contact_form",
  "time": "2023-10-01T12:00:00Z",
  "entityIdentifier": "blog",
  "isUserAdmin": false,
  "formModuleId": 2,
  "parentId": null,
  "userIdentifier": null,
  "formData": [
    {
      "marker": "name",
      "type": "string",
      "value": "Jack"
    }
  ]
}

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"

formData.time: string
Formun gönderim zamanı.
örnek: "2023-10-01T12:00:00Z"

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

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

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

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

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

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

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

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