Bloki warunkowe i wersje szablonu

Jeden szablon zamiast pięciu

Prawdziwa umowa to nie jest stały tekst. Klauzula o poręczycielu pasuje do umowy najmu, w której poręczyciel jest, i nigdzie indziej; sekcja podpisów pojawia się raz dla każdego najemcy. Zamiast utrzymywać pięć niemal identycznych szablonów, oznacz bloki we wzorze i określ, kiedy każdy z nich obowiązuje.

Oznaczanie bloku

W Wordzie otocz warunkowy fragment znacznikami:

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

Między nimi można użyć {{else}} dla sformułowania, które obowiązuje, gdy warunek nie jest spełniony.

Aby powtórzyć sekcję, otocz ją znacznikami {{#each tenants}} i {{/each}}, a w środku użyj {{tenants.full_name}}. Sekcja powtarza się raz dla każdego skanu, po którym przechodzi: na przykład jeden blok podpisu dla paszportu każdego najemcy.

Umieszczaj znaczniki w osobnych wierszach. Cały akapit jest usuwany razem z blokiem, dzięki czemu Word sam przenumeruje punkty.

Sekcja powtarzana to nie to samo co tabela, do której wiersze dodajesz ręcznie (usługi w protokole, towary na fakturze). O takich tabelach przeczytasz w artykule Tabele ze zmienną liczbą wierszy.

Określanie, kiedy blok obowiązuje

W edytorze szablonu sekcja Bloki warunkowe zawiera jedną regułę na blok: nazwę bloku w takiej postaci, jak wpisałeś ją we wzorze, oraz to, co musi być spełnione. Reguła to listy rozwijane, a nie formuła:

• pole jest wypełnione;
• pole jest puste;
• pole równa się jakiejś wartości;
• pole jest większe niż lub jest mniejsze niż liczba lub data.

Dla bloku powtarzanego wybierasz, po których skanach ma się powtarzać.

Blok bez reguły jest traktowany jako nieobecny, więc literówka w nazwie usuwa klauzulę, zamiast po cichu ją dodać. To celowe: brakujący akapit zostanie zauważony, dodatkowy – nie.

Wersje

Wszystko, co zmienia wynik generowania, nadaje szablonowi nową wersję:

• nowy wzór;
• zmienione mapowanie;
• zmieniony warunek.

Zmiana nazwy szablonu tego nie robi.

Każdy dokument zapisuje wersję, z której został utworzony, widoczną na liście dokumentów. To odpowiedź na pytanie „dlaczego ta umowa brzmi inaczej niż ta z zeszłego miesiąca” długo po tym, jak szablon się zmienił.

Wskazówki

• Przetestuj obie gałęzie. Po dodaniu warunku wypełnij jeden dokument, w którym jest spełniony, i jeden, w którym nie jest, i przeczytaj oba.
• Nazywaj bloki według ich znaczenia. guarantor czy vat_payer czyta się na liście reguł lepiej niż block1.