Passo 1: Criar um Componente

Este passo explica o modo de criação do seu componente customizado no Oracle Content Management.

Quando cria um componente customizado, deve ser registado para ser passível de utilização por parte do Oracle Content Management. Para informar o Oracle Content Management sobre o seu componente, utilize a página Componentes no Criador de Sites para registar o componente.

Existem dois tipos de componentes a registar.

  • Componente local:

    • Este é um componente cujos ficheiros são armazenados no servidor da instância do Oracle Content Management.

    • A principal vantagem é o facto de não ser necessário preocupar-se com problemas entre protocolos ou entre domínios porque os ficheiros estão localizados no seu site.

    • A desvantagem é o facto de não poder executar qualquer lógica de middle-tier no servidor do Oracle Content Management, por isso, deve utilizar as APIs REST para servidores remotos que suportem CORS.

    • Este tipo de componente poderá ser incorporado na página diretamente ou pode optar por utilizar uma moldura inline para apresentar o componente na página.

  • Componente remoto:

    • Um componente onde os ficheiros são armazenados num servidor remoto e só poderá registar os URLs no painel Apresentar e Definições para o componente.

    • Um componente remoto oferece uma vantagem, caso tenha a lógica do lado do servidor que deve executar ao criar o conteúdo para o seu componente.

    • A desvantagem é o facto de ter de garantir que quaisquer problemas de segurança e entre domínios são resolvidos para aceder a esses URLs.

    • Os componentes remotos utilizam sempre uma moldura inline para apresentação na página.

Para criar e registar um componente local:

  1. Na página principal do Oracle Content Management, clique em Programador.

    É apresentada a página Programador.

  2. Clique em Visualizar todos os Componentes.

  3. No menu, escolha Criar Componente Local.

  4. Introduza um nome para o componente, por exemplo, A_Local_Component.

  5. Introduza uma descrição opcional.

  6. Clique em Criar.

    Depois de efetuar este procedimento, verá um componente denominado A_Local_Component na sua lista de componentes.

Verificar os Resultados para o Passo 1

Agora que criou um componente com êxito, deverá vê-lo na paleta de componentes para qualquer site que criar. Utilize estes passos para validar a criação do seu componente:

  1. Crie um site denominado localComponentTest.

  2. Selecione o site e clique em Abrir.

  3. Clique em Editar.

  4. Crie uma atualização para o site e atribua-lhe um nome e, opcionalmente, uma descrição.

  5. Selecione uma página no site.

  6. Clique em ícone de componente na paleta lateral e selecione Customizar para apresentar a lista de componentes customizados.

  7. Selecione A_Local_Component na lista de componentes customizados e arraste-o para a página.

    Deverá ver agora uma apresentação por omissão para o componente local que criou.

  8. Selecione ícone do menu Opções no cabeçalho para o componente que acabou de largar na página.

  9. Selecione Definições.

  10. Altere o alinhamento e defina o estilo para o componente.

  11. Feche o painel Definições.

Os passos seguintes explicam o modo como o componente customizados é criado e a forma como pode modificá-lo consoante as suas necessidades. Avance para Passo 2: Rever a Estrutura do Seu Componente Local.