Formları CSV'den oluştur

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/import-csv \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "forms": [
    {
      "name": "<string>",
      "siteIds": [
        "<string>"
      ],
      "years": [
        123
      ],
      "elements": [
        {
          "key": "<string>",
          "label": "<string>",
          "optionValues": [
            "<string>"
          ],
          "optionLabels": [
            "<string>"
          ],
          "datasetItems": [
            "<string>"
          ],
          "description": "<string>",
          "placeholder": "<string>",
          "unit": "<string>",
          "unitId": "<string>",
          "required": true,
          "metadata": {}
        }
      ],
      "tags": [
        "<string>"
      ]
    }
  ]
}
'

[
  {
    "id": "<string>",
    "name": "<string>"
  }
]

Form

Formları CSV'den oluştur

Yapılandırılmış bir CSV şablonundan birden fazla formu toplu halde oluşturur (site manager yetkisi gerektirir).

CSV formatı gereksinimleri:

Form sütunları: name, description, instructions
Öğe sütunları: element_type, element_label, element_key, element_required, element_options
Dağıtım sütunları: site_ids, year, period_type
Ayar sütunları: public_access, password_protected, metadata

Desteklenen öğe tipleri: Platformun desteklediği 11 form öğesinin tamamı

Toplu işleme özellikleri:

Tek işlemde birden fazla form oluşturma
Tutarlılık için otomatik öğe anahtarı üretimi
Formları birden fazla tesise aynı anda dağıtma
Satır bazında doğrulama ve ayrıntılı hata raporları

Kullanım senaryoları:

Standart formları çok sayıda tesise dağıtmak
Harici sistemlerden form migrasyonu yapmak
Şablon bazlı form kütüphaneleri oluşturmak
Uyum gereksinimlerinde hızlı dağıtım sağlamak

Hata yönetimi:

Satır bazlı doğrulamalar ve açıklayıcı hata mesajları
Kısmi başarı (bazı formlar oluşturulurken hatalı satırlar raporlanır)
Önizleme moduyla gerçek oluşturma öncesi doğrulama
Toplu işlem başarısız olduğunda geri alma seçenekleri

POST

forms

import-csv

Formları CSV'den oluştur

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/import-csv \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "forms": [
    {
      "name": "<string>",
      "siteIds": [
        "<string>"
      ],
      "years": [
        123
      ],
      "elements": [
        {
          "key": "<string>",
          "label": "<string>",
          "optionValues": [
            "<string>"
          ],
          "optionLabels": [
            "<string>"
          ],
          "datasetItems": [
            "<string>"
          ],
          "description": "<string>",
          "placeholder": "<string>",
          "unit": "<string>",
          "unitId": "<string>",
          "required": true,
          "metadata": {}
        }
      ],
      "tags": [
        "<string>"
      ]
    }
  ]
}
'

[
  {
    "id": "<string>",
    "name": "<string>"
  }
]

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Gövde

application/json

forms

object[]

gerekli

Show child attributes

Yanıt

Successful response

string

gerekli

name

string

gerekli

Form özetini getir Formu kopyala