Witryna ASAMPLE

Zawartość

Niniejszy dokument przedstawia witrynę ASAMPLE XTEND, która jest domyślną witryną XTEND i która zawiera standardowe tokeny definicji XTEND, jak również projekt HTML zbudowany za pomocą programu Dreamweaver (oprogramowanie do tworzenia stron internetowych).

Projekt ten zawiera strony szablonowe (strona główna, o nas, login, kontakt, błąd itp.), aby pomóc programiście XTEND rozpocząć projekt.

Projekt HTML

Pliki

Witryna ASMAPLE HTML bazuje na szablonie programu Dreamweaver.

Struktura stron

Szablon strony („Template\ASAMPLE.dwt”) stanowi przykład podziałów poprzez wykorzystanie „edytowalnych regionów” i „bibliotek .lbi” z główną treścią i elementami wspólnymi dla wszystkich stron:

• nazwa firmy w lewym górnym rogu
• strefa wyświetlania wiadomości w prawym górnym rogu
• menu po lewej stronie
• menu na dole strony
• arkusz stylów
• 2 funkcje JavaScript w celu rozłożenia procesów
• po wczytaniu strony (xBodyOnLoad)
• poprzez kliknięcie łącza dynamicznego (xtdDoMyDlk)

Edytowalne regiony

Szablon zawiera następujący podział „edytowalnych regionów”:

• Tytuł strony (doctitle)
• Nagłówek HTML (head)
• Treść przed znacznikiem FORM (beforeForm)
• Główna treść (Content)
• Treść po znaczniku FORM (afterForm)

Biblioteki

Szablon strony „Template\ASAMPLE.dwt” składa się z następujących bibliotek:

• Komórka TopLeft.lbi zawierająca nazwę firmy
• Komórka TopRight.lbi zawierająca datę bieżącego dnia oraz wiadomości użytkownika (token aMsgUser)
• Dolne menu (BottomMenu.lbi)
• Menu po lewej (LeftMenu.lbi)

Biblioteka paging.lbi służy do zarządzania stronicowaniem w tabelach XTEND.

Elementy graficzne

Dostępne są następujące elementy graficzne:

• Arkusz stylów (my.css.)
• Gama obrazów w katalogu IMG\
• Obrazy flag krajów FLAG\ używane na stronie „Lista krajów”

Strony HTML

Dostępne są następujące szablony stron HTML:

• home.html
• about.html
• account.html
• contact.html
• countries.html
• login.html

Dostępne są następujące techniczne strony HTML:

• notavail.html
• reconnection.html
• error.html

Pliki

Lokalizacja

Projekt HTML ASAMPLE jest przechowywany na serwerze głównym X3 w następującym katalogu X3_PUB/X3FOLDER/X_TEND/X_HTML/ASAMPLE/FRA w języku francuskim i .../POL w języku polskim.

X3_PUB
Katalog publikacji dla wszystkich folderów z obecnym rozwiązaniem

X3FOLDER
Nazwa bieżącego folderu X3

Jeśli pliki strony ASMAPLE nie znajdują się w tym katalogu, oznacza to, że XTEND nie jest dostępne dla bieżącego folderu X3.

W systemach Unix użytkownik musi sprawdzić, czy wszystkie pliki projektu HTML mają następujące uprawnienia dostępu:

• „Odczyt” dla wszystkich
• „Odczyt/Zapis/wykonaj" dla programistów XTEND

Kopiuj lokalnie

Nie zaleca się modyfikowania strony ASAMPLE, lecz skopiowanie plików lokalnie, zmieniając nazwę witryny.

Pobierz lokalnie zawartość witryny poprzez klienta FTP takiego jak FileZilla.

W celu stworzenia strony z tego szablonu należy najpierw zainstalować program DreamWeaver. Następnie należy utworzyć nową witrynę, która jest przekierowana do lokalnie pobranego katalogu.

W przypadku nie zainstalowania programu DreamWeaver użytkownik może przeprowadzić test, modyfikując strony HTML za pomocą edytora tekstowego takiego jak NotePad++ lub PSPad i dokonać aktualizacji zdalnie (na serwerze X3) za pomocą klienta FTP. W takim przypadku użytkownik może usunąć katalog „Biblioteki” i „Szablonów”.

Zarządzanie treścią

Treść stron nie jest przechowywana na stronie HTML, lecz w bazie danych X3, do której dostęp można uzyskać za pośrednictwem funkcji treści Html XTEND.

Ma to na celu pokazanie w jaki sposób możliwe jest zarządzanie zawartością HTML w X3.

Ta metoda nie jest optymalnym rozwiązaniem ze względu na czasy odpowiedzi. Wywołanie usługi sieciowej odczytu treści HTML (CLOB) jest mniej zalecane niż bezpośrednie wyświetlanie strony HTML przez serwer HTTP.

Należy znaleźć kompromis pomiędzy wydajnością, która zależy od wielu czynników (infrastruktura sieci/maszyny, rozmiaru dokumentu, przepływu danych serwera X3 między innymi) a łatwością zarządzania witryną XTEND.

Z technicznego punktu widzenia treść jest wyświetlana przez pole (TEXTE), której wartość jest określona przez sekcję (ABLKDOCHTML).

Ta sekcja odpowiada za wybór treści strony HTML zgodnie z nazwą strony (pole DOCCOD) poprzez wywołanie interfejsu (ADOCHTML) typu „Dostęp wygenerowany przez tabelę”.

Lista stron

Strony z treścią

strona główna
Strona główna (Nazwa=AHOME)

o nas
strona „O nas” (Nazwa=ABOUT)

kontakt
Przejdź do strony wpisu formularza HTML i zapisz w X3 (Alias=ACONTACT)

login
Strona logowania XTEND (Nazwa=ALOGIN)

konto
Strona informacji o użytkowniku po zalogowaniu (Nazwa=ACCOUNT)

kraje
Strona przykładowa „Dostępu do danych” i „łącza danych/listy”, która wyświetla (w stronach) listę krajów (tabela TABCOUNTRY) i która służy do wyboru kraju, aby wyświetlić informacje (dane) na temat waluty i języka (Nazwa=ACOUNTRIES)

Strony techniczne

Następne strony to strony techniczne zdefiniowane na poziomie witryny XTEND.

error
Pojawia się w przypadku wystąpienia błędu krytycznego (Wyjątek) - (Nazwa=AERROR)

notavail
Pojawia się, gdy strona nie jest jeszcze dostępna (Nazwa=ANOTVAIL)

reconnection
Pojawia się, gdy użytkownik uzyskuje z powrotem dostęp do sesji po zamknięciu przeglądarki (Nazwa=ARECONNECTION)

Uwaga

Strona działa dla ENG. Wszystkie strony nie są dostępne w tym języku.

Połączenia SAFE X3

Ten akapit wyświetla listę interfejsów oraz usług sieciowych wykorzystywanych przez stronę ASAMPLE i przedstawia sposób ich aktywacji po uruchomieniu XTEND.

Tworzenie puli usług sieciowych.

Usługi sieciowe mogą działać tylko po zdefiniowaniu domyślnej puli usług sieciowychXTEND.

Sprawdź poprawność puli po utworzeniu, tak aby serwer XTEND wziął ją pod uwagę.

Operacje do wykonania przez konsolę X3

Obecny folder X3 musi zostać opublikowany na serwerze X3WEB za pośrednictwem konsoli X3. Ponadto użytkownik musi znaleźć wpis dotyczący tego folderu na liście „Puli usług sieciowych”, do której dostęp można uzyskać za pośrednictwem funkcji X3 GESAYS (menu pól narzędzi/usług sieciowych).

Jeśli lista jest pusta lub nie zawiera folderu X3 użytkownika, oznacza to, że:

• folder X3 nie został opublikowany na serwerze X3WEB
• nie zdefiniowano puli połączeń dla tego folderu X3 w konfiguracji serwera usług sieciowych

Te dwie czynności należy przeprowadzić za pośrednictwem konsoli X3.

Definiowanie puli usług sieciowych XTEND

Operacja ta polega na domyślnym zdefiniowaniu puli połączeń, która będzie „entry point” (URL) wszystkich wywołań usług sieciowych używanych przez witrynę ASAMPLE.

Idź do Pula usług sieciowych.

Jeżeli pula 'ADEFAULT' jest wyświetlana na liście, zmodyfikuj informację:

• „Pula X3”, tak aby była kierowana do serwera usług sieciowych i właściwej puli połączeń
• „Użytkownik” za pomocą ważnych informacji logowania X3

Jeżeli pula ta nie istnieje, odnieś się do dokumentu puli usług sieciowych XTEND, aby utworzyć ją z nazwą 'ADEFAULT'.

Interfejsy

Niniejszy akapit przedstawia operację konieczną do wykonania w celu aktywacji interfejsów wykorzystywanych przez witrynę ASAMPLE .

Strona ASAMPLE wykorzystuje następujące trzy interfejsy, do których dostęp można uzyskać za pośrednictwem funkcji interfejsu (GESAYI) .

Ustawienia wspólne pliku interfejsu

Pula domyślna:Tak

Dostęp chroniony:Nie

Wyświetlanie komunikatów:Sprawdź informację, ostrzeżenie, błąd

Interfejs ADOCHTML

1. Otwórz rekord interfejsu ADOCHTML

2. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Typ: „Wygenerowano dostęp do tabeli”
Kod tabeli:AYTDOC
Nazwa publikacji:AXTDHTML

3. Wygeneruj dostęp przez kliknięcie na przycisk „Wygeneruj dostęp”
Następujące elementy zostają wygenerowane automatycznie: Proces WTAXTDHTML, rekord podprogramu WTAXTDHTML/ACCTAB oraz usługa sieciowa AXTDHTML
1. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Maks. l. wierszy:10
Tabela pól:

4. Zapisz i sprawdź rekord

Interfejs AXTDFORM

1. Otwórz rekord interfejsu AXTDFORM

2. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Typ:Czynność użytkownika obiektu
Obiekt:AYZ
Nazwa publikacji:AXTDAYZ

3. Wygeneruj dostęp przez kliknięcie przycisku „Wygeneruj dostęp”
Następujące elementy zostają wygenerowane automatycznie: Proces WJAXTDAYZ oraz usługa sieciowa AXTDAYZ
1. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Tabela pól:

4. Zapisz i sprawdź rekord

Interfejs AXTDLOGIN

1. Otwórz rekord interfejsu AXTDLOGIN

2. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Typ„Czynność użytkownika podprogramu”
Proces:AYTXTLOGIN
Podprogram:ACTION
Rekord podprogramu (przez tunel na polu procesu): AYTXTLOGIN/ACTION

3. Wygeneruj dostęp przez kliknięcie przycisku „Wygeneruj dostęp”
Następujące elementy zostają wygenerowane automatycznie: Usługa sieciowa AXTDLOGIN
1. Sprawdź następujące ustawienia i zmodyfikuj je jeżeli są nieprawidłowe
Tabela pól:

4. Zapisz i sprawdź rekord

Interfejsy ACOUNTRY/ACURRENCIES/ALANGUAGES

Procedura jest taka sama jak w przypadku ADOCHTML z tabelami TABCOUNTRY, TABCUR, TABLAN.

JavaScript

Wykorzystanie JavaScript w witrynie ASAMPLE jest ograniczone do:

• kontrolowania określonych wprowadzonych danych
• zarządzania wyświetlaniem wiadomości

W poniższym przykładzie przedstawiona jest pewna liczba standardowych entry points. Zostały zaprogramowane w pliku szablonowym DreamWeaver (ASAMPLE.dwt) i jest dostępny ze wszystkich stron opartych na tym szablonie.

Biblioteka XTEND

Kod JavaScript, specyficzny dla XTEND, jest umieszczony w kodzie strony HTML za pomocą tokena ALIBJS. Ten token jest odpowiedzialny za wstawianie

• biblioteki prototype.js
• bibliotek XTEND JavaScript
• arkusza stylów XTEND

<script adx='ALIBJS'></script>

Ładowanie strony HTML

// Program obsługi zdarzeń dla wszystkich stron przyŁadowaniu
funkcja xBodyOnLoad()
{
// Ustaw wartość „0” dla niezaznaczonych pól wyboru
xtdSetUnSelelectedValue('0');
// pageBodyOnLoad jest programem obsługi strony przyŁadowaniu
jeśli (typeof(pageBodyOnLoad)=='function')
pageBodyOnLoad();
}
}

pageBodyOnLoad

Ten entry point służy do wykonywania procesów specyficznych dla strony HTML dla zdarzenia '<BODY onLoad>' strony.

W celu aktywacji tego entry point użytkownik musi zadeklarować funkcję JavaScript 'funkcja pageBodyOnLoad(){}' na stronie HTML.

Procesy dla kliknięcia dynamicznego łącza

Funkcja ta służy do usuwania wiadomości użytkownika oraz wywoływania entry point kontroli dla kliknięć dynamicznych łączy.

// Wywoływana za każdym razem, gdy użytkownik kliknie łącze XTEND
funkcja xtdDoMyDlk(aDomOut)
{
// Wyczyść komunikaty użytkownika
xtdRemoveElmtId('xtdusermsg',true);
zmienna wContinue=prawda;
// Wywoływanie programu obsługi pageDoMyDlk, jeśli istnieje
jeśli (typeof(pageDoMyDlk)=='function') wContinue=pageDoMyDlk(aDomOut);
zwrot wContinue;
}

pageDoMyDlk

Ten entry point służy do wykonywania procesów specyficznych dla strony HTML przy kliknięciu dynamicznego łącza.

W celu aktywacji tego entry point użytkownik musi zadeklarować funkcję JavaScript «funkcja pageDoMyDlk(){aDomOut}' na stronie HTML.

//Prosi użytkownika o potwierdzenie utworzenia nowego formularza po kliknięciu przez użytkownika na dynamiczne powiązanie ADLKCONTACTNEW
funkcja pageDoMyDlk(aDomOut)
{
jeśli (aDomOut.isDlk('ADLKCONTACTNEW'))
zwrot potwierdzenia(„Potwierdź utworzenie formularzu\nPotwierdź utworzenie”);
zwrot prawdziwy;
}