Programowalne presety

W Capitally funkcje takie jak Import i Podatki pozwalają definiować złożoną logikę za pomocą prostego edytora no-code. W rzeczywistości wszystkie wbudowane presety zostały utworzone przy użyciu tego edytora – możesz więc w pełni wykorzystać możliwości aplikacji i dostosować ją do swoich potrzeb.

Ten artykuł przeprowadzi Cię przez wspólne funkcjonalności. Dodatkowe szczegóły znajdziesz w artykułach dotyczących Importu oraz Podatków .

Bloki konstrukcyjne

Presety są budowane z użyciem Wyciągów. Podczas ich ewaluacji każdy wyciąg jest wykonywany jeden po drugim, aż do napotkania instrukcji Wyjdź lub do końca listy.

Ilekroć wyciąg musi przetworzyć wartość, używana jest formuła . Mogą one obejmować zakres od stałej wartości, takiej jak aktywo lub konkretna liczba, przez wartość parametru, jak kolumna danych lub typ transakcji, aż po formuły pozwalające na złożone obliczenia.

Możesz to traktować jak prosty język skryptowy lub rozbudowaną formułę Excel. Zapewnia on podstawowe pojęcia, takie jak wyciągi, wyrażenia, zmienne, funkcje i pętle. Jednak wszystko jest budowane w sposób wizualny, bez kodowania.

Podejmowanie decyzji za pomocą instrukcji If

Najbardziej podstawowym elementem jest instrukcja Jeśli . Pozwala ona podejmować decyzje na podstawie dowolnych parametrów; jeśli warunki zostaną spełnione, wykonane zostaną zagnieżdżone wyciągi. Jeśli nie zostaną spełnione, sprawdzony zostanie następny blok else lub else if .

Wstawianie instrukcji i bloków if

Aby wstawić nową instrukcję, najedź kursorem na miejsce przed, po lub pomiędzy istniejącymi instrukcjami i kliknij dzielnik, który się pojawi, a następnie wybierz instrukcję lub preset z menu. Aby wstawić nowy blok „Jeśli”, najedź na miejsce przed, po lub pomiędzy istniejącymi if/else i kliknij szary dzielnik, który się pojawi, by móc je modyfikować. separator, który się pojawi, i wybierz instrukcję lub preset z menu.

Aby wstawić nowy blok „Jeśli”, najedź kursorem na miejsce przed, po lub pomiędzy istniejącymi blokami jeśli/lub i kliknij szary separator, który się wyświetli.

Modyfikowanie elementów

Każda instrukcja i blok „Jeśli” posiada menu, którego możesz użyć, aby 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.

Oraz / Lub

Gdy potrzebne są złożone warunki, możesz umieścić pierwszy warunek w bloku Oraz/Lub i w ten sposób łączyć wiele warunków.

Ustawianie parametrów za pomocą instrukcji Ustaw

Możesz modyfikować parametr obiektu lub zmienną za pomocą instrukcji Set . Po prostu wybierz parametr do modyfikacji i podaj 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 przypisywania, takie jak dodawanie, mnożenie, dopisywanie tekstu na początku lub na końcu i tak dalej.

Wartość zostanie powiększona o kolumnę Kwota, a do Notatki zostanie dopisany Opis

Transformacja wartości

Proste skalary, takie jak tekst lub liczby, mogą zostać przekształcone przed przypisaniem. Klikając fx , możesz wybrać jedną z transformacji. Możesz łączyć wiele transformacji ze sobą i zmieniać ich kolejność metodą przeciągnij i upuść.

Wartość stanie się zaokrągloną wartością bezwzględną z kolumny KwotaZastępowanie tekstu

Transformacja 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ąć fragment, zastępując go pustym ciągiem znaków.

Zastąp obsługuje również Wyrażenia regularne , w tym tak zwane grupy przechwytujące i referencje wsteczne. Po prostu włącz przycisk (.*) .

Załóżmy, że masz tekst „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 $2 $1 , aby otrzymać „orange apple banana”.

Wyodrębnianie tekstu

Zamiast zastępowania możesz po prostu dopasować część ciągu znaków, która powinna zostać użyta. Najlepiej sprawdza się to z Wyrażeniami regularnymi, gdzie wyodrębniona zostanie pierwsza grupa przechwytująca.

Rozwijając przykład z „apple orange banana”, użycie [a-z]+ ([a-z]+) [a-z]+ wyodrębni tylko środkowe słowo – „orange”.

Mapowanie wartości

Dla niektórych parametrów, takich jak Aktywo lub Typ transakcji, możesz również mapować jedną wartość na inną. Kliknij odwróconą ikonę S ikona obok fx , aby dodać mapowanie.

Mapowanie sprawdzi, czy przychodząca wartość spełnia warunek porównania. Jeśli tak – zostanie użyta wybrana wartość. Mapowania będą dopasowywane sekwencyjnie, a pierwsze pasujące zostanie zastosowane.

Konwersja typów wartości

Parametry mogą mieć niedopasowane typy. Na przykład tekst zostanie automatycznie skonwertowany na liczbę lub datę, o ile zawiera sensowną wartość (np. 2024-11-01 lub 1st Nov 2024).

Działa to również w przypadku Kont, Walut, Rynków lub Typów transakcji, gdzie dowolna wartość tekstowa zostanie użyta do przeszukania danych projektu lub rynku.

W przypadku aktywów możesz dodatkowo określić, które typy aktywów i rynki powinny zostać uwzględnione oraz w jakiej kolejności preferencji.

Definiowanie zmiennych

Podobnie jak w każdym języku skryptowym, możesz zdefiniować zmienną, aby przechowywała wartość do ponownego wykorzystania. Każda zmienna ma określony typ i wartość początkową. Po zdefiniowaniu może być używana jako Referencja lub być ustawiana (Set) jak każdy inny parametr.

Domyślnie wszystkie zmienne są lokalne – co oznacza, że są dostępne tylko w obrębie bloku, w którym zostały zadeklarowane (włączając bloki zagnieżdżone) i tylko po ich deklaracji.

Możesz zmienić 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 także między jego wywołaniami – na przykład dla każdego wiersza w imporcie lub każdego zdarzenia podatkowego.

Komentarze

Obliczenia są przydatne tylko wtedy, gdy rozumiesz liczby. Możesz dodawać bogato sformatowane komentarze w dowolnym miejscu presetu, aby lepiej opisać logikę.