Giriş

Gerçek zamanlı gönderimler ve veri toplama ile dinamik formlar alın.

🎯 Bu modül ne yapar?

Forms modülü, formları almanıza olanak tanır - iletişim formları, anketler, kayıtlar, geri bildirim formları - ve kullanıcı gönderimlerini doğrulama, dosya yüklemeleri ve otomatik bildirimlerle toplar.

Bunu form oluşturucunuz olarak düşünün - formları OneEntry yönetim panelinde oluşturursunuz, uygulamanızda görüntülersiniz ve yanıtları otomatik olarak toplarsınız.

📖 Basit Açıklama

Kullanıcılardan bilgi toplamanız gerektiğini hayal edin:

• 📞 İletişim Formu - isim, e-posta, mesaj, telefon
• 📋 Anket - çoktan seçmeli sorular, puanlamalar
• 👤 Kayıt Formu - kullanıcı bilgileri, tercihleri
• 💼 İş Başvurusu - özgeçmiş yükleme, ön yazı
• 📝 Geri Bildirim Formu - puanlamalar, yorumlar, öneriler
• 🎟️ Etkinlik Kaydı - katılımcı bilgileri, bilet seçimi

Formları sıfırdan oluşturmak yerine:

• ✅ OneEntry yönetim panelinde formlar oluşturun (sürükleyip bırakma alanları)
• ✅ Form yapısını dinamik olarak alın
• ✅ Verileri OneEntry'ye gönderin (otomatik depolama)
• ✅ Alanları doğrulayın (zorunlu, e-posta formatı, dosya türleri)
• ✅ Formlar gönderildiğinde bildirim alın
• ✅ Yanıtları yönetim panelinde görüntüleyin

Gerçek dünya örneği:

Forms Modülü Olmadan (manuel):
- Form HTML/validasyonunu manuel olarak oluşturun ❌
- Gönderimleri depolamak için arka uç ayarlayın ❌
- Veritabanı tabloları oluşturun ❌
- Yanıtları görüntülemek için yönetim paneli oluşturun ❌
- E-posta bildirim kodu yazın ❌

Forms Modülü ile (otomatik):
- Yönetim panelinde form oluşturun ✅
- API aracılığıyla form yapısını alın ✅
- Verileri gönderin → Otomatik depolandı ✅
- Yanıtları panelde görüntüleyin ✅
- Otomatik e-posta bildirimleri ✅

✨ Temel Kavramlar

Form Nedir?

Bir form, kullanıcılardan bilgi toplamanın yapılandırılmış bir yoludur:

• Alanlar - Girdi öğeleri (metin, e-posta, onay kutuları, dosya yükleme)
• Doğrulama - Kurallar (zorunlu, format, min/max uzunluk)
• Gönderimler - Veritabanında saklanan kullanıcı yanıtları
• Yapı - OneEntry'de tanımlanan form düzeni
• Dinamik - API'den form yapısını alın, uygulamanızda render edin

Form Yaşam Döngüsü

1. OneEntry yönetim panelinde form oluştur
   ↓
2. Alanları tanımla (isim, e-posta, mesaj, vb.)
   ↓
3. Doğrulama kurallarını ayarla
   ↓
4. SDK aracılığıyla form yapısını al
   ↓
5. Uygulamanızda formu render edin
   ↓
6. Kullanıcı formu doldurur
   ↓
7. Verileri OneEntry'ye gönder
   ↓
8. Doğrulama gerçekleşir
   ↓
9. Veriler veritabanında saklanır
   ↓
10. Bildirimler gönderilir (e-posta, webhook)

Form Alanı Türleri

Kullanabileceğiniz yaygın alan türleri:

Alan Türü	Açıklama	Örnek Kullanım
metin	Kısa metin girişi	İsim, Unvan, Şehir
e-posta	Doğrulama ile e-posta adresi	İletişim e-postası
textarea	Çok satırlı metin	Mesaj, Yorumlar, Biyografi
sayı	Sayısal girdi	Yaş, Miktar, Telefon
onay kutusu	Tek bir onay kutusu veya birden fazla	Şartlar, Tercihler
radyo	Seçeneklerden tek seçim	Cinsiyet, Boyut, Plan
seçim	Aşağı açılır menü	Ülke, Kategori, Durum
dosya	Dosya yükleme	Özgeçmiş, Fotoğraf, Belge
tarih	Tarih seçici	Doğum tarihi, Etkinlik tarihi

📋 Bilmeniz Gerekenler

Form Yapısı

Her formun bu ana alanları vardır:

{
  id: 123,
  marker: "contact_form",   // Benzersiz tanımlayıcı
  localizeInfos: {
    title: "Bize Ulaşın",    // Form başlığı
    description: "İletişime geçin" // Form açıklaması
  },
  fields: [   // Form alanları
    {
      marker: "name",
      type: "text",
      localizeInfos: { title: "İsim" },
      isRequired: true,
      validation: { minLength: 2, maxLength: 50 }
    },
  ],
  statusId: 1,                 // 1 = aktif, 0 = taslak
  isActive: true,              // Form etkin mi
  successMessage: "Teşekkür ederiz!" // Gönderim sonrası mesaj
}

Alan Doğrulaması

Her alanın doğrulama kuralları olabilir:

{
  "marker": "email",
  "type": "email",
  "isRequired": true, // Doldurulması zorunlu
  "validation": {
    "format": "email",  // Geçerli e-posta olmalı
    "minLength": 5,     // En az 5 karakter
    "maxLength": 100,   // En fazla 100 karakter
    "pattern": "^[a-z0-9]+@[a-z]+\\.[a-z]{2,}$"  // Özel regex
  }
}

Yaygın doğrulama kuralları:

• isRequired - Alan doldurulmalı
• minLength - Minimum metin uzunluğu
• maxLength - Maksimum metin uzunluğu
• format - E-posta, telefon, URL formatı
• pattern - Özel regex deseni
• min / max - Sayı aralığı
• fileTypes - İzin verilen dosya uzantıları
• maxFileSize - Maksimum dosya boyutu

---

📊 Hızlı Referans Tablosu - Yöntemler

Yöntem	Ne Yapar	Ne Zaman Kullanılır
getAllForms()	Tüm formları al (sayfalı)	Mevcut tüm formları listele
getFormByMarker()	Marker ile form al	Kodda belirli bir formu al

Not: Form oluşturmak/düzenlemek için OneEntry yönetim panelini kullanın. SDK, formları almak ve veri göndermek içindir.

---

❓ Sıkça Sorulan Sorular (SSS)

Formları nasıl oluşturur veya düzenlerim?

Formlar OneEntry yönetim panelinde oluşturulur:

1. OneEntry yönetimine giriş yapın
2. Formlar bölümüne gidin
3. Yeni form oluşturun veya mevcut olanı düzenleyin
4. Alanları ekleyin (sürükleyip bırakma)
5. Doğrulama kurallarını yapılandırın
6. Formu etkinleştirin

SDK, formları almak ve veri göndermek içindir, form oluşturmak için değil.

---

Form verilerini göndermeden önce nasıl doğrularım?

Tarayıcı doğrulaması + manuel kontroller kullanın:

---

Formlarla dosya yükleyebilir miyim?

Evet! FileUploading modülünü kullanın ve alanınıza file ekleyin:

Daha fazla bilgi: FormsData Modülü

---

Form gönderildiğinde özel bildirimler gönderebilir miyim?

Evet, OneEntry yönetim panelinde yapılandırın:

• Yönetici/kullanıcıya e-posta bildirimleri
• Sunucunuza webhook bildirimleri
• Events modülü ile entegrasyon

---

Form gönderim hatalarını nasıl yönetirim?

Her zaman try/catch kullanın

---

Formlar koşullu alanlara sahip olabilir mi (diğer alanlara göre göster/gizle)?

SDK'da doğrudan değil, ancak UI'nizde uygulayabilirsiniz.

---

💡 Önemli Notlar

Formlar Yönetim Panelinde Oluşturulur

Unutmayın: SDK, formları almak ve veri göndermek içindir, form oluşturmak için değil.

Form oluşturmak/düzenlemek için: OneEntry yönetim panelini veya Admin API'yi kullanın.

---

Her Zaman Verileri Doğrulayın

✅ İstemci tarafı doğrulaması yeterli değildir:

• İstemcide doğrulayın (daha iyi UX)
• Sunucuda doğrulayın (OneEntry bunu otomatik olarak yapar)

---

Dosya Yüklemelerini Dikkatlice Yönetin

✅ Dosya yüklemeleri için en iyi uygulamalar:

• Yüklemeden önce dosya türünü doğrulayın
• Dosya boyutu sınırlarını kontrol edin
• Yükleme ilerlemesini gösterin
• Yükleme hatalarını yönetin

---

🎓 En İyi Uygulamalar

✅ Yapılması Gerekenler:

• Formları referans almak için işaretçileri kullanın (ID'ler değil)
• Verileri istemci ve sunucuda doğrulayın
• Gönderim sırasında yükleme durumlarını gösterin
• Açık hata mesajları sağlayın
• Başarılı gönderimden sonra gönder butonunu devre dışı bırakın
• Başarılı gönderimden sonra formu temizleyin
• Dosya yükleme hatalarını nazikçe yönetin
• Hata yönetimi için try/catch kullanın

❌ Yapılmaması Gerekenler:

• Kodda form ID'lerini sabit kodlayın
• Doğrulama olmadan formları gönderin
• Hata yönetimini göz ardı edin
• Tekrar eden gönderimlere izin verin
• Boyut/tip doğrulaması olmadan dosya yükleyin
• Kullanıcılara teknik hataları gösterin
• Kullanıcı geri bildirimini sağlamayı unutmayın
• Yükleme durumlarını atlayın

---

Modülün kullanıcı arayüzü hakkında daha fazla bilgi https://doc.oneentry.cloud/docs/forms/introduction

Forms modülünün tanımı

const { Forms } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Gelişmiş kullanım örnekleri Forms Girişi bölümünde bulunabilir.

---

🔗 İlgili Belgeler

• FormsData Modülü - Form gönderimlerini görüntüleyin ve yönetin
• Events Modülü - Form gönderiminde otomatik bildirimler ayarlayın
• FileUploading Modülü - Formlarda dosya yüklemelerini yönetin
• Users Modülü - Form gönderen kullanıcıları yönetin

---