formbasedocs
Uygulamaya gitUygulama

Entegrasyonlar

Linear

Gönderimleri otomatik olarak Linear sorunlarına dönüştürün. Her gönderim, seçtiğiniz ekipte özel başlık, açıklama ve projeyle bir sorun oluşturur.


Ne elde edersiniz

  • Her gönderim için bağlanan kullanıcıya atfedilen bir Linear sorunu
  • Şablon düzenleyiciden oluşturulan başlık ve açıklama — herhangi bir form alanı değerini eklemek için @ yazın

  • Açıklama markdown destekler (kalın, listeler, başlıklar, kod blokları, blok alıntılar, bağlantılar)
  • Her soruna uygulanan isteğe bağlı varsayılan proje
  • Mevcut gönderimleri talep üzerine geriye dönük doldurun (~saniyede 1 sorun)
  • Yayına geçmeden önce doğrulayabilmeniz için gerçek bir [Test] önekli sorun oluşturan test düğmesi

Linear’ı bağlayın

  1. 1

    Form ayarları → Entegrasyonlar → Linear’ı açın

    Linear 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: read, write, issues:create.

  2. 2

    Bir ekip seçin

    Sorunlar bu ekibin biriktirme listesine düşer. Her entegrasyon bir ekibi hedefler — ikinci bir ekibe yönlendirmek için başka bir entegrasyon ekleyin.

  3. 3

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

    Bir proje seçin. Her soruna uygulanır ve ekip değiştirdiğinizde sıfırlanır.

  4. 4

    Başlık ve açıklama 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 (en fazla 255 karakter); açıklama 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 açıklama yazın. Atlamak için Kapalı bırakın. Pro veya Business gerektirir.

  6. 6

    Sonlandır

    Test gönder, seçilen ekipte [Test] önekli gerçek bir sorun oluşturur — sonrasında arşivleyin veya silin. Ardından Entegrasyon oluştur’a basın ve her gönderim bir Linear sorunu oluşturur.

Mevcut gönderimleri geriye dönük doldurma

İlk bağlandığınızda mevcut gönderimleri Linear sorunları olarak dışa aktarabilirsiniz. Geriye dönük doldurma, Linear’ın hız sınırları içinde kalmak için arka planda ~saniyede 1 sorun hızında çalışır. İlerleme her 10 gönderimde bir kaydedilir.

Terk edilmiş yanıt etkinlikleri

Bir katılımcı formunuzu başlatır ancak tamamlamazsa, formbase kısmi veriler için ayrı bir sorun 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ş sorun başlığını ve açıklamasını doldurun — ikisi de boş bırakılamaz. Terk edilmiş sorunlar bir partial-submission etiketi alır.

Saatlik bir tarama boşta kalan taslakları arar, bu yüzden sorun, 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: sorun yalnızca seçtiğiniz alanlardan en az biri doldurulmuşsa oluşturulur.

Pro özelliği

Terk edilmiş yanıt teslimi Pro veya Business plan gerektirir. Temel Linear entegrasyonu tüm planlarda kullanılabilir. Bkz. planlar ve fiyatlandırma.

Token yenileme

Linear erişim token’ları, süresi dolmaya yaklaştığında her gönderim öncesinde otomatik olarak yenilenir. Yenileme başarısız olursa (token iptal edilmiş, uygulama kaldırılmış), formbase entegrasyonu hata olarak işaretler ve bir başarısızlık bildirimi e-postası alırsınız. Geri yüklemek için çalışma alanı Entegrasyonlar sayfasından yeniden bağlanın.

Entegrasyonu kaldırma

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

  • Linear’dan — OAuth iznini kullanıcı ayarlarınızdan iptal edin. Bir sonraki gönderim başarısız olur ve kimlik bilgisi süresi dolmuş olarak işaretlenir.

Sınırlar ve davranış

  • Gönderim başına bir sorun — mevcut soruna yorum ekleme modu yok
  • Başlık düz metindir, 255 karakteri aşınca üç nokta ile kesilir; açıklama 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 sorundan ulaşılabilir
  • @ ile eklenen bir tekrarlayan grup alanı, her kaydı “ · “ ile birleştirilmiş olarak gösterir

SSS

Üç Linear OAuth kapsamı: read (ekipleri, projeleri ve etiketleri listele), write (sorun meta verilerini güncelle) ve issues:create (sorun oluştur). Bağlantı actor=user kullanır, bu nedenle sorunlar bir bota değil size atfedilir.

Evet. Entegrasyon detay sayfasını açın ve her iki alanı da değiştirin. Ekip değiştirmek, projeler ekibe özgü olduğundan projeyi sıfırlar.

Evet. Birden fazla kimlik bilgisi eklemek için farklı Linear hesaplarını yetkilendirin. Her form entegrasyonu hangisini kullanacağını seçer.

Evet. Linear bağlantıları çalışma alanı kapsamındadır. Herhangi bir çalışma alanı üyesi, entegrasyon kurarken bağlı herhangi bir Linear hesabını kullanabilir.

Entegrasyon otomatik olarak duraklar ve kurulumu yapan kişiye bir e-posta gider. İptal edilmiş bir token, kaybedilmiş bir izin veya silinmiş bir ekip beş başarısızlığı beklemez — entegrasyonu hemen durdurur. Her durumda nedeni düzeltin ve Devam Ettir’e basın.

Sonraki adımlar