In diesem Schritt wird erläutert, wie Sie eine benutzerdefinierte Komponente in Oracle Content Management erstellen.
Wenn Sie eine benutzerdefinierte Komponente erstellen, muss diese für die Verwendung durch Oracle Content Management registriert werden. Sie informieren Oracle Content Management über die Komponente, indem Sie diese in Sitebuilder auf der Seite "Komponenten" registrieren.
Sie können zwei Typen von Komponenten registrieren.
Lokale Komponente:
Die Dateien dieser Komponente werden auf dem Oracle Content Management-Instanzserver gespeichert.
Der Hauptvorteil hierbei besteht darin, dass keine domain- oder protokollübergreifenden Probleme auftreten, da die Dateien in der Site aufbewahrt werden.
Der Nachteil besteht darin, dass Sie keine Middle-Tier-Logik im Oracle Content Management-Server ausführen können. Daher müssen Sie REST-APIs zu Remoteservern verwenden, die CORS unterstützen.
Dieser Komponententyp kann direkt in die Seite eingebettet werden. Sie können die Komponente aber auch in einem Inlineframe auf der Seite rendern.
Remotekomponente:
Die Dateien dieser Komponente werden auf einem Remoteserver gespeichert. Sie registrieren lediglich die URLs zum Rendering- und Einstellungsbereich für die Komponente.
Eine Remotekomponente bietet einen Vorteil, wenn Sie serverseitige Logik verwenden, die beim Erstellen des Inhalts für die Komponente ausgeführt werden muss.
Allerdings müssen Sie hier sicherstellen, dass alle domainübergreifenden und sicherheitsbezogenen Probleme für den Zugriff auf diese URLs behoben wurden.
Remotekomponenten werden immer in einem Inlineframe auf der Seite gerendert.
So erstellen und registrieren Sie eine lokale Komponente:
Klicken Sie auf der Oracle Content Management-Homepage auf Entwickler.
Die Seite Entwickler wird angezeigt.
Klicken Sie auf Alle Komponenten anzeigen.
Wählen Sie im Menü die Option Lokale Komponente erstellen aus.
Geben Sie einen Namen für die Komponente ein. Beispiel: A_Local_Component.
Geben Sie eine Beschreibung ein (optional).
Klicken Sie auf Erstellen.
Anschließend wird die Komponente A_Local_Component
in der Komponentenliste angezeigt.
Ergebnisse für Schritt 1 prüfen
Wenn Sie die Komponente erfolgreich erstellt haben, sollte diese in der Komponentenpalette für jede von Ihnen erstellte Site angezeigt werden. Führen Sie die folgenden Schritte aus, um die Erstellung Ihrer Komponente zu validieren:
Erstellen Sie die Site localComponentTest
.
Wählen Sie die Site aus, und klicken Sie auf Öffnen.
Klicken Sie auf Bearbeiten.
Erstellen Sie ein Update für die Site mit einem Namen und optional einer Beschreibung.
Wählen Sie eine Seite in der Site aus.
Klicken Sie in der seitlichen Palette auf , und wählen Sie Benutzerdefiniert aus, um die Liste der benutzerdefinierten Komponenten anzuzeigen.
Wählen Sie A_Local_Component
in der Liste der benutzerdefinierten Komponenten aus, und ziehen Sie die Komponente per Drag-and-Drop auf die Seite.
Jetzt sollte ein Standardrendering für die erstellte lokale Komponente angezeigt werden.
Wählen Sie im Banner für die Komponente, die Sie gerade auf der Seite abgelegt haben, aus.
Wählen Sie Einstellungen aus.
Ändern Sie die Ausrichtung, und legen Sie den Stil für die Komponente fest.
Schließen Sie den Einstellungsbereich.
In den folgenden Schritten wird erläutert, wie die benutzerdefinierte Komponente erstellt wird und wie Sie sie Ihren Anforderungen entsprechend ändern. Weiter mit Schritt 2: Struktur der lokalen Komponente prüfen.