Karta Zmienne

Podsumowanie:

Zmienne aplikacji to definiowane na poziomie definicji aplikacji zmienne, które mogą przyjmować różne wartości, zależnie od rodzaju środowiska, w jakim są używane. Odwołanie do zmiennej wymaga użycia składni smart numbers. Zmienne mogą być używane jako parametry akcji (np. adres serwera dla źródła danych), w edytorach kodu i szablonach oraz wielu polach tekstowych i hybrydowych tekst/SQL (informacja o możliwości użycia składni smart numbers jest podana jako „placeholder”).

☛ ADMINISTRACJA > Lista aplikacji > Dodaj definicję/Edytuj > Zmienne

Definiowanie

Aby zdefiniować zmienną aplikacji, kliknij przycisk Dodaj i określ następujące właściwości:

Kod: symbol zmiennej używany w odwołaniach, w tym przez składnię smart numbers.

Nazwa zmiennej: nazwa zmiennej aplikacji.

Typ: typ danych zmiennej; lista wartości z typami danych obsługiwanymi w nAxiom.

Wartości zmiennej: wartości zmiennej, które będą używane w odpowiednich środowiskach; wpisz wartości w polach:

• Tryb deweloperski
• Tryb testowy
• Tryb produkcyjny

W wartości zmiennej można także odwołać się do innej zmiennej, używając składni smart numbers z selektorem AppInLineVariables, oraz do wartości parametru systemowego (np. {@_TenantBaseUrl}) i parametrów z kontekstu formularza (z wyjątkiem tablic, np. OpenedForms). Można także w polach wartości używać składni smart numbers z innymi selektorami. Wartość zmiennej zostanie w takim przypadku wyliczona rekurencyjnie.

Migruj wartości tej zmiennej: zestaw przełączników do sterowania importowaniem wartości zmiennej na środowisko docelowe określonego typu; patrz sekcja poniżej.

Zmienne aplikacji można między innymi zastosować do ustawienia różnych czasów kroku w procesie w różnych środowiskach, np. czas kwarantanny w środowisku deweloperskim i testowym może wynosić 30 sekund, a w środowisku produkcyjnym 14 dni. Innym przykładem mogą być różne adresy serwerów, np. platnosci-blik-test w środowiskach dev/test i platnosci-blik w środowisku prod.

Odwoływanie się do zmiennych

Do wartości zmiennych aplikacji można odwoływać się za pomocą składni smart numbers na dwa sposoby:

{&NazwaAplikacji.AppVariables.KodZmiennej}

• AppVariables: odwołanie przeznaczone do użycia w zapytaniach SQL (np. w klauzuli WHERE jako wartość filtrująca); przekazuje wartość zmiennej jako parametr zgodnie z zadeklarowanym typem, dla typu tekstowego wartość zmiennej w zapytaniu jest renderowana w apostrofach

lub

{&NazwaAplikacji.AppInlineVariables.KodZmiennej}

• AppInlineVariables: zwraca zadeklarowaną wartość zmiennej (jako tekst); wywoływane w ten sposób zmienne środowiskowe mogą na przykład być używane do podstawiania różnych nazw tabel w klauzuli FROM lub nazw kolumn w klauzuli WHERE w zapytaniach SQL, a także w akcjach C#, gdzie wartości typu tekstowego należy ująć w podwójne apostrofy (“).

• Migracja aplikacji powoduje nadpisanie wartości zmiennych aplikacji w środowisku testowym i produkcyjnym. Nie dotyczy to przypadku, kiedy zmienne w środowisku źródłowym mają wartość NULL.
• Jeśli w mechanizmie podpowiedzi nie ma kodu zmiennej, która została dopiero co zdefiniowana, należy wyczyścić pamięć podręczną aplikacji w ustawieniach systemu.

Ustawienia migrowalności zmiennych

Konsultant może decydować o sposobie importu zmiennych aplikacji — a precyzyjniej, ich wartości — do środowiska docelowego. Służy do tego przycisk Ustawienia migrowania zmiennych widoczny w nagłówku listy zmiennych. Po kliknięciu tego przycisku jest wyświetlane okno dialogowe z trzema przełącznikami, które umożliwiają wyłączenie importu wartości zmiennych do środowiska określonego typu.

Przełączniki w tym oknie mają zastosowanie do wszystkich zmiennych danej aplikacji. Ustawienia migrowalności można konfigurować indywidualnie dla każdej zmiennej w oknie edycji zmiennej.

Zasada działania przełączników jest następująca:

• przełącznik włączony:
  • wartość danej zmiennej nadpisze wartość tej zmiennej w środowisku docelowym,
  • jeśli zmienna ma wartość null, taka wartość zostanie ustawiona w środowisku docelowym
  • jeśli zmienna nie istnieje w środowisku docelowym, zostanie w nim utworzona wraz z bieżącą wartością.
• przełącznik wyłączony:
  • wartość zmiennej w środowisku docelowym nie zmieni się,
  • jeśli zmienna nie istnieje w środowisku docelowym, zostanie w nim utworzona z wartością null.

Powiązane tematy:

• Smart numbers
• Ustawienia systemu, sekcja Cache