PDF z Państwa danych
Usługa tworzy PDF z danych, które dostarcza Państwa aplikacja lub baza danych.
Dokumenty, umowy i PDF jako usługa obok Państwa systemu
Umowy, oferty i formularze mają powstawać automatycznie jako PDF z danych Państwa systemu, ale treść zależy od konkretnego przypadku. Budujemy do tego osobną usługę ze zmiennymi i wariantami tekstu, którą system wywołuje przez interfejs. Rdzeń Państwa oprogramowania pozostaje przy tym bez przebudowy.
- Od 2015 r. ColdFusion i Lucee w systemach produkcyjnych
- Doświadczenie naszych inżynierów z systemami do generowania dokumentów i umów
- Odpowiedź w ciągu jednego dnia roboczego
Trzy sytuacje, w których pomaga usługa generowania dokumentów
Szablony Word, które ktoś dopasowuje ręcznie
Umowy, oferty i pisma powstają z szablonów Word, które ktoś dopasowuje do każdego przypadku. To zabiera czas. Łatwo przy tym zgubić fragment tekstu, a w kilku plikach krążą różne wersje.
Usługa dokumentów, która nie zna reguł
Z doświadczenia naszych inżynierów wynika, że istniejące usługi dokumentów tworzą wprawdzie PDF, ale nie zawsze odwzorowują zmienne i warianty tekstu zależne od przypadku. Wtedy nadal ktoś ręcznie decyduje, który tekst trafia do którego dokumentu.
Dokumenty, które po zmianie platformy wyglądają inaczej
Gdy system przenosi się na inną platformę, na przykład z Windows na Linux, czasem zmieniają się czcionki i rozmiary stron. Przesuwają się podziały wierszy, tabele i stopki, a często widać to dopiero po przełączeniu.
Co robi usługa generowania dokumentów
-
-
Umowy i formularze z regułami
Zmienne, warianty tekstu i reguły ustalają, który tekst w jakim przypadku trafia do dokumentu.
-
Wersjonowane szablony
Usługa wersjonuje szablony, więc zawsze da się ustalić, która wersja obowiązywała w danym czasie.
-
Elektroniczny obieg dokumentów
Od utworzenia do wysyłki dokument przechodzi przez usługę elektronicznie, bez plików Word i segregatorów po drodze.
-
Wysyłka e-mailem
Na życzenie usługa sama wysyła gotowy dokument, zamiast zwracać go do Państwa systemu.
Jak usługa działa obok Państwa systemu
Usługa jest osobnym komponentem z interfejsem (REST lub SOAP). Państwa system wysyła dane i rodzaj dokumentu. Usługa wybiera szablon i warianty tekstu według reguł, wstawia zmienne i zwraca gotowy PDF.
Rdzeń Państwa oprogramowania nie jest przy tym przebudowywany: system wywołuje usługę w miejscu, w którym dziś powstaje dokument. Gotowy PDF zapisuje lub wysyła Państwa system, a na życzenie także usługa.
Zależnie od środowiska budujemy usługę w ColdFusion lub Lucee albo w PHP, na życzenie także w Pythonie z FastAPI. Gdzie działa i kto ją prowadzi, decydują Państwo.
Państwa system może przekazać usłudze przez interfejs także zagnieżdżoną logikę biznesową. Przykład: umowa kupna obejmuje trzy samochody, dwa są ubezpieczone u ubezpieczyciela X, a jeden u ubezpieczyciela Y. Dokument zawiera wtedy trzy razy ten sam blok tekstu o pojeździe, ale trzeci ma inny blok podrzędny o ubezpieczeniu i inne rodzaje danych. Ten przykład i tabela poniżej opierają się na fikcyjnych danych.
Jedna klauzula, trzy warianty: gdy dokument musi odzwierciedlać logikę biznesową
| Klauzula „Płatność” | Przypadek A | Przypadek B | Przypadek C |
|---|---|---|---|
| Rodzaj klienta | Firma | Osoba prywatna | Firma |
| Produkt | Standardowa dostawa | Urządzenie w najmie | Standardowa dostawa |
| Kraj i język | Polska, polski | Polska, polski | Niemcy, niemiecki |
| Tekst w dokumencie | Kwotę z faktury należy zapłacić w PLN w ciągu 30 dni od daty wystawienia faktury. | Czynsz w wysokości {kwota} PLN jest płatny miesięcznie z góry, po raz pierwszy {data}. | Der Rechnungsbetrag ist innerhalb von 30 Tagen nach Rechnungsdatum in EUR zu zahlen. |
Jak powstaje usługa
-
Przykładowy dokument i reguły
Przekazują nam Państwo przykładowy dokument i wyjaśniają, kiedy obowiązuje który tekst.
-
Model
Spisujemy zmienne, warianty tekstu i warunki, a potem uzgadniamy ten model z Państwem.
-
Prototyp
Prototyp tworzy Państwa przykładowy dokument z fikcyjnych danych. Widzą Państwo wynik, zanim w grę wejdą prawdziwe dane.
-
Podłączenie
Podłączamy usługę przez interfejs (REST lub SOAP) do Państwa istniejącego systemu.
-
Test na platformie docelowej
Sprawdzamy utworzone dokumenty tam, gdzie działa usługa: czcionki, rozmiary stron i marginesy.
-
Przekazanie
Otrzymują Państwo działającą usługę z dokumentacją interfejsu i testami na fikcyjnych danych. Gdzie znajdują się szablony i kod oraz kto prowadzi usługę, decydują Państwo.
Co ColdFusion i Lucee oferują przy PDF (stan: 2026-10)
- PDF w CFML
- Adobe ColdFusion i Lucee tworzą PDF z HTML i CFML (cfdocument) oraz przetwarzają istniejące pliki PDF (cfpdf), Lucee przez swoje rozszerzenie PDF.
Doświadczenie naszych inżynierów z dokumentami i PDF
- Typ systemu
- Systemy do generowania dokumentów i umów
- ColdFusion i Lucee
- od 2015 r. w systemach produkcyjnych: Adobe ColdFusion od wersji 9 do 2025, Lucee 5, 6 i 7
- Zmiana platformy
- Przeniesienia z Windows i IIS na Linux, z testem dokumentów pod kątem czcionek i rozmiarów stron
- Interfejsy
- REST i SOAP
Jak zaczynamy pracę nad usługą dokumentów
- Prototyp pracuje na fikcyjnych danych, prawdziwe dane klientów nie są do tego potrzebne.
- Gdzie znajdują się szablony, reguły i kod, decydują Państwo. Na koniec przekazujemy stan prac w uporządkowanej formie.
A co, jeśli u nas ktoś będzie niedostępny? Dokumentację sporządzamy na życzenie. Repozytorium z reguły znajduje się u Państwa. Zastępstwo organizujemy na życzenie.
Jakie systemy znają nasi inżynierowie, opisuje strona Doświadczenie. Jak współpracujemy, opisuje strona Współpraca.
Pierwszy krok: rozmowa o Państwa przykładowym dokumencie, potem pilotaż generowania dokumentów
Pilotaż generowania dokumentów
Dla firm, które chcą tworzyć umowy, oferty lub formularze z danych swojego systemu, gdy treść zależy od konkretnej sprawy.
- jeden rodzaj dokumentu, na przykład umowa lub oferta, na podstawie przykładowego dokumentu
- zmienne, warianty tekstu i reguły dla tego rodzaju dokumentu
- generowanie PDF przez interfejs API, który wywołuje Państwa system
- testy na fikcyjnych danych
- ocena, czego wymagają kolejne rodzaje dokumentów
Zakres i cenę ustalamy w rozmowie wstępnej i potwierdzamy na piśmie przed rozpoczęciem pracy.
Co zawiera wynik
Działająca usługa dla jednego rodzaju dokumentu, z opisem interfejsu API, testami i dokumentacją.
Pytania o usługę generowania dokumentów
Czy potrzebujemy do tego nowego systemu?
Nie. Usługa generowania dokumentów działa obok Państwa obecnego oprogramowania i jest z nim połączona przez interfejs. Rdzeń Państwa oprogramowania nie jest przebudowywany: system wywołuje usługę w miejscu, w którym dziś powstaje dokument.
Jeśli to stary system ma stać się interfejsem, opisuje to strona Monolit jako usługa webowa.
Czy tworzą i integrują Państwo interfejsy API (REST, SOAP)?
Tak. Tworzymy interfejsy i podłączamy systemy, zarówno przez REST i JSON, jak i przez SOAP i XML, łącznie z synchronizacją danych między aplikacjami. Typowe zastosowania opisujemy na stronie Rozwój i integracje.
Kto utrzymuje szablony?
To Państwo decydują. Szablony należą do Państwa i są przechowywane tam, gdzie Państwo wskażą, na przykład razem z kodem we własnym repozytorium. Od Państwa zależy też, czy teksty dopasowuje dział, który z nich korzysta, czy zmiany wprowadza programista.
Utrzymanie i dalszy rozwój przejmujemy na życzenie, tak jak opisuje to strona Przejęcie i utrzymanie.
Co z naszą obecną usługą dokumentów?
Uzupełniamy ją, a nie zastępujemy. Nadal tworzy dokumenty, do których dobrze się nadaje. Nowa usługa przejmuje dokumenty, których treść zależy od zmiennych i reguł. Które rodzaje dokumentów trafią w przyszłości do której usługi, ustalamy wspólnie z Państwem.
Ile trwa przygotowanie pierwszego prototypu?
Powiemy to, gdy zobaczymy Państwa przykładowy dokument. Czas zależy od tego, ile zmiennych, wariantów tekstu i reguł zawiera dokument i ile rodzajów dokumentów do niego należy. Liczba podana z góry byłaby tylko zgadywaniem.
Nakład pracy i przewidywany czas otrzymują Państwo na piśmie po rozmowie i krótkiej analizie.
W jakiej technologii powstaje usługa?
To zależy od Państwa środowiska i od tego, co Państwa dział IT będzie potem w stanie utrzymywać. Jeśli używają Państwo już ColdFusion lub Lucee, budujemy usługę w tej technologii, bo CFML potrafi tworzyć PDF (stan: 2026-10). W Lucee potrzebne jest do tego rozszerzenie PDF. W innym przypadku budujemy ją w PHP, a na życzenie także w Pythonie z FastAPI.
Język, w którym napisany jest Państwa obecny system, nie ma znaczenia dla połączenia, bo usługa jest wywoływana przez interfejs.
Gdzie znajdują się dane?
To Państwo decydują. Usługa działa na Państwa własnej infrastrukturze albo u wybranego przez Państwa dostawcy, a dane pozostają tam, gdzie Państwo to ustalą. Do przykładowego dokumentu i prototypu nie potrzebujemy prawdziwych danych.
Jaka jest Państwa stawka godzinowa?
To zależy od zakresu, modelu współpracy i pilności. Prosimy krótko opisać Państwa sytuację, a po rozmowie otrzymają Państwo ofertę. Nie trzeba przy tym podawać budżetu. Stałe ceny podajemy przy produktach wejściowych.
Jaki dokument ma tworzyć Państwa system?
Wystarczy podać rodzaj dokumentu, system i, jeśli jest znana, technologię. Przykładowy dokument omówimy w rozmowie. Prosimy nie przesyłać przez formularz poufnych materiałów. Odpowiadamy w ciągu jednego dnia roboczego.