W Capitally funkcje takie jak Import i Podatki pozwalają definiować złożoną logikę za pomocą prostego edytora no-code. Wszystkie wbudowane presety są tworzone przy użyciu tego samego edytora — dzięki temu możesz korzystać z pełnych możliwości aplikacji i dostosować ją do swoich potrzeb.
Ten artykuł przeprowadzi Cię przez wspólne funkcjonalności. Szczegółowe informacje znajdziesz w artykułach dotyczących Importu i Podatków .
Elementy składowe
Presety są budowane przy użyciu Wyciągów. Podczas ich wykonywania każdy wyciąg jest przetwarzany kolejno, aż do napotkania wyciągu Exit lub zakończenia listy wyciągów.
Gdy wyciąg musi obliczyć wartość, używane jest wyrażenie . Może to być stała wartość, np. aktywo lub konkretna liczba, wartość parametru, np. kolumna danych lub typ transakcji, albo formuły umożliwiające złożone obliczenia.
Możesz traktować to jak prosty język skryptowy lub złożoną formułę w Excelu. Udostępnia podstawowe koncepcje, takie jak wyciągi, wyrażenia, zmienne, funkcje i pętle. Wszystko jest jednak budowane w sposób wizualny, bez pisania kodu.
Fragmenty kodu
Skorzystaj z wbudowanych fragmentów kodu jako dobrego punktu wyjścia. Możesz je wstawiać w dowolnym miejscu z menu Dodaj wyciąg
Podejmowanie decyzji za pomocą instrukcji If
Najbardziej podstawowym wyciągiem jest instrukcja If . Pozwala ona podejmować decyzje na podstawie dowolnych parametrów — jeśli warunki są spełnione, zagnieżdżone wyciągi zostaną wykonane. Jeśli nie są spełnione, sprawdzany jest kolejny blok else lub else if .
Wstawianie wyciągów i bloków if
Aby wstawić nowy wyciąg, najedź kursorem na przestrzeń przed, po lub między istniejącymi wyciągami i kliknij niebieski pojawi się niebieski separator i wybierz instrukcję lub preset z menu.
Aby wstawić nowy blok „If", najedź kursorem na przestrzeń przed, po lub pomiędzy istniejącymi blokami if/else i kliknij szary separator, który się pojawi
Modyfikowanie ich
Każda instrukcja i blok If ma menu, za pomocą którego możesz je Kopiować, Wycinać, Duplikować i Usuwać.
Po skopiowaniu lub wycięciu instrukcji możesz ją wkleić w ten sam sposób, w jaki dodajesz nowe instrukcje — pojawi się tam opcja Wklej.
Możesz kopiować i wklejać między dwoma różnymi Presetami podatkowymi, a nawet między dwoma różnymi projektami.
And / Or
Gdy potrzebne są złożone warunki, możesz opakować pierwszy warunek w blok And/Or i w ten sposób łączyć wiele warunków.
Ustawianie parametrów za pomocą instrukcji Set
Możesz modyfikować parametr lub zmienną obiektu za pomocą instrukcji Set . Wystarczy wybrać parametr do zmodyfikowania i podać wartość.
Waluta opłaty będzie taka sama jak Waluta wartości
Modyfikowanie istniejącej wartości zamiast jej zastępowania
Klikając listę rozwijaną to , możesz wybrać różne tryby przypisania, takie jak dodawanie, mnożenie, dołączanie lub poprzedzanie tekstu itd.
Wartość zostanie zwiększona o kolumnę Kwota, a do Notatki zostanie dołączony Opis
Przekształcanie wartości
Proste wartości skalarne, takie jak tekst lub liczby, mogą być przekształcane przed przypisaniem. Klikając fx , możesz wybrać jedno z przekształceń. Możesz łączyć wiele przekształceń i zmieniać ich kolejność metodą przeciągnij i upuść.
Wartość stanie się zaokrągloną wartością bezwzględną kolumny KwotaZastępowanie tekstu
Przekształcenie Replace pozwala zastąpić wystąpienia pasującego tekstu czymś innym. Na przykład możesz zastąpić słowo (np. .GR na .EU) lub usunąć coś, zastępując to niczym.
Replace obsługuje również Wyrażenia regularne , w tym tzw. grupy przechwytywania i odwołania wsteczne. Wystarczy przełączyć przycisk (.*) .
Załóżmy, że masz ciąg „apple orange banana" i chcesz zamienić miejscami dwa pierwsze słowa. Możesz użyć wzorca ([a-z]+) [a-z]+ ([a-z]+) i zastąpić go przez $2 $1 , aby uzyskać „orange apple banana".
Wyodrębnianie tekstu
Zamiast wyodrębniać, możesz po prostu dopasować tę część ciągu, która ma zostać użyta. Najlepiej sprawdza się to z Wyrażeniami regularnymi, ponieważ wyodrębniona zostanie pierwsza grupa przechwytywania.
Rozwijając powyższy przykład z „apple orange banana", użycie wzorca [a-z]+ ([a-z]+) [a-z]+ wyodrębni tylko środkowe słowo — „orange".
Mapowanie wartości
W przypadku niektórych parametrów, takich jak Typ aktywa lub Typ transakcji, możesz również mapować wartość z jednej na drugą. Kliknij odwrócone S ikona obok fx aby dodać mapowanie.
Mapowanie sprawdza, czy nadchodząca wartość spełnia określony warunek. Jeśli tak – zostanie użyta wybrana wartość. Mapowania są dopasowywane kolejno, a wygrywa pierwsze pasujące.
Rzutowanie wartości między typami
Parametry mogą mieć niezgodne typy. Na przykład tekst zostanie automatycznie przekonwertowany na liczbę lub datę, o ile zawiera sensowną wartość (np. 2024-11-01 lub 1st Nov 2024).
Działa to również dla Kont, Walut, Rynków i typów transakcji – każda wartość tekstowa zostanie użyta do wyszukania w danych projektu lub danych rynkowych.
Dla aktywów możesz dodatkowo określić, które typy aktywów i rynki powinny być uwzględnione oraz w jakiej kolejności preferencji.
Definiowanie zmiennych
Podobnie jak w każdym języku skryptowym, możesz zdefiniować zmienną przechowującą wartość do późniejszego ponownego użycia. Każda zmienna ma określony typ i wartość początkową. Po jej zdefiniowaniu można się do niej odwoływać lub ustawiać ją jak każdy inny parametr.
Domyślnie wszystkie zmienne są lokalne – co oznacza, że są dostępne tylko w bloku, w którym zostały zadeklarowane (włącznie z zagnieżdżonymi blokami) i tylko po ich zadeklarowaniu.
Możesz przełączyć je na współdzielone, co oznacza, że ich wartość zostanie zainicjowana tylko raz i będzie dostępna nie tylko w całym programie, ale również między jego kolejnymi wywołaniami – np. dla każdego wiersza importu lub każdego zdarzenia podatkowego.
Komentarze
Obliczenia są pomocne tylko wtedy, gdy rozumiesz liczby. Możesz dodawać bogato sformatowane komentarze w dowolnym miejscu presetu, aby lepiej opisać logikę.
