Como Fazer – Abonos Pendentes - RSS

Produto: TOTVS Automação de Ponto (RM Chronus)

Versão: 11.00

Processo: RSS

Subprocesso: Abonos Pendentes

Introdução

Esse documento tem como objetivo auxiliar na criação de um RSS que demonstra os abonos pendentes da aprovação do gestor. O RSS Abonos Pendentes poupa tempo, pois a cada atualização realizada no RM Portal, na página referente a abonos pendentes, o assinante do Canal RSS receberá uma notificação, bastando apenas clicar no link encaminhado para acessar a página e proceder com a aprovação dos abonos.

Saiba como configurar um RSS e obter uma poderosa ferramenta de gestão

Para inicializar um RSS, antes de tudo, deve-se possuir uma ou várias consultas SQL na base. A SQL deve contemplar informações relevantes para o retorno correto do Feed. Deve conter campos na cláusula SELECT e WHERE que servem como parâmetros, “campos chave” na criação do Canal RSS. Ou seja, quando a SQL apresentar alteração na quantidade (número de linhas) ou no conteúdo o RSS será disparado.

É importante lembrar que essas consultas SQL devem conter informações relevantes a quem quiser assinar o canal.

Pelo fato de uma SQL poder ser “filtrada” através de parâmetros, use bastante os parâmetros para trabalhar com os Feeds, principalmente aqueles que envolvam Coligada, Usuário e Datas, que são valores padrão (será explicado no item Parâmetros) do RSS. Dessa forma é possível ter uma informação mais enxuta para cada usuário.

1) Antes de configurar o RSS, é preciso definir nos parâmetros globais, os quais podem ser acessados através do menu “Ambiente” de qualquer aplicativo da solução, a URL de acesso ao RM Portal:

2) Para criar uma consulta SQL, acesse o menu "Gestão" de qualquer aplicativo da solução:

3) Crie a consulta abaixo:

4) Ainda no menu “Gestão”, clique em “Canais RSS”:

5) Na janela de Canal RSS clique no ícone (Incluir). Feito isso, será aberta a tela de inclusão do canal. Conheça seus campos e como preenchê-los conforme RSS proposto por este documento:

Aba “Identificação”:

Disponível para todas as Coligadas: marcando esta caixa de seleção o canal será exibido como opção de RSS para todas as coligadas presentes nos produtos RM.

Titulo: Preenchimento obrigatório. É exibido no início do canal, coloque um nome de fácil identificação do canal.

Descrição: Preenchimento obrigatório. É exibido logo após o título do canal. Coloque uma breve descrição sobre o canal RSS.

Imagem: Campo opcional. Ao escolher uma imagem essa será exibida em forma de link para o campo URL.

URL: Campo opcional. Ao inserir um endereço de um site, o mesmo será o link da imagem, caso seja inserida.

Aba “Permissões”:

A permissão a um canal RSS é dada a um ou mais perfis, os quais devem ser criados com antecedência no produto. Este perfil deve ser associado ao Canal, para isso, basta selecionar o perfil na tela de visualização de perfis e clicar em OK.

Aba “Fontes”:

Consulta SQL do Alerta: Campo obrigatório. Essa consulta é a parte principal do Canal, ela comanda o disparo do RSS. Com base na variação do seu conteúdo, na variação de linhas ou diferenças de valores, a SQL retorna os números de Feeds a serem enviados para o usuário. Ou seja, funciona como uma trigger no banco de dados, quando um evento é detectado no banco este dispara uma ação programada pelo usuário.

Identificador Único: Um conjunto de campos da Consulta SQL do Alerta que diferencia um Feed de outro, como a “chave primária” da Fonte RSS. Isso torna cada Feed único. Ficará disponível após a salvar a Fonte. Por exemplo, considere a consulta SQL abaixo:

SELECT PFunc.Nome, PFunc.Salario FROM PFunc

Se no campo “Identificador Único” selecionarmos “PFunc.Nome” e “PFunc.Salario”, sempre que um dos campos sofrer um INSERT ou um UPDATE, será disparado o RSS. Se selecionarmos somente o campo “PFunc.Salario”, quando este campo sofrer um INSERT ou um UPDATE é que será disparado o RSS.

Título: Campo obrigatório. Descreva uma identificação sobre o Feed e/ou informações que retornam da SQL de leitura. (Consulte o item Passagem de Parâmetro)

Descrição: Campo obrigatório. Deverá inserir informações sobre o Feed e/ou informações que retornam da SQL de leitura. (Consulte o item Passagem de Parâmetro)

SQL/URL do Tipo de Leitura: Deve-se escolher entre uma SQL ou uma URL para a leitura do Feed. A fonte de leitura deve ter conteúdo referente ou detalhamento das informações da SQL do alerta.

Para demonstrar os abonos pendentes, use a URL abaixo:

http://localhost/Corpore110/Main.aspx?ActionID=PtoAAbonFunActionWeb&SelectedMenuIDKey=AprovarAbonos

Passagem de Parâmetros: Em alguns pontos do configurador, encontramos o botão “Parâmetros”. Este indica que aquele determinado recurso pode ser usado com passagem de parâmetros.

Um parâmetro também pode ser identificado através de chaves “{}”, dentro destas chaves, devemos colocar números sequenciais. O conjunto de chaves e números sequenciais identifica um parâmetro. Conforme exemplo da tela abaixo:

Valores Defaults dos Parâmetros: O RM Portal permite escolher alguns valores defaults na passagem de parâmetros, esses valores são:

Ø Valor Fixo – Permite que seja passado um valor fixo em todas as vezes que for solicitada a Leitura do RSS. Válido somente para consultas SQL.

Ø Usuário RSS – Usuário que está logado ou irá logar no RM Portal.

Ø Última Coligada do Usuário RSS – Última coligada que o usuário do RSS acessou.

Ø Data da leitura – A data da última leitura de algum RSS feita pelo usuário.

6) Para publicar o canal, vá à edição deste, copie a URL a ser enviada aos assinantes que tenham interesse, em seguida acesse “Processos / Publicar Canal RSS”.

7) Através da tela de publicação do Canal RSS são configurados: assunto e texto do e-mail, o qual será usado para convidar os usuários associados ao perfil cadastrado no Canal RSS para participar do mesmo.

Para facilitar o uso dessa rotina foram incluídos 2 marcadores:

1. [TITULOCANAL] – deve ser substituído pelo título do Canal, que está na tela de cadastro do Canal RSS.

2. [URLCANAL] – Será substituído pela URL para assinar o Canal.

Após alterar o assunto e o corpo do e-mail, se necessário, clique em “Executar” para envio do convite.

8) Assinando um Canal RSS a partir de um Leitor de RSS:

8.1) O leitor de RSS pode ser acionado através do menu “Gestão” de qualquer aplicativo RM.

8.2) No Leitor RSS, clique em “Canais / Adicionar Canal”

8.3) Copie a URL enviada por e-mail e insira no seu leitor de RSS, após preenchimento dos demais campos do leitor, clique em OK.

9) Assinando um Canal RSS no Firefox:

9.1) Copie a URL enviada por e-mail, cole na barra de endereço do navegador e clique na tecla “Enter” do seu teclado. Será exibida uma tela para inserir o usuário e senha do RM Portal para acessar o Canal RSS. Após a inserção clique em OK.

10) Assinando um Canal RSS no Microsoft Outlook 2007:

10.1) No Outlook, clique com o botão direito do mouse sobre “RSS Feeds”.

10.2) Selecione “Adicionar Novo RSS Feed...”

10.3) Na tela exibida inclua a URL do RSS, enviada por e-mail. Clique em “Adicionar”.

10.4) Para assinar o RSS no Outlook 2007 deve-se inserir o usuário e senha do RM Portal, caso seja solicitado.

Informações Adicionais

No momento do registro do Canal RSS no leitor de RSS (Outlook, Firefox, etc.) deve-se informar qual usuário dos sistemas da linha RM está autorizado a registrar o canal.

Ao incluir/alterar/excluir uma Fonte é necessário salvar o Canal novamente para efetuar as alterações.

O uso do “NOLOCK” nas consultas SQL melhora o desempenho e seu uso é incentivado principalmente nas consultas de tabelas muito grandes. Este recurso é exclusivo para bases SQL Server.

Veja como usar o "NOLOCK" em uma consulta:

SELECT * FROM NOME_TABELA (NOLOCK);