Dodawanie/edycja elementu opartego na PL/SQL

Należy wybrać:

• Dodaj element jako nową, lecz nie jako bieżącą wersję — aby dodać element jako nową wersję, lecz nie wyświetlać go od razu na stronie. Później można dokonać zmiany na bieżącą wersję.
• Dodaj element jako nową i bieżącą wersję — aby dodać element jako nową wersję i od razu wyświetlić go na stronie.
• Zastąp bieżącą wersję — aby zastąpić uprzednią wersję elementu.

Uwaga: Dla dwóch pierwszych opcji system OracleAS Portal zachowuje rejestr poprzednich wersji elementu. Trzecia opcja jest dostępna tylko wtedy, gdy poziomem obsługi wersji jest "Zwykła".

Należy wybrać tę wersję elementu, z której mają zostać skopiowane wartości atrybutów. Można zacząć od istniejącej wersji tłumaczenia lub od najnowszej wersji w języku domyślnym. Wartości atrybutów zostaną skopiowane z wybranej wersji. Gdy operacja kopiowania zostanie ukończona, wartości tłumaczalnych atrybutów staną się dostępne.

Na liście tej znajduje się zarówno najnowsza wersja elementu w języku domyślnym portalu, jak i wszystkie inne wersje dostępne w bieżącym (innym niż domyślny) języku.

Aby skopiować atrybuty wybranego elementu i utworzyć jego nową wersję, należy nacisnąć przycisk Wykonaj. Po potwierdzeniu wyboru nastąpi powrót do strony edycji elementu, na której można dokonać dalszych korekt tłumaczalnych atrybutów elementu.

Należy podać (lub wkleić) kod PL/SQL dla tego elementu.

Przykład:

htp.print('Witaj świecie!');

Uwagi:

• Nie trzeba podawać instrukcji BEGIN ani END, lecz trzeba wpisać końcowy średnik (;).
• Jeśli kod PL/SQL elementu jest stosunkowo obszerny, warto umieścić go w procedurze i wywoływać ją za pomocą elementu.
• Jeśli strona zawierająca element PL/SQL jest buforowana na poziomie systemu, to wszelkie wywołania PL/SQL należy poprzedzić nazwą schematu. Na przykład:

  <nazwa_schematu>.wwpob_home_page.draw_quicktips_portlet;

• Podany tu kod PL/SQL nie jest weryfikowany, gdy tworzenie lub edytowanie elementu zostanie zakończone. Weryfikacja jest przeprowadzana podczas próby wykonania kodu. Jeśli kod jest poprawny, to jest wykonywany podczas wypełniania elementu; jeśli jest niepoprawny, są zwracane komunikaty o błędach. Po utworzeniu strony należy koniecznie przetestować kod.

Należy podać opisową nazwę, która będzie wyświetlana dla danego elementu. Można użyć maksymalnie 256 znaków.

Uwaga: Użytkownicy wyświetlają element, klikając na jego wyświetlanej nazwie. Powinna być ona możliwie opisowa.

Należy wybrać kategorię, która najlepiej opisuje dany element.

Uwaga: Na tej liście są przedstawione wszystkie kategorie, które administrator grupy stron udostępnił dla tej grupy stron.

Należy podać datę, kiedy element ma stać się dostępny.

Uwaga: Gdy nadejdzie dzień określony przez datę publikowania, element stanie się widoczny dla użytkowników oglądających stronę. Przed tą datą element jest widoczny jedynie w trybie edytowania.

Należy wybrać:

• Na stałe — aby element był zawsze wyświetlany. Element będzie dostępny, aż zostanie usunięty lub ustawiony ręcznie jako wygasły.
• Wygasa po — aby element był wyświetlany przez określoną liczbę dni, licząc od daty opublikowania. W sąsiadującym polu należy podać liczbę dni, po upływie których element wygasa.
• Wygasa w dniu — aby element był wyświetlany aż do określonej daty i godziny. W sąsiadującym polu należy podać datę (w formacie DD-MMM-YYYY HH12:MI PM).

Uwaga: Gdy element wygaśnie, nie będzie widoczny dla użytkowników oglądających stronę. Element jest nadal widoczny w trybie edytowania, gdzie można go edytować — i jeśli trzeba — anulować wygaśnięcie.

W polu Dostępne perspektywy należy wybrać perspektywy, które najlepiej opisują dany element, po czym kliknąć na ikonie "Przenieś w prawo".

Uwagi:

• Na liście Dostępne perspektywy są przedstawione wszystkie perspektywy, które administrator grupy stron udostępnił dla tej grupy stron.
• Kolejność perspektyw na liście Wyświetlane perspektywy decyduje o kolejności wyświetlania perspektyw obok elementu (jeśli w obszarze zawierającym element są wyświetlane perspektywy).

Należy podać szczegóły dotyczące grafiki i związać je z elementem. Korzystając z pierwszego pola (), należy podać położenie grafiki lub wyszukać ją w systemie plików. W drugim polu () można podać trwały adres URL grafiki lub używaną wewnętrznie nazwę pliku zawierającego uprzednio wysłaną grafikę. Można dodawać grafiki w formatach JPEG, GIF i PNG.

Uwaga: W nazwie grafiki mogą występować dowolne znaki z wyjątkiem następujących:

& # % \ / : * ? < > | , "

Uwaga: Aby dowiedzieć się, jaka jest nazwa uprzednio wysłanej grafiki, należy odnaleźć ją w portalu, kliknąć na niej prawym przyciskiem myszy i wybrać polecenie Właściwości. Wewnętrzną nazwą będzie wartość liczbowa, na przykład 1645.GIF. Jeśli nazwa grafiki nie ma postaci liczbowej, to nie jest to wysłana grafika i nie można jej ponownie użyć.

Jeśli jest włączona obsługa wersji elementów, to — aby zawsze była wyświetlana najnowsza wersja grafiki — należy, zamiast wewnętrznej nazwy pliku grafiki, użyć trwałego adresu URL. Będzie wówczas zawsze pobierana najnowsza wersja. Dlatego, zamiast nazwy 1645.GIF, należałoby wpisać:

/portal/page/<DAD>/<GUID>

Jest to względny format trwałego adresu URL. Na przykład:

/portal/page/obrazek/A47D41ECA23648A9E030007F0100118A

Należy zawsze używać względnych adresów URL, aby nie utracić spójności tego odwołania, jeśli zostanie zmieniona nazwa hosta lub nazwa domeny albo jeśli zawartość zostanie wyeksportowana do innego serwisu.

Trwały URL elementu można uzyskać, wyświetlając atrybut "Arkusz właściwości" w obszarze, w którym jest zawarty element. Po wyświetleniu atrybutu "Arkusz właściwości" należy kliknąć na ikonie "Arkusz właściwości" () obok elementu, po czym skopiować potrzebny fragment trwałego adresu URL. Trwały adres URL jest wyświetlany obok pola Łącze elementu.

Arkusz właściwości, który się uzyskuje przez kliknięcie na ikonie "Arkusz właściwości", różni się od uzyskanego po kliknięciu prawym przyciskiem myszy na grafice i wybraniu (z menu podręcznego) polecenia Właściwości.

Należy wybrać tę opcję, jeśli ma być możliwe wyrejestrowywanie i rejestrowanie elementów. Gdy element jest wyrejestrowany, nikt inny nie może go edytować.

Uwaga: Administratorzy grup stron i projektanci stron mogą rejestrować elementy nawet wtedy, gdy są one wyrejestrowane przez innych użytkowników.

Należy wybrać:

• Element wyświetlany bezpośrednio w obszarze strony — aby wynik wykonania kodu PL/SQL był wyświetlany bezpośrednio na stronie.
• Łąącze wyświetlające element w pełnym oknie przeglądarki — aby, gdy użytkownik kliknie na wyświetlanej nazwie łącza, zawartość bieżącego okna przeglądarki była zastępowana przez wynik wykonania kodu PL/SQL.
• Łącze wyświetlające element w nowym oknie przeglądarki — aby, gdy użytkownik kliknie na wyświetlanej nazwie łącza, było otwierane nowe okno przeglądarki z wyświetlonym wynikiem wykonania kodu PL/SQL.

Uwaga: Szablonu portalu dla elementów można używać tylko wtedy, gdy jest wybrana jedna z opcji wyświetlania jako Łącze. Jeśli zostanie wybrana opcja Element wyświetlany bezpośrednio w obszarze strony, to szablon portalu dla elementów (określony we właściwościach strony lub w atrybutach elementu) będzie ignorowany.

Ta opcja jest dostępna podczas edytowania (nie dodawania) elementu i to pod warunkiem, że:

• dla strony zawierającej element jest włączona opcja zezwalająca elementom na używanie innego szablonu portalu;
• w grupie stron, do której należy strona z elementem, lub w grupie stron "Współużytkowane obiekty" jest dostępny przynajmniej jeden szablon portalu;
• element jest jednego z następujących typów:
  • Tekst
  • PL/SQL
  • URL
  • Plik typu MIME:
    • Text/HTML
    • Text/Plain

Należy wybrać:

• Nie używaj szablonu portalu — aby dla tego elementu nie był używany szablon portalu.
• Użyj tego samego szablonu portalu co strona nadrzędna (<nazwa strony>) — aby był używany szablon portalu określony dla strony zawierającej ten element.
• Użyj tego szablonu portalu — aby był używany szablon portalu inny niż określony dla strony. Należy wybrać odpowiedni szablon portalu z rozwijanej listy. Jeśli zostanie wybrany szablon, z którym są powiązane parametry, to zostaną one wyświetlone, tak że będzie można zmienić typ wartości na liście typów wartości parametrów. Można wybrać:
  • Null — aby nie podawać żadnej wartości parametru.
  • Strona — aby szczegóły strony zostały przekazane do parametru w szablonie portalu (dla elementów).
  • Zmienna systemowa — aby użyć wartości zmiennej systemowej, na przykład USER_NAME.
  • Wartość stała — aby podać określoną wartość.

Element PL/SQL jest wykonywany przy użyciu wybranego schematu bazy danych. Ta opcja jest dostępna tylko wtedy, gdy zalogowany użytkownik ma uprawnienia administratora bazy danych (DBA).