Set
Zastosowanie
Dział zatytułowany „Zastosowanie”Pozwala ustawić wartość w polu w innej sprawie albo ustawić wartość w polu tabeli.
Składnia
Dział zatytułowany „Składnia”Set("target","fieldTitle","newValue");Set("target","fieldTitle","newValue","rowSpecifier");Argumenty
Dział zatytułowany „Argumenty”- target – (String) Określa gdzie dane mają być zmienione. Można tu użyć:
- nazwy tabeli np „Pozycje faktury„
- wskazać tabelę zagnieżdżoną w taki sposób „Dekretacja>Podział VAT”
- nazwy pola typu odnośnik, które jest na formularzu np „Dotyczy zamówienia„
- numer sprawy (caseID) np „6882„
- fieldTitle – (String) Nazwa pola znajdującego się w docelowej sprawie lub tabeli
- newValue – (String) Wartość która ma być wprowadzona do tego pola.
- rowSpecifier – (String) [Optional] Używane tylko dla tabeli – określa wiersz(e), w którym dane mają być zmienione. Dopuszczalne wartości to „first” | „last” | „all” | rowNumber (rowNumber jest wartością numeryczną określająca numer wiersza w tabeli np 3 będzie oznaczało trzeci wiersz w tabeli. Gdy parametr nie zostanie określony, domyślnie używana jest wartość „all”, czyli zmiana zostanie wprowadzona we wszystkich wierszach tabeli.
Zwracana wartość
Dział zatytułowany „Zwracana wartość”Zwraca wartość logiczną. Zwraca false jeżeli operacja się nie powiodła. W pozostałych przypadkach zwraca true.
Przykłady
Dział zatytułowany „Przykłady”Przykład 1:
Ustawienie wartości dla kolumny w tabeli.
Wykonanie tej funkcji spowoduje ustawienie wartości 100 dla wszystkich wierszy w kolumnie „Ilość” w tabeli „Pozycje faktury”. Set(„Pozycje faktury”,”Ilość”, „100”);
Przykład 2:
Ustawienie wartości dla konkretnego wiersza w tabeli.
Wykonanie tej funkcji spowoduje ustawienie wartości „rsimmons’ w trzecim wierszu tabeli Akceptanci w kolumnie Akceptujący
Set("Akceptanci", "Akceptujący", "rsimmons", 3);Podobny przykład, ale ustawiający wartość w ostatnim wierszu tabeli
Set("Akceptanci", "Akceptujący", "rsimmons", "last");Przykład 3:
Jak dodać nowy wiersz do tabeli i ustawić w nim wartość?
Dodając wiersz za pomocą funkcji AddTableRow, trzeba zapamiętać numer tego wiersza. W tym przykładzie numer nowego wiersza zapamiętywany jest w zmiennej row.
row = AddTableRow("Users list");Set("Users list","User",CurrentUser(),row);Przykład 4:
Ustawienie wartości w innej sprawie, na którą wskazuje pole typu odnośnik.
Załóżmy że mamy proces Obieg faktur i proces Zamówienia.
W procesie Obiegu faktur mamy pola
- „Dotyczy zamówienia”, które jest polem typu odnośnik.
- „Numer faktury”, które jest polem tekstowym
W procesie Zamówień mamy pole:
- „Zrealizowano fakturą numer”
W procesie Obiegu faktur użytkownik w polu „Dotyczy zamówienia” wskazuje zamówienie, które dotyczy otrzymanej faktury. Chcemy, aby z poziomu procesu Obiegu faktur zostało ustawione pole „Zrealizowane fakturą numer” w zamówieniu powiązanym z naszą fakturą.
Set("Dotyczy zamówienia","Zrealizowano fakturą numer',[Numer faktury]);Numer faktury jest w nawiasach kwadratowych, ponieważ odwołujemy się do wartości z tego pola.