Image Added
Akcja
Kod waluty ( typ: wartość tekstowa ) - waluta powinna
| Panel |
|---|
| title | Podstawowe informacje |
|---|
| Kategoria: WalutaUmiejscowienie akcji: Zmienna
Dostępna od wersji: 1.0.3 |
| Panel |
|---|
| Akcja zwraca do zmiennej kurs złotego (PLN) dla podanej waluty i daty. | Warning |
|---|
Dla wersji cuf-components sprzed wersji 1.0.30: Przed wywołaniem akcji należy wykonać zadanie zaplanowane, które pobierze do naszej bazy danych kursy walut. Opis tego zadania znajduje się tutaj: Pobieranie kursów walut z NBP. |
|
|
Akcja wywołuje się każdorazowo po zmianie wartości parametru "Kod waluty" lub "Data z której pobrać kurs". Uwaga - akcja nie wykonuje się po wejściu w formularz.
Jeśli zostanie określone wykonanie warunkowe, to dopiero po zajściu tego warunku akcja będzie reagowała na zmiany parametrów "Kod waluty" lub "Data z której pobrać kurs". Uwaga - po zajściu warunku kurs nie pobierze się, musi nastąpić jakaś zmiana!
Umiejscowienie akcji
Zmienna formularza typu kwotowego.
Przykładowa konfiguracja akcji
Image Removed
| Umiejscowienie akcji | Wartość parametru "Zdarzenia wywołujące akcję" | Działanie parametru "Wykonanie warunkowe" | Warunek wywołania akcji |
|---|
| Zmienna | Wywołanie przy zmianie zmiennych | Uaktywnia akcję | Zmiana wartości w zmiennej podanej w parametrze: Zmienne aktualizujące. | | Wywołanie po zajściu warunku wykonania warunkowego | Wywołuje akcję | Parametr "Wykonanie warunkowe" zwróci "prawdę" | | Wykonanie przy aktualizacji waluty lub daty, lub przesunięcia | Uaktywnia akcję | Zmiana wartości w jednej ze zmiennych podanych w parametrach: Kod waluty, Data z której pobrać kurs oraz Przesunięcie daty |
|
| Panel |
|---|
| title | Parametry konfiguracyjne |
|---|
| | Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia |
|---|
| Kod waluty* | 1.0.3 | Waluta powinna zostać przekazana w postaci kodu waluty (kody walut dostępne są na stronie NBP), np. EUR, USD. |
|
|
Data kursu ( typ: wartość datowa ) - data| Tekst | | Pole edytowalne | | | Data kursu* | 1.0.3 | Data, z której zostanie pobrany kurs. Uwaga - |
|
|
jeżeli w | jeżeli w tabeli nie zostanie znaleziony kurs z podanej daty, to akcja znajdzie kurs z możliwie najbliższą datą do podanej i występującej przed nią. |
|
|
Film instruktażowy
Mapa z przykładową konfiguracją
| Data | | Pole edytowalne | Data nie powinna być większa niż obecny dzień | | Zdarzenia wywołujące akcję* | 1.0.49 | ( typ : wartość tekstowa ) - Parametr, który określa kiedy ma zostać wywołana akcja. | Tablica wartości tekstowych | Wykonanie przy aktualizacji waluty lub daty lub przesunięcia daty | Nieedytowalna lista rozwijalna | Wartości do wyboru:
- Wywołanie przy zmianie zmiennych
- Wywołanie po zajściu warunku wykonania warunkowego
- Wykonanie przy aktualizacji waluty lub daty, lub przesunięcia daty
| Zmienne aktualizujące | 1.0.49 | (powiązane z parametrem Zdarzenia wywołujące akcję) Określa przy aktualizacji których zmiennych wywoła się akcja. | Tablica zmiennych | | Nieedytowalna lista rozwijalna | Widoczny tylko, gdy Zdarzenia wywołujące akcję są ustawione na "Wywołanie przy zmianie zmiennych" | | Numer Tabeli | 1.0.81 | Zwracany numer tabeli z NBP | Zmienna tekstowa | | Pole edytowalne | | | Typ Tabeli | 1.0.81 | Zwracany typ tabeli z NBP | Zmienna tekstowa | | Pole edytowalne | | | Przesunięcie daty* | 1.0.106 | Modyfikuję datę pobrania kursu (dodaje/odejmuje ilość dni od podanej daty) | Całkowity | 0 | Pole edytowalne | Przykład:
Gdy data jest ustawiona na 21.07.2021 a parametr na -1 to data kursy będzie sprawdzana na dzień 20.07.2021 | | Data ustanowienia kursu | 1.0.162; 1.1.8 | Ostateczna data odczytu, dla której wykonano zapytanie. | Zmienna tekstowa | | | | Strefa czasowa banku NBP | 1.0.135 | Użyj strefy czasowej banku NBP zamiast strefy czasowej serwera. | Logiczny | Nie | Nieedytowalna lista rozwijana | Niedostępne od wersji 1.0.153 |
Parametr*- pole wymagane |
| Panel |
|---|
| title | Przykładowa konfiguracja |
|---|
|  Image Added
|
| Panel |
|---|
| 1.0.3 1.0.30 - Zmiana sposobu pobierania walut na systemowy.
1.0.42 1.0.49 (obowiązująca dokumentacja) - Dodanie dynamicznego formularza z nowym parametrem Zdarzenia wywołujące akcje
1.0.98 (obowiązująca dokumentacja) - Dodanie komentarza w chmurce w przypadku błędu
1.0.106 (obowiązująca dokumentacja) - Dodanie parametru Przesunięcie daty
1.0.135 - Dodanie parametru "Strefa czasowa banku NBP"
1.0.153 - Usunięcie parametru "Strefa czasowa banku NBP" (żadna strefa czasowa nie jest już uwzględniana)
- Logowanie ActivityId
1.0.162; 1.1.8 - Możliwość ustawienia wynikowej zmiennej z faktyczną datą ustanowienia kursu.
|
| Panel |
|---|
| title | Pakiet z przykładowym formularzem wykorzystującym akcję |
|---|
| | View file |
|---|
| name | Testy komponentów - akcje - [AKCJA] Pobranie kursu PLN 2019-10-14 10_22_49.zip |
|---|
|
|
|
| page | Akcje cuf-components |
|---|
|
hide-if |
|
Powiązane zadania| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-33 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-242 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-241 |
|---|
|
|
| English |
|---|
← Return to the list of available actions | Panel |
|---|
| Category: CurrencyAction location: VariableAvailable from version: 1.0.3 |
| Panel |
|---|
| Action to the zloty currency (PLN) for the given currency and date. |
| Panel |
|---|
| | The location of the action | Value of the "Events triggering action" parameter | Operation of the "Conditional execution" parameter | Condition for calling an action |
|---|
| Variable | Call when variables are changed | Activates the action | Changing the value in the variable specified in the parameter: Updating variables. | | Calling on the condition of conditional execution | Invokes an action | The "Conditional Execution" parameter will return "true" | | Executed on currency or date update or shift | Activates the action | Changing the value in one of the variables given in the parameters: Currency code, Date of exchange rate and Day shift |
|
| Panel |
|---|
| title | Configuration parameters |
|---|
| | Name of the parameter | From version | Description | Parameter type | Default value | Field type | Notes and restrictions |
|---|
| Currency code* | 1.0.3 | The currency should be transferred in the form of a currency code (currency codes are available on the NBP website), e.g. EUR, USD. | String | | Editable field | | | Date of exchange rate* | 1.0.3 | Date from which the course will be downloaded. Note - if the table does not find the rate on the given date, the action will find the rate with the closest possible date to the given and occurring before it. | Date | | Editable field | | | Action executing types* | 1.0.49 | (type: text value) - A parameter that defines when the action is to be invoked. | An array of text values | Execution when updating currency or date or date shift | Non-editable drop-down list | Selectable values: - Call when variables are changed
- Calling on the condition of conditional execution
- Execution when updating currency or date or date shift
| | Updating variables | 1.0.49 | (related to the Events triggering action parameter) Defines which variables will be triggered when updating. | An array of variables | | Non-editable drop-down list | It is visible only when the Events that trigger the action are set to "Call when variables are changed" | | Table number | 1.0.49 | Column for entering the table number from which the exchange ratewas taken | An array of text variables | | Editable field | | | Table type | | Column for writing the table type from which the exchange ratewas taken | An array of text variables | | Editable field | | | Day shift* | 1.0.106 | Modify the date of downloading the course (adds / subtracts the number of days from the given date) | Integer | 0 | Editable field | Example:
When the date is set to 07/21/2021 and the parameter is set to -1, the exchange rate date will be checked for 07/20/2021 | | Effective date | 1.0.162; 1.1.8 | Effective date the request has been made for. | Text variable | | | | NBP Bank timezone | 1.0.135 | Use polish NBP Bank timezone instead of a server timezone. | Boolean | No | Noneditable dropdown list | Removed in 1.0.153 |
Parameter*- required field |
| Panel |
|---|
| title | Sample configuration |
|---|
|  Image Added
|
| Panel |
|---|
| 1.0.3 1.0.30 - Changing the method of downloading currencies to the system one.
1.0.42 1.0.49 (applicable documentation) - Adding a dynamic form with a new parameter Events triggering actions
1.0.98 (applicable documentation) - Adding a comment in the tooltip in case of an error
1.0.106 (applicable documentation) - Addition of the Date shift parameter
1.0.135 - Added "NBP Timezone" parameter
1.0.153 - Removed "NBP Timezone" (no timezone is required now)
- Logging ActivityId
1.0.162; 1.1.8 - Possibility to set effective exchange date variable.
|
|
