GitHub Issues

Ne elde edersiniz

• Her gönderim için bağlanan kullanıcıya atfedilen bir GitHub issue

• Şablon düzenleyiciden oluşturulan başlık ve gövde — herhangi bir form alanı değerini eklemek için @ yazın

• Gövde GitHub-flavored markdown destekler (kalın, listeler, başlıklar, kod blokları, bağlantılar)
• Her issue’ya uygulanan isteğe bağlı varsayılan kilometre taşı

• Yayına geçmeden önce doğrulayabilmeniz için gerçek bir [Test] önekli issue oluşturan test düğmesi

GitHub’ı bağlayın

1. 1

   Form ayarları → Entegrasyonlar → GitHub Issues’ı açın

   GitHub hesabını bağla’ya basın veya çalışma alanının zaten bağladığı bir hesabı seçin. Bir açılır pencere sizi OAuth onayı boyunca yönlendirir. İstenen kapsamlar: repo, read:user, read:org.

2. 2

   Bir depo seçin

   Seçici, push erişiminiz olan depoları listeler. formbase arşivlenmiş ve devre dışı bırakılmış depoları hariç tutar.

3. 3

   Varsayılanları ayarlayın (isteğe bağlı)

   Varsayılan bir kilometre taşı seçin. Her issue’ya uygulanır ve depoyu değiştirdiğinizde sıfırlanır.

4. 4

   Başlık ve gövdeyi oluşturun

   Şablon düzenleyicilerini kullanın. Form alanı değerlerini veya PDF Link gibi gönderim meta verilerini eklemek için @ yazın. Başlık düz metin olarak işlenir (maksimum 256 karakter); gövde GitHub-flavored markdown olarak işlenir.

5. 5

   Terk edilmiş gönderimler (isteğe bağlı)

   Bir boşta kalma penceresi seçin ve kimsenin tamamlamadığı taslaklar için ayrı bir başlık ve gövde yazın. Atlamak için Kapalı bırakın. Pro veya Business gerektirir.

6. 6

   Sonlandır

   Test gönder, seçilen depoda [Test] önekli gerçek bir issue oluşturur — sonrasında kapatın veya silin. Ardından Entegrasyon oluştur’a basın ve her gönderim bir GitHub issue’sı oluşturur.

Terk edilmiş yanıt etkinlikleri

Bir katılımcı formunuzu başlatır ancak tamamlamazsa, formbase kısmi veriler için ayrı bir issue oluşturabilir. Terk edilmiş etkinliği şuradan sonra gönder’i 12 saat, 1 gün, 3 gün veya 1 hafta olarak ayarlayın, ardından terk edilmiş issue başlığını ve gövdesini doldurun — ikisi de boş bırakılamaz. Terk edilmiş issue’lar, ilk kullanımda oluşturulan bir partial-submission etiketi alır.

Saatlik bir tarama boşta kalan taslakları arar, bu yüzden issue, pencere geçtikten sonraki ilk taramada görünür. Yalnızca bir paylaşım bağlantısından gelen taslaklar taranır ve Zorunlu alanlar bunu daha da daraltır: issue yalnızca seçtiğiniz alanlardan en az biri doldurulmuşsa oluşturulur.

Token’lar

GitHub OAuth App token’ları sona ermez — yenileme token’ı rotasyonu yoktur. GitHub hesabınızın yetkili OAuth Uygulamaları sayfasından izni iptal ederseniz, bir sonraki gönderim başarısız olur, formbase kimlik bilgisini süresi dolmuş olarak işaretler ve size bir başarısızlık bildirimi e-postası gönderilir. Geri yüklemek için çalışma alanı Entegrasyonlar sayfasından yeniden bağlanın.

Entegrasyonu kaldırma

• formbase’den — Form ayarları → Entegrasyonlar → GitHub Issues → Sil. Yeni gönderimler hemen issue oluşturmayı durdurur.

• GitHub’dan — Hesabınızın yetkili OAuth Uygulamaları sayfasından OAuth iznini iptal edin. formbase kendi tarafındaki token’ı otomatik olarak iptal etmez.

Sınırlar ve davranış

• Gönderim başına bir issue — mevcut issue’ya yorum ekleme modu yok
• Geriye dönük doldurma yok — yalnızca yeni gönderimler issue oluşturur
• Başlık düz metindir, 256 karakteri aşınca üç nokta ile kesilir; gövde yalnızca markdown’dır

• Boş bir başlık, New submission to <form name> değerine döner

• Dosya yükleme yanıtları, dosya adının ardından indirme bağlantısıyla birlikte işlenir; böylece dosyaya issue’dan ulaşılabilir

• Katılımcı yanıtları issue gövdesine olduğu gibi eklenir — bir yanıt @username içeriyorsa GitHub o kullanıcıya bildirim gönderir ve #123 bir issue referansı oluşturur

SSS

Sonraki adımlar