Ana içeriğe atla
Twenty’de PDF’yi otomatik olarak oluşturun veya edinin ve bir kayda ekleyin. Bu, Şirketler, Fırsatlar veya diğer nesnelere bağlı teklif, fatura ya da raporlar oluşturmak için yaygın olarak kullanılır.

Genel Bakış

Bu iş akışı, kullanıcıların seçilen herhangi bir kayıt için isteğe bağlı olarak PDF oluşturabilmesi için Manuel Tetikleyici kullanır. Bir Mantıksal İşlev şunları gerçekleştirir:
  1. PDF’yi bir URL’den indirme (bir PDF oluşturma hizmetinden)
  2. Dosyayı Twenty’ye yükleme
  3. Kayda bağlı bir ek oluşturma

Ön Gereksinimler

İş akışını kurmadan önce:
  1. Bir API Anahtarı oluşturun: Ayarlar → API’ler’e gidin ve yeni bir API anahtarı oluşturun. Mantıksal işlev için bu belirtece ihtiyacınız olacak.
  2. Bir PDF oluşturma hizmeti kurun (isteğe bağlı): PDF’leri dinamik olarak oluşturmak istiyorsanız (ör. teklifler), PDF’yi oluşturmak ve bir indirme URL’si almak için Carbone, PDFMonkey veya DocuSeal gibi bir hizmet kullanın.

Adım Adım Kurulum

Adım 1: Tetikleyiciyi Yapılandırın

  1. İş Akışları’na gidin ve yeni bir iş akışı oluşturun
  2. Manuel Tetikleyici’yi seçin
  3. PDF’leri eklemek istediğiniz nesneyi seçin (ör. Company veya Opportunity)
Manuel Tetikleyici ile kullanıcılar, bir kayıt seçildiğinde sağ üstte görünen bir düğmeyi kullanarak bu iş akışını çalıştırıp bir PDF oluşturabilir ve ekleyebilir.

Adım 2: Bir Mantıksal İşlev ekleyin

  1. Bir Kod eylemi (mantıksal işlev) ekleyin
  2. Aşağıdaki kodla yeni bir işlev oluşturun
  3. Girdi parametrelerini yapılandırın

Girdi Parametreleri

ParametreDeğer
companyId{{trigger.object.id}}
Farklı bir nesneye (Person, Opportunity vb.) ekliyorsanız, parametreyi buna göre yeniden adlandırın (ör. personId, opportunityId) ve mantıksal işlevi güncelleyin.

Mantıksal İşlev Kodu

Adım 3: Kullanım Senaryonuza Göre Özelleştirin

Farklı bir nesneye eklemek için

targetCompanyId değerini uygun alanla değiştirin:
NesneAlan Adı
ŞirkettargetCompanyId
KişitargetPersonId
FırsattargetOpportunityId
Özel NesnetargetYourCustomObjectId
Ek oluşturma mutasyonunda hem işlev parametresini hem de variables.data nesnesini güncelleyin.

Dinamik bir PDF URL’si kullanmak için

Bir PDF oluşturma hizmeti kullanıyorsanız şunları yapabilirsiniz:
  1. Önce PDF’yi oluşturmak için bir HTTP İsteği eylemi yapın
  2. Döndürülen PDF URL’sini mantıksal işleve bir parametre olarak iletin

Adım 4: Test Edin ve Etkinleştirin

  1. İş akışını kaydedin
  2. Bir Company kaydına gidin
  3. menüsüne tıklayın ve iş akışınızı seçin
  4. PDF’nin eklendiğini doğrulamak için kayıttaki Attachments bölümünü kontrol edin
  5. İş akışını etkinleştirin

PDF Oluşturma Hizmetleriyle Birleştirme

Dinamik teklifler veya faturalar oluşturmak için:

Örnek: Teklif Oluştur → PDF’yi Ekle

AdımEylemAmaç
1Manuel Tetikleyici (Company)Kullanıcı bir kayıtta başlatır
2Kayıt AraOpportunity veya satır öğesi ayrıntılarını alın
3HTTP İsteğiKayıt verileriyle PDF oluşturma API’sini çağırın
4Sunucusuz İşlevOluşturulan PDF’yi indirin ve ekleyin

Popüler PDF Oluşturma Hizmetleri

  • Carbone - Şablon tabanlı belge oluşturma
  • PDFMonkey - Şablonlardan dinamik PDF oluşturma
  • DocuSeal - Belge otomasyon platformu
  • Documint - API-öncelikli belge oluşturma
Her hizmet, bir PDF URL’si döndüren bir API sağlar; ardından bunu mantıksal işleve iletebilirsiniz.

Sorun Giderme

SorunÇözüm
”PDF indirilemedi”PDF URL’sinin erişilebilir olduğunu ve geçerli bir PDF döndürdüğünü kontrol edin
”Yükleme başarısız”API anahtarınızın geçerli olduğunu ve yazma izinlerine sahip olduğunu doğrulayın
”Ek oluşturma başarısız”Nesne kimliği alan adının hedef nesnenizle eşleştiğinden emin olun

İlgili