Produto: | RM |
Ambiente: | Unspecified |
Versão: | 11.0 |
Esse documento tem como objetivo auxiliar na criação de um RSS que demonstra as batidas pendentes da aprovação do gestor.
O RSS Aprovação de batidas poupa tempo, pois a cada atualização realizada no RM Portal referente a batidas, 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.
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:
Para Base SQL
Código : RSS.PTO.002 Título : Batidas a serem aprovadas
SELECT ABATFUN.CHAPA, ABATFUN.DATA,PPESSOA.NOME,
( SELECT PP.NOME
FROM PSUBSTCHEFE, PFUNC, PPESSOA PP
WHERE PSUBSTCHEFE.CHAPASUBST = PFUNC.CHAPA
AND PFUNC.CODPESSOA = PP.CODIGO
AND PP.CODUSUARIO = :CODUSUARIO
AND SUBSTRING(PFUNC.CODSECAO, 1, LEN(PSUBSTCHEFE.CODSECAO)) = PSUBSTCHEFE.CODSECAO
) CHEFE
FROM ABATFUN INNER JOIN PFUNC ON (ABATFUN.CHAPA = PFUNC.CHAPA)
INNER JOIN PPESSOA
INNER JOIN GUSUARIO ON PPESSOA.CODUSUARIO = GUSUARIO.CODUSUARIO
ON (PPESSOA.CODIGO = PFUNC.CODPESSOA)
INNER JOIN APARAM ON (APARAM.CODCOLIGADA = ABATFUN.CODCOLIGADA)
WHERE ABATFUN.STATUS <> 'C' AND ABATFUN.STATUS <> 'D' AND
ABATFUN.DATA>= APARAM.INICIOPERMES AND ABATFUN.DATA <= APARAM.FIMPERMES
AND EXISTS ( SELECT PSUBSTCHEFE.CODSECAO
FROM PSUBSTCHEFE, PFUNC, PPESSOA PP
WHERE PSUBSTCHEFE.CHAPASUBST = PFUNC.CHAPA
AND PFUNC.CODPESSOA = PP.CODIGO
AND PP.CODUSUARIO = :CODUSUARIO
AND SUBSTRING (PFUNC.CODSECAO, 1, LEN(PSUBSTCHEFE.CODSECAO)) = PSUBSTCHEFE.CODSECAO)
Para Base Oracle :
SELECT ABATFUN.CHAPA, ABATFUN.DATA,PPESSOA.NOME,
( SELECT PP.NOME
FROM PSUBSTCHEFE, PFUNC, PPESSOA PP
WHERE PSUBSTCHEFE.CHAPASUBST = PFUNC.CHAPA
AND PFUNC.CODPESSOA = PP.CODIGO
AND PP.CODUSUARIO = :CODUSUARIO
AND SUBSTR(PFUNC.CODSECAO, 1, LENGTH(PSUBSTCHEFE.CODSECAO)) = PSUBSTCHEFE.CODSECAO
) CHEFE
FROM ABATFUN INNER JOIN PFUNC ON (ABATFUN.CHAPA = PFUNC.CHAPA)
INNER JOIN PPESSOA
INNER JOIN GUSUARIO ON PPESSOA.CODUSUARIO = GUSUARIO.CODUSUARIO
ON (PPESSOA.CODIGO = PFUNC.CODPESSOA)
INNER JOIN APARAM ON (APARAM.CODCOLIGADA = ABATFUN.CODCOLIGADA)
WHERE ABATFUN.STATUS <> 'C' AND ABATFUN.STATUS <> 'D' AND
ABATFUN.DATA>= APARAM.INICIOPERMES AND ABATFUN.DATA <= APARAM.FIMPERMES
AND EXISTS ( SELECT PSUBSTCHEFE.CODSECAO
FROM PSUBSTCHEFE, PFUNC, PPESSOA PP
WHERE PSUBSTCHEFE.CHAPASUBST = PFUNC.CHAPA
AND PFUNC.CODPESSOA = PP.CODIGO
AND PP.CODUSUARIO = :CODUSUARIO
AND SUBSTR (PFUNC.CODSECAO, 1, LENGTH(PSUBSTCHEFE.CODSECAO)) = PSUBSTCHEFE.CODSECAO)
Ainda no menu “Gestão”, clique em “Canais RSS”:
4) 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 as batidas a serem aprovadas, use a URL que direciona para a página de aprovação. Exemplo:
http://localhost/Corpore1100/Main.aspx?ActionID=PtoABatFunActionWeb&SelectedMenuIDKey=AprovarBatidas
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.
5) Para publicar o canal, vá à edição deste, copie a URL a ser enviada aos assinantes que tenham interesse, em seguida acesse “Processos / Publicar Canals RSS”.
6) 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.
7) 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.
8) 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.
9) 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); |
1. Problemas para Autenticar usuário quando Adicionamos um novo RSS
Primeiramente devemos verificar o arquivo WEB.Config Procure pelo nome “ServiceAlias” , nesta clausula deve estar apontado value="XXXXX" /> onde XXXX é o nome do Alias configurado no Alias. dat para acesso a base que se deseja. Segundo Acesse o Menu INICIAR do Windows , acesse “Ferramentas Administrativas \ Gerenciador do Serviços de Informações da Internet (IIS)” Acesse “Sites\Default Web Site” clique e “Autenticação” As autenticações devem ficar da seguinte maneira Obs: Em alguns servidores pode haver menos ou mais serviços Terceiro Verifique o Site “CorporeRM” . Clique em autenticação As autenticações do site devem ficar da seguinte maneira Obs: Em alguns servidores pode haver menos ou mais serviços Em seguida resete o seu IIS (pelo menu ou pelo comando iisreset.exe) No caso do sistema Operacional ser o Windows XP, deve-se desmarcar a opção Autenticação do Windows Integrada.
| |
| Quarto
Caso após essas verificações o problema ainda continuar, verificar o arquivo MADAM.DLL dentro da pasta \CorporeRM\RM.NET e \CorporeRM\Corpore.NET\Bin e conferir se a versão dessa DLL está a mesma da BibliotecaRM. |