Smart numbers

Podsumowanie:

Referencja typu smart numbers zwraca identyfikator obiektu na podstawie kodu tego obiektu. Funkcja jest dostępna w edytorze SQL i C# (akcja algorytm C#), a także w niektórych polach tekstowych, hybrydowych tekst/SQL, a nawet numerycznych (o obsłudze tekst wyświetlany w polu jako placeholder). Funkcja działa w ten sposób, że po wpisaniu ciągu {& podpowiada kolejno kod aplikacji, oznaczenie obiektu aplikacji, kod modułu i kod obiektu, np.
{&AppName.ObjectType.ModuleName.ObjectCode}
Jedynie w przypadku zmiennych aplikacji referencja zwraca wartość zmiennej.

W polach tekstowych, hybrydowych tekst/SQL w trybie tekstowym oraz numerycznych można jedynie wkleić wyrażenie przygotowane wcześniej, np. w edytorze SQL.

Użycie składni smart numbers eliminuje odwołania do identyfikatorów, co umożliwia eksport obiektów aplikacji do innych środowisk, w których generowane automatycznie wartości identyfikatorów mogą być inne.

Składnia smart numbers obsługuje następujące rodzaje obiektów aplikacji nAxiom: akcje, zmienne środowiskowe, role (biznesowe i systemowe), statusy biznesowe, typy biznesowe, źródła danych, wartości słownikowe i grupy interesariuszy.

Aby użyć mechanizmu, wpisz nawias klamrowy otwierający ({) i symbol ampersand (&) co spowoduje wyświetlenie listy aplikacji zdefiniowanych w systemie. W niektórych przypadkach jest dostępna pozycja PARENT, która oznacza aplikację macierzystą dla bieżącego formularza.

Po wybraniu aplikacji wpisz kropkę, aby wyświetlić listę obsługiwanych obiektów. Obecnie są to:

• akcje (Actions): następnie wybierz kod modułu i kod akcji

• zmienne środowiskowe (AppVariables, AppInLineVariables): następnie wybierz kod zmiennej

  • 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
  • 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 (“).

• role biznesowe (BusinessRoles): następnie wybierz kod modułu i kod roli
• statusy dokumentów (BusinessStatuses): następnie wybierz kod definicji dokumentu i kod statusu
• typy biznesowe (BusinessTypes): następnie wybierz kod definicji dokumentu i kod typu biznesowego
• źródła danych (DataSources): następnie wybierz kod modułu i kod źródła danych
• wartości słownikowe (Dictionaries) następnie wybierz kod słownika i kod wartości słownika

• grupy interesariuszy (Stakeholders) następnie wybierz kod definicji dokumentu i kod grupy interesariuszy

  

Przykładowa składnia reprezentująca wartość identyfikatora dla statusu Odrzucono to:

{&Reklamacje34.BusinessStatuses.rklRjs.rklRjs_odrzucono}

W momencie wywołania zapytania dynamicznie obliczana jest wartość identyfikatora wybranego obiektu lub pobierana wartość zmiennej.

Aby składnia smart numbers działała poprawnie, kod w definicji obiektu nie może zawierać znaków diakrytycznych.

W przypadku dodania nowego elementu (roli, kategorii interesariuszy, pozycji słownika, statusu, typu biznesowego, zmiennej środowiskowej) lista obiektów dostępnych w składni smart numbers zaktualizuje się po przelogowaniu konsultanta lub po wyczyszczeniu pamięci podręcznej (ADMINISTRACJA > Ustawienia systemowe > Cache > Monaco).

Aby aplikacje nAxiom importowane do innej witryny działały poprawnie, konieczne jest zastąpienie wszystkich odwołań do konkretnej wartości identyfikatora składnią smart numbers. Poniżej wymieniono miejsca w aplikacji AdminSPA, w których można używać składni smart numbers. Ręczne wpisanie wyrażenia smart numbers w innych miejscach nie zostanie poprawnie przetworzone.

Gdzie używać smart numbers

Składni smart numbers można używać:

• w każdym edytorze SQL
• w akcji algorytm C# (pole Algorytm C#)
• w akcji zapytania do webserwisów (pole Ścieżka żądania)
• w poniższych polach definicji źródła danych:
  • Adres serwera
  • Open api url
  • Serwer autoryzacji
  • Nazwa bazy danych
  • Nazwa instancji
  • Port
• w polach tekstowych, hybrydowych tekst/SQL i numerycznych, w których jest wyświetlana informacja o obsłudze smart numbers (jako „placeholder text”)

• w definicji zmiennych aplikacji w polach wartości zmiennej

  W definicji zmiennych można również odwoływać się do innych zmiennych, używając selektora AppInLineVariables.

Jednak tylko w dwóch pierwszych przypadkach implementacja smart numbers interaktywnie wyświetla podpowiedzi. W pozostałych przypadkach można wyrażenie smart numbers wpisać ręcznie (lub wkleić) i będzie ono prawidłowo interpretowane podczas wykonywania aplikacji po stronie FrontSPA. W tych przypadkach zastosowanie mają przede wszystkim zmienne aplikacji używane z selektorem AppInLineVariables.

Automatyczne użycie smart numbers

Podczas konfigurowania listy wyboru interesariusza na formularzu można zawęzić użytkowników wyświetlanych na liście do określonej roli biznesowej. Wybrana rola zostanie automatycznie dodana w klauzuli WHERE zapytania SQL w konfiguracji listy z użyciem składni smart numbers. Pokazano to na ilustracji poniżej.

Powiązane tematy:

• Ustawienia systemu, sekcja cache