Użyteczne usługi i usługi biznesowe
W niniejszej sekcji opisano niektóre usługi biznesowe i inne usługi udostępnione w produkcie, które mogą być przydatne podczas wdrożenia.
Usługa eksploratora danych
W systemie udostępniony jest mechanizm wykonywania instrukcji wyboru SQL do użycia w skryptach, wtyczkach Java lub przy użyciu wywoływania usługi WWW. Jest to wykonywane poprzez utworzenie strefy przy użyciu jednego z typów stref eksploratora danych, w których zdefiniowano SQL. Następnie należy utworzyć usługę biznesową przy użyciu usługi eksploratora danych (FWLZDEXP).
W poniższych punktach przedstawiono sposoby tworzenia własnej usługi biznesowej dla tej usługi. Należy pamiętać, że zazwyczaj dla każdej strefy istnieje oddzielna usługa biznesowa.
- Należy wprowadzić kod i opis usługi biznesowej. Zaleca się definiowanie kodu usługi biznesowej zgodnego z kodem strefy, aby ułatwić zarządzanie, która usługa biznesowa wywołuje którą strefę.
- Należy wybrać nazwę usługi FWLZDEXP.
- Na karcie Schemat w węźle <schema> należy wprowadzić odwzorowanie dotyczące pól wymaganych w usłudze eksploratora danych:
- Strefa powinna być odwzorowana do pola usługi ZONE_CD . Należy określić kod strefy jako wartość domyślną.
- Dla każdego filtra użytkownika zdefiniowanego w strefie należy utworzyć odwzorowanie schematu do pola usługi Fx_VALUE , gdzie "x" jest numerem filtra (z parametrów strefy).
- Dla każdego filtra ukrytego zdefiniowanego w strefie należy utworzyć odwzorowanie do pola usługi Hx_VALUE , gdzie "x" jest numerem filtra (z parametrów strefy).
- Wyniki wyszukiwania są zwracane przez usługę eksploratora danych jako lista. Wartość każdej kolumny znajduje się w polu usługi COL_VALUE z odpowiednim numerem kolejnym ( SEQNO ). Wyniki mogą zostać spłaszczone na podstawie numeru kolejnego, umożliwiając zdefiniowanie nazwy elementu logicznego.
- Inne użyteczne pole to ROW_CNT , zawierające liczbę wierszy pobranych w wyszukiwaniu.
Poniżej przedstawiono przykład schematu usługi biznesowej, która odbiera kod obiektu biznesowego i zwraca listę wartości statusu oraz ich opisy umożliwiające określenie przyczyny statusu.
<schema>
<zone mapField="ZONE_CD" default="F1-BOSTSLST"/>
<bo mapField="H1_VALUE" />>
<rowCount mapField="ROW_CNT"/>>
<results type="list" mapList="DE">>
<status dataType="string" mapField="COL_VALUE">
<row mapList="DE_VAL">>
<SEQNO is="1" />>
</row>>
</status>>
<description dataType="string" mapField="COL_VALUE">
<row mapList="DE_VAL">>
<SEQNO is="2" />>
</row>>
</description>>
</results>>
</schema>
Usługa dziennika obiektu obsługi
Wiele obiektów obsługi obsługuje tabelę dziennika zgodną ze wzorcem nazw i zachowania kolumn. W systemie udostępniona jest usługa o nazwie "Ogólna usługa dziennika obiektu obsługi" (F1MOLOGP), której można użyć do wykonywania często spotykanych funkcji związanych z zapisami dziennika:
-
Odczyt zapisów dziennika. Po przekazaniu określonego obiektu obsługi, klucza głównego i numeru kolejnego dziennika usługa zwróci szczegóły tego zapisu dziennika. W produkcie udostępniono ogólną usługę biznesową, którą można wykorzystać do tego celu - Ogólny obiekt obsługi - pobieranie szczegółów dziennika (F1-ReadMOLog). Można także utworzyć usługę biznesową dla danego obiektu obsługi, w której kod obiektu obsługi jest przydzielony do elementu obiektu obsługi przy użyciu składni domyślnej. Pozwala to na wykorzystanie w funkcji biznesowej dotyczącej tego obiektu obsługi określonej usługi biznesowej.
-
Dodawanie dziennika. Ta usługa może służyć do dodawania zapisu dziennika. Po dodaniu dziennika użytkownika w szczegółowym opisie umieszczone zostaną komentarze od użytkownika. Generowane systemowo zapisy dziennika zawierają zwykle kategorię komunikatu/numer komunikatu wraz z innymi informacjami, takimi jak status, określony typ dziennika i opcjonalnie powiązane odwołanie obiektu (za pośrednictwem charakterystyki). W produkcie udostępniono ogólną usługę biznesową, którą można wykorzystać do tego celu - Dodawanie ogólnego dziennika obiektu obsługi (F1-AddMOLog). Można także utworzyć usługę biznesową dla danego obiektu obsługi, w której kod obiektu obsługi jest przydzielony do elementu obiektu obsługi przy użyciu składni domyślnej. Pozwala to na wykorzystanie w funkcji biznesowej dotyczącej tego obiektu obsługi określonej usługi biznesowej.
Podstawowe usługi biznesowe
W niniejszej tabeli opisano niektóre usługi biznesowe udostępnione w produkcie, które mogą być przydatne podczas wdrożenia na potrzeby logiki niestandardowej.
Usługi powiązane z obiektem biznesowym
Nazwa usługi biznesowej | Opis |
---|---|
F1-AutoTransitionBO | Służy do wykonywania monitorowania algorytmów powiązanych z bieżącym stanem danego wystąpienia obiektu biznesowego (co może skutkować późniejszą zmianą stanu). |
F1-CompareBusinessObjectData | Umożliwia porównanie dwóch wersji danego wystąpienia obiektu biznesowego. |
F1-DetermineBo | Służy do określenia obiektu biznesowego danego wystąpienia obiektu obsługi poprzez wykonanie logiki określania obiektu biznesowego dotyczącej obiektu obsługi. |
F1-GetRequiredFieldsForBOState | Umożliwia zwracanie wymaganych pól statusu danego obiektu biznesowego. |
F1-RetrieveBOOption | Umożliwia zwracanie wartości opcji obiektu biznesowego dla danego obiektu biznesowego i typu opcji. |
F1-RetrieveBOStatusOption | Umożliwia zwracanie wartości opcji obiektu biznesowego dla danego obiektu biznesowego, statusu i typu opcji. |
F1-RetrieveBOStatusOption | Służy do pobierania listy obiektów biznesowych dla danego obiektu obsługi, dostępnych dla bieżącego użytkownika. |
F1-RetrieveBoStatusDescription | Zwracanie opisu statusu danego obiektu biznesowego. |
F1-RetrieveBusinessObjectLabel | Zwracanie etykiety odpowiedniej dla danej ścieżki (np. elementu) w schemacie obiektu biznesowego. |
F1-RetrieveNextStates | Zwracanie listy następnych możliwych stanów na podstawie danych wejściowych obiektu obsługi i jego klucza głównego lub obiektu biznesowego i jednego z jego statusów. |
Usługi powiązane z pocztą e-mail
Nazwa usługi biznesowej | Opis |
---|---|
F1-EmailService | Umożliwia wysłanie wiadomości e-mail w czasie rzeczywistym. |
F1-RetrieveEmailAddress | Służy do pobierania adresów e-mail użytkowników należących do roli Do wykonania. |
F1-RetrieveEnvironmentURL | Służy do pobierania informacji na temat adresu URL bieżącego środowiska instalacji. |
Narzędzia dotyczące odwzorowań i skryptów
Nazwa usługi biznesowej | Opis |
---|---|
F1-AddWarning | Ta usługa biznesowa może służyć do rejestrowania ostrzeżeń poprzez podawanie szczegółów komunikatu. W systemie zbierane są wszystkie ostrzeżenia, a następnie są wyświetlane wszystkie na raz użytkownikowi. |
F1-CheckOnlineConnection | Sprawdzanie, czy połączenie jest typu Online, czy typu Zadanie. |
F1-CheckWarning | Służy do sprawdzania, czy ostrzeżenia zostały zebrane. Jeśli ostrzeżenia zostały zebrane, nie należy wykonywać żadnej logiki, która nie może zostać wycofana (gdy ostrzeżenia są wyświetlane). |
F1-DateMath | Służy do wykonywania różnych obliczeń matematycznych daty i godziny. Więcej szczegółów można znaleźć w opisie usługi biznesowej. |
F1-DateTimeFormattingService | Służy do formatowania danej daty/godziny na podstawie ustawień profilu wyświetlania użytkownika. |
F1-ExecuteScriptInNewSession | Służy do wykonywania skryptu usługi w nowej sesji/transakcji przetwarzania. |
F1-GetFieldLabel | Służy do pobierania etykiety danego pola. |
F1-GetForeignKeyReference | Umożliwia zwracanie informacji dotyczących odwołania do klucza obcego dla danego odwołania do klucza obcego i klucza głównego, takich jak opis informacji, opcja nawigacji i menu kontekstowe. |
F1-GetFKReferenceDetails | Umożliwia zwracanie informacji dotyczących odwołania do klucza obcego dla danego obiektu obsługi i klucza głównego, takich jak kod odwołania do klucza obcego, opis informacji, opcja nawigacji, strefa wyszukiwania i menu kontekstowe. |
F1-GetLookupDescription | Umożliwia zwracanie opisu wyszukiwania dla wartości pola wyszukiwania dotyczącej nazwy pola wyszukiwania. |
F1-GetExtLookUpVal | Umożliwia zwracanie listy wartości danego obiektu biznesowego rozszerzanej listy wartości. |
F1-GetMonthInYearAbbreviation | Umożliwia zwracanie trzyznakowego skrótu miesiąca dla daty wejściowej w formacie systemowym. |
F1-NumberAmountFormatter | Służy do formatowania danej ilości lub liczby na podstawie ustawień profilu wyświetlania użytkownika. Może także służyć do odbierania danych wejściowych w celu skorygowania skali i opcjonalnie zastosowania ustawień waluty. |
F1-OutmsgDispatcher | Służy do przydzielania komunikatu w czasie rzeczywistym, dając użytkownikowi możliwość utrzymywania komunikatu w bazie danych i przechwytywania błędów, które mogą wystąpić podczas wywoływania. Więcej informacji można znaleźć w sekcji Komunikaty czasu rzeczywistego. |
F1-OutmsgMediator | Rozwiązanie alternatywne do F1-OutmsgDispatcher, które może być lepszą opcją, jeśli nadawca nie wymaga utworzenia wystąpienia rekordu komunikatu wychodzącego. Więcej informacji można znaleźć w sekcji Komunikaty czasu rzeczywistego. |
F1-RethrowError | Umożliwia zgłaszanie błędu aplikacji przy użyciu kategorii/numeru/parametrów komunikatu wejściowego. |
F1-RetrieveMODescription | Służy do pobierania opisu obiektu obsługi. |
F1-ReturnMessage | Umożliwia zwracanie rozwiniętego komunikatu na podstawie kategorii, numeru, parametrów i typów parametrów komunikatu. |
F1-SavePointDispatcher | Zezwala na wykonywanie skryptu usługi, gdy wyjątki są przechwycone, a transakcja jest cofnięta do bezpiecznego punktu wyznaczonego przed wykonaniem skryptu usługi. |
Usługi powiązane z użytkownikiem
Nazwa usługi biznesowej | Komentarze |
---|---|
F1-CheckApplicationSecurity | Służy do sprawdzania zabezpieczeń użytkownika dotyczących danej usługi aplikacyjnej/trybu dostępu |
F1-CheckUserAuthorization | Określanie, czy dany użytkownik ma uprawnienia dostępu, na podstawie wejściowej usługi aplikacyjnej, kodu zabezpieczeń i poziomu autoryzacji. |
F1-DetermineIfUserCanApproveTD | Określanie, czy bieżący użytkownik może zatwierdzić daną pozycję Do wykonania. |