Etapa 1: Criar um Componente

Esta etapa explica como criar seu componente personalizado no Oracle Content Management.

Quando você cria um componente personalizado, ele deve ser registrado para uso do Oracle Content Management. Para informar o Oracle Content Management sobre seu componente, use a página Componentes no Site Builder para registrar o componente.

Há dois tipos de componentes a serem registrados.

  • Componente local:

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

    • A principal vantagem é que você não precisa se preocupar com problemas de domínio ou protocolo cruzado porque os arquivos estão localizados no site.

    • A desvantagem é que você não pode executar qualquer lógica de camada intermediária no servidor do Oracle Content Management. Use APIs REST para servidores remotos que suportam CORS.

    • Esse tipo de componente pode ser incorporado na página diretamente ou você pode optar por usar um iframe para renderizá-lo na página.

  • Componente remoto:

    • Um componente no qual os arquivos são armazenados em um servidor remoto e você apenas registra os URLs no painel Renderização e Definições para o componente.

    • Um componente remoto oferece uma vantagem quando você tem a lógica do servidor que deve ser executada ao criar o conteúdo do componente.

    • A desvantagem é que você deve ter certeza de que qualquer problema de domínio cruzado e segurança seja resolvido para acessar esses URLs.

    • Os componentes remotos usam sempre um iframe para renderização na página.

Para criar e registrar um componente local:

  1. Na home page do Oracle Content Management, clique em Desenvolvedor.

    A página Desenvolvedor é exibida.

  2. Clique em Exibir todos os Componentes.

  3. No menu, escolha Criar Componente Local.

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

  5. Informe uma descrição opcional.

  6. Clique em Criar.

    Depois de ter feito isso, você verá um componente chamado A_Local_Component em sua lista de componentes.

Verificar os Resultados da Etapa 1

Agora que você criou com sucesso um componente, deverá vê-lo na paleta de componentes para qualquer site que criar. Use estas etapas para validar a criação do componente:

  1. Crie um site chamado localComponentTest.

  2. Selecione o site e clique em Abrir.

  3. Clique em Editar.

  4. Crie uma atualização para o site e dê a ela um nome e, se desejar, uma descrição.

  5. Selecione uma página no site.

  6. Clique em ícone do componente na paleta lateral e selecione Personalizado para exibir a lista de componentes personalizados.

  7. Selecione A_Local_Component na lista de Componentes personalizados, arraste-o e solte-o na página.

    Agora você deverá ver uma renderização padrão do componente local que você criou.

  8. Selecione Ícone Menu de opções no banner para o componente que você acabou de soltar na página.

  9. Selecione Definições.

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

  11. Feche o painel Definições.

As etapas a seguir explicam como o componente personalizado é criado e como modificá-lo de acordo com suas finalidades. Continue em Etapa 2: Verificar a Estrutura de seu Componente Local.