Passo 1: Creare un componente

In questo passo viene spiegato come creare il componente personalizzato in Oracle Content Management.

Il componente personalizzato creato deve essere registrato per poter essere utilizzato da Oracle Content Management. Per informare Oracle Content Management delle caratteristiche del componente si utilizza la pagina Componenti di SiteBuilder per registrare il componente.

I tipi di componente da registrare sono due.

Componente locale:
- Si tratta del componente i cui file sono memorizzati nel server dell'istanza di Oracle Content Management.
- Il vantaggio principale offerto dai componenti locali consiste nel fatto che non ci si deve preoccupare di eventuali problemi tra domini o protocolli perché i file sono posizionati con il sito.
- Lo svantaggio consiste nell'impossibilità di eseguire la logica di livello intermedio nel server di Oracle Content Management ed è pertanto necessario utilizzare le API REST per i server remoti che supportano CORS.
- Questo tipo di componente può essere incorporato direttamente nella pagina oppure è possibile scegliere di utilizzare un frame in linea per eseguire il rendering del componente nella pagina.
Componente remoto:
- Componente i cui i file sono memorizzati su un server remoto e per il quale si registrano solo gli URL nel pannello Rendering e Impostazioni per il componente.
- Un componente remoto offre un vantaggio se si dispone di logica lato server che deve essere eseguita durante la creazione del contenuto per il componente.
- Lo svantaggio è dato dal fatto che è necessario assicurarsi che gli eventuali problemi tra domini e di sicurezza siano stati risolti per l'accesso a tali URL.
- I componenti remoti utilizzano sempre un frame in linea per il rendering nella pagina.

Per creare e registrare un componente locale, effettuare le operazioni riportate di seguito.

Nella home page di Oracle Content Management fare clic su Sviluppatore.

Viene visualizzata la pagina Sviluppatore.
Fare clic su Visualizza tutti i componenti.
Scegliere Crea componente locale nel menu.
Immettere un nome per il componente, ad esempio A_Local_Component.
Immettere una descrizione (facoltativo).
Fare clic su Crea.

Una volta effettuate queste operazioni il componente denominato A_Local_Component sarà visibile nella lista dei componenti.

Controllare i risultati per il passo 1

Quando la creazione riesce, il componente è visibile nella tavolozza dei componenti per qualsiasi sito creato. Utilizzare la procedura riportata di seguito per convalidare la creazione del componente.

Creare un sito denominato localComponentTest.
Selezionare il sito e fare clic su Apri.
Fare clic su Modifica.
Creare un aggiornamento per il sito e assegnare un nome e, facoltativamente, una descrizione.
Selezionare una pagina nel sito.
Fare clic su nella tavolozza laterale e selezionare Personalizzato per visualizzare la lista dei componenti personalizzati.
Selezionare il componente A_Local_Component nella lista dei componenti personalizzati e trascinarlo sulla pagina.

Viene ora visualizzato un rendering predefinito per il componente locale creato.
Selezionare nel banner per il componente appena rilasciato sulla pagina.
Selezionare Impostazioni.
Modificare l'allineamento e impostare lo stile per il componente.
Chiudere il pannello Impostazioni.

Nei passi successivi viene descritta la struttura del componente personalizzato e viene spiegato come modificarlo per le proprie esigenze. Continuare con l'argomento Passo 2: Esaminare la struttura del componente locale.