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:- PDF’yi bir URL’den indirme (bir PDF oluşturma hizmetinden)
- Dosyayı Twenty’ye yükleme
- Kayda bağlı bir ek oluşturma
Ön Gereksinimler
İş akışını kurmadan önce:- 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.
- 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
- İş Akışları’na gidin ve yeni bir iş akışı oluşturun
- Manuel Tetikleyici’yi seçin
- PDF’leri eklemek istediğiniz nesneyi seçin (ör. Company veya Opportunity)
Adım 2: Bir Mantıksal İşlev ekleyin
- Bir Kod eylemi (mantıksal işlev) ekleyin
- Aşağıdaki kodla yeni bir işlev oluşturun
- Girdi parametrelerini yapılandırın
Girdi Parametreleri
| Parametre | Değ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:
| Nesne | Alan Adı |
|---|---|
| Şirket | targetCompanyId |
| Kişi | targetPersonId |
| Fırsat | targetOpportunityId |
| Özel Nesne | targetYourCustomObjectId |
variables.data nesnesini güncelleyin.
Dinamik bir PDF URL’si kullanmak için
Bir PDF oluşturma hizmeti kullanıyorsanız şunları yapabilirsiniz:- Önce PDF’yi oluşturmak için bir HTTP İsteği eylemi yapın
- Döndürülen PDF URL’sini mantıksal işleve bir parametre olarak iletin
Adım 4: Test Edin ve Etkinleştirin
- İş akışını kaydedin
- Bir Company kaydına gidin
- ⋮ menüsüne tıklayın ve iş akışınızı seçin
- PDF’nin eklendiğini doğrulamak için kayıttaki Attachments bölümünü kontrol edin
- İş 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ım | Eylem | Amaç |
|---|---|---|
| 1 | Manuel Tetikleyici (Company) | Kullanıcı bir kayıtta başlatır |
| 2 | Kayıt Ara | Opportunity veya satır öğesi ayrıntılarını alın |
| 3 | HTTP İsteği | Kayıt verileriyle PDF oluşturma API’sini çağırın |
| 4 | Sunucusuz İşlev | Oluş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
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 |