Jeden szablon zamiast pięciu

Zapytaj kogokolwiek, kto przygotowuje umowy, ile wersji umowy najmu przechowuje, a odpowiedź nigdy nie brzmi „jedną”. Jest wersja z poręczycielem. Wersja dla najemcy będącego firmą. Wersja z klauzulą o zwierzętach. W dziewięćdziesięciu procentach są identyczne, w ciągu roku się rozjeżdżają, a nikt nie pamięta, które brzmienie punktu 12 jest aktualne.

Od dziś szablon może mieć części, które pojawiają się tylko wtedy, gdy mają zastosowanie.

Oznaczanie bloku we wzorze

W Wordzie otocz warunkową część znacznikami:

{{#if guarantor}}
5. Poręczyciel odpowiada za zobowiązania najemcy.
{{/if}}

Między nimi działa {{else}} dla alternatywnego brzmienia. Aby powtórzyć sekcję raz dla każdej osoby, otocz ją znacznikami {{#each tenants}} i {{/each}}.

Usunięty blok zabiera ze sobą cały akapit i właśnie dlatego numerowane punkty same się przenumerowują: Word robi to, gdy znika akapit, a nie zrobiłby tego, gdybyśmy tylko wyczyścili tekst.

Określanie, kiedy blok obowiązuje

W edytorze szablonu blok dostaje regułę, a reguła to listy rozwijane:

Pole jest wypełnione, jest puste, równa się czemuś, jest większe lub mniejsze niż liczba lub data. To cały język, a jego oszczędność jest celowa. Biuro konfiguruje to raz, a potem musi umieć wyjaśnić, jedenaście miesięcy później, dlaczego w umowie, którą ktoś podpisał, brakuje klauzuli. Zdanie „pole poręczyciela było puste” da się wyjaśnić. Formuły napisanej zeszłej wiosny nie wyjaśni nikt.

Blok bez reguły liczy się jako nieobecny. Literówka w nazwie bloku usuwa więc klauzulę, zamiast po cichu ją zachować, bo brakujący akapit zostanie zauważony, a dodatkowy – nie.

Powtarzanie sekcji

{{#each tenants}} powtarza się dla skanów w danej pozycji. Trzy przesłane dokumenty najemców oznaczają, że blok pojawi się trzy razy, za każdym razem wypełniony z własnego skanu. Jedno przesłanie, trzy bloki podpisów, bez kopiowania i wklejania.

Która wersja utworzyła ten dokument

Druga połowa tego wydania jest cichsza, ale będzie ważniejsza.

Szablony się zmieniają. Do tej pory dokumentu wygenerowanego w marcu nie dało się wyjaśnić we wrześniu: wzór był od tego czasu dwa razy edytowany, a nic tego nie zapisywało. Teraz wszystko, co zmienia wynik, nadaje szablonowi nową wersję, zachowywana jest migawka wzoru, mapowania i warunków, a każdy dokument zapisuje wersję, z której powstał. Jest ona widoczna na liście dokumentów.

Zmiana nazwy szablonu nie zmienia wersji. Dokument nie staje się innym dokumentem dlatego, że ktoś poprawił literówkę w nazwie.

Co dalej

Szósta funkcja to część skierowana na zewnątrz: publiczne API, webhooki, gdy dokument jest gotowy, eksport do Google Drive i nie tylko oraz wysyłanie gotowego dokumentu do podpisu. DocuTract wewnątrz Twojego dotychczasowego procesu, a nie obok niego.

Cała lista jest we wpisie nad czym pracujemy dalej, a opis bloków i wersji krok po kroku – w centrum pomocy.