Přejít na hlavní obsah
Automaticky vygenerujte nebo získejte PDF a připojte ho k záznamu v Twenty. To se běžně používá k vytváření nabídek, faktur nebo reportů, které jsou propojené se společnostmi, příležitostmi nebo jinými objekty.

Přehled

Tento pracovní postup používá Ruční spouštěč, takže uživatelé mohou na požádání vygenerovat PDF pro libovolný vybraný záznam. O zpracování se stará logická funkce:
  1. Stažení PDF z adresy URL (ze služby pro generování PDF)
  2. Nahrání souboru do Twenty
  3. Vytvoření přílohy propojené se záznamem

Předpoklady

Než nastavíte pracovní postup:
  1. Vytvořte klíč API: Přejděte do Nastavení → API a vytvořte nový klíč API. Tento token budete potřebovat pro logickou funkci.
  2. Nastavte službu pro generování PDF (volitelné): Pokud chcete dynamicky generovat PDF (např. nabídky), použijte službu jako Carbone, PDFMonkey nebo DocuSeal k vytvoření PDF a získání adresy URL pro stažení.

Nastavení krok za krokem

Krok 1: Nakonfigurujte spouštěč

  1. Přejděte na Pracovní postupy a vytvořte nový pracovní postup
  2. Vyberte Ruční spouštěč
  3. Zvolte objekt, ke kterému chcete připojovat PDF (např. Společnost nebo Příležitost)
S Ručním spouštěčem mohou uživatelé spustit tento pracovní postup pomocí tlačítka, které se zobrazí vpravo nahoře po výběru záznamu, aby vygenerovali a připojili PDF.

Krok 2: Přidejte logickou funkci

  1. Přidejte akci Code (logická funkce)
  2. Vytvořte novou funkci pomocí kódu níže
  3. Nakonfigurujte vstupní parametry

Vstupní parametry

Pokud připojujete k jinému objektu (Osoba, Příležitost apod.), přejmenujte parametr podle toho (např. personId, opportunityId) a aktualizujte logickou funkci.

Kód logické funkce

Krok 3: Přizpůsobte pro svůj případ použití

Chcete-li připojit k jinému objektu

Nahraďte targetCompanyId příslušným polem: Aktualizujte jak parametr funkce, tak objekt variables.data v mutaci přílohy.

Chcete-li použít dynamickou adresu URL PDF

Pokud používáte službu pro generování PDF, můžete:
  1. Nejprve proveďte akci HTTP Request pro vygenerování PDF
  2. Předejte vrácenou adresu URL PDF logické funkci jako parametr

Krok 4: Otestujte a aktivujte

  1. Uložte pracovní postup
  2. Přejděte na záznam společnosti
  3. Klikněte na nabídku a vyberte svůj pracovní postup
  4. Zkontrolujte v části Přílohy u záznamu, že bylo PDF připojeno
  5. Aktivujte pracovní postup

Kombinace se službami pro generování PDF

Pro vytváření dynamických nabídek nebo faktur:

Příklad: Vygenerovat nabídku → Připojit PDF

Oblíbené služby pro generování PDF

  • Carbone - Generování dokumentů založené na šablonách
  • PDFMonkey - Dynamické vytváření PDF ze šablon
  • DocuSeal - Platforma pro automatizaci dokumentů
  • Documint - Generování dokumentů primárně přes API
Každá služba poskytuje API, které vrací adresu URL PDF, kterou pak můžete předat logické funkci.

Řešení potíží

Související