Dodawanie pól obliczeniowych do formularza

Aplikacja Adobe Acrobat Sign umożliwia bieżącą aktualizację pól w dokumencie (umowie) w oparciu o dane wprowadzone przez sygnatariusza w trakcie procesu podpisywania dokumentu. Można to zrobić za pomocą pól obliczeniowych. Możesz wykorzystać pola obliczeniowe, aby w ramach dokumentu (albo szablonu dokumentu) ustanowić reguły, zanim dokument zostanie wysłany do podpisania. Reguły te są przetwarzane, kiedy dokument trafia do sygnatariusza i wówczas dokument ten jest na bieżąco aktualizowany w oparciu o treść (wartości) w poszczególnych polach.

Pola obliczeniowe mogą być definiowane w dokumentach przy użyciu dowolnego z następujących mechanizmów:

• środowisko tworzenia formularzy Acrobat Sign,
• znaczniki tekstowe Acrobat Sign (więcej informacji można znaleźć w sekcji Dokumentacja znaczników tekstowych),
• pola formularzy Adobe Acrobat PDF (więcej informacji można znaleźć w sekcji Tworzenie formularzy w programie Acrobat – karta informacyjna).

Przykłady wykorzystania pól obliczeniowych

Pola obliczeniowe mogą być wykorzystywane wszędzie tam, gdzie zachodzi potrzeba bieżącej aktualizacji dokumentu w trakcie procesu jego podpisywania. Poniżej przedstawiono kilka przykładów, w jaki sposób można wykorzystać pola obliczeniowe. Niniejsze przykłady mają wyłącznie charakter informacyjny.

1. Tworzenie formularza zamówienia – pola obliczeniowe mogą być użyte przy tworzeniu formularza zamówienia, gdzie sygnatariusz dokonuje wyboru z listy dostępnych elementów oraz określa zamawianą ilość. Wybranie pozycji z listy automatycznie aktualizuje formularz, wprowadzając cenę zaznaczonego elementu. Wprowadzona przez sygnatariusza zamawiana ilość powoduje z kolei automatyczne obliczenie całkowitej należności za zamówione elementy. Formularz może również dokonywać dodatkowych obliczeń, na przykład wartości należnego podatku lub kwoty upustów w oparciu o obowiązujące reguły w tym względzie.

2. Automatyczne wypełnianie terminu zakończenia obowiązywania umowy – dla umów, w przypadku których klienci mogą wybrać okres obowiązywania umowy w czasie jej podpisywania (6 miesięcy, 12 miesięcy, 24 miesiące itd.), pole obliczeniowe może być użyte, aby automatycznie wprowadzić datę zakończenia umowy na podstawie wyboru dokonanego przez klienta przy składaniu podpisu.

3. Formularze rejestracji z wieloma opcjami do wyboru – pola obliczeniowe mogą zostać użyte do tworzenia formularzy rejestracji (np. członkostwa w organizacji), w których osoba podpisująca formularz może dokonywać wyboru spośród dostępnych opcji. Wybory dokonywane przez sygnatariusza mogą wprowadzać zmiany w innych aktywnych polach formularza, określających warunki umowy, takie jak czas jej obowiązywania, a także całkowity koszt.

Podstawowe informacje o polach obliczeniowych

Pole obliczeniowe można przypisać do każdego pola formularza, pola wyboru czy przycisku opcji w formularzu Acrobat Sign. W czasie podpisywania dokumentu sygnatariusz nie może bezpośrednio wprowadzić wartości do pola, które zostało określone jako obliczeniowe, wartość w tym polu jest automatycznie obliczana w oparciu o reguły zdefiniowane w formularzu.

Definicja pola obliczeniowego składa się z dwóch części: wyrażenia i formatu.

Pola obliczeniowe można definiować za pomocą znaczników tekstowych Acrobat Sign, używając aplikacji internetowej Acrobat Sign, albo za pomocą pól formularzy PDF. W przypadku korzystania ze znaczników Acrobat Sign albo z pól formularzy PDF do definiowania pól obliczeniowych, wyrażenie będące wzorem obliczenia zostaje zdefiniowane przy użyciu dyrektywy o nazwie „calc”. Formatowanie pola obliczeniowego można określić za pomocą dyrektywy o nazwie „format”.

Przykład

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

Przykład ten ilustruje zastosowanie znaczników tekstowych do zdefiniowania w dokumencie pola o nazwie „someCalculatedField”. Pole to jest przypisane do odbiorcy identyfikowanego jako signer1. Wartość w tym polu jest obliczana na podstawie wzoru określonego parametrem „someExpn”. Typ obliczonej wartości określa parametr „formatType”, a formatowanie ustalone jest w oparciu o format zdefiniowany jako „someFormat”.

Środowisko tworzenia dokumentu w aplikacji internetowej Acrobat Sign zawiera w pełni funkcjonalny kreator wyrażeń, pozwalający definiować wzory dla pól obliczeniowych. Patrz Używanie kreatora wyrażeń do definiowania pól obliczeniowych, aby uzyskać więcej szczegółowych informacji odnośnie tworzenia wyrażeń.

Wyrażenia pól obliczeniowych

Wyrażenie definiuje wzór (regułę), na podstawie której zostanie obliczona wartość pola obliczeniowego. Wyrażenie może zawierać co najmniej jeden z następujących elementów:

Obsługiwane operatory

W polach obliczeniowych obsługiwane są następujące operatory.

Obsługiwane funkcje

Przy określaniu wyrażeń w ramach pól obliczeniowych obsługiwane są następujące funkcje.

Dopuszczalne wartości dla części dat

Następujące wartości mogą być używane w ramach funkcji odnoszących się do daty, kiedy określana jest ta część daty, w oparciu o którą ma działać dana funkcja.

Formatowanie pól obliczeniowych

Oprócz definiowania wyrażeń dla pól obliczeniowych można również formatować uzyskaną wartość. Wartość ta może być sformatowana jako tekst (ustawienie domyślne), jako liczba lub jako data.

Jeśli dyrektywa formatowania jest używana ze znacznikami tekstowymi, to przybiera postać dwóch argumentów: FormatType i Format.

Formatowanie pól obliczeniowych jako liczb

Następujące znaki mogą być użyte do określania formatowania wartości końcowej jako liczby

Formatowania pól obliczeniowych jako dat

Poniższe znaki mogą być użyte do określania formatowania wartości końcowej jako daty.

Przykłady formatowania

Poniższe przykłady pokazują, jak należy formatować daty i liczby pól obliczeniowych.

• Pola obliczeniowe sformatowane jako data:

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

Wartość końcowa wyglądać będzie np. tak: „Maj 22, 2016”.

• Pola obliczeniowe sformatowane jako liczby.

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

Wartość końcowa będzie wyglądać np. tak: „$ 1,987.65”.

Używanie Kreatora wyrażeń do definiowania pól obliczeniowych

Pola obliczeniowe można zdefiniować za pomocą środowiska tworzenia dokumentu Acrobat Sign. Jeśli pracujesz w tym środowisku, poniżej opisano kolejne kroki definiowania pól obliczeniowych.

1. Przeciągnij i upuść pole w obrębie dokumentu. Kliknij dwukrotnie właśnie dodane pole, aby otworzyć okno dialogowe właściwości pola. Odpowiednio nazwij to pole. Zmień atrybut Typ wartości, używając listy rozwijanej dla typu Obliczone wartości. Oznacza to, że wartość pola będzie ustalana w oparciu o obliczenie dokonane podczas podpisywania dokumentu.

2. Wpisz wyrażenie obliczeniowe w polu tekstowym o nazwie Wzór lub kliknij przycisk funkcji (fx), aby otworzyć Kreatora wyrażeń.

3. Użyj Kreatora wyrażeń do zdefiniowania wyrażenia dla pola obliczeniowego (patrz ilustracja poniżej). Obszar wyrażenie znajdujący się na górze pokazuje wzór, który używany jest do obliczenia wartości pola. Możesz wpisać formułę w obszarze wyrażenia lub użyć środowiska tworzenia dokumentu w celu utworzenia wzoru. Kreator wyrażeń zawiera listę wszystkich dostępnych Funkcji, listę utworzonych w dokumencie Pól formularza oraz listę obsługiwanych Operatorów, co pomaga tworzyć wyrażenia. Możesz dodać Pole albo Funkcję do wzoru, klikając dwukrotnie dany element w obszarze listy Kreatora wyrażeń. Możesz także dodawać Operatory do wyrażenia, klikając żądany operator na Liście operatorów.

4. Po zakończeniu definiowania wyrażenia możesz sprawdzić jego składnię, klikając przycisk Sprawdź składnię, a następnie zapisując zmiany.

5. Ustaw typ pól obliczeniowych, używając listy rozwijanej Wyświetl jako.

6. Jeżeli pole Wyświetl jako to data albo liczba, ustaw wartość tego pola na Format daty/liczby, korzystając z listy rozwijanej. Można również wybrać opcję Własne formatowanie, aby zdefiniować własne formatowanie dla tego pola.

Pola obliczeniowe w formacie waluty

W formacie Waluta dla pola obliczeniowego jest wstawiany symbol waluty przed obliczoną wartością. (W przeciwnym razie obliczenie jest prostą matematyką, zgodnie ze wzorem).

Wstawiany symbol jest oparty na następujących regułach:     

• Jeśli pola źródłowe zawierają walidację Waluty dla USA, symbol wyświetlany jest w dolarach amerykańskich: $
• Jeśli pola źródłowe zawierają walidację Waluty dla Wielkiej Brytanii, symbol wyświetlany jest w funtach szterlingach: £

Aby formatowanie Waluty działało, pole obliczeniowe musi być skonfigurowane z następującymi parametrami:

• wartość Wyświetl jako ustawiona na Liczba
  
• wartość Format liczby ustawiona na Waluta
  

Pola źródłowe używane w obliczeniach mogą mieć zweryfikowaną wartość Liczba lub Waluta:

Przykłady pól obliczeniowych

• {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
  • Pole w dokumencie przypisane do pierwszego z sygnatariuszy, które zostanie wyświetlone tylko wówczas, gdy inne pole (pole wyboru) o nazwie „sameAs” pozostanie niezaznaczone. Wartość tego pola jest automatycznie uzupełniana wartością pola „billingState” (Status rozliczenia), którą sygnatariusz wprowadził do dokumentu.
• {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
  • Pole w dokumencie przypisane do pierwszego sygnatariusza. Jego wartość zostaje automatycznie wyliczona na podstawie wartości w polach „q1” i „pr1”. Uzyskana wartość jest formatowana jako wartość walutowa i zostaje wyświetlona z symbolem dolara ($) poprzedzającym kwotę obliczoną z dokładnością do dwóch miejsc po przecinku. Uzyskana wartość jest ponadto wyrównywana w ramach pola do prawej.
• price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
  • Pole w dokumencie, nazwane „price” (cena), którego wartość zostaje obliczona na podstawie wartości wybranej przez sygnatariusza w innym polu dokumentu, nazwanym „pn1”. W tym przykładzie, jeżeli pole „pn1” równa się W1, to wartość wyświetlana w polu „price” wynosi 9,99, a jeżeli pole „pn1” równa się W2, to wartość wyświetlana w polu „price” wynosi 5,99 i tak dalej. Jeżeli żadna z wartości nie odpowiada wartości w polu „pn1”, to wartość wyświetlana w polu „price” wynosi 0. Korzystając z tego mechanizmu, pola obliczeniowe mogą być używane, aby automatycznie uzupełniać cenę w oparciu o wybór, jakiego dokonał sygnatariusz w ramach procesu podpisywania dokumentu.