Wytyczne do projektu KBD2.A, sem. 10Z


Wprowadzenie
Zadanie
Uwagi techniczne
Czynności wstępne
1. Projekt wstępny
2. Struktura danych i "esej"
3. Odbiór końcowy

Wprowadzenie

Cel projektu

Celem projektu KBD2 jest przećwiczenie wykorzystania różnych aspektów technologii Oracle. Nie wymaga się zbudowania kompletnego systemu ani użytecznej aplikacji; celem zaś jest wypróbowanie możliwie wielu różnych narzędzi i technik. Wymagana jest natomiast samodzielna praca: stwierdzenie niesamodzielności, np. powielenia fragmentu innej pracy czy przepisania rozwiązania z jakiegoś tutoriala, spowoduje wystawienie oceny niedostatecznej z całego projektu, a co za tym idzie i z przedmiotu.

Projekt jest wykonywany w zespołach dwuosobowych.

Instrukcja ta będzie zapewne modyfikowana, proszę więc pracować zawsze z aktualną jej wersją.

Etapy projektu

Projekt jest podzielony na trzy etapy:

Projekt wstępny
Sformułowanie zadania, stworzenie modelu tabel i założeń do dalszych części.
Struktury danych
Utworzenie struktur danych i wypełnienie ich danymi testowymi.
Odbiór końcowy
Poprawione struktury danych z danymi przykładowymi, uruchomiony kod PL/SQL i fragmenty aplikacji.

Odbiory etapów projektu i terminarz

Odbiory poszczególnych etapów projektu odbywają się "wirtualnie", przy użyciu poczty elektronicznej. Gotowość części projektu do odbioru zgłasza się wysyłając do prowadzącego zajęcia list z zawartością określoną w dalszej części tej instrukcji. Otrzymanie listu przez prowadzącego powinno zostać potwierdzone; w przypadku braku potwierdzenia po kilku dniach należy ponowić próbę lub skontaktować się z prowadzącym w celu wyjaśnienia sytuacji.

Uwaga: proszę korzystać wyłącznie z oficjalnego serwera pocztowego WEiTI; adres nadawcy musi zawierać nazwisko wysyłającego. Listy wysyłane z innych miejsc oraz z użyciem różnych "ksywek" będą ignorowane!

Ostateczne terminy przekazania etapów projektu do odbioru określa tabela:

Etap Termin
Projekt wstępny 2010-12-17
Struktury danych 2011-01-07
Odbiór końcowy 2011-01-28

Zadanie

Sformułowanie problemu

Każdy zespół samodzielnie formułuje treść problemu, do którego następnie projektuje strukturę danych i fragmenty aplikacji.

Problem powinien być w miarę prosty i musi spełniać poniższe założenia.

Założenia do zadania

Wymagane ćwiczenia z technologią Oracle

Struktura danych

Wymagania

Nazwa Opis Ważność
Struktura tabel

Poprawna struktura tabel wraz z więzami deklaratywnymi i indeksami.

Wymagane
Wyzwalacze

Wyzwalacze realizujące nietrywialne funkcje (podstawienie wartości z sekwencji to za mało!).

Wymagane
Perspektywy

Perspektywy (sensownie zastosowane w aplikacji).

Zalecane
Podprogramy PL/SQL

Procedury, funkcje i pakiety PL/SQL, zastosowane w aplikacji lub w wyzwalaczach.

Zalecane
Rozszerzenia struktury

Elementy rozszerzające strukturę: klastry, partycje, zmaterializowane perspektywy, typy relacyjno-obiektowe, indeksy funkcjonalne i bitowe itp.

Opcjonalne

Aplikacje WWW

Wymagania

Nazwa Opis Ważność
Raport w WWW

Raport wykonany za pomocą technologii Web-PL/SQL.

Wymagane
Strona XSQL

Strona wykonana za pomocą technologii XSQL.

Wymagane
Zapytania SQLX

Zapytania zwracające struktury XML na podstawie danych relacyjnych.

Wymagane

Aplikacja Application Express

Wymagania

Nazwa Opis Ważność
Formularz master-detail

Co najmniej jeden formularz zawierający przynajmniej dwa zsynchronizowane bloki: nadrzędny i podrzędny.

Wymagane
Raport

Co najmniej jeden raport, zalecane użycie break groups i sumowania.

Wymagane
Menu

Menu łączące wykonane moduły.

Zalecane

"Esej" na temat fragmentu technologii Oracle

Wymagania

W sem. 10Z każdy zespół opisuje najważniejsze fakty związane z wybranym pakietem wbudowanym PL/SQL (z rodziny DBMS_*) serwera Oracle 11g.

Nazwa Opis Ważność
Opis wybranej technologii

Krótki opis wybranej technologii (max 6 stron).

Wymagane
Własne przykłady

Opracowane samodzielnie przykłady, przetestowane praktycznie i włączone do ww. opisu.

Wymagane

Uwagi techniczne

Instrukcja

Niniejsza instrukcja będzie modyfikowana w miarę rozwoju sytuacji, np. w przypadku stwierdzenia nieprzewidzianych trudności technicznych. Należy zatem pracować z aktualną wersją instrukcji. Zmiany wprowadzane w czasie semestru będą wyróżniane kolorem.

Pytania i uwagi do instrukcji należy zgłaszać pocztą elektroniczną do doc. dra inż. Tomasza Traczyka.

Konta uczestników zajęć

Każdy zespół musi mieć przynajmniej jedno konto na komputerach i serwerze w Pracowni Komputerowej IAIS (s. 528). Oprócz tego każdemu zespołowi zakładane jest konto na serwerze Oracle. Konta na Oracle mają nazwy KBD2A##, gdzie ## jest przydzielonym zespołowi numerem. Początkowe hasło jest takie samo jak nazwa konta. (Uwaga! W Oracle 11g hasła są wrażliwe na wielkość liter!)
Uwaga: w dalszej części instrukcji notacja KBD2A## będzie oznaczała tę właśnie nazwę z przydzielonym numerem zespołu.
Lista zespołów zostanie rozesłana pocztą po skompletowaniu zgłoszeń.

Awarie

Wszelkie awarie i problemy techniczne należy niezwłocznie zgłaszać pocztą elektroniczną do doc. dra inż. Tomasza Traczyka.
Zgłoszenie musi zawierać szczegółowy opis problemu i okoliczności jego powstania, w tym:

Zgłoszenia problemów nie zawierające dostatecznie szczegółowej informacji o zaistniałym problemie nie będą rozpatrywane, a zgłoszenia szczególnie ogólnikowe, jako "niegodne inżyniera", mogą być "premiowane" obniżeniem oceny.
Uwaga: problemy, które nie zostały zgłoszone, nie będą mogły stanowić usprawiedliwienia ewentualnego opóźnienia wykonania części projektu.

Znane problemy

Monity JDevelopera i SQLDevelopera
Narzędzia JDeveloper i SQLDeveloper mogą wyświetlać monity pytające czy wykonywać mogrację z poprzedniej wersji oraz czy ściągać z sieci najnowsze poprawki (updates). Na monity te należy odpowiadać przecząco.
Brak miejsca na dysku Z:
Na dysku Z: powinno być sporo wolnego miejsca, jego brak może np. spowodować problemy w działaniu JDevelopera i SQLDevelopera.
Kopie rezerwowe plików projektowych
Pliki z serwera plików Lab1 nie są backupowane. Dlatego w swym dobrze pojętym interesie każdy uczestnik projektu powinien we własnym zakresie wykonywać kopie rezerwowe plików wytworzonych w czasie projektu.

Liczba sesji użytkownika

Ze względu na ograniczone zasoby serwera uprasza się nie utrzymywać wielkiej liczby jednocześnie otwartych sesji połączenia z bazą Oracle. W związku z tym należy unikać uruchamiania dużej liczby programów równocześnie oraz zamykać narzędzia w danej chwili niepotrzebne (np. zbędne sesje SQL*Plusa).

Oprogramowanie

Projekt musi być wykonany z użyciem bazy Oracle 11g oraz narzędzia Application Express, które udostępniono w laboratorium 528 (dostęp jest możliwy także spoza Wydziału przez sieć). Prowadzący projekt nie udziela konsultacji dotyczących instalacji i uruchamiania oprogramowania na komputerach poza laboratorium.

Dostęp do bazy spoza laboratorium

Do bazy danych Oracle dostać się można spoza laboratorium używając następujących parametrów połączenia:

Wywoływanie Application Express

Oprogramowanie Application Express dostępne jest przez przeglądarkę internetową pod adresem URL http://gluon.elka.pw.edu.pl/elka/apex/
Po wywołaniu tego adresu pojawić się powinien dialog zapytania o przestrzeń roboczą, nazwę użytkownika i hasło; należy podać nazwę konta KBD2A## jako odpowiedź na wszystkie te pytania (uwaga: hasło koniecznie dużymi literami); hasło można następnie zmienić.
Dokumentacja do Application Express jest dostępna w tym narzędziu pod łącznikiem Help, a także na OTN

Wywoływanie modułu Web-PL/SQL

Moduły PL/SQL wywoływane są z przeglądarki internetowej przez adres URL. Skonfigurowany jest odpowiedni tzw. DAD (Data Access Descriptor), umożliwiający taki dostęp. Odpowiedni adres URL to: http://gluon.elka.pw.edu.pl/kbd/wywolanie_procedury
Po wywołaniu takiego adresu pojawić się powinien dialog zapytania o nazwę użytkownika i hasło; należy podać nazwę i hasło odpowiedniego użytkownika bazy Oracle.

Czynności wstępne

Przed przystąpieniem do analizy należy wykonać czynności wstępne, konfigurujące środowisko pracy.

Sprawdzenie dostępu do zasobów i skonfigurowanie środowiska

Przed przystąpieniem do regularnej pracy należy sprawdzić działanie kont w pracowni 528 i skonfigurować środowisko.

Lp. Czynność Wskazówki Ważność
1 Sprawdzić działanie konta na serwerze Zalogować się do sieci używając nazwy użytkownika i hasła dla serwera Lab1
W razie kłopotów poprosić pracownika dyżurującego w laboratorium, by zawiadomił kierownika laboratorium o zaistniałym problemie.
Zalecane
2 Sprawdzić, czy istnieje dysk Z: i czy użytkownik ma w nim prawa zapisu. Użytkownik powinien mieć dostęp z prawami zapisu do swojego katalogu na dysku sieciowym; dysk ten powinien być przypisany do litery Z:. Jeśli litera Z: nie jest odpowiednio przypisana, dokonać "mapowania dysku sieciowego". Wymagane
3 Utworzyć katalogi robocze Na dysku Z: utworzyć katalogi Z:\oracle i z:\oracle\temp. Wymagane

Następnie należy sprawdzić działanie konta na serwerze Oracle.

Lp. Czynność Wskazówki Ważność
1 Sprawdzić dostęp do serwera Oracle Wywołać program SQL*Plus. Połączyć się do bazy, używając przydzielonej nazwy użytkownika Oracle (KBD2A##) i takiego samego hasła.
W razie problemów niezwłocznie powiadomić pocztą elektroniczną doc. dra inż. Tomasza Traczyka.
Zalecane
2 Zmienić hasło na serwerze Oracle Używając polecenia password lub zdania SQL alter user ... identified by ...; zmienić hasło na serwerze Oracle (pamiętać, że hasła są case-sensitive!). Opcjonalne
3 Sprawdzić dostęp do narzędzia Application Express Wywołać URL http://gluon.elka.pw.edu.pl/elka/apex/ i podać nazwę użytkownika KBD2A## jako odpowiedź na wszystkie trzy pytania (uwaga: hasło koniecznie dużymi literami!).
W razie problemów niezwłocznie powiadomić pocztą elektroniczną doc. dra inż. Tomasza Traczyka.
Zalecane
4 Zmienić hasło w Application Express Na karcie Home w menu Administration użyć opcji Change Password i zmienić hasło Application Express (pamiętać, że hasła są case-sensitive i że to hasło nie jest tożsame z hasłem do bazy Oracle!). Opcjonalne

1. Projekt wstępny

Projekt wstępny ma określać założenia dalszej pracy.

Projekt wstępny - zawartość

Należy zaproponować temat zadania oraz "eseju", wykonać model danych dla proponowanego zadania oraz zgrubnie opisać planowane dalsze działania. Głównym celem tego etapu jest ocena przez prowadzącego, czy zaproponowane zadanie spełnia oczekiwania.

Artefakty

Należy dostarczyć następujące materiały:

Nazwa Opis Ważność
Sformułowanie problemu

Zwięzły opis postawionego problemu.

Wymagane
Model tabel

Model struktury danych dla postawionego problemu w postaci diagramu tabel. Model musi być poprawny, tj. spełniać typowe kryteria poprawności dla struktur relacyjnych oraz zawierać definicje kluczy głównych, obcych i unikalnych (jeśli są).

Wymagane
Model graficzny

Model ma być dostarczony w postaci diagramu tabel, wykonanego narzędziem JDeveloper.

Wymagane
Opis planowanych elementów projektu

Zwięzłe wyliczenie planowanych modułów aplikacji i innych elementów projektu.

Wymagane
Wyzwalacze, podprogramy PL/SQL

Spis planowanych wyzwalaczy, podprogramów PL/SQL wraz z bardzo zwięzłym opisem działania.

Wymagane
Rozszerzenia struktury danych

Spis planowanych perspektyw, zmaterializowanych perspektyw, struktur relacyjno-obiektowych itp.

Zalecane
Temat proponowanego "eseju"

W sem. 10Z należy podać nazwę opisywanego pakietu (jeśli pakiet jest bardzo obszerny, można określić jego podzbiór, który będzie opisany).

Wymagane
Uzgodnienie tematów między zespołami

Natychmiast po wyborze tematu "eseju" należy o tym powiadomić inne zespoły, wysyłając wiadomość na przedmiotową listę mailingową KBD2.A@elka.edu.pl, w celu uniknięcia wielokrotnego zgłoszenia tego samego tematu.

Zalecane

Rysowanie diagramów tabel za pomocą JDevelopera

Lp. Czynność Wskazówki Ważność
1 Utworzenie środowiska projektowego w JDeveloperze Po wywołaniu programu JDeveloper wybrać w nawigatorze pozycję Applications i za pomocą menu File/New wybrać pozycje General/Workspace. Nadać tworzonej przestrzeni roboczej nazwę kbd2a##_ws, a nowemu projektowi nazwę kbd2a##_pr. Wymagane
2 Utworzenie diagramu tabel Wybrać w nawigatorze projekt kbd2a##. Za pomocą menu File/New wybrać pozycje General/Diagram/Database Design. Nadać tworzonemu diagramowi nazwę kbd2a##_dd, a pakietowi nazwę kbd2a##_pg. Wymagane
3 Rysowanie diagramu tabel Za pomocą narzędzi z widocznej z prawej strony palety rysować diagram tabel. Umieścić na nim tabele, kolumny, klucze główne i obce oraz klucze unikalne i ograniczenia check (jeśli potrzebne). Zalecane jest także wpisywanie komentarzy dla kolumn.
Edycję właściwości tabeli prowadzi się za pomocą dialogu, który ukazuje się po "dwukliknięciu" w symbol tabeli na rysunku.
Wymagane
4 Porządkowanie i opisanie diagramu tabel Na rysunku obowiązkowo należy umieścić notatkę (note), a w niej nazwiska autorów oraz numer zespołu.
Diagram tabel należy uporządkować za pomocą opcji Straighten lines, Lay out shapes, Align oraz oraz Minimize pages, dostępnych pod prawym przyciskiem myszki (opcje te wymagają uprzedniego zaznaczenia elementów, które mają być uporządkowane) lub w menu Model. Diagram powinien mieścić się na jednej stronie.
Wszystkim elementom diagramu należy zmienić wypełnienie na białe, używając opcji Display properties/Colors/Fill dostępnej (po wybraniu elementu) pod prawym uchem myszki.
Wymagane

Forma dostarczenia wyników

Lp. Czynność Wskazówki Ważność
1 Dostarczenie diagramu tabel Rysunek z diagramem tabel należy przekształcić do postaci pliku JPEG o nazwie kbd2a##_1.jpg za pomocą narzędzia Publish diagram z menu Model. Wymagane
2 Dostarczenie pozostałych opisów Pozostałe opisy (bardzo zwięzłe, wydruk musi się zmieścić na jednej stronie - kolejne strony nie będą czytane!) powinny być załączone do listu w postaci pliku PDF o nazwie kbd2a##_1.pdf Wymagane

Odbiór etapu 1

Forma odbioru

W/w pliki przesłać prowadzącemu jako załączniki do listu elektronicznego. List powinien mieć temat: KBD2A##, etap 1. W treści listu należy umieścić imiona i nazwiska autorów.

Lp. Czynność Wskazówki Ważność
1 Wysłać pliki do prowadzącego Wypisać w liście wymagane informacje (patrz wyżej). Dołączyć wymagane pliki jako załączniki do listu elektronicznego. Wymagane
2 Oczekiwać potwierdzenia W przypadku braku potwierdzenia po kilku dniach interweniować! Zalecane

Uwagi:

Poprawianie etapu 1

Wykonując kolejny etap należy uwzględnić zalecenia oceniającego.
Jeśli oceniający tego wyraźnie zażądał, należy niezwłocznie poprawić pracę i przekazać do ponownego sprawdzenia. Prawo do poprawki jest uzależnione od terminowego przesłania części 1 projektu.

Forma odbioru poprawek

Pliki z poprawionymi wynikami należy przesłać prowadzącemu jako załączniki do listu elektronicznego. List powinien mieć temat: KBD2A##, etap 1 - poprawka.
W treści listu należy umieścić te same informacje, co przy pierwszym "podejściu"; pliki z wynikami powinny być nazwane kbd2a##_1p.*.

2. Struktura danych i "esej"

W tej części projektu kontroli podlega prawidłowość wykonania struktur danych w bazie Oracle. Czytany i oceniany jest także dostarczony "esej".

Struktura danych i "esej" - zawartość projektu

Należy opracować ostateczną wersję modelu tabel i wykonać skrypty zakładające struktury danych i wprowadzające dane przykładowe. Skrypty te należy wykonać na serwerze Oracle udostępnionym w laboratorium. "Esej" należy dostarczyć w postaci pliku PDF oraz w formie wydrukowanej na papierze.

Artefakty

Należy dostarczyć następujące materiały:

Nazwa Opis Ważność
Model tabel

Ostateczny model tabel struktury danych dla postawionego problemu.

Wymagane
Uwzględnienie wyników projektu wstępnego

Model musi być poprawny oraz uwzględniać uwagi i sugestie wynikające ze sprawdzenia projektu wstępnego.

Wymagane
Model graficzny

Model ma być dostarczony w postaci diagramu tabel wykonanego narzędziem JDeveloper. Nazwy więzów itp. powinny być poprawione tak, by były sensowne i komunikatywne (nazwy automatycznie tworzone przez narzędzie na ogół tego postulatu nie spełniają).

Wymagane
Skrypt tworzący struktury danych

Jeden skrypt SQL DDL, tworzący podstawowe struktury danych. Nie musi jeszcze zawierać elementów proceduralnych (PL/SQL), zmaterializowanych perspektyw itp. Skrypt powinien być nazwany kbd2a##_2_ddl.sql.

Wymagane
Tabele

Zdania CREATE TABLE tworzące wszystkie tabele projektu.

Wymagane
Indeksy

Zdania CREATE INDEX, tworzące niezbędne indeksy.

Wymagane
Więzy

Zdania ALTER TABLE tworzące więzy deklaratywne (klucze główne, unikalne, obce i ograniczenia check).

Wymagane
Wyzwalacze

Planowane wyzwalacze lub ich prototypy.

Opcjonalne
Dane testowe w bazie danych

W bazie danych powinna znaleźć się struktura danych z danymi testowymi.

Wymagane

Generowanie wstępnej wersji pliku DDL

Wstępną wersję pliku DDL można wygenerować z diagramu tabel utworzonego w JDeveloperze.

Lp. Czynność Wskazówki Ważność
1 Otworzyć diagram tabel Wyszukać diagram kbd2a##_dd na nawigatorze i dwukrotnie kliknąć. Zalecane
2 Wygenerować wstępny plik DDL Wskazać myszką tło diagramu i z menu pod prawym przyciskiem myszki wybrać pozycję Generate/Data Definition Language for diagram. Wybrać wszystkie tabele oraz opcje CREATE (or replace) i Generate SQL scripts. Wybrać projekt kbd2a##_pr.jpr, a plik SQL nazwać kbd2a##_2_ddl.sql Zalecane
3 Poprawić plik DDL Wygenerowany plik DDL poprawić, dodając do niego brakujące elementy i komentarze, a usuwając elementy zbędne (np. śmieciowe domyślne klauzule). Wymagane

Forma dostarczenia wyników

Lp. Czynność Wskazówki Ważność
1 Dostarczenie diagramu tabel Rysunek z diagramem tabel należy przekształcić do pliku JPEG o nazwie kbd2a##_2.jpg, jak poprzednio. Na rysunku muszą być umieszczone nazwiska autorów oraz numer zespołu. Wymagane
2 Dostarczenie struktury danych Skrypt SQL DDL powinien być zawarty w jednym pliku (patrz wyżej), a struktura wraz z danymi testowymi powinna być umieszczona w bazie danych dostępnej w laboratorium. Wymagane

"Esej"

W etapie 2 należy dostarczyć kompletną końcową wersję "eseju" do oceny. Mile widziane (ale nie bezwzględnie konieczne) jest wykorzystanie opisywanej technologii w kodzie prezentowanym w etapie 3.

Lp. Czynność Wskazówki Ważność
1 Poznać i opisać wybrany fragment technologii Koncentrować się na kluczowych zagadnieniach i na potencjalnym zastosowaniu; nie kopiować fragmentów dokumentacji! Wymagane
2 Opracować przykłady Opracować samodzielnie oryginalne przykłady ilustrujące omawiane zagadnienie, przetestować je i włączyć do opisu (z odpowiednim komentarzem). Wymagane

Forma dostarczenia wyników

Lp. Czynność Wskazówki Ważność
1 Dostarczenie "eseju" "Esej" ma być dostarczony w postaci PDF oraz w postaci wydruku na papierze (maksymalnie 6 stron, czcionka nie mniejsza od 11pt!). Wymagane

Odbiór etapu 2

Forma odbioru

Pliki z wynikami należy przesłać prowadzącemu jako załączniki do listu elektronicznego. List powinien mieć temat: KBD2A##, etap 2.

W treści listu należy umieścić:

Lp. Czynność Wskazówki Ważność
1 Wysłać pliki do prowadzącego Wypisać w liście wymagane informacje (patrz wyżej). Dołączyć wymagane pliki jako załączniki do listu elektronicznego (nie pakować ich programem archiwizującym). Wymagane
2 Oczekiwać potwierdzenia W przypadku braku potwierdzenia po kilku dniach interweniować! Zalecane
3 Dostarczyć wydruk "eseju" Wydruk dostarczyć do Sekretariatu Dydaktycznego IAiIS, pok. 22/23, nie później niż 3 dni po terminie oddania etapu. Wymagane

Uwagi:

Poprawianie etapu 2

Nie jest przewidziane poprawianie tego etapu. W kolejnym etapie należy po prostu uwzględnić zalecenia oceniającego. Ewentualne wątpliwości wyjaśniać w trybie konsultacji.

3. Odbiór końcowy

W tym etapie odbiorowi podlegają gotowe i działające składniki systemu. Przypomnieć należy, że celem projektu nie jest wykonanie kompletnego systemu, ale takich jego fragmentów, które pozwalają zapoznać się z możliwie wieloma aspektami technologii Oracle.

Odbiór końcowy - zawartość

Należy wykonać końcowe wersje modułów projektu (aplikacja Application Express, moduł Web-PL/SQL itp.). Dostarczyć także trzeba końcową wersję skryptu tworzącego struktury danych, kod PL/SQL i umieścić odpowiednie dane testowe w bazie danych.

Artefakty

Należy dostarczyć następujące materiały:

Nazwa Opis Ważność
Wyniki w postaci plików

Następujące wyniki należy przesłać w postaci plików:

Wymagane
Skrypt tworzący struktury danych

Jeden skrypt SQL DDL, tworzący podstawowe struktury danych, wyzwalacze, inne elementy proceduralne oraz pozostałe obiekty tworzone w bazie danych (oprócz modułu Web-PL/SQL). Skrypt powinien być nazwany kbd2a##_3_ddl.sql.

Wymagane
Skrypt tworzący moduł Web-PL/SQL

Jeden skrypt PL/SQL, tworzący moduł Webowy. Skrypt powinien być nazwany kbd2a##_3_web.sql.

Wymagane
Strona XSQL

Plik zawierający stronę XSQL powinien być nazwany kbd2a##_3.xsql.
Bardzo proszę, by ewentualne parametry stony XSQL miały sensowne wartości domyślne!

Wymagane
Zapytania SQLX

Plik z utworzonymi zapytaniami SQLX. Plik powinien być nazwany kbd2a##_3.sqlx. Wynik zapytania SQLX (typu XMLType) powinien być przetworzony na napis za pomocą metody getClobVal().

Wymagane
Wyniki na serwerze

Następujące wyniki należy udostępnić na serwerze:

Wymagane
Dane testowe w bazie danych

Dane testowe umieszczone w udostępnionej do celów projektu bazie danych.

Wymagane
Moduł Web-PL/SQL

Działający moduł Web-PL/SQL dostępny przez URL. Procedura startowa modułu powinna mieć nazwę startWWW.
Bardzo proszę, by ewentualne parametry procedury startowej miały sensowne wartości domyślne!

Wymagane
Aplikacja Application Express

Aplikacja Application Express dostępna na serwerze.
Aplikacja ta powinna mieć wyłączoną autoryzację (tworząc aplikację należy w dialogu Create Application wybrać opcję Authentication Scheme = No Authentication).

Wymagane

Kod procedur, funkcji, wyzwalaczy itp. powinien zawierać sensowne komentarze. Należy je umieścić wewnątrz kodu tych modułów, tj. po instrukcji CREATE..., by komentarze te zapisane zostały także w bazie danych.
Jeśli strony XSQL czy procedury Web-PL/SQL mają parametry, to powinny one mieć takie wartości domyślne, by coś sensownego się wyświetlało, a w komentarzu należy podać ze dwa zestawy działających wartości.

Instrukcje pomocnicze

Uruchamianie stron XSQL za pomocą JDevelopera

Lp. Czynność Wskazówki Ważność
1 Utworzyć połączenie z bazą danych Na zakładce Connections wybrać pozycję Database. Z menu File/New wybrać General/Connections/Database Connection. Połączenie nazwać kbd2a, pozostawić typ połączenia Oracle (JDCBC). Wpisać nazwę użytkownika i hasło, rolę pozostawić pustą. W parametrach połączenia wybrać sterownik typu thin, nazwę serwera, port i SID przepisać z punktu "Dostęp do bazy spoza laboratorium" niniejszej instrukcji. Przetestować połączenie i jeśli działa, to je zapisać. Wymagane
2 Utworzyć stronę XSQL Na zakładce Applications wybrać projekt kbd2a##_pr. Z menu File/New wybrać General/XML/XSQL File; plikowi nadać nazwę kbd2a##_3.xsql. W znaczniku <page> dodać atrybut connection="kbd2a". Utworzyć zawartość strony ze znacznikiem/znacznikami <xsql:query>. Wymagane
3 Testować stronę XSQL Uruchomić stronę XSQL za pomocą pozycji Run kbd2a##_3.xsql menu Run. Uruchamia się lokalny serwer OC4J, co trwa chwilę. Strona XSQL powinna się pokazać w przeglądarce WWW. Po obejrzeniu wyniku nie zamykać przeglądarki. Wymagane
4 Poprawiać stronę XSQL Po wprowadzeniu poprawek do strony XSQL nie trzeba ponownie uruchamiać serwera OC4J; wystarczy zapisanie pliku XSQL (File/Save), przejście do przeglądarki i odświeżenie strony (F5). Zalecane

Odbiór etapu 3

Forma odbioru

Pliki z wynikami należy przesłać prowadzącemu jako załącznik do listu elektronicznego. List powinien mieć temat: KBD2A##, etap 3.

W treści listu należy umieścić:

Lp. Czynność Wskazówki Ważność
1 Wysłać pliki do prowadzącego Wypisać w liście wymagane informacje (patrz wyżej). Dołączyć wymagane pliki jako załączniki do listu elektronicznego (nie pakować programem archwizującym). Wymagane
2 Oczekiwać potwierdzenia W przypadku braku potwierdzenia po kilku dniach interweniować! Zalecane

Uwagi:

Poprawianie etapu 3

Etap 3 poprawiać można jedynie w przypadku niezaliczenia. Ze względu na to, że przedmiot jest typu B, czas na złożenie poprawki jest bardzo ograniczony.
Poprawkę należy przesłać niezwłocznie w formie takiej samej jak wyniki etapu 3, zaznaczając w temacie listu, że jest to poprawka.