O serviço de RSS possui um ambiente administrativo para que o editor de conteúdo cadastre RSS's e gere o arquivo XML com conteúdo de notícias, ou avisos, entre outros tipos de conteúdos, correspondentes ao assunto (categorias) do RSS. A figura abaixo exibe a área com os RSS's cadastrados:
Para o cadastro de um RSS,basta acionar o comando Adicionar e preencher as seguintes informações:
Aba Geral
| • | Nome: Campo obrigatório que deve ser preenchido com o nome do canal de conteúdo que será exibido na lista, antes de cada feed(arquivo XML). Corresponde à categoria do assunto do conteúdo a ser selecionado pelo usuário; |
| • | Caminho: Campo facultativo que pode ser preenchido com o caminho físico aonde o arquivo será gerado, relativo a "www/data/rss". Se o caminho não for informado, o arquivo será armazenado em "www/data/rss/(id da instância de serviço)/(id do rss).xml". Ao alterar o caminho na edição de um RSS, o arquivo antigo é excluído do diretório, evitando armazenamento de arquivos inutilizados no servidor. No exemplo acima, especificou-se o nome amigável do arquivo "esporte.xml". Este por sua vez será salvo em "www/data/rss". |
| • | Cabeçalho: Campo de preenchimento obrigatório que deve conter informações referentes ao canal ou site. Tais informações estarão contidas no arquivo XML a ser criado. |
Na adição de um RSS, o campo cabeçalho já vem preenchido com um valor default. Este valor contém um exemplo de tags. As tags que devem conter tais informações são padrão e estão especificadas em http://www.rssboard.org/rss-specification .
Ainda no cabeçalho, as tags <pubDate> e <lastBuilddate> possuem como valor as variáveis do Lumis Portal ${publishedDate} e ${buildDate} respectivamente, que por sua vez, seus valores serão preenchidos .
Pelo menos as tags <title>, <link> e <description> são obrigatórias e devem conter respectivamente: o nome do site ou do canal; o link para o site ou canal; e uma breve descrição do site ou canal .
| • | Posição: Campo obrigatório que deve ser preenchido com a posição do RSS na lista. Caso não seja especificado, assumirá posição "0"; O valor especificado na posição apenas será determinante se a ordenação da lista nao tiver sido especificada pelo administrador do portal; |
| • | Número de itens: Campo facultativo que pode conter a quantidade de conteúdos que estará no arquivo XML. |
Aba Fonte de Dados
| • | Serviço: Campo obrigatório que deve ser preenchido com o nome do serviço de conteúdo registrado no portal e utilizado pela solução; |
| • | Instância de serviço: Campo obrigatório que deve ser preenchido com uma das instâncias de tal serviço selecionado previamente; |
| • | Fonte de Dados: Campo facultativo que pode ser preenchido com a fonte de dados especificada para o serviço. Um serviço pode ser provido de mais de um source. Se não for selecionada uma fonte de dados que proverá os conteúdos para a instância de serviço, o Lumis Portal selecionará o primeiro que encontrar; |
As próximas informações básicas correspondem aos valores dos elementos do arquivo XML.Tais elementos serão exibidos, tanto quanto forem as ocorrências de conteúdos.
| • | Data: Campo facultativo que pode ser preenchido com alguma informação referente a data associada a cada conteúdo (data de publicação se tiver algum ou outro tipo de data relacionada ao conteúdo). Caso não seja informado, no arquivo XML será exibida a data de publicação daquele conteúdo ; |
| • | Título: Campo facultativo que pode ser preenchido com alguma informação cadastrada para o conteúdo, que pode ser nome, título, introdução, descrição, entre outros. Caso não seja especificado, será exibido no arquivo XML o valor do campo que está definido como isprimaryName , na definição do serviço daquele conteúdo; |
| • | Descrição: Campo facultativo que pode ser preenchido com alguma informação cadastrada para o conteúdo, que pode ser nome, título, introdução, descrição, entre outros. Caso não seja especificado, será exibido no arquivo XML o valor do campo que está definido como isIntroduction , na definição do serviço daquele conteúdo; |
| • | Link: Campo facultativo que pode ser preenchido com alguma informação que será tratada como link para a página de detalhes do conteúdo. Quando não especificado, o Lumis adotará o seu padrão de link para a página de detalhes. Porém, quando a página é exibida, é fornecida uma URL, cuja expressão é resultado de um cálculo utilizando o valor do campo Link; |
Informação sobre filtro de conteúdos a serem exibidos no arquivo XML:
| • | Filtrar: Campo facultativo que pode ser preenchido com uma cláusula SQL contendo um filtro dos conteúdos da instância de serviço selecionada. |
O serviço de RSS permite ainda que o editor de conteúdo estabeleça regras para publicação como período que determinado conteúdo estará disponível para o usuário final da solução; publique o mesmo RSS em outros idiomas; e submeta o RSS ao processo de aprovação (workflow) para que seja publicado.
Observação |
|
Para informações sobre como cadastrar período de publicação, workflow e publicação para outros idiomas, consultar a seção “Funcionalidades Gerais dos Serviços de Gestão de Conteúdo ”. |
|
Ao confirmar a adição ou edição de um RSS, o arquivo XML é gerado automaticamente. Além disso, quaisquer alterações no conteúdo da instância de serviço que irá prover determinado RSS, fazem com que o arquivo XML seja gerado novamente.
O editor pode também, manualmente, gerar o arquivo XML de cada RSS, através da opção Gerar XML disponível na interface administrativa.
A figura abaixo é um exemplo de um arquivo XML gerado em "www/data/rss":
Observe no arquivo no arquivo XML acima, que é exibido o cabeçalho cadastrado no RSS de "Esportes".
Cada conteúdo de notícias da instância de serviço especificada, e que satisfaz a condição do filtro também especificado no cadastro do RSS de "Esportes" será exibida na tag <item>.
De todas as notícias cadastradas para aquela instância de serviço selecionada, apenas uma atendia a condição do filtro. Portanto, so ela foi adicionada ao arquivo.
Os valores das tags <title>, <description>, <link> e <pubDate> pertencentes a <item> , que correspondentes às informações sobre o conteúdo, são os estipulados durante o cadastro da fonte de dados.
É incluído um link para para o rss.css nos RSS'S gerados. Assim, quando o browser não possuir um coletor de feeds, não será exibido o XML puro do RSS.