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).

Uwaga: W produkcie podstawowym udostępnianych jest wiele usług biznesowych odwołujących się do tej usługi, które mogą zostać użyte jako szablon.

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.

OSTRZEŻENIE: Nie ma ona pełnić roli całościowej informacji na temat usług biznesowych. Wszystkie obsługiwane usługi biznesowe można znaleźć na stronie usługi biznesowej.

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.