Para renderizar itens de conteúdo, são utilizadas as Disposições de Conteúdo. Estas recebem os dados do item de conteúdo, renderizam-no em HTML e inserem-no na página.
Por omissão, as disposições de conteúdo tiram partido dos modelos Mustache para renderizar os itens de conteúdo, embora seja possível a respetiva implementação em qualquer tecnologia JavaScript. Para que o modelo Mustache seja renderizado, espera-se que os dados estejam num determinado formato. O ficheiro render.js
da disposição de conteúdo tem de garantir que o modelo que transmite corresponde a esse formato.
As disposições de conteúdo são renderizadas em vários casos de utilização:
Quando são utilizadas na IU de Gestão de Ativos do Oracle Content Management, os dados podem encontrar-se num estado "editado" para o utilizador pré-visualizar as alterações antes de os gravar.
Quando são utilizadas num site do Oracle Content Management numa lista de conteúdos ou num item de conteúdo, os dados são aumentados com informações adicionais sobre o site no qual estão em execução.
Quando são utilizadas através da chamada contentClient.renderLayout()
do Content SDK, em que o utilizador do Content SDK transmite os dados pretendidos diretamente à disposição do conteúdo.
Por questões de desempenho, existe um compromisso geral entre criar uma única consulta que devolva todos os dados necessários ou várias consultas para que a estrutura seja renderizada o mais rápido possível, com uma consulta inicial rápida, e as áreas sejam posteriormente preenchidas através de consultas subsequentes. O modelo a escolher depende dos seus dados e dos casos de utilização.
Além disso, os dados transmitidos a uma disposição de conteúdo podem variar no formato devido ao modo como os dados foram obtidos. Por exemplo, se utilizar um REST de conteúdo com um parâmetro de expansão, as referências de campo a outros itens de conteúdo, quer individualmente quer como um grupo, também podem ser devolvidas. Se os itens de conteúdo referenciados não forem incluídos, precisará de efetuar chamadas adicionais de REST.
Para tratar de todos os casos, o programador da disposição do conteúdo deve tentar ser flexível relativamente ao formato dos dados recebidos. Além disso, quando necessário, o programador pode extrair dados adicionais e coagir os dados para o formato esperado pelo modelo de renderização.