Formularz kontaktowy 

Funkcjonowanie

Poniżej opisana została metoda tworzenia „formularza XTEND” poprzez wykonywanie czynności „Zapisz” na obiekcie AYZ X3 uruchomionej kliknięciem przycisku na stronie HTML. Dane formularza są wprowadzane przez użytkownika w polach formularza HTML i służą jako ustawienia czynności.

Jeżeli witryna XTEND utworzona została z kopii witryny ASAMPLE, to rekordy ustawień już istnieją.

W przeciwnym wypadku istnieje możliwość utworzenia ich lub skopiowania kolejno z witryny ASAMPLE przez użycie przycisku czynności X3 „Kopiuj”.

Formularz XTEND składa się z:

  • nagłówka (sekcji listy):
      • Temat (TTL)
      • Adres email użytkownika (MAICOD))
      • Komunikat (CMT))
      • Rodzaj (TYP)
  • ustawień (sekcja tabeli) służących do kontroli opcji:
      • Opisu (PARCOD)
      • Wartości (PARVAL)

Dane, jakie są obliczane w momencie tworzenia to: kod (FRMCOD), status (STATUT) i data utworzenia (CREDAT).

W naszym przykładzie celem jest stworzenie formularza zapytania kontaktowego (TYP=CON) z następującymi opcjami dotyczącymi danej osoby:

  • Firma
  • Działalność
  • Kod pocztowy
Tworzenie
  • Utworzenie strony HTML (AXTDFRMCREATE) z formularzem wprowadzania danych.
    Dla celów poniższego przykładu, dane formularza przesyłane są w trybie kodowanym (HTTPS)
  • Tworzenie interfejsu (AXTDFRM) w celu wywołania usługi sieciowej
  • Tworzenie czynności sieciowej typu „tworzenie obiektu X3” (AXTDFRMCREATE) z ustawieniami pozwalającymi na wprowadzanie Tytułu, adresu email, komentarza oraz z listą wybranych opcji.
    Te ustawienia zostaną „zmapowane” na ustawieniach po wprowadzeniu usługi sieciowej.
  • Utworzenie tokena łącza dynamicznego (ADLKCONTACTNEW), który zostanie umieszczony na stronie HTML (przycisk „Utwórz”), w celu nadania ustawieniom wartości formularza HTML i uruchomienia czynności.
Wyświetlane

Po jego utworzeniu, formularz wyświetlany na bieżącej stronie w trybie zablokowanym, dzięki czemu użytkownik może zweryfikować jego zawartość.

Oznacza to odczyt danych przesłanych przez usługę sieciową (nagłówka i ustawień) i wyświetlenie ich na ekranie.

Odczyt dokonywany jest poprzez mapowanie ustawień podczas ich przekazywania z usługi sieciowej do dwóch jednostek XTEND (XTDFRMHEAD i XTDFRMPARAM) w celu utworzenia danych w pamięci i wstawienie dwóch tokenów sekcji (ABLKFRMHEAD i ABLKFRMPARAM) w celu wyświetlenia danych.

Token „sekcji warunkowej” (ACNDXTDFRMHIDE) zarządza sposobem wyświetlania na tej samej stronie (formularz edytowalny i formularz utworzony jako nieedytowalny).

Zapytanie

Zapytania do utworzonych formularzy mogą być przesyłane poprzez funkcję X3: Form(GESAYZ)

Ustawienia X3

Poniższa część stanowi uzupełnienie procedury tworzenia czynności użytkownika.

Krok nr 1 - Tworzenie interfejsu

1. Utwórz interfejs „Czynności użytkownika obiektu” AXTDFORM opartego na nazwie publikacji obiektu AYZ (AXTDAYZ)

2. Generuj dostęp

3. Wygeneruj wszystkie pola interfejsu
Patrz menu „Narzędzia/Tworzenie pola tokenu”

Krok nr 2 - Tworzenie jednostek

Utwórz jednostki:

  • AXTDFRMHEAD z polami nagłówka
  • XTDFRMPARAM z polami opcji PARCOD i PARVAL

Patrz menu Narzędzia/Wprowadzania: pomoc.

Jednostki te są następnie wykorzystywane w mapowaniu zwrotnym czynności tworzenia formularza.

W naszym przykładzie, dla AYZ zostały zdefiniowane dwa klucze:

  • FRMCOD, odnoszący się do identyfikatora formularza
  • FCYCOD, będący kodem witryny XTEND i jest równy kodowi bieżącej witryny.


Klucz FCYCOD filtruje formy w zależności od bieżącej witryny ASAMPLE.

Konieczne jest usunięcie tego klucza w celu odczytania wszystkich formularzy bazy danych.

Krok nr 3 - Tworzenie czynności sieciowej

Raportowanie ustawień

Utwórz czynność typu „standardowa” AXTDFRMCREATE z ustawieniami: typ, tytuł, adres email, komentarz i opcje.

Tylko ustawienia usług sieciowych właściwe dla kontekstu wywołania czynności zostają zadeklarowane jako ustawienia wprowadzanej czynności.

Token łącza dynamicznego wskazuje, jaka wartość zostanie nadana tym ustawieniom, w zależności od kontekstu wywołania (pole sieciowe, pole XTEND itd.).

„Kasowanie podczas uruchomienia”
zaznaczone w celu usunięcia jednostek AXTDFRMHEAD i AXTDFRMPARAM podczas uruchomienia czynności (przed uzyskaniem wyniku wywołania podprogramu) w celu kontrolowania poprawnego wyświetlania wyników na tej samej stronie HTML, poprzez token „sekcji warunkowej” oparty na obecności pola FRMCOD.

Raportowanie czynności
Tak: dla wszystkich wywołań będą rejestrowane w logu

Aktywne przy powtórnym ładowaniu
Nie: aby zapobiec utworzeniu formularza po wciśnięciu klawisza F5 po utworzeniu formularza

Przycisk uaktywnienia
Utwórz: aby uruchomić przycisk czynności „Zapisz obiekt AYZ”

Mapowanie ustawień na wejściu

Ma ono to na celu dopasowanie pola XTEND do ustawień wywołania usługi sieciowej.

W tym przykładzie konieczne jest tylko mapowanie ustawień czynności TYP, TTL, CMT,MAIDCOD, PARCOD i PARVAL.

Mapowanie PARCOD i PARVAL jest mapowaniem typu „Multi”, co umożliwia serwerowi XTEND „mapowanie” kilku pól HTML o takiej samej nazwie w ramach ustawień wielowymiarowych.

Kod jednostki nie jest wprowadzany, w celu „mapowania” ustawień czynności.

Ustawienia usług sieciowych, których wartości pochodzą zawsze z tego samego kontekstu, mogą mieć nadawane wartości bezpośrednio w trakcie mapowania czynności poprzez określenie jednostki.

Na przykład, jeżeli konieczne jest przekazanie kodu logowania użytkownika, może on być zmapowany bezpośrednio z polem AUSERCODE jednostki ASESSION, zamiast być zadeklarowanym jako ustawienie czynności.

Mapowanie ustawień na wyjściu

Dane zwrócone przez X3 powinny utworzyć dwie jednostki XTEND:

  • AXTDFRMHEAD, w której przechowywane pola ekranów list
  • AXTDFRMPARAM (Multi), w której przechowywane są pola sekcji tabeli zwierającej ustawienia

Jednostki typu Czynność są archiwizowane do późniejszego wykorzystania podczas sesji użytkownika.

Zostają one automatycznie odtworzone po każdym wywołaniu działania.

Czynności usuwania wpisów

Aby móc zarządzać wyświetlaniem poprzez „sekcję warunkową”, jednostki powinny zostać usunięte przy pierwszym pojawieniu się strony (w momencie kliknięcia tokenu łącza dynamicznego ADLKCONTACT, znajdującego się w menu po lewej stronie).

W tym celu tworzona jest czynność AXTDFRMRESET usuwająca jednostki AXTDFRMHEAD i AXTDFRMPARAM.

Czynność ta jest powiązana z tokenem ADLKCONTACT.

Typ
Standardowy

Interfejs
Brak

Krok nr 4 - Tworzenie łącza dynamicznego

Łącze dynamiczne ADLKXTDFRMCREATE jest tokenem, który jest wstawiany w przycisku logowania

Służy do określenia strony docelowej (bieżącej strony) w celu skojarzenia czynności AXTDFRMCREATE i określenia wartości ustawień.

Parametry ogólne

Raportowanie czynności
Tak: by każde kliknięcie na link zostało zarejestrowane w logu

Wymuszenie trybu http post
Nie: Ponieważ działanie na ustawieniach jest związane z łączem dynamicznym, zapytanie zostaje automatycznie wysłane w trybie POST

Bieżąca strona
Tak: Wynik (utworzony komunikat lub formularz) jest wyświetlany na bieżącej stronie

Czynność
Kod uruchamianej czynności

Pola kontrolne sieci
Tak: W celu kontroli ustawień sieciowych (patrz sekcja „Czynności”)

Ustawienia czynności

Celem jest zadeklarowanie wszystkich ustawień czynności i wskazanie metody określenia ich wartości.

Pole TYP
Stałe: Typem formularza jest zawsze „kontaktowy” (CON)

Pole TTL, MAICOD
„Mand. Web fld”: Obowiązkowy wpis w polu sieciowym.

Pola CMT, PARCOD, PARVAL
„Web field”: Nieobowiązkowy wpis w polu sieciowym.

Cste/Attrib. web
Zawierają nazwę znacznika wejściowego (nazwę trybutu)

Kontrola wpisu jest aktywna tylko wtedy, gdy zaznaczona jest opcja „Zakładka ogólna/Kontrola pól sieci”.

Zapytanie jest wysyłane do serwera XTEND tylko wtedy, gdy:

  • użytkownik nadał wartości wszystkim wymaganym polom
  • wprowadzone dane są prawidłowe dla wszystkich pól typu data i numeryczne.

Kontrola zostaje przeprowadzona przez bibliotekę XTEND JavaScript.

Token wyświetlania strony

Token ADLKCONTACT może służyć do wyświetlania strony tworzenia formularza z menu po lewej stronie.

Aby móc zarządzać sposobem wyświetlania poprzez ACNDXTDFRMHIDE (sekcję warunkową), konieczne jest usunięcie jednostek formularza przy pierwszym wyświetleniu.

Operacja ta wykonywana jest poprzez powiązanie czynności AXTDFRMRESET z tokenem ADLKCONTACT.

Jest to token służący do wyświetlania strony w trybie zabezpieczonym (https) w celu wykazania, że dane użytkownika są zakodowane.

Raportowanie czynności
Tak

Wymuszenie trybu post
Tak: Aby utrzymać kontekst XTEND zapisany na bieżącej stronie.
Metoda HTTP GET jest wykorzystywana wyłącznie dla łączy typu „kotwica”, które muszą być kompatybilne z robotami sieciowymi typu „crawler”.

Bieżąca strona
No/AXTDFRMCREATE: Strona docelowa

Czynność
AXTDFRMRESET : w celu usunięcia jednostek formularza

Krok nr 5 - Tworzenie tokenów sekcji

Tokeny sekcji ABLKFRMHEAD i ABLKFRMPARAM służą do wyświetlania jednostek AXTDFRMHEAD i AXTDFRMPARAM, reprezentujących dane formularza XTEND.

Sekcja nagłówka

Typ
Pojedynczy rekord: Odczytuje jednostkę AXTDFRMHEAD, umieszcza dane na szczycie stosu kontekstu i wykonuje tokeny potomne.

Brak danych
Nic nie wyświetlono: Jeżeli jednostka AXTDFRMHEAD nie istnieje, tokeny sekcji i tokeny podrzędne nie są brane pod uwagę

Jednostka
AXTDFRMHEAD : Kod jednostki do wyświetlenia

Sekcja parametrów

Typ
Multi rekord: Wykonuje iterację dla wszystkich jednostek ASHIPADDR i AXTDFRMPARAM każdą jednostkę na górze stosu kontekstu danych, a następnie wykonuje tokeny podrzędne

Brak danych
Nic nie wyświetlono: Jeżeli jednostka AXTDFRMHEAD nie istnieje, tokeny sekcji i tokeny podrzędne nie są brane pod uwagę

Jednostka
AXTDFRMPARAM : Kod jednostki do wyświetlenia

Wiersz według sekcji:
10: Wyświetla maksymalnie 10 jednostek AXTDFRMPARAM na stronie

Komórka według wierszy
1: Wyświetla jedną jednostkę AXTDFRMPARAM na wiersz

Styl dla wiersza
Brak: Styl do zdefiniowania w pliku „my.css” w celu zmiany koloru tła wiersza

Nie jest możliwe zdefiniowanie kryteriów wyboru w sekcjach wyboru jednostek archiwizowanych na serwerze XTEND, które są typu Sesja lub Czynność. Sekcja ta wybiera automatycznie wszystkie jednostki.

Kryteria wyboru są stosowane wyłącznie do jednostek typu „Dostęp do danych”.

Krok nr 6 - Tworzenie tokena sekcji warunkowej

Celem jest zilustrowanie użycia sekcji warunkowych.

Token ACNDXTDFRMHIDE służy do modyfikowania zawartości strony, w zależności od obecności lub braku formularza.

  • Jeżeli jednostka AXTDFRMHEAD istnieje (sekcja AXTDFRMHEAD nie jest pusta), oznacza to że formularz został utworzony i powinien zostać wyświetlony
  • Jeżeli jednostka AXTDFRMHEAD nie istnieje (sekcja AXTDFRMHEAD jest pusta), oznacza to że powinny zostać wyświetlone pola wpisu.

Wyświetlanie
Nie zaznaczone: Oznacza to, że zawartość tokena (html lub tokenów podrzędnych) jest ukryta, jeżeli nie zaznaczono warunku.

Typ kryteriów
Pusta sekcja: Wskazuje, że warunki wyświetl/ukryj oparte zostały na tym, że jeden z zawiera lub nie zawiera danych

Sekcja
ABLKFRMHEAD : Kod sekcji, jaki ma zostać sprawdzony

Czynność AXTDFRMRESET, usuwająca jednostki formularza, została utworzona, w związku z czym pola wpisu wyświetlane są przy pierwszym wyświetleniu strony, nawet jeżeli formularz został utworzony już wcześniej.

Czynność ta wywoływana jest przez token łącza dynamicznego AXTDFRMRESET, wyświetlającego stronę tworzenia formularza poprzez kliknięcie menu z lewej strony.

Krok nr 7 - Tworzenie strony

Utwórz stronę AXTDFRMCREATE.

Strona domyślna
Powiąż plik contact.html.
Plik musi być obecny na serwerze X3 i może zostać wybrany klawiszem F12.

Protokół
Https: Służy do wskazania, że ​​konieczne jest kodowanie danych zapytania Http (patrz konfiguracja HTTPS)

Sekcja główna i sekcja tła
Brak

Dostęp chroniony
Nie: służy do wskazania, że ​​strona jest w dostępie otwartym (anonimowym)

Raportowanie czynności
Tak: służy do rejestracji każdego wyświetlenia strony w logu

Krok nr 8 – Zatwierdzenie witryny

Po modyfikacji ustawień X3 zaleca się sprawdzenie witryny w całości w celu opracowania słownika serwera XTEND poprzez funkcję Zatwierdzenie witryny internetowej (AYTFCYGEN)”.

Zweryfikuj, czy witryna XTEND została opublikowana, tzn. czy zostało zaznaczone pole „Publikuj witrynę” rekordu „Witryna internetowa”.

Strona HTML

Łącze do strony

Wstawienie łącza dynamicznego ADLKCONTACT w menu po lewej stronie w celu wyświetlenia strony i usunięcia utworzonego formularza.

<TD class='button'><A adx=»ADLKCONTACT»>Kontakt</A></TD>

Zarządzanie wyświetlaniem

Token „sekcji warunkowej” ACNDXTDFRMHIDE służy do wyświetlania wpisu formularza, w wypadku gdy nie został odnaleziony formularz XTEND. W przeciwnym wypadku, wyświetla on zawartość formularza.

<!adx='ACNDXTDFRMHIDE'>
<!-- Wyświetl zawartość utworzonej formuły jeśli sekcja ABLKFRMHEAD nie jest pusta-->
<!adx='ACNDXTDFRMHIDE'>
<!adx='ACNDXTDFRMHIDE:xNot'>
<!-- Wyświetl formułę jeśli sekcja ABLKFRMHEAD nie jest pusta-->
<!-- Ustawienia xNot:Odwrócony warunek tokenu 'sekcji warunkowej'-->
<!adx='ACNDXTDFRMHIDE'>

Wpis nagłówka

Tworzenie pól <input> z tokenem adx=„FieldName”.

Jeżeli w znaczniku <input> nie został określony żaden atrybut, jest on generowany automatycznie z nazwą tokenu adx.
W wypadku wykrycia przez serwer XTEND błędu wpisu aplikacji X3, ustawienie xrc(<input adx='TokenName:xrc'>) służy do ponownego wywołania ostatniej wprowadzonej wartości.
Pozwala on uniknąć utraty wprowadzanych danych.

<H1>Formularz kontaktowy</H1>
<table>
<tr>
<td><b><b>Email:</b></td>
<td>
<input type='text' adx='MAICOD:xrc' size="'50'>"
</td>
</tr>
<tr>
<td><b><b>Temat:</b></td>
<td>
<input type='text' adx='TTL:xrc' size="'50'>"
</td>
</tr>
<tr>
<td><b>Wiadomość:</b></td>
<td>
<textarea adx='CMT:xrc' rows='5' cols='75'></textarea>
</td>
</tr>
</table>

Wprowadzanie opcji

Tworzenie pól łączy: <input> taki jak Klucz/Wartość, jaki zostanie „zmapowany” na dwóch kolumnach sekcji tabeli lub dwóch N-wymiarowych ustawieniach podprogramu.

  • PARVAL zawiera dane wprowadzone przez użytkownika
  • PARCOD zawiera kod o wartości fiwe, niemożliwy do zobaczenia („ukryty”).

Mapowanie PARCOD/PARVAL łączy się z ustawieniami usług sieciowych i jest przeprowadzany zgodnie z kolejnością tworzenia pól na stronie HTML.

<tr>
<td><b>Société:</b></td>
<td>
<input type='Text' adx='PARVAL:xrc' size="'50'><BR/"> <input type='hidden' name='PARCOD' value='Société'>
</td>
</tr>
<tr>
<td><b>Activité:</b></td>
<td>
<select adx='PARVAL'>
<option value=''>Pr&eacute;ciser :</option>
<option value='Artisans' >Artisans</option>
</select>
<input type='hidden' name='PARCOD' value='Activité'>
</td>
</tr>
<tr>
<td><b>Kod pocztowy:</b></td>
<td>
<input type='text' value='' adx='PARVAL:xrc' size="'10'><BR/"> <input type='hidden' name='PARCOD' value='Code Postal'>
</td>
</tr>

Tworzenie przycisku

Tworzenie „Przycisku” wprowadzania z atrybutem adx, zawierającym kod łącza dynamicznego.

Wszystkie przyciski <input type='button'> zawierające tokeny adx muszą być typu „przycisk”.
Nie należy używać typu „prześlij”.

<tr>
<td>
<input type='button' class='button' adx='ADLKXTDFRMCREATE' value='Créer'>
</td>
</tr>

Działanie użytkownika zostaje uznane za zatwierdzone, jeżeli wywołanie usługi sieciowej nie wyśle żadnego komunikatu błędu.

Komunikaty o błędach są wysyłane w języku 4GL przez podprogram ADDMESSERR (Wywołanie ADDMESSERR('Message') z AWEB)

Komunikaty X3 są wyświetlane poprzez token AXUSERMSG.

Ex: <span id='userMsg' class='userMsg' adx='aMsgUser'></span>

Automatyczna kontrola wprowadzania danych

Pola MAICOD i TTL zostały zdefiniowane jako obowiązkowe pola sieciowe, kontrola odbywa się w sposób automatyczny i nie wymaga dodania kodu JavaScript.

Wyświetlane komunikaty o błędzie to AJSWEBFLDMANDAT (pole obowiązkowe) i AJSWEBFLDBADVAL (błędny format).

Dodatkowa kontrola w JavaScript

Możliwe jest dodanie elementów kontrolnych w JavaScript w ramach ustawień sieciowych poprzez dodanie na stronie HTML funkcji JavaScript zwanej xtdWebParamCheckValue .

Jeżeli biblioteka XTEND wykryje obecność tej funkcji, będzie ona wywołana poprzez poniższe ustawienie:

  • aWebParamOutl'objet reprezentujący to ustawienie
      • aWebParamOut .setValue(String) nadający wartość temu ustawieniu
      • aWebParamOut .getValue() zwraca wartość ustawienia
  • aInputFieldName kod ustawienia
  • aInputFieldIndex indeks, jeżeli łącze umieszczone jest w sekcji
  • aInputFieldValue wartość ustawienia

Funkcja ta zwraca prawdę\fałsz w celu potwierdzenia\odrzucenia wpisu.

Komunikat AJSWEBFLDBADVAL wyświetlany jest w przypadku wystąpienia błędu wpisu.

Na przykładowej stronie została dodana funkcja kontrolująca format email.

<script type='application/x-javascript'>
// Funkcja ta umożliwia dopasowanie kontroli wartości parametrów sieciowych
function xtdWebParamCheckValue(aWebParamOut,aInputFieldName,aInputFieldIndex,aInputFieldValue){
// Sprawdzenie wartości danych wejściowych adresu email
if (aInputFieldName=='MAICOD'){
var wEmail=xtdCheckEmail(aInputFieldValue);
if (wEmail && wEmail!=aInputFieldValue)
aWebParamOut.setValue(aInputFieldIndex,wEmail);
return wEmail!=null;
}
return true;
}
</script>

Funkcja xtdWebParamCheck służy do filtrowania pól, jakie mają być kontrolowane.

Działa analogicznie do xtdWebParamCheckValue.

var gNbChecked=0;
// Zwraca wartość „true” jeżeli wskazana jest kontrola ustawień sieciowych aInputFieldName/aInputFieldIndex
function xtdWebParamCheck(aWebParamsOut,aInputFieldName,aInputFieldIndex){
/*
Przykład listy pobrań z polami wyboru (ASELECTED) służącymi do wyboru wierszy.
Pole AQUANTITY nie jest kontrolowane, jeżeli wiersz nie został wybrany
*/
if (aInputFieldName=='AQUANTITY'){
// gNbChecked jest licznikiem wybranych pozycji
if (aInputFieldIndex==0) gNbChecked=0;
// Wiersz został wybrany, jeżeli wartość ASELECTED jest równa 1
if (aWebParamsOut.getParamValue('ASELECTED',aInputFieldIndex)=='1'){
gNbChecked++;
return true;
}
return false;
}
return true;
}

Wyświetlanie nagłówka

Sekcja ABLKFRMHEAD służy do ustawiania kontekstu danych.

Pola wyświetlane są poprzez token adx umieszczony w znaczniku HTML.

<table width="'90%'" border="'0'" cellspacing='2' cellpadding='4'>
<!adx='ABLKFRMHEAD'>
<tr>
<td><b>Email:</b></td>
<td adx='MAICOD'></td>
</tr>
<tr>
<td><b>Sujet:</b></td>
<td adx='TTL'></td>
</tr>
<tr>
<td><b>Wiadomość:</b></td>
<td><pre adx='CMT'></pre></td>
</tr>
<!adx='ABLKFRMHEAD'>
</table>

Opcje wyświetlania

Sekcja ABLKFRMPARAM służy do powtarzania opcji formularza i tworzenia takiej samej liczby wierszy <tr> co liczba opcji.

Dla każdej opcji XTEND ustawia kontekst danych, co ma na celu uzyskanie wartości tokenów adx PARCOD i PARVAL umieszczonych w znacznikach HTML.

<!adx='ABLKFRMPARAM'>
<tr>
<td><b adx='PARCOD'></b></td>
<td adx='PARVAL'></td>
</tr>
<!adx='ABLKFRMPARAM'>

JavaScript

Punkt wpisu pageDoMyDlk służy do dodawania procesu uruchamianego kliknięciem użytkownika i anulowania bieżącego procesu w wypadku zwrócenia wartości „fałsz”.

W tym przypadku jest to prośba o potwierdzenie przed wysłaniem formularza na serwer XTEND.

//Prosi użytkownika o potwierdzenie utworzenia nowego formularza po kliknięciu przez użytkownika na łącze dynamiczne ADLKCONTACTNEW
function pageDoMyDlk(aDomOut)
{
if (aDomOut.isDlk('ADLKCONTACTNEW'))
return confirm('Confirm form creation\Confirm creation');
return true;
}

Punkt wpisu xtdWebParamCheckValue jest częścią mechanizmu kontrolującego wartości „pól sieciowych” XTEND (ustawienia sieciowe czynności XTEND).

Jeżeli funkcja xtdWebParamCheckValue została zdefiniowana na stronie HTML, jest ona wywoływana przez bibliotekę XTEND przy każdej kontrol „pól sieciowych”.

W tym przypadku - kontrola wartości pola MAICOD (adresu email) poprzez funkcję XTEND xtdCheckEmail.

// Funkcja ta umożliwia dopasowanie kontroli wartości parametrów sieciowych
function xtdWebParamCheckValue(aWebParamOut,aInputFieldName,aInputFieldIndex,aInputFieldValue){
// Sprawdzenie wartości danych wejściowych adresu email
if (aInputFieldName=='MAICOD'){
var wEmail=xtdCheckEmail(aInputFieldValue);
if (wEmail && wEmail!=aInputFieldValue)
aWebParamOut.setValue(aInputFieldIndex,wEmail);
return wEmail!=null;
}
return true;
}