7 Gerir Componentes e Disposições Customizados

Como programador, pode criar e gerir componentes e disposições customizados. Como um contribuidor do site, pode registar os componentes de terceiros (aplicações) e grupos de componentes.

Os componentes customizados incluem grupos de componentes que cria no editor e componentes locais e remotos que cria utilizando as opções descritas nesta secção. As disposições customizadas incluem disposições da secção para organizar componentes num slot numa página e disposições do conteúdo para organizar os campos num item de conteúdo.

Para aprender como utilizar componentes com o seu site, consulte Organizar Conteúdo das Páginas.

Para obter informações sobre a utilização de componentes individuais, consulte Utilizar Componentes Integrados.

Para obter detalhes sobre como criar os seus próprios componentes, consulte Desenvolver Componentes.

Noções sobre Componentes Customizados

Os componentes são as secções individuais que compõem uma página na Web. Quando olha para uma página na Web, o que vê? É provável que veja uns quantos títulos, alguns parágrafos de texto e várias ligações para outras páginas no site. Também poderá ver imagens, botões, divisores, mapas e galerias. Cada um destes itens constitui um componente.

Para acrescentar um componente a uma página, certifique-se de que está definido para Editar, clique em e escolha o tipo de componente que pretende utilizar.

Arraste o componente do painel e largue-o num slot da página. É tão simples quanto isto. Arraste e largue títulos, parágrafos, imagens e outros componentes onde os pretende posicionar numa página.

Pode facilmente registar e incorporar componentes remotos (aplicações) e até mesmo criar os seus próprios componentes utilizando as opções no gestor de componentes. Clique em Programador e, em seguida, clique em Visualizar Todos os Componentes.

Clique em Criar e selecione a opção associada para criar um novo componente local ou registar um componente remoto. Os componentes que criar e partilhar deste modo são listados no painel de componentes customizados no editor.

Para obter detalhes sobre como criar os seus próprios componentes, consulte Desenvolver Componentes.

Componentes Remotos

Se tiver um componente (aplicação) de terceiros que pretenda utilizar, basta registá-lo e utilizá-lo no seu site. É muito fácil.

Quando registar um componente remoto, especifique o URL para o próprio componente remoto e um segundo URL para quaisquer definições que um autor da Web possa especificar para o componente remoto.

Após registar um componente remoto, pode partilhá-lo com outros utilizadores. Os componentes remotos registados que lhe pertencem ou que são partilhados consigo são listados no painel Componentes Customizados no Criador de Sites.

Pode alterar as propriedades de um componente remoto no editor da mesma forma que faria para qualquer outro componente. Basta clicar no ícone de menu e escolher Definições. O botão Customizar abre o URL de definições que especificou quando registou o componente remoto.

Nota:

Uma vez que os componentes remotos são alojados num servidor diferente do servidor que aloja o Oracle Content Management, estes são delimitados numa moldura inline (utilizando um elemento iframe) por motivos de segurança. Nem todos os componentes remotos podem ser delimitados numa moldura inline. Contacte o fornecedor para saber se pode ser delimitado.

Componentes Locais

Os programadores podem criar componentes com acesso às mesmas funcionalidades e capacidades que as fornecidas pelo Oracle Content Management. Pode inserir o componente diretamente na página ou delimitá-lo numa moldura inline com o elemento iframe.

Quando clica em Criar para criar um componente local, um componente de amostra totalmente funcional é acrescentado à lista de componentes com um nome especificado pelo utilizador e um identificador exclusivo. Como um programador, pode modificar a amostra para criar as suas próprias soluções.

Para obter detalhes sobre como criar os seus próprios componentes, consulte Desenvolver Componentes.

Noções sobre Disposições

Uma disposição de página organiza slots e conteúdo numa página. Uma disposição de secção organiza conteúdo num slot. Uma disposição de conteúdo organiza os campos num item de conteúdo.

Em geral, uma disposição especifica a apresentação do conteúdo, mas não o próprio conteúdo. Separar o conteúdo da sua apresentação facilita a apresentação dos mesmos conteúdo em diferentes modos ou a alteração da apresentação sem ter de tocar no conteúdo.

Disposição da Página

Quando acrescenta uma página a um site, seleciona uma disposição a utilizar para essa página. Cada disposição possui áreas na página, denominados slots, onde um contribuidor pode arrastar e largar conteúdo. Uma disposição de página define o número e a posição dos slots na página. Uma disposição também inclui conteúdo que é predefinido e posicionado na página. Este conteúdo pode ser estático e não editável, como um logótipo de empresa, ou pode ser minimamente editável, como o texto do cabeçalho que um contribuidor pode alterar, não podendo alterar a respetiva posição ou aspeto.

As disposições de página são armazenadas no tema. Os temas podem ter uma ou mais disposições de página. Como programador, pode copiar e modificar um tema existente para ciar um novo tema. Consulte Desenvolver Disposições.

Segue-se a descrição de GUID-0D1E20B4-F6E9-4C58-BD3F-2D530C5E6504-default.png

Descrição da ilustração GUID-0D1E20B4-F6E9-4C58-BD3F-2D530C5E6504-default.png

Disposição da Secção

Uma disposição da secção organiza automaticamente o conteúdo que lhe foi acrescentado, permitindo que um contribuidor acrescente facilmente conteúdo sem despender tempo na formatação na página. Por exemplo, uma disposição da secção organiza automaticamente conteúdo em múltiplas colunas ou numa lista vertical. Um contribuidor de site pode acrescentar uma ou mais disposições da secção a um slot para organizar conteúdo.

Segue-se a descrição de GUID-36A933A5-73C5-4587-8009-927D948AB023-default.png

Descrição da ilustração GUID-36A933A5-73C5-4587-8009-927D948AB023-default.png

Além das disposições fornecidas, um programador pode criar disposições da secção adicionais para resolver determinados problemas de disposição ou para simplificar a criação para os contribuidores. Um criador do tema até pode criar disposições da secção num slot numa disposição da página. Consulte Desenvolver Disposições.

Disposição do Conteúdo

Se for um utilizador empresarial, pode criar e utilizar itens de conteúdo com base nos tipos e disposições de conteúdo que lhe foram fornecidos. O conteúdo estruturado desta forma permite-lhe, como contribuidor, juntar o conteúdo para um item de conteúdo fora do Criador de Sites. Múltiplas disposições de conteúdo associadas ao tipo de conteúdo permitem que o criador do site apresente o item de conteúdo em diferentes contextos sem ter de tocar no conteúdo criado. Como programador, pode criar novas disposições a partir da disposição por omissão fornecida. Consulte Desenvolver Disposições.
Segue-se a descrição de GUID-6BFCEB85-93E9-49BA-B4B8-6170DBE40210-default.png
Descrição da ilustração GUID-6BFCEB85-93E9-49BA-B4B8-6170DBE40210-default.png

Utilizar Componentes e Disposições Customizados

Como programador, pode criar e gerir componentes e disposições customizados. Como um contribuidor do site, pode registar os componentes de terceiros (aplicações) e grupos de componentes.

Os componentes customizados incluem grupos de componentes que o utilizador cria no editor e componentes locais e remotos que o utilizador cria utilizando as opções descritas abaixo. Se tiver uma aplicação de terceiros (componente remoto) que pretenda utilizar, basta registá-la e utilizá-la no seu site. Os programadores também podem criar componentes locais com acesso às mesmas funcionalidades e capacidades que as fornecidas pelo Oracle Content Management.

As disposições customizadas incluem disposições da secção para organizar componentes num slot numa página e disposições do conteúdo para organizar os campos num item de conteúdo.

Utilize as opções na barra de menus ou menu do botão direito do rato na página Componentes para efetuar as tarefas seguintes.

Tarefa	Descrição
Registar um componente remoto	Quando registar um componente remoto, especifique o URL para o próprio componente remoto e um segundo URL para quaisquer definições que um autor da Web possa especificar para o componente remoto. Para poder criar um componente, o seu administrador deve ativar as opções no menu Criar. Se não vir o menu Criar na página de componentes, contacte o administrador. Clique em Criar e selecione a opção associada para registar um componente remoto. Consulte Registar Componentes Remotos.
Criar um componente ou uma disposição local	Quando criar um componente ou uma disposição local, é-lhe fornecido um componente ou uma disposição de amostra totalmente funcional que utiliza como base para criar o seu próprio componente ou a sua própria disposição. Antes de criar um componente ou uma disposição, o seu administrador deve ativar as opções no menu Criar. Se não vir o menu Criar na página de componentes, contacte o administrador. Clique em Criar e selecione a opção associada para criar um novo componente ou uma nova disposição local. Consulte Criar Componentes Locais, Disposições, Editores de Campos de Conteúdo ou Fichas de Conteúdo. Para obter informações sobre outras formas de criar componentes, consulte Desenvolver Componentes.
Copiar um componente ou uma disposição	Pode criar um novo componente ou uma nova disposição copiando um componente ou uma disposição existente e efetuando alterações na cópia. Nota: Não pode alterar o nome de um componente ou de uma disposição após criá-lo ou registá-lo. Pode copiar um componente ou uma disposição e especificar um nome diferente para a cópia. Todas as outras informações de registo, incluindo o valor de chave para componentes remotos, são mantidas. As informações de partilha são independentes das informações de registo e não são copiadas. Clique com o botão direito do rato no componente ou na disposição que pretende copiar e escolha Copiar. Introduza um nome e clique em Copiar. Pode utilizar letras, números, caracteres de sublinhado (_) e hífenes (-). Se introduzir um espaço, este é substituído automaticamente por um hífen.
Criar Editor de Campos de Conteúdo	Pode criar um editor de campos de conteúdo que pode ser promovido e utilizado ao criar um tipo de conteúdo para controlar o aspeto do campo de dados. São suportados todos os tipos de dados, exceto Multimédia e Referência. O componente deve ser promovido antes de ficar disponível para utilização ao criar um tipo de conteúdo.
Partilhar um componente ou uma disposição	Pode partilhar o componente ou a disposição com outros utilizadores do Oracle Content Management. Pode partilhar um componente ou uma disposição, caso seja o proprietário ou lhe tenha sido atribuído o perfil de grupo Gestor. Ao partilhar um componente ou uma disposição, deve atribuir um perfil de grupo ao utilizador que define o que ele pode fazer com o componente. Clique com o botão direito do rato no componente ou na disposição que pretende partilhar, escolha Partilhar e clique em Acrescentar Membros. Introduza um ou mais nomes de utilizador ou endereços de correio eletrónico e atribua um destes perfis de grupo: Visualizador: Os visualizadores podem ver e utilizar o componente ou a disposição na lista de componentes e disposições customizados do editor. Também podem visualizar as pastas e os ficheiros do tema, mas não podem efetuar alterações. Descarregador: Os descarregadores podem também descarregar ficheiros e gravá-los nos seus próprios computadores. Contribuidor: Os contribuidores podem também editar o componente ou a disposição, importar novos ficheiros, apagar ficheiros e apagar o próprio componente ou a disposição, desde que não esteja em utilização num site. Gestor: Os gestores podem também acrescentar utilizadores e atribuir os seus perfis de grupo. É automaticamente atribuído o perfil de grupo de gestor ao criador de um componente ou de uma disposição(o proprietário).
Editar um componente ou uma disposição	Se for um programador da Web, pode exportar e modificar ficheiros de componentes ou disposições individuais ou pode utilizar a aplicação do ambiente de trabalho e sincronizar quaisquer alterações efetuadas no sistema local. Também pode exportar um componente ou uma disposição individualmente ou como parte de um pacote de modelo, que inclui quaisquer componentes e disposições da secção customizados, e trabalhar com o componente ou a disposição em modo offline, no seu ambiente de desenvolvimento preferido. Se efetuar alterações num componente ou numa disposição, deve publicar um ou outro para que essas alterações sejam refletidas pelos sites que utilizam o componente ou a disposição.
Exportar ou importar um componente ou uma disposição	Pode exportar um componente ou uma disposição para o modificar offline e, em seguida, importá-lo como um novo componente ou disposição ou para substituir o componente ou disposição existente. Pode também exportar um componente ou uma disposição para deslocá-los para outra instância e importá-los ali. Pode exportar um componente ou uma disposição individualmente ou como parte de um pacote de modelo, que inclui quaisquer componentes e disposições customizados. Quando exporta um componente ou uma disposição, copia o componente ou a disposição para uma pasta como um único ficheiro .zip. Pode exportar o pacote do componente ou da disposição diretamente a partir da pasta para desempacotar e utilizar os ficheiros individuais. Quando tiver terminado de trabalhar com os ficheiros do componente ou da disposição, crie um ficheiro .zip que contenha o pacote do componente ou da disposição, importe-o e substitua o componente ou a disposição original ou crie um novo. Consulte Exportar ou Importar Componentes ou Disposições.
Publicar um componente ou uma disposição	Se um site utilizar uma disposição ou um componente novo não publicado, o componente ou a disposição é publicado automaticamente com o site quando colocar o site online pela primeira vez. Se efetuar alterações num componente ou numa disposição e pretender atualizar os sites online de modo a mostrar as alterações, deve publicar o componente ou a disposição de forma explícita. Pode publicar um componente ou uma disposição, caso seja o proprietário ou lhe tenha sido atribuído o perfil de grupo Gestor. Selecione o componente ou a disposição na lista e clique em Publicar (ou Publicar Novamente para componentes ou disposições publicados anteriormente) na barra de menus. É apresentado um ícone Publicado junto ao componente ou à disposição na lista.
Apagar ou repor um componente ou uma disposição	Se tiver as permissões adequadas, pode apagar uma pasta de componente ou de disposição e do respetivo conteúdo. Quando apaga um componente ou uma disposição, a pasta do componente ou da disposição e todas as respetivas pastas e ficheiros associados são deslocados para o lixo. Pode apagar ou repor um componente ou uma disposição, caso tenha criado os mesmos (ou seja, se for o proprietário do componente ou da disposição) ou caso alguém tenha partilhado um componente ou uma disposição consigo e lhe tenha atribuído o perfil de grupo Contribuidor ou Gestor. Nota: Não pode apagar um componente ou uma disposição se estiver em utilização por qualquer site ou atualização, incluindo sites ou atualizações que estejam no lixo. Para apagar um componente ou uma disposição, clique com botão direito do rato no componente ou na disposição que pretende apagar e escolha Apagar. É solicitado que confirme a deslocação do componente ou da disposição para o lixo. Um componente ou uma disposição apagados permanecem no lixo até: Repor o componente ou a disposição. Apagar permanentemente o componente ou a disposição. A sua quota do lixo ser atingida. O lixo ser automaticamente esvaziado com base no intervalo definido pelo administrador do serviço. O valor por omissão é 90 dias. Para repor um componente ou uma disposição, clique em Lixo e, em seguida, clique com o botão direito do rato no componente ou na disposição a partir da lista e escolha Repor.

Registar Componentes Remotos

Para utilizar um componente remoto num site, primeiro deve registá-lo no Oracle Content Management.

Pode registar componentes remotos de terceiros e componentes remotos que tenha programado.

Nota:

Para poder registar um componente remoto, o seu administrador deve ativar as opções no menu Criar. Se não vir o menu Criar na página de componentes, contacte o administrador.

Para registar um componente remoto para utilização no Oracle Content Management:

Clique em Programador e, em seguida, clique em Visualizar Todos os Componentes.
Clique em Criar e escolha Registar Componente Remoto.
Na janela Registar Componente Remoto, introduza ou selecione informações, incluindo:
- Nome: Nome do componente que os utilizadores irão ver.
- Descrição: Descrição do componente que os utilizadores irão ver.
- URL do Componente: O endpoint utilizado num iframe para renderizar o conteúdo do componente numa página. Deve ser HTTPS.
- URL de Definições: O endpoint utilizado num iframe para renderizar as definições de um componente remoto acrescentado a uma página. Deve ser HTTPS.
- Largura das Definições: Define a largura por omissão do painel de definições do componente em píxeis.
- Altura das Definições: Define a altura por omissão do painel de definições do componente em píxeis.
- Chave: Uma chave AES de 192 bits associada ao componente remoto e utilizada para criar um token de hash assinado quando o componente é aprovisionado. É utilizada para codificar e garantir que as definições do componente são lidas e escritas de forma segura.
Clique em Registar.
Uma vez terminada a criação do componente remoto, o nome é apresentado na lista de componentes. Pode explorar os ficheiros utilizados para registar o componente clicando no nome do componente na lista de componentes.

As informações de registo do componente são armazenadas no catálogo utilizado pelos sites criados na mesma instância do Oracle Content Management, mas o componente permanece um serviço remoto.

Como proprietário do componente, o ícone do componente é acrescentado ao painel Componentes Customizados no editor com o nome que atribuiu ao componente. Pode partilhar o componente com outros utilizadores e estes verão o componente no painel Componentes Customizados do editor.

Criar Componentes Locais, Disposições, Editores de Campos de Conteúdo ou Fichas de Conteúdo

Como programador, quando criar um componente ou disposição local, está a receber um exemplo totalmente funcional que pode modificar para o seu próprio componente ou disposição.

Antes de criar um componente ou uma disposição, o seu administrador deve ativar as opções no menu Criar. Se não vir o menu Criar na página de componentes, contacte o administrador.

Como programador, pode criar componentes com acesso às mesmas funcionalidades e capacidades que as fornecidas pelo Oracle Content Management.

Para criar um componente ou disposição local de exemplo:

Clique em Programador e, em seguida, clique em Visualizar Todos os Componentes.
Clique em Criar e selecione o tipo de componente ou a disposição que pretende criar.
Introduza um nome para o componente ou disposição. Não pode utilizar um nome utilizado por outro componente ou disposição.

Pode utilizar letras, números, caracteres de sublinhado (_) e hífenes (-). Se introduzir um espaço, este é substituído automaticamente por um carácter de sublinhado.

Não utilize os seguintes nomes para modelos, temas, componentes, sites ou páginas de site: authsite, conteúdo, páginas, scstemplate_*, _comps, _components, _compsdelivery, _idcservice, _sitescloud, _sitesclouddelivery, _themes, _themesdelivery. Embora possa utilizar os seguintes nomes para as páginas de site, não os utilize para modelos, temas, componentes ou sites: documentos, sites.
Opcionalmente, introduza uma descrição para o componente ou disposição.
Para o tipo de componente, selecione Por Omissão para inserir o componente diretamente na página, Sandboxed para delimitar o componente numa moldura inline (utilizando um elemento iframe) ou Modelo para apresentar utilizando apenas um modelo.

Nota:
Se selecionar Modelo, o componente local não é baseado em Knockout e, por isso, não pode utilizar componentes encadeados quando forem colocados numa página. Isto significa, por exemplo, que a edição do título ou do corpo de texto deve ser efetuada através das definições customizadas no painel de definições do componente, em vez de selecionar o texto do componente conforme apresentado na página.
Clique em Criar.
Uma barra de progresso mostra o estado de criação. Uma vez terminada a criação do componente, da disposição ou da ficha, o nome é apresentado na lista de componentes. Pode explorar as pastas e os ficheiros que compõem o componente ou a disposição ao clicar no nome do componente ou da disposição na lista de componentes.
Para selecionar um ícone diferente de ícone por omissão atribuído ao componente ou disposição:
1. Selecione o componente ou a disposição na lista.
2. Clique em Propriedades.
3. Clique no separador Logótipo do Componente.
4. Clique num logótipo da galeria de logótipos e, em seguida, clique em Concluído.

Para obter informações detalhadas sobre como criar os seus próprios componentes, consulte Desenvolver Componentes.

Depois de customizar o seu componente, a disposição, o editor do campo de conteúdo ou a ficha de conteúdo, pode partilhá-los com outros ou promovê-los para que possam utilizá-lo das seguintes formas:

Componente Customizado: Quando utiliza o Criador de Sites, o ícone do componente é acrescentado ao painel Componentes Customizados no editor com o nome que atribuiu ao componente.
Disposição de Secção: Quando utiliza o Criador de Sites, o ícone da disposição de secção é acrescentado ao painel Disposições de Secção no editor com o nome que atribuiu à disposição.
Disposição de Conteúdo: Um administrador de conteúdo pode atribuir a disposição a um ou mais tipos de conteúdo, como a vista por omissão ou acrescentada a uma lista de disposições que um criador de sites pode selecionar no Criador de Sites para especificar como um item de conteúdo desse tipo é apresentado na página.
Editor de Campos de Conteúdo: Para disponibilizar um editor de campos de conteúdo para utilização ao criar tipos de conteúdo, selecione-o e clique em Promover, em seguida, confirme e clique em OK. Depois de promovidos, os editores de campos de conteúdo ficam disponíveis para controlar o aspeto de todos os campos de dados, exceto Multimédia e Referência, ao criar tipos de conteúdo.
Ficha de Conteúdo: Para disponibilizar uma ficha de conteúdo para utilizar ao criar tipos de conteúdo, selecione-a e clique em Promover. Em seguida, confirme e clique em OK. Depois de promovidas, as fichas de conteúdo ficam disponíveis para utilizar com todos os tipos de conteúdo e tipos de ativo.

Exportar ou Importar Componentes ou Disposições

Pode exportar um componente para o modificar offline e, em seguida, importá-lo como um novo componente ou para substituir o componente existente. Pode também exportar um componente para o deslocar para outra instância do Oracle Content Management e importá-lo ali.

Exportar

Quando exportar um componente, essencialmente copia o componente para uma pasta no Oracle Content Management como um único ficheiro .zip. Pode exportar o componente diretamente a partir da pasta para desempacotar e trabalhar com os ficheiros individuais. Quando tiver terminado de trabalhar com os ficheiros do componente, crie um ficheiro .zip que contenha as pastas e ficheiros do componente, importe-o e substitua o componente original ou crie um novo.

Nota:

Quando exportar um componente, as informações de partilha do componente não são incluídas.

Para exportar um componente:

Clique em Programador e, em seguida, clique em Visualizar Todos os Componentes.
Selecione um componente ou disposição e escolha Exportar na barra de menus ou no menu apresentado quando clica com o botão direito do rato.
Navegue para uma pasta ou crie uma nova pasta clicando em Nova, fornecendo um nome e uma descrição opcional, e clicando em Criar. Para abrir uma pasta, clique no ícone da pasta ou no nome da pasta.
Selecione uma pasta clicando na caixa de seleção da pasta associada e clique em OK.

Um ficheiro do pacote do componente ou da disposição é criado na pasta selecionada com o nome do componente ou da disposição e uma extensão .zip.

Importar

Antes de importar ou criar um componente, uma disposição ou um editor de campos de conteúdo, o seu administrador deve ativar as opções no menu Criar. Se não vir o menu Criar na página de componentes, contacte o administrador.

Para importar um componente, uma disposição ou um editor de campos de conteúdo:

Clique em Programador e, em seguida, clique em Visualizar Todos os Componentes.
Clique em Criar e escolha Importar componente. Escolha esta opção para importar um componente, uma disposição da secção ou uma disposição de conteúdo.
Se tiver importado o pacote do componente ou da disposição, navegue para a pasta que contém o componente ou a disposição e abra a pasta. Se ainda não tiver importado o pacote, vá para a pasta onde pretende importar o componente ou a disposição ou crie uma nova pasta. Clique em Importar e, em seguida, encontre o pacote do componente ou da disposição e clique em Abrir.
Clique na caixa de seleção junto ao nome do ficheiro do componente ou da disposição e clique em OK. Uma nova disposição ou um novo componente é criado e acrescentado à lista de componentes. Se o nome ou ID do componente ou da disposição já existir, é-lhe solicitado que resolva os conflitos. Poderá ser necessário criar um novo componente ou uma nova disposição ou pode substituir o componente ou a disposição existente pela versão importada.