Get

Zastosowanie

Pozwala pobrać wartość z określonego pola. Wartość może być pobrana:

  • z innej sprawy poprzez podanie jako „source”
    • caseID sprawy z której wartość pobieramy
    • nazwy pola typu Odnośnik, wtedy wartość zostanie pobrana ze sprawy na którą wskazuje pole typu Odnośnik
  • z tabeli w bieżącej sprawie,
  • z tabel zagnieżdżonych

Składnia

Get("source","fieldTitle");
Get("source","fieldTitle","rowSpecifier");

Argumenty

  • source – (String) Określa skąd dane mają być pobrane. Można tu użyć:
    • numer sprawy (caseID) np „6882
    • nazwy pola typu odnośnik, które jest na formularzu np „Dotyczy zamówienia
    • nazwy tabeli np „Pozycje faktury
  • fieldTitle – (String) Nazwa pola znajdującego się w sprawie lub tabeli z której pobieramy wartość
  • rowSpecifier – (String) [Optional] Używane tylko dla tabeli – określa wiersz(e), z którego dana ma być pobrana. Dopuszczalne wartości to  „first” | „last” | 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ść „first”, czyli pobrana zostanie wartość z pierwszego wiersza tabeli.

Zwracana wartość

Zwraca wartość String. Zwraca wartość ze wskazanego pola.

Elementy powiązane

  • funkcja Set
  • funkcja forcase()

Przykłady

Przykład 1:

Zwraca wartość z pola „Amount” z pierwszego wiersza tabeli o nazwie „Positions” i zapisuje wynik w zmiennej o nazwie a.

a = Get("Positions","Amount");

Przykład 2:

Zwraca zawartość pola Name z trzeciego wiersza tabeli „People” i wartość zapisuje w zmiennej n.

n = Get("People", "Name", 3);

Przykład 3:

Zakładamy że istnieje tabela o nazwie Dekretacja, która zawiera tabelę zagnieżdżoną o nazwie VAT. Z poziomu reguł tabeli Dekretacja możemy odwołać się do danych z tabeli VAT np w ten sposób

Get("VAT",Stawka VAT);

Funkcja zwróci wartość z pierwszego wiersza kolumny Stawka VAT.

Przykład 4:

Zakładamy, że na formularzu w procesie „Obieg faktur” istnieje pole typu odnośnik o nazwie „Dotyczy zamówienia”, które wskazuje na proces „Zamówienia”. W procesie „Zamówienia” istnieje pole o nazwie „Wartość zamówienia”, które przechowuje kwotę netto zamówienia. W procesie Obiegu faktur użytkownik w polu „Dotyczy zamówienia” wskazał konkretne zamówienie, które dotyczy otrzymanej faktury. Chcemy, z poziomu procesu Obiegu faktur porównać wartość z pola [Kwota netto] z faktury z wartością skojarzonego zamówienia. Możemy w regule ręcznej (przycisk) użyć np takiego kodu:

warZam = Get("Dotyczy zamówienia","Wartość zamówienia");
if (warZam < [Kwota netto])
{
   ShowMessage(1,"Kwota netto faktury przekracza wartość zamówienia, która wynosi " + warZam);
}

Przykład 5:

Funkcja Get nie umożliwia odwoływania się bezpośrednio z poziomu reguł tabeli do innych wierszy tej samej tabeli. W tym przypadku jedyną możliwością jest użycie funkcji GetFromPrevRow(fieldName).

Przykład 6:

Odwołanie się do pól formularza z poziomu reguły tabeli. Tabela powiązana jest z formularzem poprzez pole systemowe o nazwie [CaseConnectedToCaseId]. Jeżeli jesteśmy wewnątrz reguły tabeli i chcemy sięgnąć do wartości z pola formularza np chcemy odczytać „NIP kontrahenta”, to możemy użyć funkcji Get w następujący sposób:

Get([CaseConnectedToCaseId],"NIP Kontrahenta");

 

Was this article helpful?
0 out Of 5 Stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.