SetTemplate

Zastosowanie

Funkcja SetTemplate ustawia szablon dokumentu dla wskazanego pola typu dokument (załącznik) w formularzu bieżącej sprawy. Szablon wskazujesz nazwą szablonu dostępnego na bieżącym etapie sprawy.

Efekt działania

Pole typu dokument w formularzu ma ustawiony wskazany szablon dokumentu.

Zmiana szablonu jest tymczasowym efektem interfejsu. Nie zapisuje się w bazie danych i może zmienić się po odświeżeniu strony, ponownym otwarciu sprawy albo ponownym przeliczeniu reguł. Jeżeli efekt ma się utrzymywać podczas edycji, używaj funkcji w regule automatycznej, która przelicza się w trakcie pracy z formularzem.

Składnia

SetTemplate("fieldName", "templateName");

Argumenty

Argument	Typ	Wymagany	Opis
fieldName	tekst	Tak	Nazwa pola.
templateName	tekst	Tak	Nazwa szablonu, który chcesz ustawić dla pola. Wielkość liter nie ma znaczenia.

Zwracana wartość

Funkcja zwraca wartość logiczną: true, jeżeli szablon został ustawiony dla pola, albo false, jeżeli nie znalazła pola lub szablonu.

Przykłady

Przykład 1: szablon dla pola

Funkcja ustawia szablon template.docx dla pola UploadField.

SetTemplate("UploadField", "template.docx");

Dobre praktyki

• Podawaj nazwę pola i nazwę szablonu dokładnie tak, jak w konfiguracji procesu.
• Sprawdzaj wynik funkcji, jeżeli dalsza część reguły zależy od ustawionego szablonu.

Typowe błędy

• Nazwa pola, które nie istnieje. Jeżeli nazwa jest wpisana wprost, walidacja reguły zgłosi nieistniejące pole. Jeżeli nazwa pochodzi ze zmiennej, funkcja zwróci false, a szablon nie zostanie ustawiony. Sprawdź nazwę pola przed wywołaniem funkcji.
• Nazwa szablonu, który nie istnieje albo nie jest dostępny na bieżącym etapie. Funkcja zwróci false, a szablon nie zostanie ustawiony. Sprawdź nazwę szablonu w konfiguracji etapu.

Powiązane funkcje

• SetAttachmentFieldSettings