Projektowanie > Safe X3 WAS > Połączenie SAFE X3 > Czynność sieciowa 

SEEWARNINGZaleca się, by przed utworzeniem własnej witryny przeczytać dokumentację:Przed rozpoczęciem.


Czynność użytkownika typu EXTEND wyzwala operację wykonywaną bezpośrednio przez serwer XTEND lub odwołuje się do usługi sieciowej X3, będącej podprogramem lub czynnością powiązaną z obiektem X3.
Czynność wykorzystuje usługi sieciowe X3 jeżeli powiązana jest z interfejsem.
Czynność służy do opisywania mapowania pomiędzy obiektami XTEND/polami i grupami/konfiguracjami interfejsu przy odbiorze (analiza ustawień wywołania) oraz wydawaniu (przetwarzania przesłanych wartości).
Czynność przypisana jest do łącza dynamicznego zamieszczonym na stronie HTML jako przycisk lub tag kotwicy.
Czynność jest uruchamiana po kliknięciu przez użytkownika.

Predefiniowane działania

Szczegóły predefiniowanych działań

Kod

Konfiguracje

Łącze dynamiczne

Opis

ABLKFIRSTPAGE

Nie

ADLKFIRSTPAGE

Wyświetla pierwszą stronę bloku
Składnia MyBlock.MyDynamicLink

ABLKNEXTPAGE

Nie

ADLKNEXTPAGE

Wyświetla następną stronę bloku

ABLKPREVPAGE

Nie

ADLKPREVPAGE

Wyświetla poprzednią stronę bloku

ABLKLASTPAGE

Nie

ADLKLASTPAGE

Wyświetla ostatnią stronę bloku

ABLKRESTOREMAINCTX

Nie

Do utworzenia

Powróć do listy bez utraty podziału na strony
Utwórz łączne dynamiczne do strony zawierającej blok jako do strony docelowej

ABLKSELECT

Nie

ADLKSELECT

Służy do wyboru wiersza bloku
MyBlock.MyField wyświetla wartość MyField do wybranego wiersza

ABLKUNSELECT

Nie

ADLKUNSELECT

Służy do usunięcia wyboru wiersza bloku

ARESTOREFORM

Nie

ADLKRESTOREFORM

Przywraca formę HTML z wartościami pierwotnymi
Nie uwzględnia parametru HTML xrc

ARESTORESESSION

Nie

ADLKRESTORESESSION

Wykorzystywane na stronie ponownego połączenia (patrz: historia witryny)
Wyświetla ostatnią stronę otwartą przed zamknięciem przeglądarki

ASESSLOGIN

Tak

ADLKLOGIN

Logowanie użytkownikaKod użytkownika (AUSERCODE) oraz hasło (APWD) w konfiguracji
Należy jeszcze wykonać mapowanie interfejsów oraz ustawień

ASESSLOGOUT

Nie

ADLKLOGOUT

Służy do wylogowania użytkownika

ASESSSWITCHCOOKIES

Nie

ADLKSWITCHCOOKIES

Służy do przełączania się pomiędzy trybami „z ciasteczkami” oraz „bez ciasteczek”.
Wykorzystaj blok warunkowy ADISPNOCOOKIES
do wyświetlenia stanu sesji z ciasteczkami/bez ciasteczek

ASESSSWITCHLANG

Tak

Nie

Zmień język użytkownika
Kod języka jest parametrem

ASESSSWITCHSITE

Tak

Nie

Zmienia witrynę
Dostępne kody X3SOLUTION/X3FOLDER/XTENDLANG/XTENDSITE

ATRACESET

Nie

ADLKTRACESET

Aktualizacja logu XTEND

SEEINFOW celu wykonania, należy dokonać konfiguracji czynności AXTDLOGIN przy uwzględnieniu interfejsu logowania, utworzonego dla tej strony.

Warunek

SEEREFERTTO Odniesienie do dokumentacji Implementacja

Zarządzanie ekranem

Nagłówek

Pola

Na tej karcie występują następujące pola :

Wybierz kod czynności.

SEEREFERTTO Zobacz tabelę Predefiniowane działania.

  • Lokalizacja (pole FCYLIB)

Bieżąca strona internetowa

  • Opis (pole INTIT)

Tytuł bieżącej czynności.

Zamknij

 

Karta Ogólne

Pola

Na tej karcie występują następujące pola :

Czynność

  • Typ (pole ACTTYP)

To pole informuje o typie czynności:

  • standardowa,
  • zalogowanie
  • lub wylogowanie.

Domyślnie zawiera wartość „Standardowa”.

  • Aktywne przy przeładowaniu (pole ACTREFRESH)

To pole wskazuje, czy czynność ma zostać wykonana ponownie po naciśnięciu przez użytkownika klawisza F5.

Domyślnie ma wartość „Nie”, która blokuje wykonanie czynności.
Zapobiega to tworzeniu nowego zlecenia po naciśnięciu klawisza F5.

  • Monitorowanie aktywności (pole LOGMOD)

To pole służy do włączania funkcji raportowania realizacji czynności.
Na serwerze XTEND jest prowadzony dziennik w pliku .log.

Jednostka do usunięcia

  • Rozpocznij usuwanie (pole ENTSUPBEF)

Czynność może powodować usuwanie jednostek na początku lub na końcu wykonywania.

  • Domyślnie pole nie jest zaznaczone. Jeśli nie występują błędy, usunięcie następuje na koniec wykonywania.

  • W przypadku zaznaczenia pola usunięcie następuje na początku czynności.

Na przykład:

Dla czynności przekazywania zlecenia:

  • Niezaznaczenie pola będzie sygnałem do usunięcia koszyka.
  • Jeśli zlecenie zostało utworzone bez błędów, koszyk zostanie usunięty.

Tabela Usuwanie

W tym polu należy wprowadzić kody jednostek, które mają zostać usunięte.

Zarządzanie usługami sieciowymi

To pole określa kod interfejsu wywoływanego przez czynność.

  • pole INTTYP

 

  • Przycisk uaktywnienia (pole WSOACT)

Wybierz typ przycisku dla obiektu:

  • Czytaj,
  • Utwórz,
  • Usuń,
  • Zapisz,
  • Inny: należy wpisać kod przycisku.

  • Kod przycisku (pole WSOACTBTN)

Jeśli w polu „Przycisk uaktywnienia” zostanie zaznaczona opcja „Inny”, należy wpisać kod przycisku.

Na przykład:

Dla obiektu Fakturamożna wpisać kod „V”. Przycisk będzie wtedy inicjował sprawdzanie poprawności faktury.

  • Typ parametru (pole WSOTYPPAR)

Dla czynności typu „Inny” należy zaznaczyć opcję „podpis” dotyczącą metody „actionObject”, która ma być wywoływana.

W przypadku usługi internetowej obiektów systemu X3 są dostępne dwie metody „actionObject”. Mają one takie same nazwy, ale różne parametry. Są to następne parametry:

  • „Klucze”: tabela kluczy obiektów
  • „Dane”: zawartość XML obiektu

Tabela Parametry akcji

Kod parametru czynności.
Parametr jest „polem tokenu”, który należy zadeklarować w słowniku.

  • Wartość (pole VALTYP40)

Możliwe są dwa rodzaje wartości:

  • Stała : służy do wprowadzania stałej wartości; należy ją wpisać w kolumnie „Stała”.
  • Wprowadzony ręcznie: wartość jest wpisywana w polu „Łącze dynamiczne” na podstawie kontekstu użycia.

Zazwyczaj w łączu dynamicznym wartość pochodzi:

  • z pola formularza HTML,
  • z pola jednostki typu „sesja” lub „czynność”,
  • z pola bloku (dostęp jednostki do danych): w tym przypadku wartość jest odczytywana z bloku ACURRENT.
  • Stała (pole VALEUR40)

Wartość stałej.

Zamknij

 

Karta Mapowanie interfejsu

Prezentacja

Ta zakładka przedstawia mapowanie pomiędzy polami XTEND a ustawieniami podprogramów lub pól obiektów X3.

Tabele

Parametry przy odbiorze (Obiekty do interfejsu)

Tabela „Obiekty/konfiguracja” --> przedstawia powiązania pomiędzy uprzednio dokonaną konfiguracją czynności a konfiguracją usługi sieciowej powiązanej z interfejsem.

SEEINFOW celu dokonania wyboru parametru czynności, kolumna obiektu nie powinna być analizowana.
W takim przypadku, lista parametrów czynności jest wyświetlana po wciśnięciu F12 na komórce „Pole/konfiguracja...”.

Możliwe jest również bezpośrednie mapowanie pola obiektu na konfigurację usługi sieciowej poprzez określenie kodu obiektu w kolumnie „Obiekt”.

Parametry przy odbiorze (Interfejs do Obiektów)

Tabela „Interfejs/Obiekty” --> przedstawia powiązania pomiędzy konfiguracją usługi sieciowej powiązanej z interfejsem a obiektami XTEND, utworzonymi przez czynność.

___________________________

Podczas mapowania usługi sieciowej obiektu X3, konfiguracja AMODSTAMP grupy ADXTEC zawiera wartość TimeStamp (oznaczenie ostatniej modyfikacji) obiektu X3.

AMODSTAMPjest otrzymanym polem tokenu.

Służy do obsługi konfliktów aktualizacji obiektów, które mogą mieć miejsce w trybie usług sieciowych (asynchronicznym).

Jeżeli ustawienie powraca do X3, proces X3 porównuje je z wartością obiektu zapisanego w bazie danych oraz zwraca błąd, jeżeli wartości się różnią („obiekt jest modyfikowany na innej stacji roboczej”).

Zamknij

 

Pola

Na tej karcie występują następujące pola :

Tabela Jednostki/parametry --> Interfejs

Kod jednostki XTEND służy do przyporządkowania parametrów.
Aby przypisać parametr czynności, należy pozostawić pole niewypełnione.

  • Pola/parametry (pole FIEKEY20)

Kod parametru czynności lub kod pola jednostki.

  • Grupa (pole DSCGRP20)

Kod ekranu grupy publikacji lub usługi sieciowej.

  • Ustawienie interfejsu (pole DSCCOD20)

Wybierz opcję „Nie”, aby przypisać N pól Xtend do N wartości tego samego parametru systemu X3.

Wtedy w kolumnie „Indeks” można wpisać indeks „parametru interfejsu” (parametru systemu X3) i w ten sposób nadać wartość polu XTEND.

SEEREFERTTO W celu uzyskania bardziej szczegółowych informacji patrz akapit Wielokrotne mapowanie.

  • Multi (pole INTMLT20)

Wybierz opcję „Nie”, aby przypisać N wartości tego samego parametru systemu X3 do N pól Xtend.

Wtedy w kolumnie „Indeks” można wpisać indeks parametru systemu X3 i w ten sposób nadać wartość polu XTEND.

SEEREFERTTO W celu uzyskania bardziej szczegółowych informacji patrz akapit Wielokrotne mapowanie.

  • Indeks (pole DSCIND20)

Przypisanie N pól Xtend do N wartości parametru systemu X3:

Wprowadź 'Nie'w kolumnie 'Multi'.
W tabeli wartości „Parametry interfejsu” (parametrów systemu X3) kolumna „Indeks” zawiera indeks komórki, w której zostanie umieszczona wartość pochodząca z pola XTEND.

SEEREFERTTO W celu uzyskania bardziej szczegółowych informacji patrz akapit Wielokrotne mapowanie.

Interfejs --> Jednostki

Kod czynności zawierający schemat powrotu, jeśli został już zdefiniowany dla innej czynności.

W przypadku obiektu programu X3 do tworzenia czynności XTEND służy przycisk czynności programu. Zasadniczo schemat powrotu jest taki sam dla wszystkich czynności. Można go opisać w jednej czynności.

Tabela Publikacja

  • Grupa (pole DSCGRP21)

Kod ekranu grupy publikacji lub usługi sieciowej.

  • Ustawienie interfejsu (pole DSCCOD21)

Nazwa parametru podprogramu albo kod pola obiektu programu X3.

  • Multi (pole INTMLT21)

Wybierz opcję „Nie”, aby przypisać N pól Xtend do N wartości tego samego parametru systemu X3.

Wtedy w kolumnie „Indeks” można wpisać indeks „parametru interfejsu” (parametru systemu X3) i w ten sposób nadać wartość polu XTEND.

SEEREFERTTO W celu uzyskania bardziej szczegółowych informacji patrz akapit Wielokrotne mapowanie.

  • Indeks (pole DSCIND21)

Przypisanie N wartości parametru systemu X3 do N pól Xtend:

Wprowadź 'Nie'w kolumnie 'Multi'.
Wartość pola XTEND jest podana w kolumnie „Indeks” stanowiącej wartość indeksu tabeli wartości „Parametry interfejsu” (parametrów systemu X3).

SEEREFERTTO W celu uzyskania bardziej szczegółowych informacji patrz akapit Wielokrotne mapowanie.

Kod jednostki, w której zostanie utworzone pole XTEND z wartością „parametru interfejsu”.

  • Pole (pole FIEKEY21)

Kod pola XTEND, które ma zostać utworzone.

Zamknij

 

Wielokrotne mapowanie

Mapowanie standardowe (pole do pola) odwołuje się do deklaracji konfiguracji 4GL pola.

W niektórych przypadkach nie należy deklarować jednego ustawienia pola, ale pogrupować wartości pól w jednej konfiguracji 4GL:

  • Jeżeli liczba pól przekracza 50 (forma HTML z wieloma polami wprowadzania).
    Usługa sieciowa X3 nie dopuszcza więcej niż 60 konfiguracji, z których 10 jest wykorzystywanych przez XTEND w charakterze konfiguracji technicznych.
  • Jeżeli liczbę pól można zmienić w konfiguracji, a nie jest wymagana modyfikacja usługi sieciowej, ani mapowania czynności po każdej zmianie.

GESAYA_1.jpg

XTEND zezwala na wykorzystanie jednej, wielowymiarowej konfiguracji 4GL w celu zachowania wszystkich wartości pól z kolumn mapowania „Multi” oraz „Indeks”.

Zależność wartość/pole jest określana na podstawie pozycji (indeksu) w tabeli.

„Multi” oraz „Indeks” są aktywne wyłącznie jeżeli konfiguracja interfejsu ma wymiar > 1.

Tryb standardowy (pole do pola)

Tworzenie pojedynczego wiersza mapowania.
Ustawienie „Multi” ma wartość” „Tak”, co oznacza, że pole zostanie utworzone przez obiekt XTEND o wartości odpowiadającej indeksowi bieżącego wiersza.

Konfiguracja indeksu nie jest wykorzystywana.

Tryb N wartości konfiguracji X3 -> N pól Xtend

Utworzenie tej samej liczby wierszy mapowania, co pól XTEND do określenia wartości
Wartość „Nie” w ustawieniu „Multi” oznacza, że należy wprowadzić wyłącznie jedno pole XTEND o wartości ustawienia X3, którego indeks został określony w kolumnie „Indeks”.

Tryb N pól Xtend -> N wartości konfiguracji X3

Utworzenie tej samej liczby wierszy mapowania, co wartości do dodania do konfiguracji X3.
Wartość „Nie” w ustawieniu „Multi” oznacza, że należy wprowadzić komórkę tabeli, której indeks został określony w kolumnie „Indeks”, o wartości pola XTEND.

Raporty

Z funkcją domyślnie powiązane są następujące raporty :

 PRTSCR : Drukowanie ekranu

Można to zmienić w ustawieniach.

Przyciski określone

Przycisk służy do kopiowania czynności sieciowej.

Pasek menu

Narzędzia / Zatwierdzenie ze sprawdzeniem

Komunikaty o błędzie

Jedynymi komunikatami o błędach są komunikaty ogólne.

Użyte tabele

SEEREFERTTO Odniesienie do dokumentacji Implementacja