Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim...

33
Adobe Sign Tworzenie formularzy za pomocą znaczników tekstowych karta informacyjna

Transcript of Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim...

Page 1: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Tworzenie formularzy za pomocą znaczników tekstowych — karta informacyjna

Page 2: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

© 2017 Adobe Systems Incorporated. All rights reserved.

Ostatnia aktualizacja: 15 marca 2017 r.

Page 3: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

3

Zawartość Overview ................................................................................................................................... 5

Text Tags Quick Start Guide ....................................................................................................... 6 Text Tag Examples ..............................................................................................................................6

Signature and Initials Fields ....................................................................................................................... 6 Recipient Role Fields ................................................................................................................................. 6 Prefill Fields ............................................................................................................................................... 7 Text Fields .................................................................................................................................................. 7 Read-only Fields ........................................................................................................................................ 7 Checkboxes ................................................................................................................................................ 7 Radio Buttons ............................................................................................................................................ 7 Field Validation .......................................................................................................................................... 7 Conditional Rules ....................................................................................................................................... 7 Calculated Fields ........................................................................................................................................ 8

Conversion of Text Tags to Form Fields ...............................................................................................8 Field Length and Formatting ..................................................................................................................... 8 Interacting with Form Fields During Signing ............................................................................................. 8 Form Fields in the Signed document ......................................................................................................... 9

Long Text Tags ....................................................................................................................................9

Text Tags Deep Dive ................................................................................................................ 10 Text Tag Syntax ................................................................................................................................ 10 Controlling Field Interactions During Signing ..................................................................................... 12

Assigning Form Field to Specific Signers ................................................................................................. 12 Sender Prefills Data ................................................................................................................................. 12 Unassigned Fields .................................................................................................................................... 11

Basic Adobe Sign Field Types............................................................................................................. 11 Signature and Initials Fields ..................................................................................................................... 11 Special Adobe Sign Fields ........................................................................................................................ 11 Special Read-only Fields .......................................................................................................................... 12 Signature Block ........................................................................................................................................ 12 Text Fields ................................................................................................................................................ 12

Defining Required / Optional Fields .................................................................................................. 13 Editable / Read-Only Fields ............................................................................................................... 13

Advanced Document Processing with Text Tags ....................................................................... 15 Additional Field Types ...................................................................................................................... 15

Checkboxes .............................................................................................................................................. 15 Radio Buttons .......................................................................................................................................... 16 Multi-line Text Fields ............................................................................................................................... 17 Drop-down Lists ...................................................................................................................................... 17 Supporting Documents (File Attachments) ............................................................................................. 18 Hyperlinks ................................................................................................................................................ 19 Participant Stamps and Transaction IDs .................................................................................................. 19

Page 4: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

4

Digital Signatures ..................................................................................................................................... 20 Specifying Default Value ................................................................................................................... 20 Specifying Tooltip ............................................................................................................................. 20 Specifying Font Appearance .............................................................................................................. 21 Specifying Field Alignment ................................................................................................................ 21 Specifying Repeat Fields ................................................................................................................... 21 Specifying Data Validation Rules ....................................................................................................... 21

Supported Field Validation Rules ............................................................................................................ 21 Masking Sensitive Data ..................................................................................................................... 23 Specifying Conditional Rules for Fields .............................................................................................. 24 Specifying Calculation Formulas For Fields ........................................................................................ 26 Shortening Text Tags ........................................................................................................................ 26

Removing Pages From Output................................................................................................................. 27 Advanced Text Tags Examples ........................................................................................................... 28

Checkboxes .............................................................................................................................................. 28 Radio Buttons .......................................................................................................................................... 28 Drop-down List ........................................................................................................................................ 28 Field Validation ........................................................................................................................................ 28 Shortening Text Tags ............................................................................................................................... 28 Conditional Rules ..................................................................................................................................... 29 Calculated Fields ...................................................................................................................................... 30

Page 5: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

5

Omówienie Znaczniki tekstowe Adobe Sign to specjalnie sformatowany tekst, który można umieścić w dowolnym miejscu tworzonego dokumentu, określając lokalizację, rozmiar i typ pola, mogą to być na przykład pola podpisu lub inicjału, pola wyboru, przyciski opcji i pola formularza, a także zaawansowane reguły postępowania z polami opcjonalnymi. Znaczników tekstowych można także używać podczas tworzenia dokumentów PDF z polami formularza. Zobacz Tworzenie formularzy w programie Acrobat – karta informacyjna.

Znaczniki tekstowe są konwertowane na pola formularza Adobe Sign wówczas, kiedy dokument zostaje przesłany lub wysłany do podpisania. Znaczniki tekstowe Adobe Sign można umieścić w dokumentach dowolnego typu, takich jak PDF, Microsoft Word, PowerPoint, Excel oraz pliki tekstowe (.txt, .rtf).

Na przykład:

{{Sig_es_:signer1:signature}} Pole podpisu cyfrowego przypisane do odbiorcy identyfikowanego jako signer1 {{Cmpy_es_:signer2:company}} Pole nazwy firmy odbiorcy identyfikowanego jako signer2.

{{address_es_:signer1}} Pole dla odbiorcy identyfikowanego jako signer1 przeznaczone do wprowadzenia adresu {{*city_es_:signer1}} Pole wymagane dla odbiorcy identyfikowanego jako signer1 przeznaczone do wprowadzenia miasta tego odbiorcy.

{{!price}} Pole tylko do odczytu. Odbiorcy nie mogą zmienić wartości w tym polu.

Znaczniki tekstowe Adobe Sign to potężny mechanizm pozwalający tworzyć szablony dokumentów, które umożliwiają pozycjonowanie pól podpisu i inicjałów, gromadzenie danych pochodzących od różnych nadawców w ramach jednej umowy, definiowanie reguł weryfikacji zgromadzonych danych i dodawanie warunków ich akceptacji. Jeśli dokument jest poprawnie skonfigurowany ze znacznikami tekstowymi, wówczas może on służyć jako szablon przy wysyłaniu dokumentów do podpisu i zagwarantować, że dane zgromadzone w ramach umów są spójne oraz ważne w skali całej organizacji.

Uwaga! W zależności od wybranej opcji dostępne są możliwości i funkcje specyficzne dla kont Adobe Sign – Business, Adobe Sign – Enterprise, albo dla obu planów.

Page 6: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

6

Skrócona instrukcja obsługi znaczników tekstowych

Przykłady znaczników tekstowych We wszystkich poniższych przykładach założono, że znaczniki tekstowe znajdują się w treści dokumentu. W przypadku używania znaczników jako nazw pól formularza dokumentu PDF, należy pominąć zarówno początkowe oznaczenie „{{”, jak i końcowe „}}”.

Pola podpisu i inicjałów

{{Sig_es_:signer1:signature}} Pole podpisu cyfrowego przypisane do odbiorcy identyfikowanego jako signer1.

{{Int_es_:signer1:initials}} Pole inicjałów przypisane do odbiorcy identyfikowanego j k i {{SigB_es_:signer1:signatureblock}} Blok podpisu cyfrowego przypisany do odbiorcy identyfikowanego jako signer1.

{{OSig_es_:signer1:optsignature}} Opcjonalne pole podpisu cyfrowego przypisane do odbiorcy identyfikowanego jako signer1.

{{OInt_es_:signer1:optinitials}} Opcjonalne pole inicjałów przypisane do odbiorcy identyfikowanego jako signer1.

Pola roli odbiorcy

Pola sygnatariusza oraz nadawcy służą do określenia roli odbiorcy dla danej umowy.

Pole sygnatariusza

Rola „sygnatariusza” określa pierwszego z odbiorców (osobę podpisującą lub zatwierdzającą), która nie jest osobą wysyłającą (nadawcą). Rola „signer1” określa w każdym przypadku pierwszego odbiorcę. Odbiorca identyfikowany jako „signer1” może być również nadawcą, jeżeli wcześniej był osobą podpisującą lub zatwierdzającą umowę.

{{Cmpy_es_:signer1:company}} Pole dla odbiorcy identyfikowanego jako signer1, przeznaczone do wprowadzenia nazwy firmy tego

{{N_es_:signer2:fullname}} Pole tylko do odczytu dla odbiorcy identyfikowanego jako signer2, przeznaczone do wprowadzenia pełnego

{{Dte_es_:signer1:date}} Pole tylko do odczytu zawierające datę podpisu.

{{Em_es_:signer1:email}} Pole tylko do odczytu zawierające adres e-mail s gnatari s a

Uwaga! Zamiast korzystać z ról nadawcy „sender” i sygnatariusza „signer”, w ramach innej metody można korzystać wyłącznie z ról takich jak „signer1”, „signer2”, „signer3” itd. Wysyłając dokument, upewnij się, że wszyscy uczestnicy są dodawani w poprawnej kolejności.

Page 7: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

7

Pole nadawcy

Rola nadawcy „sender” może być używana tylko w przypadku, gdy podczas przesyłania dokumentu wybrano opcję „Muszę złożyć podpis jako pierwszy/ostatni”. Rola nadawcy „sender” zawsze określa pole przypisane do nadawcy, niezależnie od tego czy nadawca podpisuje się jako pierwszy czy jako ostatni.

{{*Ttl_es_:sender:title}} Pole wymagane dla nadawcy, przeznaczone do wprowadzenia stanowiska nadawcy

Uwaga! Zamiast korzystać z ról nadawcy „sender” i sygnatariusza „signer”, w ramach innej metody można korzystać wyłącznie z ról takich jak „signer1”, „signer2”, „signer3” itd. Wysyłając dokument, upewnij się, że wszyscy odbiorcy są dodawani w poprawnej kolejności.

Wstępne wypełnianie pól

{{price_es_:prefill}} Pole, które wypełnia nadawca przed wysłaniem dokumentu.

Pola tekstowe

{{address_es_:signer1}} Opcjonalne pole dla odbiorcy identyfikowanego jako signer1, przeznaczone do wprowadzenia adresu tego

{{*city_es_:signer1}} Pole wymagane dla odbiorcy identyfikowanego jako signer1 przeznaczone do wprowadzenia miasta tego

Pola tylko do odczytu

{{!price}} Pole tylko do odczytu. Sygnatariusze nie mogą zmieniać tej ś i

Pola wyboru

{{[]}} Pole wyboru. {{[x]}} Pole wyboru, domyślnie zaznaczone.

Przyciski opcji

{{(Red)Color}} Przycisk opcji, który po wybraniu ma wartość „Red”,

Weryfikacja pola

{{*Mobile_es_:signer1:phone}} Obowiązkowe pole telefonu umożliwiające wprowadzenie t l f f i k ń ki {{d_es_:signer1:num(>0,<60)}} Opcjonalne pole liczbowe umożliwiające wprowadzanie

t ś i d i l d d 6

Reguły warunkowe

{{field_es_:showif(price>60)}} Pole, które zostaje wyświetlone, jeżeli cena „price” ma t ść i k iż 6

Page 8: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

8

Pola obliczeniowe

{{TV_es_:calc([SubTotal]+[Tax])}} Pole, którego wartość jest obliczana automatycznie poprzez dodanie wartości w polach „SubTotal” (suma

Konwersja znaczników tekstowych na pola formularza

Długość i formatowanie pola

Podczas korzystania ze znaczników tekstowych w edytowalnym dokumencie Adobe Sign wyświetla prostokąt zakrywający cały obszar znacznika tekstowego (od oznaczenia początkowego „{{” do oznaczenia końcowego „}}”) i dokonuje konwersji znacznika tekstowego na odpowiednie pole formularza Adobe Sign.

Długość pola formularza można zwiększyć, dodając znaki spacji na początku znacznika tekstowego, tuż za oznaczeniem „{{”, lub na końcu znacznika tekstowego, tuż przed oznaczeniem „}}”. Zmniejszenie rozmiaru pola formularza można osiągnąć poprzez zmniejszenie rozmiaru czcionki w znaczniku tekstowym, aż do uzyskania odpowiedniej długości pola.

Formatowanie pola formularza (rozmiar czcionki, rodzaj, kolor itp.) zależy od formatu pierwszego oznaczenia „{”. Aby zapewnić poprawne odczytywanie znaczników tekstowych w aplikacji Adobe Sign, znaczniki te powinny być zdefiniowane z użyciem czcionek powszechnie występujących w treści dokumentu (Helvetica, Times, Arial, Verdana lub Courier). Definicje znaczników tekstowych uwzględniają wielkość liter i należy je wprowadzać wyłącznie małymi literami.

Poniższa ilustracja przedstawia znaczniki tekstowe umieszczone w dokumencie Microsoft Word.

Cały znacznik tekstowy, od początkowego nawiasu klamrowego do końcowego nawiasu klamrowego, musi zmieścić się w jednym wierszu. Jeżeli znacznik tekstowy rozciąga się na wiele wierszy, czy to w dokumencie źródłowym czy też w pliku PDF, pole formularza nie zostanie poprawnie odczytane przez Adobe Sign, co może spowodować, że zasłonięty tekst będzie widoczny dla sygnatariusza podczas podpisywania dokumentu.

W przypadku stosowania w formularzach PDF nawiasy klamrowe nie powinny być umieszczane w nazwach pól formularza PDF, rozmiar tych pól jest określany przez rozmiar pól formularza PDF, a formatowanie danych wprowadzanych do tych pól jest określane przez właściwości odpowiednich pól formularza PDF.

Pojedynczy dokument nie może zawierać jednocześnie pól formularza PDF i pól zdefiniowanych poprzez zastosowanie znaczników tekstowych.

Interakcje z polami formularza podczas czynności podpisywania

Powyższe znaczniki tekstowe są konwertowane na następujące pola do wypełnienia podczas czynności podpisywania:

Page 9: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

9

Pola formularza w podpisanym dokumencie

Po scaleniu danych w ramach podpisanego dokumentu, w podpisanym dokumencie PDF pojawią się następujące elementy:

Długie znaczniki tekstowe W przypadku stosowania w edytowalnych dokumentach, znaczniki tekstowe zawierające wiele dyrektyw mogą być bardzo długie, co sprawi, że wyznaczenie mniejszych pól w dokumencie okaże się trudne. Adobe Sign oferuje prosty mechanizm pozwalający określić krótsze znaczniki w dokumencie.

Na przykład, jeśli potrzebujesz wprowadzić wymagane pole numeru telefonicznego nadawcy, zamiast wprowadzać pełen tekst znacznika {{*Mobile_es_:signer1:phone}} możesz użyć krótszego znacznika {{$mob }} w odpowiednim miejscu w dokumencie, z odstępami, w celu dostosowania wielości pola. Pełną definicję znacznika tekstowego {{#mob=*Mobile_es_:signer1:phone}} można umieścić w innym miejscu

dokumentu. Aby dowiedzieć się więcej na temat skracania znaczników tekstowych,

patrz Skracanie znaczników tekstowych.

Page 10: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

1

Dogłębna analiza znaczników tekstowych

Składnia znaczników tekstowych Znacznik tekstowy Adobe Sign jest zdefiniowany jako:

W ramach podziału poszczególne składniki zdefiniowano następująco: • Wymagane – opcjonalna flaga określająca, czy dane pole jest wymagane i musi być wypełnione przez

sygnatariusza podczas podpisywania. Jeżeli takiej flagi nie ma, oznacza to, że dane pole formularza nie jest wymagane i sygnatariusz może (ale nie musi) wprowadzić do tego pola jakąś wartość podczas podpisywania dokumentu.

• Tylko do odczytu – opcjonalna flaga, która wskazuje, że dane pole jest polem tylko do odczytu. Oznaczenie danego pola jako pola tylko do odczytu daje pewność, że nie zostanie ono przez nikogo zmodyfikowane podczas podpisywania dokumentu. Dane można łączyć w ramach pól tylko do odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania.

• Nazwa pola – unikalna nazwa pozwalająca zidentyfikować to konkretne pole w ramach dokumentu. Nazwa pola jest używana do ustalenia wartości jakie wprowadzono podczas podpisywania, kiedy są eksportowane z usługi.

Uwaga 1! Jeśli dokument ma więcej niż jeden znacznik tekstowy o tej samej nazwie, ale o różnych dyrektywach, lub jeśli te dyrektywy podano w innej kolejności dla każdego ze znaczników o takiej samej nazwie aplikacja Adobe Sign automatycznie dodaje oznaczenie „efield” + niepowtarzalny numer + znak „_” na początku nazwy. Na przykład, jeżeli w tym samym dokumencie znajdują się dwa pola o nazwie „adres”, wówczas Adobe Sign zmienia nazwę jednego z tych pól na „efield2_adres”.

• Identyfikator ES – specyficzny ciąg znaków „_es_”, który musi być wprowadzony po nazwie pola w znaczniku tekstowym po to, aby aplikacja Adobe Sign mogła wykonywać określone funkcje. Jeżeli po nazwie pola nie ma identyfikatora Adobe Sign, wówczas pole formularza zostaje dodane do dokumentu bez żadnych dyrektyw.

• Dyrektywa – jedna lub więcej definicji, zaczynających się od dwukropka („:”), które określają rolę, typ pola oraz dodatkowe reguły przetwarzania wprowadzonej treści, definiując jej dopuszczalne rodzaje. Dyrektywy można definiować w dowolnej kolejności.

o Rola – uczestnik, z którym powiązane jest dane pole (np. nadawca, sygnatariusz). o Typ pola – typ pola formularza Adobe Sign (np. pole podpisu, inicjałów, pole wyboru lub pole tekstowe).

*!Address_es_:signer1:signature

(<Required>)(<ReadOnly>)<Field Name><ES Identifier><:Role><:Field Type>(:Rules)

Uwaga 2! Jeśli w dokumencie istnieją dwa znaczniki tekstowe z taką samą nazwą pola i takimi samymi dyrektywami ułożonymi w tej samej kolejności w dokumencie, pola te traktowane będą jako klony. Dane wprowadzane do jednego z tych pól są automatycznie kopiowane do drugiego pola które znajduje się w innym miejscu dokumentu

Page 11: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

1

o Reguły – reguły zaawansowanego przetwarzania, takie jak weryfikacja danych, logika wyświetlania (lub ukrywania) danych w oparciu o określone kryteria itp.

Page 12: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

10

Kontrolowanie interakcji z polami podczas podpisywania dokumentu Pola formularza w dokumencie mogą zostać przypisane do określonego sygnatariusza w ramach obiegu podpisywania. Adobe Sign gwarantuje, że dany sygnatariusz ma jedynie dostęp do tych pól, które zostały mu przydzielone w procesie podpisywania. Pola formularza mogą zostać przydzielone konkretnym sygnatariuszom poprzez dodanie odpowiednich dyrektyw w znaczniku tekstowym.

Przydzielanie pola formularza określonym sygnatariuszom

Adobe Sign obsługuje następujące dyrektywy w zakresie przydzielania pola formularza określonym sygnatariuszom.

{{Field2_es_:signer1}} Pole w umowie, które jest przydzielone pierwszej osobie nie będącej nadawcą umowy.

{{Field3_es_:signer1}} {{Field4_es_:signer2}}

Jeżeli umowa wymaga podpisów więcej niż jednej osoby, a każdy z sygnatariuszy musi podczas podpisywania podać określone dane, pola w umowie mogą zostać przydzielone konkretnym sygnatariuszom, używając dyrektywy signer<x>, gdzie <x> wyznacza kolejność w jakiej sygnatariusze podpiszą umowę. Pola oznaczone dyrektywą signer1 są przydzielone pierwszemu z sygnatariuszy, zaś pola oznaczone dyrektywą signer2 są przydzielone drugiemu z sygnatariuszy itd. Adobe Sign gwarantuje, że sygnatariusz ma dostęp jedynie do tych pół, które zostały mu przydzielone. Jeśli nadawca umowy, w ramach procesu składania podpisów,

d i j i j k i tki l i ”

Nadawca wstępnie wprowadza dane

W niektórych przypadkach nie jest wymagane, aby nadawca podpisał umowę, natomiast jego zadaniem jest wprowadzenie danych przed wysłaniem umowy do podpisania. Można tego dokonać, dodając dyrektywę „prefill” (wstępnie wypełnij) do odpowiednich pól formularza w umowie. Adobe Sign umożliwia nadawcy wypełnienie tych pól przed wysłaniem umowy do podpisania.

{{Field5_es_:prefill}} Pole w umowie wymagające wypełnienia przez nadawcę, zanim zostanie ona wysłana do podpisania.

Uwaga! Wstępne wypełnianie jest domyślnie włączone dla dokumentów wysyłanych do biblioteki dokumentów Adobe Sign. Wstępne wypełnianie można również włączyć aktywując opcję „Wyświetl podgląd i dodaj pola podpisu” podczas wysyłania dokumentu. Aby ustawić dyrektywę „prefill” (wstępnie wypełnij) dla wszystkich umów wysyłanych ze strony Wyślij, niezależnie od tego czy włączona jest opcja Podgląd, skontaktuj się z działem pomocy technicznej firmy Adobe.

Page 13: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

11

Nieprzypisane pola

Podczas podpisywania którykolwiek z sygnatariuszy może wypełnić pole, które nie zawiera dyrektywy przypisującej to pole do konkretnego odbiorcy. Po wypełnieniu pola zostaje ono zablokowane, aby zapobiec możliwości zmiany wpisanej wartości przez kolejnych sygnatariuszy.

{{Address}} Pole w umowie, które może być wypełnione przez dowolnego sygnatariusza {{zip_es_:zip4}} Pole w umowie dla dowolnego z sygnatariuszy, przeznaczone do wprowadzenia kodu pocztowego, który podlega weryfikacji

Podstawowe typy pól Adobe Sign W dokumencie można utworzyć różne typy pól, wprowadzając określone dyrektywy w ramach znaczników tekstowych. Podczas podpisywania dokumentu aplikacja Adobe Sign interpretuje znaczniki i konwertuje je na odpowiednie pola formularza. Wszystkie typy pól, które można dodać do dokumentu za pośrednictwem internetowej aplikacji Adobe Sign, można również określić za pomocą znaczników tekstowych.

Pola podpisu i inicjałów

Można zamieścić pola podpisu lub inicjałów Adobe Sign w konkretnych miejscach dokumentu, dodając dyrektywę, która przydziela odpowiedni typ do pola podpisu. Domyślnie pola podpisu i inicjałów są wymagane. Jednak niektóre dokumenty mogą wymagać, aby sygnatariusz opcjonalnie podpisał dokument także w innych, dodatkowych miejscach. Takie miejsca opcjonalnych podpisów lub inicjałów można również zdefiniować w dokumencie przy użyciu znaczników tekstowych.

Uwaga! Aplikacja Adobe Sign wymaga, aby dokument zawierał co najmniej jedno pole podpisu dla każdego z sygnatariuszy. Osoby zatwierdzające dokument nie muszą mieć przydzielonych pól podpisu w dokumencie podczas jego podpisywania.

{{Sig1_es_:sender:signature}} Wymagane pole podpisu przypisane do nadawcy.

{{Int1_es_:signer1:initials}} Wymagane pole inicjałów przypisane do odbiorcy identyfikowanego jako signer1 {{OSig1_es_:signer2:optsignature}} Opcjonalne pole podpisu cyfrowego przypisane do odbiorcy id t fik j k i {{OInt1_es_:signer1:optinitials}} Opcjonalne pole inicjałów przypisane do odbiorcy identyfikowanego jako signer1

Specjalne pola Adobe Sign

Aplikacja Adobe Sign udostępnia specjalne pola, które można umieścić w dokumencie, aby zgromadzić informacje o sygnatariuszu, takie jak zajmowane stanowisko czy nazwa reprezentowanej firmy. Jeżeli informacje dla tych pól są już dostępne, wówczas aplikacja Adobe Sign automatycznie wypełnia pola w momencie prezentowania ich sygnatariuszowi podczas procesu podpisywania.

{{Ttl1_es_:title}} Pole, w którym należy podać stanowisko sygnatariusza.

{{Cmpy1_es_:company}} Pole, w którym należy podać nazwę firmy sygnatariusza.

Page 14: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

12

Specjalne pola tylko do odczytu

Ponadto aplikacja Adobe Sign obsługuje gromadzenie danych dotyczących daty złożenia podpisu, adresu poczty e-mail, a także imienia i nazwiska sygnatariusza w treści umowy. Te pola są automatycznie wypełnianie przez aplikację Adobe Sign i podczas podpisywania umowy sygnatariusz nie może ich modyfikować.

{{Dte1_es_:date}} Pole automatycznego wprowadzania daty złożenia podpisu.

{{Em1_es_:email}} Pole automatycznego wprowadzania adresu e-mail sygnatariusza. W przypadku korzystania z Widżetów Adobe Sign adres e-mail może być edytowany przez sygnatariusza po podpisaniu takiego Widżetu. W zależności od konfiguracji konta aplikacja Adobe Sign weryfikuje adres e-mail podany przez sygnatariusza przed zakończeniem procedury

{{Name1_es_:fullname}} Pole, w którym należy podać imię i nazwisko sygnatariusza.

Blok podpisu

Jeżeli w dokumencie nie zamieszczono żadnego pola podpisu dla danego sygnatariusza, aplikacja Adobe Sign automatycznie umieści blok podpisu dla tego konkretnego sygnatariusza na dole dokumentu. Domyślnie blok podpisu obejmuje pole podpisu i pole adresu e-mail. Jednak jeśli twój administrator konta lub grupy aktywuje opcję „Wymagaj, aby sygnatariusze podawali swoje stanowisko podczas składania podpisu cyfrowego” albo „Wymagaj, aby sygnatariusze podawali nazwę firmy podczas składania podpisu cyfrowego”, ewentualnie obie te opcje (w Preferencjach dotyczących podpisu), wówczas w bloku podpisu znajdą się również pola stanowiska i/lub nazwy firmy. Ilustracja poniżej przedstawia blok podpisu zawierający wszystkie cztery pola.

Możesz ustawić cały blok podpisu Adobe Sign w dowolnym miejscu dokumentu za pomocą dyrektywy „signatureblock”.

{{SBlk1_es_:signatureblock}} Umiejscawia blok podpisu w określonym miejscu w dokumencie.

Pola tekstowe

Wszystkie pola rozmieszczone w dokumencie, które nie zawierają żadnych dodatkowych dyrektyw definiujących typ pola, są traktowane jako pola tekstowe przeznaczone do wypełnienia.

{{propertyName_es_:signer}} Definiuje edytowalne pole tekstowe o nazwie „propertyName”, znajdujące

Page 15: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

13

Definiowanie pół wymaganych / opcjonalnych W przypadku większości pól można określić, czy ich uzupełnienie ma być wymagane czy opcjonalne. Aplikacja Adobe Sign nie daje sygnatariuszowi możliwości podpisania umowy, jeśli nie zostaną wypełnione wszystkie wymagane pola.

Domyślnie wszystkie pola są opcjonalne, poza następującymi wyjątkami:

• Pola podpisu i inicjałów domyślnie są wymagane, chyba że zostaną zdefiniowane za pomocą znaczników tekstowych „optsignature” lub „optinitials”. Zobacz Pola podpisu i inicjałów, aby uzyskać więcej informacji na temat tych znaczników tekstowych.

• Pola Stanowisko i Nazwa firmy są wymagane, jeżeli z ustawień twojego konta wynika, że wchodzą one w skład bloku podpisu. Zobacz Blok podpisu, aby uzyskać informacje na temat szczególnych ustawień konta.

Pole wymagane jest oznaczone symbolem gwiazdki (*) umieszczonym przed nazwą pola lub poprzez dodanie odpowiedniej dyrektywy w znaczniku tekstowym. Na przykład:

{{*phone_es_:signer1}} {{phone_es_:signer1:required}} {{phone_es_:prefill:required}}

Definiuje wymagane pole tekstowe o nazwie „phone”, które musi zostać wypełnione albo przez sygnatariusza, albo w trakcie wstępnego wypełniania dokumentu.

{{address_es_:signer1}} Definiuje opcjonalne pole o nazwie „address”, które musi być wypełnione przez odbiorcę identyfikowanego jako

Pola wymagane oznaczane są czerwoną gwiazdką po lewej stronie pola.

Pola edytowalne / tylko do odczytu Domyślnie można edytować wszystkie pola, które nie są polami tylko do odczytu. Wyjątek stanowią niektóre specjalne pola dotyczące sygnatariusza (adres e-mail, imię i nazwisko sygnatariusza oraz data podpisu), które domyślnie są polami tylko do odczytu. Zobacz Specjalne pola tylko do odczytu, aby uzyskać więcej informacji.

Pola tylko do odczytu są przydatne, kiedy dokonujemy automatycznego scalenia danych w jeden dokument, używając API Adobe Sign, lub kiedy wykorzystujemy funkcję scalenia danych w ramach MegaSign. Pola tylko do odczytu dają pewność, że w trakcie podpisywania sygnatariusz nie może zmienić scalonych danych.

Dodanie do nazwy pola prefiks wykrzyknikowy (!) lub użycie symbolu dyrektywy tylko do odczytu sprawia, że pole oznaczone jest jako tylko do odczytu.

Page 16: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

14

Na przykład:

{{!price}} {{price_es_:readonly}}

Definiuje pole tekstowe tylko do odczytu jako przeznaczone do wypełnienia w ramach scalenia danych

Page 17: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

15

Zaawansowane przetwarzanie dokumentu ze znacznikami tekstowymi

Dodatkowe typy pól Możesz tworzyć następujące typy pól za pomocą ich własnych, unikatowych znaczników tekstowych:

• Pola wyboru • Przyciski opcji • Wielowierszowe pola tekstowe • Listy rozwijane • Dokumenty pomocnicze (załączniki) • Hiperłącza • Stemple uczestników i identyfikatory transakcji

Pola wyboru

Możesz utworzyć pole wyboru przy użyciu znaczników tekstowych, umieszczając w dokumencie znacznik pola wyboru albo stosując dyrektywę pola wyboru.

{{[]}}{{CB_es_:checkbox}} Pozycjonuje nienazwane pole wyboru w dokumencie.

{{[x]}}{{CB1_es_:checkbox(checked)}} Pozycjonuje nienazwane pole wyboru, które jest w dokumencie domyślnie zaznaczone.

{{[]Comm_es_:signer1}}{{Comm_es_:checkbox:signer1}} Pozycjonuje pole wyboru o nazwie „Comm” przypisane do odbiorcy identyfikowanego jako

{{[]*}}{{CB2_es_:required:checkbox}} Nienazwane wymagane pole wyboru, które musi zostać wypełnione przez odbiorcę identyfikowanego jako signer1. Zobacz Definiowanie pół wymaganych /

{{[]!}}{{CB3_es_:readonly:checkbox}} Nienazwane pole wyboru tylko do odczytu. Zobacz Definiowanie pół wymaganych / opcjonalnych, aby uzyskać więcej

{{CB4_es_:checkbox:label("I agree.")}} Definiuje pole wyboru z etykietą zawierającą przyjazny dla użytkownika opis tego pola wyboru. Etykieta wyświetlana jest sygnatariuszowi tylko podczas podpisywania i w

Page 18: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

16

Przyciski opcji

Znaczników tekstowych można używać do definiowania i pozycjonowania Przycisków opcji w dokumencie. Przyciski opcji muszą mieć co najmniej dwie opcje (dwa wybory) w ramach grupy przycisków opcji, identyfikowanej przez tę samą nazwę pola w dokumencie. Każda opcja (wybór) przycisku opcji musi mieć inną wartość wyboru. Przyciski opcji można definiować za pomocą następującej składni.

{{(option_value)fieldname_es_}} Pozycjonuje przycisk opcji w dokumencie.

{{(Red)Color_es_:signer1}} {{(Blue)Color_es_:signer1}} {{(Green)Color_es_:signer1}}

Definiuje trzy przyciski opcji należące do tej samej grupy o nazwie „Color” (Kolor), przypisanej do odbiorcy identyfikowanego jako signer1. Opcje mają wartości Red

{{Color_es_:signer1:radio(Red)}} {{Color_es_:signer1:radio(Blue)}} {{Color_es_:signer1:radio(Green)}}

Alternatywnym sposobem definiowania grupy przycisków opcji Color (Kolor) jest użycie dyrektywy „radio”.

{{(Red)Color_es_:signer1:label(“Red”)}} {{(Blue)Color_es_:signer1:label(“Blue”)}} {{(Green)Color_es_:signer1:label(“Green”)}}

Definiuje grupę przycisków opcji i nadaje każdemu z przycisków opcji przyjazną dla użytkownika etykietę. Etykieta zostaje wyświetlona sygnatariuszowi podczas

Określanie stylu przycisków opcji

Aplikacja Adobe Sign umożliwia tworzenie przycisków opcji w różnych stylach. Utworzony styl przycisków opcji jest wyświetlany w dokumencie PDF. Jednak podczas podpisywania przyciski opcji są zawsze wyświetlane jako kółka.

Dyrektywa znacznik

Dopuszczalne wartości Przykład

:style okrąg (Styl domyślny, jeśli żaden nie jest określony).

:style(circle) :style(diamond) :style(star) :style(check) :style(cross) :style(square)

romb

gwiazda

zaznaczenie

krzyżyk

kwadrat

Page 19: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

17

Wielowierszowe pola tekstowe

Znaczników tekstowych można użyć do definiowania pól tekstowych, które będą obejmowały wiele wierszy. Podczas podpisywania pola te mogą być używane do zebrania danych zawartych w wielu wierszach w dokumencie.

{{largeField_es_:signer1:multiline}} Definiuje pole o nazwie „largeField”, przypisane do odbiorcy identyfikowanego jako signer1, które podczas podpisywania dokumentu pozwala

{{largeField2_es_:signer1:multiline(4)}} Definiuje pole o nazwie „largeField2”, przypisane do odbiorcy identyfikowanego jako signer1, które podczas podpisywania dokumentu pozwala sygnatariuszowi wprowadzić do pola cztery wiersze danych. Jeśli brak parametru określającego liczbę

Listy rozwijane

Znaczników tekstowych można używać do definiowania i pozycjonowania w dokumencie listy rozwijanej. Listy rozwijane mogą zawierać wiele opcji; użytkownik może wybrać jedną z tych opcji podczas podpisywania dokumentu. Definicja listy rozwijanej składa się z dwóch elementów: unikalnego zestawu opcji, z których odbiorca może wybrać jedną, i opcjonalnie z zestawu wartości, które zostają zwracane podczas eksportowania danych z umowy.

Opcje na listach rozwijanych muszą być unikalne, natomiast wartości na tych listach już takie być nie muszą (np. z wielu rozwijanych opcji może być eksportowana ta sama wartość). Wartości list rozwijanych są opcjonalne. Jeśli nie ma zdefiniowanych wartości list rozwijanych, wówczas rozwijane opcje są zwracane, kiedy dane z umowy zostają wyeksportowane. Jeśli wartości list rozwijanych zostały zdefiniowane, liczba zdefiniowanych wartości musi być równa liczbie opcji. Jeśli liczba opcji nie jest równa liczbie zdefiniowanych wartości, zostanie to rozpoznane jako błąd i pole nie zostanie uznane za listę rozwijaną.

Podczas definiowania domyślnego wyboru dla listy rozwijanej lub definiowania warunków innego pola na podstawie wyboru przez odbiorcę jednej z opcji na rozwijanej liście, należy użyć eksportowanych wartości (nie opcji). Jeśli nie ma zdefiniowanych eksportowanych wartości, należy użyć opcji z listy rozwijanej.

{{*Color_es_:signer1:dropdown(options="Red,Green, Blue”)}}

Pozycjonuje w dokumencie odpowiednią listę rozwijaną. Podczas podpisywania lista umożliwia odbiorcy identyfikowanemu jako signer1 dokonanie wyboru spośród trzech dostępnych opcji. Ta lista rozwijana nie definiuje żadnych wartości do wyeksportowania, w rezultacie wybrana opcja zostaje wyeksportowana ze strony

Page 20: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

18

{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,G,B”)}}

Pozycjonuje w dokumencie listę rozwijaną. Podczas podpisywania lista umożliwia odbiorcy identyfikowanemu jako signer1 dokonanie wyboru spośród trzech dostępnych opcji. W tym przypadku lista rozwijana określa również możliwe wartości do wyeksportowania (R, G, B). W zależności od opcji wybranej przez odbiorcę podczas podpisywania odpowiednia wartość zostaje wyeksportowana z strony Zarządzaj, poprzez API, albo ze strony Raporty. Jeśli na przykład odbiorca

bi j R d” (C ) t

{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,,B”)}}

W tym przykładzie opcje listy rozwijanej są takie same jak w poprzednim przykładzie, lecz jedna z wartości została pominięta. Jeśli podczas podpisywania odbiorca identyfikowany jako signer1 wybierze z rozwijanej listy opcję „Green”

{{Color_es_:signer1:dropdown(options="Red,,Blue”, values=”R,G,B”)}}

W tym przykładzie rozwijana lista daje odbiorcy identyfikowanemu jako signer1 trzy opcje, przy czym druga z opcji jest pusta. Jeśli odbiorca wybierze tę pustą opcję, to zostanie wyeksportowana wartość „G”.

Do definicji pól list rozwijanych można w zależności od potrzeb dodawać dodatkowe dyrektywy, na przykład nadając liście rozwijanej status pola wymaganego, dodając do niej warunki logiczne lub zastrzegając, że opcja wybrana przez odbiorcę pozostanie ukryta w dokumencie PDF.

Dokumenty pomocnicze (pliki załączników)

Adobe Sign może służyć do gromadzenia dokumentów pomocniczych od sygnatariuszy w trakcie procedury podpisywania. W trakcie procedury podpisywania aplikacja Adobe Sign zamienia znacznik tekstowy na pole, które sygnatariusz może wybrać w celu przesłania pliku. Przesłany dokument (dokumenty) zostanie uwzględniony jako część podpisanego dokumentu, przekonwertowany na format PDF i załączony do podpisanej umowy po zakończeniu procesu jej podpisywania. Pola formularza służące do gromadzenia plików przesłanych przez sygnatariusza definiuje się za pomocą dyrektywy „attachment” (załącznik).

{{*DriversLicense_es_:signer1:attachment}} Definiuje wymagane pole o nazwie „DriversLicense” (Prawo jazdy) przypisane do odbiorcy identyfikowanego jako signer1. Odbiorca jest zobligowany, aby podczas

{{photo_es_:signer1:attachment:label("Photo")}} Definiuje opcjonalne pole o nazwie „photo” (zdjęcie) przypisane do odbiorcy identyfikowanego jako signer1. Odbiorca ten podczas podpisywania może wykorzystać to pole, aby przesłać zdjęcie. Można użyć dyrektywy etykiety, aby sformułować przyjazny dla użytkownika opis tego pola. Etykieta

Page 21: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

19

Definiowanie pola załącznika:

Pole załącznika wyświetlane podczas podpisywania:

Hiperłącza

Za pomocą aplikacji Adobe Sign można zamieszczać hiperłącza w dokumentach. Hiperłącza reagujące na kliknięcia podczas procesu podpisywania mogą przenosić odbiorców do dowolnych miejsc w dokumencie lub na zewnętrzne adresy URL. Dla hiperłączy można również utworzyć etykiety, co spowoduje, że w dokumencie zamiast adresu URL wyświetlany będzie tekst etykiety.

Uwaga! Hiperłącza obsługiwane są jedynie przez plany Adobe Sign – Business i Adobe Sign – Enterprise.

{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}} Definiuje hiperłącze prowadzące do zewnętrznego adresu URL. Zawiera też etykietę „Adobe”, która zostanie wyświetlona odbiorcy podczas

{{doclink_es_:link:page(10):label(View this section)}} Definiuje hiperłącze prowadzące do strony 10 w bieżącym dokumencie. Zawiera też etykietę „View this section” (Patrz ten rozdział), która zostanie wyświetlona odbiorcy

Stemple uczestników i identyfikatory transakcji

Stemple uczestnika i Identyfikatory transakcji można dodawać do podpisanych dokumentów PDF przez sygnatariuszy. Indywidualny stempel uczestnika pojawia się po tym, jak dana osoba podpisała lub zatwierdziła dokument. Stempel uczestnika zawiera jego imię i nazwisko, czas złożenia podpisu/zatwierdzenia dokumentu oraz adres e-mail. Identyfikatory transakcji i stemple pojawiają się w ostatecznej wersji podpisanego dokumentu PDF.

Uwaga! Stemple uczestnika i identyfikatory transakcji obsługiwane są jedynie przez plany Adobe Sign – Business i Adobe Sign – Enterprise.

{{userstamp1_es_:signer1:stamp}} Definiuje stempel uczestnika dla odbiorcy identyfikowanego jako signer1. Ten stempel pojawia się w ostatecznej wersji

{{userstamp2_es_:signer2:stamp}} Definiuje stempel uczestnika dla odbiorcy identyfikowanego jako signer2. Ten stempel pojawia się w ostatecznej wersji

{{transstamp2_es_:transactionid}} Definiuje stempel identyfikatora transakcji, który pojawia się w ostatecznej wersji podpisanego dokumentu PDF.

{{userstamp_es_:signer1:stamp:repeat}} {{transstamp1_es_:transactionid:repeat}}

Definiuje stempel, który pojawia się w tym samym miejscu na wszystkich stronach ostatecznej wersji podpisanego

Page 22: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

20

Podpisy cyfrowe

Podpisy cyfrowe można dodawać do dokumentów. Każdy dokument może zawierać tylko jeden podpis cyfrowy na jednego sygnatariusza. W przypadku dodania więcej niż jednego podpisu cyfrowego na jednego sygnatariusza (np.: {{digsig1_:signer1: digitalsignature}} i {{digsig2_:signer1: digitalsignature}}), tylko ten pierwszy zostanie zachowany, a reszta zostanie automatycznie usunięta, kiedy dokument zostanie wysłany do podpisu, chyba że zostaną one usunięte ręcznie w środowisku tworzenia i przeglądania dokumentu jeszcze przed wysłaniem.

Uwaga! Podpisy cyfrowe są obsługiwanie wyłącznie przez plan Adobe Sign – Enterprise.

{{digsig1_es_:signer1:digitalsignature}} Definiuje podpis cyfrowy dla odbiorcy identyfikowanego jako signer1

Ustawianie wartości domyślnej Aplikacja Adobe Sign umożliwia ustawienie domyślnej wartości pola za pomocą znaczników tekstowych. Ustawiona wartość domyślna jest prezentowana uczestnikom podczas podpisywania dokumentu.

Dyrektywa znacznik

Przykład

:default :default("Wartość domyślna ujęta w podwójny cudzysłów") :default('Wartość domyślna ujęta w podwójny cudzysłów')

Jeżeli wartość domyślna zawiera pojedynczy cudzysłów lub apostrof, to musi ona zostać ujęta w podwójny cudzysłów. Na przykład: {{location_es_:signer1:default("Signer's Business")}}. Jeśli podwójne cudzysłowy muszą być użyte w wartości domyślnej, wówczas musi być ona ujęta w pojedynczy cudzysłów.

Formułowanie podpowiedzi Znaczniki tekstowe umożliwiają również formułowanie Podpowiedzi dla pól formularza Adobe Sign. Podpowiedzi są wyświetlane odbiorcom podczas podpisywania.

Dyrektywa znacznik

Przykład

:tooltip :tooltip("Prosimy załączyć kopię swojego prawa jazdy") :tooltip('Wybierz kolor')

Page 23: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

20

Określenie wyglądu czcionki Znaczników tekstowych można używać, aby zmienić wygląd czcionki w danym polu w taki sposób, że to nowe ustawienie nadpisze ustawienia czcionki wprowadzone w ramach znacznika tekstowego określającego nazwę czcionki, jej kolor oraz rozmiar. Aby wyszukać nazwę czcionki, użyj dowolnej nazwy czcionki pojawiającej się w bieżącym dokumencie lub jednej z następujących nazw czcionek: Helvetica, Times, Arial, Verdana lub Courier. Aby określić kolor, należy stosować wartości szesnastkowe RGB lub wybrać dowolny z poniższych, dostępnych kolorów: biały, jasnoszary, szary, ciemnoszary, czarny, czerwony, różowy, pomarańczowy, żółty, zielony, karmazynowy, niebieskozielony lub niebieski. Domyślnie nazwa i rozmiar czcionki to nazwa i rozmiar pierwszego nawiasu „{” na początku znacznika tekstowego.

Dyrektywa znacznik

Przykład

:font :font(name=Times, color=#FF0000, size=12) – określa parametry tekstu w polu w następujący sposób: czcionka typu Times w kolorze czerwonym i o rozmiarze 12 punktów

:font(color=green, size=14) – określa parametry pola w następujący sposób: czcionka w

Ustawianie wyrównania pola Znaczniki tekstowe mogą być używane do wyrównania wartości wprowadzonych do pól formularza. Domyślnie wartości w polach formularza są wyrównane do lewej. Jednak za pomocą dyrektyw w znacznikach tekstowych pola formularza można wyśrodkować lub wyrównany do prawej.

Dyrektywa znacznik

Przykład

:align(alignment) :align(left) – powoduje wyrównanie tekstu w danym polu do lewej. Jest to domyślne ustawienie dla pól formularza i ta dyrektywa nie wymaga wprowadzenia. :align(right) – powoduje wyrównanie tekstu w danym polu do prawej. :align(center) – powoduje wyrównanie tekstu w polu formularza do środka.

Określanie pól powtarzalnych Znaczniki tekstowe mogą być używane do tego, aby powtarzać takie same pola na każdej stronie dokumentu, bez konieczności kopiowania ich dla każdej kolejnej strony. Może to być szczególnie użyteczne w przypadku pól podpisu lub stempli uczestników na bardzo długich dokumentach.

Dyrektywa znacznik

Przykład

:repeat :stamp:repeat – kopiuje stempel uczestnika w tym samym miejscu na każdej kolejnej stronie dokumentu. Upewnij się, że rola sygnatariusza została zdefiniowana dla stempla. (np. sygnatariusz1, sygnatariusz2). :signature:repeat – kopiuje pole podpisu w tym samym miejscu na każdej kolejnej stronie dokumentu. Upewnij się, że rola sygnatariusza została zdefiniowana dla stempla. (np. sygnatariusz1, sygnatariusz2).

Page 24: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

21

:repeat(after) – kopiuje pole w tym samym miejscu na wszystkich stronach po stronie, na której zostało dodane. :repeat(before) – kopiuje pole w tym samym miejscu na wszystkich stronach przed stroną, na której zostało dodane. :repeat(2,10), :repeat(6-9), :repeat(2,6-9) – kopiuje pole w tym samym miejscu na wyszczególnionych stronach lub zakresach stron w dokumencie.

Określanie reguł weryfikacji danych Aplikacja Adobe Sign obsługuje różne typy weryfikacji pól zdefiniowanych przez dodatkowe dyrektywy znaczników tekstowych. Określone reguły weryfikacji danych zostają uruchomione, kiedy sygnatariusz wprowadza dane podczas podpisywania. Aplikacja Adobe Sign nie zezwala odbiorcy na zakończenie procesu podpisywania, jeżeli wprowadzone przez niego dane nie są zgodne z określonymi regułami weryfikacji.

Na przykład:

{{*Mobile_es_:signer1:phone}}

Definiuje wymagane pole o nazwie „Mobile” (Telefon komórkowy) przypisane do odbiorcy identyfikowanego jako signer1. Podczas podpisywania odbiorca musi podać w tym polu

{{Birthday_es_:signer2:isdate}}

Definiuje pole o nazwie „Birthday” (Data urodzenia) przypisane do odbiorcy identyfikowanego jako signer2. Podczas

Niektóre typy walidacji pól mogą zawierać dodatkowe parametry, które ograniczają wartości dopuszczalne w

danym polu.

{{duration_es_:signer1:num(>=0,<=60)}}

Definiuje opcjonalne pole o nazwie „duration” (czas trwania), gdzie wprowadzana wartość musi

{{tenNum_es_:signer1:string(char=num,maxlen=10)}}

Definiuje opcjonalne pole o nazwie „tenNum”, które pozwala wprowadzić maksymalnie 10

Obsługiwane reguły walidacji pól

Typ walidacji

Dyrektywa znacznik

Opcjonalne parametry i wartości Przykłady

String :string char alpha – tylko litery :string :string(char=alpha) :string(char=num) :string(char=alphanum) :string(maxlen=10) :string(char=alpha,maxlen=10)

num – tylko liczby

alphanum – litery i cyfry maxlen Określona maksymalna długość

Liczba :num >= Większa lub równa :num :num(<=1000) <= Mniejsza lub równa

:num(>=50,<=500)

Page 25: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

22

Typ walidacji

Dyrektywa znacznik

Opcjonalne parametry i wartości Przykłady

Waluta :curr kraj us – domyślnie :curr :curr(country=us) :curr(country=uk) :curr(<=500)

uk – Wielka Brytania >= Większa lub równa <= Mniejsza lub równa

:curr(country=us,<=100) Procent :pct >= Większa lub równa :pct

:pct(>=50) <= Mniejsza lub równa :pct(>=0,<=100)

Data :isdate format mm/dd/rr (domyślnie) :isdate :isdate(format=dd/mm/rr) mm/dd/rrrr

dd/mm/rr dd/mm/rrrr mm/rr

Czas :time :time E-mail :isemail :isemail

Kod pocztowy

:zip kraj us – domyślnie format kodu

:zip :zip(country=uk) uk – formatu kodu pocztowego

Wielkiej Brytanii

Kod

:zip4 :zip4

Telefon :phone kraj us – domyślnie format numeru

:phone :phone(country=uk) uk – format numeru telefonicznego

Wielkiej Brytanii

Numer ubezpieczenia

:ssn :ssn

Page 26: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

23

Typ walidacji

Dyrektywa znacznik

Opcjonalne parametry i wartości Przykłady

Użycie wyrażenia regularnego w celu walidacji danych w znaczniku tekstowym

:custom regexp Wyrażenie regularne, wyrażone w postaci ciągu znaków. W tej składni znak ukośnika, który jest częścią wyrażenia regexp, jak np. „\w”, musi być zawsze poprzedzony innym ukośnikiem, np. „\\w”. Aby wyszukać ukośnik, należy użyć \\\\. Ciąg zaczyna się i kończy podwójnym cudzysłowem ("). Jeśli przewidujemy, że w danych wprowadzonych przez odbiorcę znajdzie się cudzysłów, aby zapewnić walidację wyrażenia regexp, która zaakceptuje cudzysłów, należy wprowadzić do wyrażenia znak \". Odnośniki z przykładem zastosowania

kł d i h ż ń

:custom(regexp="^5[1-5][0- 9]{14}$") :custom(regexp="^.{3}$",msg="Not a match for three chars in a row!")

msg Wiadomość wyświetlana odbiorcy, gdy wprowadzone dane nie są zgodne z

Jedno pole może zawierać tylko jedną dyrektywę walidacji. Jeżeli dla pojedynczego znacznika tekstowego określono wiele reguł walidacji, zastosowana zostanie wyłącznie reguła pierwsza. Wszystkie kolejne reguły walidacji zostaną pominięte.

Ukrywanie poufnych danych Aplikacja Adobe Sign obsługuje ukrywanie poufnych danych gromadzonych w trakcie podpisywania dokumentu poprzez dodanie szczegółowej dyrektywy do znacznika tekstowego. Podczas podpisywania dane wprowadzone przez sygnatariusza w takim polu zostają zastąpione gwiazdkami (*) lub innymi określonymi przez użytkownika znakami, po tym jak sygnatariusz opuści takie pole. Dane wprowadzone w ten sposób przez sygnatariusza nie są też wyświetlane kolejnym sygnatariuszom ani nie są ujęte w całkowicie wypełnionym dokumencie PDF. Dane wprowadzone przez sygnatariusza mogą być wyeksportowane z Adobe Sign lub przesłane za pośrednictwem API Adobe Sign.

Definicja znacznika tekstowego:

Podczas podpisywania:

W docelowym dokumencie PDF:

Page 27: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

24

{{*CC_es_:signer1:mask}} Definiuje wymagane pole o nazwie „CC” przypisane odbiorcy identyfikowanemu jako signer1, które podczas podpisywania

{{*CC_es_:signer1:mask(char=-)}} Definiuje wymagane pole o nazwie „CC” przypisane odbiorcy identyfikowanemu jako signer1, które podczas podpisywania ukrywa dane, podstawiając znak „-”. Jeżeli w znaczniku tekstowym nie określono innego znaku pozwalającego ukrywać dane, wówczas

Określanie reguł warunkowych dla pól Aplikacja Adobe Sign obsługuje stosowanie reguł warunkowych dla pól w dokumencie. Reguł warunkowych można używać do definiowania, kiedy określone pole w dokumencie ma być wyświetlone, a kiedy ukryte dla danego odbiorcy podczas podpisywania. Warunki zastosowane dla konkretnego pola są oparte na wartościach co najmniej jednego pola w dokumencie. Reguły warunkowe zastosowane dla określonego pola mogą również wskazywać, czy dane pole ma zostać wyświetlone albo schowane, gdy wszystkie warunki zdefiniowane dla tego pola są spełnione, czy wówczas gdy którykolwiek z warunków zdefiniowanych dla tego pola jest spełniony.

{{_es_:signer1:showif(condition)}} {{_es_:signer1:showifany(condition)}}

Wyświetla pole dla odbiorcy identyfikowanego jako signer1, jeśli którykolwiek ze zdefiniowanych

{{_es_:signer1:showifall(condition)}} Wyświetla pole dla odbiorcy identyfikowanego jako signer1 tylko wówczas, gdy wszystkie

{{_es_:signer1:hideif(condition)}} {{_es_:signer1:hideifany(condition)}}

Ukrywa pole dla odbiorcy identyfikowanego jako signer1, jeśli którykolwiek ze zdefiniowanych

{{_es_:signer1:hideifall(condition)}} Ukrywa pole dla odbiorcy identyfikowanego jako signer1 tylko wówczas, gdy wszystkie

{{_es_:signer1:enableif(condition)}} {{_es_:signer1:enableifany(condition)}}

Aktywuje pole dla odbiorcy identyfikowanego jako signer1, jeśli którykolwiek ze zdefiniowanych warunków jest spełniony. Przypomina to warunek „showif” (pokaż, jeśli), jednak w tym przypadku jeśli warunek nie jest spełniony, podczas podpisywania dokumentu pole to pozostaje widoczne, ale jest wyszarzone i nie można go edytować. W

l ś l ć ść

{{_es_:signer1:enableifall(condition)}} Aktywuje pole dla odbiorcy identyfikowanego jako signer1 tylko wówczas, gdy wszystkie

{{_es_:signer1:disableif(condition)}} {{_es_:signer1:disableifany(condition)}}

Blokuje pole dla odbiorcy identyfikowanego jako signer1, jeśli którykolwiek ze zdefiniowanych warunków jest spełniony. Zablokowane pole jest wyszarzone podczas procesu podpisywania. Jeżeli jest jakaś wartość domyślna dla tego zablokowanego

{{_es_:signer1:disableifall(condition)}} Blokuje pole dla odbiorcy identyfikowanego jako signer1 tylko wówczas, gdy wszystkie zdefiniowane

Page 28: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

25

Warunek jest zdefiniowany w następujący sposób: wartość operatora fieldname, gdzie fieldname odpowiada nazwie pola formularza w dokumencie, na którym opiera się warunek. Obsługiwane operatory i poprawne wartości dla różnych obsługiwanych pól formularza przedstawiono w tabeli poniżej.

Warunkowe operatory pola

Operator Znaczenie Wartość Przykład

=, ==, eq Jest równe Pojedyncza wartość myCheck=checked

!=, <>, neq Nie jest równe Pojedyncza wartość signature!=signed <, lt Mniejsze niż Pojedyncza wartość, liczbowa myNumber < 10 >, gt Większe niż Pojedyncza wartość, liczbowa myNumber > 40 <=, lte Mniejsze lub równe Pojedyncza wartość, liczbowa myNumber <= 15 >=, gte Większe lub równe Pojedyncza wartość, liczbowa myNumber >= 0 ?=, in W Lista pozycji rozdzielonych

przecinkami musi zostać ujęta w

option ?="1,2,3"

?!=,!in, not in, notin

Nie w Lista pozycji rozdzielonych przecinkami musi zostać ujęta w

option ?!= "1,2,3"

~=, contains Zawiera Pojedyncza wartość Title ~= Manager ~!=, !contains, not contains,

Nie zawiera Pojedyncza wartość Title ~!= Junior

Wiele warunków dla pojedynczego pola można rozdzielać za pomocą przecinków. Na przykład: {{notRed_es_:showifall(checkbox=checked,Color!=Red)}} definiuje pole o nazwie „notRed”, które jest ukazane sygnatariuszowi, gdy oba warunki są spełnione.

Warunkowa wartość pola dla obsługiwanych pól znaczników tekstowych

Typ pola Prawidłowe wartości Przykład

Podpis signed, unsigned signHere=signed Inicjały signed, unsigned initHere!=signed

Pole wyboru checked, unchecked myCheck=checked Przycisk opcji Wartość dla przycisków opcji Color=Red Pola tekstowe Wartość pola tekstowego Title!=Senio

r Title~=Chief

Warunki mogą zostać przypisane do każdego pola, w tym do pól wymaganych, takich jak inicjały, podpisy i bloki podpisów. Kiedy warunek jest zdefiniowany dla pola, które jest wymagane, jest ono traktowane jako wymagane wyłącznie wówczas, kiedy warunek pozwala wyświetlić to pole sygnatariuszowi podczas składania podpisu. Innymi słowy, jeśli pole podpisu opatrzone zostaje warunkiem, który każe je ukryć, nie jest ono widoczne dla sygnatariusza, a zatem podpis tego sygnatariusza nie jest wymagany w tym konkretnym polu. Liczba „pól wymaganych”, wyświetlana na dole podpisywanej strony, jest na bieżąco aktualizowana w oparciu o zdefiniowane warunki, tak aby dokładnie informować o liczbie pól, które musi wypełnić sygnatariusz, zanim zakończy podpisywanie danego dokumentu.

Każdy z sygnatariuszy musi mieć jedno pole podpisu, do którego nie został przypisany żaden warunek. Z tego powodu, jeżeli wszystkie pola podpisu dla danego sygnatariusza mają przypisany jakiś warunek, na końcu dokumentu zostaje dodany nowy blok podpisu dla tego sygnatariusza.

Page 29: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

26

Definiowanie wzorów dla pól obliczeniowych Aplikacja Adobe Sign obsługuje bieżącą aktualizację wartości w polach podpisywanego dokumentu w oparciu o inne wartości (wybory) wprowadzone przez klienta w trakcie procesu podpisywania; ten typ pól określa się mianem Pól obliczeniowych. Wzory obliczeń można zdefiniować, podobnie jak w przypadku innych pól dokumentu, używając albo znaczników tekstowych, albo metody przeciągnij i upuść w środowisku tworzenia dokumentu Adobe Sign. Wzór dla pola obliczeniowego może odwoływać się do jednego lub większej liczby pól w dokumencie, może również opierać się na innym polu obliczeniowym tego dokumentu. Obliczenia można stosować do pól liczbowych, pól dat i pól tekstowych.

Oprócz obliczania wartości dla danego pola dokumentu pole obliczeniowe może również zawierać informacje o formatowaniu wyświetlanych informacji, aby w odpowiedniej formie zaprezentować w dokumencie obliczoną wartość. Dodatkowe reguły, takie jak reguły warunkowe, ukrywanie pola i tym podobne, mogą być również zastosowane dla pól obliczeniowych za pomocą znaczników tekstowych.

f1_es_:signer1:calc(formula)

Pole obliczeniowe przypisane do odbiorcy identyfikowanego jako signer1. Jego wartość jest automatycznie obliczana na podstawie

f2_es_:signer1:calc(formula):format(formatType, format)

Pole obliczeniowe przypisane do odbiorcy identyfikowanego jako signer1. Jego wartość jest automatycznie obliczana na podstawie zdefiniowanego wzoru, a wynik jest wartością

Przykład: Pole obliczeniowe może być używane w celu dynamicznego obliczenia maksymalnego podatku

należnego porządkowo.

{{Tax_es_:signer1:calc([subtotal] * [taxrate]):format(number, "$,.00")}}

Kwota podatku jest obliczana na podstawie całkowitej wartości pozycji zamówionych przez klienta oraz stawki podatku obowiązującej w stanie, w którym klient mieszka Tak obliczona kwota podatku jest sformatowana z symbolem dolara ($) umieszczonym przed kwotą, a kwota zostaje obliczona z dokładnością do dwóch miejsc po przecinku. Na przykład, jeżeli wartość netto towarów wynosi 1250, a stawka podatkowa to 6,25%, wartość brutto w polu uwzględniającym podatek zostanie wyświetlona jako $1,328.13.

Aby uzyskać więcej informacji na temat pól obliczeniowych i ich wykorzystania w dokumentach, patrz Karta informacyjna dotycząca pól obliczeniowych.

Skrócone formy znaczników tekstowych Znaczniki tekstowe tworzą bardzo wydajny mechanizm pozwalający definiować różne typy pól w dokumencie, przydzielać te pola określonym sygnatariuszom, określać reguły walidacji pól i/lub stosować reguły warunkowe dla tych pól. Zastosowanie wszystkich tych możliwości do pojedynczego pola formularza może sprawić, że definicja dla tego pola będzie bardzo długa, co w rezultacie wpłynie na zmianę struktury całego dokumentu. Co więcej, ponieważ każda definicja pola musi zmieścić się w jednym wierszu, stosowanie licznych i skomplikowanych dyrektyw może sprawić, że opracowanie układu całego dokumentu okaże się bardzo trudne. Aby zagwarantować spójność struktury całego dokumentu, aplikacja Adobe Sign obsługuje mechanizm definiowania skróconych znaczników tekstowych w dokumencie. W skład skróconego znacznika tekstowego wchodzą dwa elementy:

Page 30: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

27

• Odniesienie do znacznika – skrócona definicja znacznika umieszczona w odpowiednim miejscu dokumentu. Odniesienie do znacznika określa rozmiar oraz położenie faktycznego pola formularza w dokumencie. Odniesienie do znacznika charakteryzuje się następującą składnią: {{$shortened_name}}. Na przykład, {{$r}} definiuje odniesienie do znacznika, gdzie „r” jest skrótem nazwy znacznika. Rozmiar pola można dostosować za pomocą spacji albo tuż za ostatnim otwierającym nawiasem klamrowym, albo tuż przed pierwszym zamykającym nawiasem klamrowym.

• Definicja znacznika – dotyczy pełnej definicji dla konkretnego znacznika i może być zdefiniowana w dowolnym miejscu dokumentu. Rozmiar i lokalizacja definicji znacznika nie mają żadnego wpływu ani na rozmiar, ani na lokalizację faktycznego pola formularza w dokumencie. Definicja znacznika ma następującą składnię: {{#shortened_name=Standard Tag Syntax}}. Na przykład {{#r=[]ReceiveCommunication_es_:signer1}} reprezentuje pełną definicję znacznika dla odniesienia do znacznika o nazwie „r”. W tym przykładzie znacznik definiuje pole wyboru przypisane odbiorcy identyfikowanemu jako signer1.

Poniższa ilustracja przedstawia na przykład dwa odniesienia do znaczników zamieszczone w dokumencie.

Pełne definicje dla obu odniesień do znaczników znajdują się w innym miejscu w dokumencie, tak jak pokazano na ilustracji poniżej.

Pełne definicje dla tych znaczników tekstowych są bardzo długie i bez możliwości umieszczenia skróconych znaczników w odpowiednich miejscach dokumentu zachowanie pierwotnej struktury dokumentu byłoby niemożliwe.

Usuwanie stron z dokumentu końcowego

Dzięki możliwości rozdzielenia lokalizacji pól od ich definicji, wszystkie definicje znaczników w treści dokumentu mogą być zamieszczone na końcu dokumentu lub na oddzielnej stronie w ramach dokumentu. Kiedy dokument zostaje wysłany poprzez aplikację Adobe Sign, wszystkie znaczniki tekstowe są przetwarzane, a na ich definicjach umieszczone są białe pola i same definicje nie są już widoczne dla sygnatariusza. Może to spowodować pojawienie się w dokumencie całkowicie pustych stron, czego przyczyną jest przetworzenie przez aplikacje Adobe Sign stron zawierających wyłącznie znaczniki tekstowe. Aby uniknąć pojawienia się tych dodatkowych, niechcianych, pustych stron dokumentu, aplikacja Adobe Sign obsługuje specjalną definicję znacznika tekstowego, która pozwala usunąć określoną stronę z dokumentu końcowego wygenerowanego przez Adobe Sign przed jego wysłaniem do podpisania.

{{#REMOVE_PAGE_FROM_OUTPUT}} Ta specjalna dyrektywa informuje aplikację Adobe Sign, aby usunąć stronę, na której dyrektywa się znajduje, z końcowego, przetworzonego dokumentu. Taki znacznik może znajdować się w dowolnym miejscu na stronie. Dokument wysłany do aplikacji Adobe Sign musi zawierać przynajmniej jedną stronę. Jeżeli dyrektywa ta pojawi się na wszystkich stronach dokumentu

Page 31: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

28

Przykłady zaawansowanych znaczników tekstowych Poniżej znajduje się kilka przykładów znaczników tekstowych wraz z opisami.

Pola wyboru

{{[]_es_:signer1}} Pole wyboru przypisane do odbiorcy identyfikowanego jako i {{[]*}} Wymagane pole wyboru.

{{[]!}} Pole wyboru tylko do odczytu.

Przyciski opcji

{{(Daily)Rate_es_:signer1}} Przycisk opcji o wartości „Daily” (Codziennie) przypisany do odbiorcy identyfikowanego jako signer1

Lista rozwijana

{{*Color_es_:signer1:dropdown(options= "Red,Green,Blue”)}}

Wymagana lista rozwijana z trzema możliwymi opcjami. Lista jest przypisana do odbiorcy identyfikowanego jako

{{Color_es_:signer1:dropdown(options= "Red,Green,Blue”):default(“Red”)}}

Lista rozwijana z trzema możliwymi opcjami i opcją „Red” (Czerwony) wyznaczoną jako opcja domyślna. Lista jest przypisana do odbiorcy identyfikowanego jako signer1. Jeśli wartość jest określona w definicji listy rozwijanej, to wartość ta musi zostać użyta do

{{Color_es_:dropdown(options=Red,Green,Blue” , values=”R,G,B”):default(“R”):mask}}

Lista rozwijana, która nie jest przypisana do żadnego odbiorcy, z trzema możliwymi opcjami odpowiadającymi trzem eksportowanym wartościom. Wartość „R” odpowiadająca wyborowi opcji „Red” (Czerwony) przez odbiorcę zostaje wybrana

{{Color_es_:dropdown(options= "Red,Green,Blue”):showif(Rate=”Daily”)}}

Lista rozwijana, która nie jest przypisana do żadnego odbiorcy, z trzema możliwymi opcjami. Lista rozwijana jest pokazywana tylko wówczas, gdy przycisk opcji o

Weryfikacja pola

{{Birthday_es_:signer2:isdate}} Opcjonalne pole daty dla odbiorcy identyfikowanego jako signer2 przeznaczone do wprowadzania daty w

{{*Zip2_es_:signer2:zip}} Pole wymagane dla odbiorcy identyfikowanego jako signer2 przeznaczone do wprowadzania kodu pocztowego w odpowiednim formacie. To pole

Skrócone formy znaczników tekstowych

{{$r}} Odniesienie do znacznika określające położenie pola.

{{#r=[]Spouse_es_:prefill}} Definicja pola wyboru do wstępnego wypełnienia przez nadawcę

Page 32: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

30

Skrótów znaczników tekstowych można również używać jako funkcji, a nie wyłącznie po to, aby zastępować całe pole.

Na przykład, wprowadźmy następujący znacznik: {{field1_es_:signer1:showif(fieldA=‘Yes)}}

Powyższy znacznik można również zapisać w formie następującego skrótu: {{field_es_:$A:$B}} #A=signer #B=showif(fieldA=‘Yes’)

Skróty znaczników tekstowych mogą również służyć jako

metody obliczeniowe. Na przykład, wprowadźmy następujący

znacznik: {{field1_es_:calc(a * b / c)}}

Powyższy znacznik można również zapisać w formie następującego skrótu: Field1_es_:$1(a,b,c)

#1(option1, option2, option3) = calc([option1] * [option2] / [option3])

Reguły warunkowe

{{f_es_:hideifall(sig=unsigned,initials=unsigned}} Pole, które jest wyświetlane, jeśli zarówno podpis, jak i inicjały są podpisane {{*emailAddress_es_:signer1:isemail:showif

(TypeOfComm="receiveEmail")}} Pole wymagane dla odbiorcy identyfikowanego jako signer1 przeznaczone do wprowadzenia prawidłowego adresu e-mail. Pole to jest wyświetlane tylko wtedy, gdy inne pole o nazwie „TypeOfComm” (Rodzaj komunikacji) ma wartość „receiveEmail” (Poczta e-

{{f_es_:hideifany(Color=”Red”,Color=”Green”}} Pole to jest ukryte, jeśli odbiorca wybierze albo kolor Red (Czerwony), albo kolor Green (Zielony) z rozwijanej listy o nazwie „Color” (Kolor).

Page 33: Adobe Sign...odczytu, korzystając z rozwiązań API Adobe Sign lub MegaSign poprzez CSV, zanim dokument zostanie wysłany do podpisania. • Nazwa pola – unikalna nazwa pozwalająca

Adobe Sign

Adobe Sign Tworzenie formularzy za pomocą znaczników

31

Pola obliczeniowe

{{shipState_es_:signer1:calc([billingState]) :showif(sameAs=unchecked)}}

Pole w dokumencie przypisane do pierwszego sygnatariusza, które jest wyświetlane wyłącznie wówczas, gdy inne pole (pole wyboru) o nazwie „sameAs” (Tak samo) nie jest zaznaczone. Wartość tego pola jest automatycznie uzupełniana wartością pola „billingState” (Status rozliczenia), którą

{{total_es_:signer1:calc(q1*pr1) :format(Number,”$,0.00”):align(right)}}

Pole w dokumencie przypisane do odbiorcy identyfikowanego jako signer1. 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

ó h l d {{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

ł i ć i bó j ki d k ł

Aby uzyskać więcej informacji na temat pól obliczeniowych, patrz Karta informacyjna dotycząca pól obliczeniowych.