Składniki, które są renderowane w ramkach wstawkowych, mogą być określane na stronach Oracle Content Management poprzez zarejestrowanie, a następnie dodanie składników z serwerów zewnętrznych (składników określanych jako składniki odległe), a także poprzez wybranie opcji ramki wstawkowej podczas tworzenia składnika lokalnego. Ten typ składnika może rozszerzyć funkcje serwisów, na przykład poprzez możliwość dodania składnika społecznościowego lub składnika "koszyk z zamówieniami".
Dla składnika odległego trzeba określić URL punktu końcowego. W przypadku składnika lokalnego renderowanego w ramce wstawkowej adresy URL są wyprowadzane z nazwy składnika, przechowywanego w katalogu składników.
URL punktu końcowego: Zawartość widżetu jest pobierana spode tego adresu URL i jest osadzana w obrębie ramki wstawkowej.
URL ustawień: Ten URL jest renderowany w ramce wstawkowej, tak aby można było skonfigurować składnik zaraz po umieszczeniu go na stronie.
Składnik może renderować statyczne lub dynamiczne wizualizacje danych oraz wyświetlać formularz bądź inny interaktywny interfejs użytkownika rozszerzający funkcje serwisu. Zob. Renderowanie ustawień składnika.
Składniki udostępniane przez Oracle Content Management
Zbiór składników, które są renderowane w ramkach wstawkowych, jest udostępniany przez usługę Oracle Content Management.
| Nazwa | Typ | ID |
|---|---|---|
|
Lista folderów |
scs-app |
Lista folderów |
|
Lista plików |
scs-app |
Lista plików |
|
Menedżer dokumentów |
scs-app |
Menedżer dokumentów |
|
Facebook - Lubię to |
scs-app |
Facebook - Lubię to |
|
Twitter - Obserwuj |
scs-app |
Twitter - Obserwuj |
|
Twitter - Udostępnij |
scs-app |
Twitter - Udostępnij |
|
Facebook - Rekomendacja |
scs-app |
Facebook - Rekomendacja |
Rejestracja składnika
Zanim w serwisie będzie można użyć odległego składnika renderowanego w ramce wstawkowej, trzeba zarejestrować — za pomocą protokołu HTTPS — URL punktu końcowego. Informacja ta jest przechowywana w katalogu składników. Punkt końcowy musi zezwalać adresowi URL na wyświetlanie w ramce wstawkowej; nie należy ustawiać nagłówka X-Frame-Options="sameorigin". W przypadku składnika lokalnego kryterium punktu końcowego jest automatycznie spełniony, ponieważ pliki są przechowywane na serwerze Oracle Content Management.
Po zarejestrowaniu składnika renderowanego w ramce wstawkowej zostanie wygenerowany nowy GUID reprezentujący składnik. Jeśli ten składnik został zarejestrowany w instancji Oracle Content Management więcej niż raz, uzyska więcej niż jeden GUID, ponieważ identyfikatory te reprezentują każdą rejestrację składnika. Gdy składnik zostanie zarejestrowany, w Oracle Content Management przechowywany będzie tylko opis powiązany z identyfikatorem GUID; składnik nadal będzie uruchamiany ze swojego odległego punktu końcowego. Zob. Rejestrowanie składnika odległego.
Po zarejestrowaniu składnika renderowanego w ramce wstawkowej zostanie również wygenerowany ID instancji. Ten ID instancji reprezentuje składnik zarejestrowany przy użyciu określonej dzierżawy Oracle Content Management. Ten sam składnik, zarejestrowany więcej niż raz w obrębie tej samej dzierżawy Oracle Content Management lub przy użyciu innej dzierżawy Oracle Content Management, będzie miał różne identyfikatory (ID) instancji.
Utrwalanie ustawień składnika odległego
Po wyrenderowaniu (w panelu ustawień) adresu URL składnika renderowanego w ramce wstawkowej, są udostępniane ID instancji i ID składnika. Dzięki temu składnik może wybrać utrwalanie dowolnych ustawień na swoim własnym serwerze, indeksując je według ID instancji i ID składnika. Alternatywnie można użyć zestawu Sites SDK z Oracle Content Management i zezwolić na przechowywanie — z uwzględnieniem ID składnika — danych JSON (maksymalnie 1,5 KB) w modelu strony serwisu.
Składnik może z łatwością uczestniczyć w wersjach stron, aktualizacjach stron i modelu publikowania serwisu.
Składnik może obejmować punkty końcowe HTML uruchamiane w przeglądarce (w przeciwieństwie do uruchamiania w systemie zaplecza).