Używaj odwołań do pól, literałów, operatorów i funkcji do tworzenia formuł dla pól obliczanych w programie Acrobat Sign.
Wprowadź formuły we właściwości Formuła pola skonfigurowanego z Typ wartości > Obliczana. Niniejsze odwołanie opisuje składnię wyrażeń dostępną do tworzenia tych formuł.
Aby skonfigurować samo pole, zobacz Utwórz pole obliczane.
Utwórz formułę
Formuła może zawierać jeden lub więcej z tych elementów:
| Element | Zastosowanie | Przykład |
|---|---|---|
| Odwołanie do pola | Użyj wartości z innego pola | cena * ilość |
| Literał | Dołącz stałą liczbę, wartość tekstową lub datę | suma * 0,10 |
| Operator | Wykonaj operacje arytmetyczne, porównania lub tekstowe | suma częściowa + podatek |
| Funkcja | Wykonaj predefiniowane obliczenie lub operację logiczną | max(wartość1, wartość2) |
Formuły mogą również odwoływać się do innych pól obliczanych.
Odwoływanie się do pól według nazwy
Użyj nazwy pola, aby odwołać się do jego wartości w formule.
Na przykład:
cena * ilość
używa wartości pól o nazwach price i quantity.
Jeśli nazwa pola zawiera spacje, umieść pełną nazwę w nawiasach kwadratowych:
[Unit price] * quantity
Używaj znaczących, unikalnych nazw pól, aby formuły pozostawały zrozumiałe podczas zmian formularza.
Zobacz Właściwości pól formularza, aby poznać wymagania dotyczące nazw pól.
Użyj wartości dosłownych
Literał to stała wartość uwzględniona bezpośrednio w formule.
Przykłady:
- Liczby: 10
- Tekst: "Zatwierdzone"
- Daty używane przez obsługiwane funkcje daty
Zamykaj ciągi tekstowe w pojedynczych lub podwójnych cudzysłowach.
Na przykład:
"Zatwierdzone"
Wartości dosłowne można łączyć z polami, operatorami i funkcjami.
Obsługiwane operatory
Używaj operatorów do wykonywania obliczeń, łączenia tekstu lub porównywania wartości.
| Operator | Operacja |
|---|---|
| + | Dodaj |
| - | Odejmij |
| / | Podziel |
| * | Mnożenie |
| & | Łącz ciągi tekstowe |
| = | Równa się |
| != | Nie równa się |
| < | Znak mniejszości |
| <= | Mniejsza niż lub równa |
| > | Znak większości |
| >= | Większa niż lub równa |
| % | Zwraca resztę po dzieleniu |
| ^ | Podnosi wartość do potęgi |
Operatory porównania zwracają wynik prawda lub fałsz i mogą być używane w funkcjach logicznych.
Na przykład:
suma >= 1000
ocenia, czy wartość total wynosi co najmniej 1000.
Funkcje matematyczne
| Funkcja | Wynik |
|---|---|
| abs(number1) | Zwróci wartość bezwzględną liczby. |
| roundUp(number1) | Zaokrągla liczbę w górę. |
| roundDown(number1) | Zaokrągla liczbę w dół. |
| round(number1) | Zaokrągla liczbę do najbliższej liczby całkowitej. |
| min(number1, number2) | Zwraca mniejszą z dwóch liczb. |
| max(number1, number2) | Zwraca większą z dwóch liczb. |
Przykład
max(Amount1, Amount2)
zwraca wartość większą spośród dwóch wartości pól.
Funkcje dat
| Funkcja | Wynik |
|---|---|
| datePart(part, date) | Zwraca określoną część daty jako liczbę całkowitą. |
| dateAdd(part, date, addition) | Dodaje określoną liczbę elementów daty do daty.Użyj wartości ujemnej, aby odjąć. |
| dateDiff(part, date1, date2) | Zwraca różnicę między dwiema datami przy użyciu określonej części daty. |
| daysIn(part, date) | Zwraca liczbę dni w określonej części daty. |
| date(string) | Konwertuje wartość tekstową reprezentującą datę na wartość daty, którą można wykorzystać w innych funkcjach. |
| now() | Zwraca datę i godzinę w momencie obliczania formuły. |
Wartości części daty
Użyj tych wartości dla argumentu części w obsługiwanych funkcjach dat:
| Wartość | Część daty lub czasu |
|---|---|
| y | Rok |
| q | Kwartał |
| m | Miesiąc |
| d | Dzień |
| h | Godzina |
| n | Minuta |
| s | Sekunda |
Przykład
dateAdd("d", StartDate, 30)
dodaje 30 dni do wartości pola StartDate.
Użyj liczby ujemnej, aby obliczyć wcześniejszą datę:
dateAdd("d", StartDate, -7)
Funkcje logiczne
Użyj funkcji logicznych, gdy obliczona wartość zależy od jednego lub kilku warunków.
| Funkcja | Wynik |
|---|---|
| if(test_logiczny, wartość_jeśli_prawda, wartość_jeśli_fałsz) | Zwraca jedną wartość, gdy test jest prawdziwy, a drugą, gdy jest fałszywy. |
| and(logical1, logical2, ...) | Zwraca wartość true tylko wtedy, gdy wszystkie określone warunki są prawdziwe. |
| or(logical1, logical2, ...) | Zwraca wartość true, gdy co najmniej jeden określony warunek jest prawdziwy. |
| not(logical) | Odwraca wynik true lub false. |
| lookup(sourceField, values, default_value) | Zwraca wartość powiązaną z polem źródłowym lub wartość domyślną, gdy nie znaleziono dopasowania. |
Użyj if, aby wybrać między wynikami
Na przykład:
if(Total >= 1000, "Wymagana akceptacja", "Zaakceptowano")
zwraca jedną wartość tekstową, gdy Total wynosi co najmniej 1000, a inną, gdy nie.
Wyniki true i false mogą same zawierać wyrażenia.
Kombinowanie testów logicznych (and, or, not)
Użyj and , gdy każdy warunek musi być prawdziwy:
and(Age >= 18, Consent = "Tak")
Użyj or , gdy dowolny warunek może być prawdziwy:
or(State = "CA", State = "OR")
Użyj not , gdy potrzebujesz przeciwieństwa warunku:
not(Status = "Closed")
Mapowanie jednej wartości na inną za pomocą lookup
Użyj lookup , gdy wartość źródłowa powinna zwrócić odpowiadającą jej wartość.
Na przykład:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
zwraca mapowaną nazwę stanu, gdy istnieje dopasowanie, i Other, gdy go nie ma.
Jest to przydatne, gdy wartość źródłowa pochodzi z określonego zestawu wyborów, takiego jak pole Dropdown lub Radio button.
Przykłady formuł
Oblicz kwotę
ilość * [Cena jednostkowa]
Mnoży ilość przez cenę jednostkową.
Dodaj kilka wartości
suma częściowa + podatek + dostawa
Dodaje wartości z trzech pól.
Oblicz procent
suma częściowa * stawka podatku
Mnoży jedno pole przez stawkę zapisaną w innym polu.
Zwróć wartość warunkowo
if(ilość >= 10, [Cena jednostkowa] * 0,9, [Cena jednostkowa])
zwraca wartość z rabatem, gdy ilość osiągnie określony próg.
Oblicz przyszłą datę
dateAdd("m", StartDate, 12)
zwraca datę 12 miesięcy po StartDate.
Połącz tekst
Nazwa odbiorcy & " — " & Firma
łączy wartości pól i tekst dosłowny w jeden wynik.
Twórz formuły łatwiejsze w obsłudze
Używaj opisowych nazw pól i utrzymuj powiązane obliczenia tak proste, jak pozwala na to formularz.
Podczas przeglądania formuły sprawdź, czy:
- Każde przywoływane pole istnieje.
- Nazwy pól są zgodne z nazwami użytymi w formule.
- Pola zawierające spacje są ujęte w nawiasy kwadratowe.
- Literały tekstowe są ujęte w cudzysłów.
- Funkcje zawierają wymagane argumenty.
- Pole obliczeniowe generuje zamierzoną wartość dla oczekiwanych danych wejściowych od odbiorcy.
Aby skonfigurować pole obliczeniowe i sformatować wyniki liczbowe, zobacz Tworzenie pola obliczeniowego.
Usprawnij pracę z usługą Acrobat Sign
Szybkie i łatwe zarządzanie dokumentami i podpisywanie ich w Internecie.
