terça-feira, 23 de novembro de 2010

Como Fazer - Canais RSS - Lotes que vencerão nos próximos XX dias

Produto: TOTVS Gestão de Estoque, Compras e Faturamento Versão 11.20
Processo do Sistema: Objetos Gerenciais
SubProcesso: RSS

Como Fazer

Como parametrizar o sistema para utilizar Canais RSS para verificar quais lotes de produtos vencerão nos próximos XX dias?

Descrição do Processo

Tem por finalidade o envio de email ao usuário vinculado a um Feed do Outloolk automaticamente sempre que a rotina de Canal RSS retornar alguma informação, ou seja, quando a execução da consulta SQL, informada na inclusão do Canal RSS, apresentar algum resultado.
É necessário que haja um critério para configuração do Canal RSS, visto que, ao utilizar uma consulta SQL mais complexa o desempenho do sistema pode ficar comprometido. O RSS será disparado automaticamente obedecendo à configuração do tempo de atualização definido no sistema, sempre que a consulta SQL retornar alguma informação.

Importante:
- Para utilização do RSS é necessário que o cliente possua o “RM PORTAL” instalado e que a versão do “Outlook” seja 2007 ou posterior.
- Para configurar o RSS o usuário deverá acessar o aplicativo através da Nova MDI.
- Todo processo de assinatura, inclusão e publicação de RSS será feito considerando o perfil parametrizado para este fim. Neste caso específico será considerado o perfil “mestre” para fazer a parametrização do processo.

Parametrizações Necessárias

  • Acessar o diretório | C:\TOTVS\CORPORERM\RM.NET | e clicar no ícone clip_image002 | para acessar a Nova MDI. A seguir clicar no ícone | clip_image004 | e escolher opção | Serviços Globais. Na sequência acessar menu | Ambiente | Parâmetros Gerais | Globais | onde deve acessar aba | Gerais | e informar:

    - Porta para envio de mensagens: definido pelo cliente.
    - URL de acesso ao Portal RM: colocar endereço de acesso ao portal.
    ** Neste exemplo específico será considerado endereço | http://rm0004068/CORPORE1120
  • Acessar o menu | Gestão | Visões de Dados | Inserir | e cadastrar Consulta SQL que será considerada para geração deste RSS com o conteúdo:

    SELECT
    TP.CODIGOPRD, TP.NOMEFANTASIA AS PRODUTO, TP.CODUSUARIO, TL.NUMLOTE, CONVERT(VARCHAR,TL.DATAVALIDADE, 103) AS VALIDADE
    FROM
    TLOTEPRD TL, TPRD TP, TSTATUSLOTEPRD TS
    WHERE
    TL.CODCOLIGADA = TP.CODCOLIGADA
    AND TL.IDPRD=TP.IDPRD
    AND TS.IDSTATUS = TL.IDSTATUS
    AND TL.DATAVALIDADE <= GETDATE()+ 5
    AND TL.DATAVALIDADE >= GETDATE()
    AND TP.CONTROLADOPORLOTE = 1

Importante:
- A consulta em questão retorna os produtos controlados por lote, cujos lotes vencerão nos próximos 05 dias (considerando a data do sistema).
- Na inclusão da consulta deve ser marcada opção | ( x ) Disponível para o RM Portal |, caso contrário a consulta não será apresentada para seleção.

  • Acessar menu | Gestão | e clicar no ícone | clip_image006 | para configurar o tempo de atualização dos dados onde deve informar:
    - Tempo de Atualização(min): tempo em minutos para atualização dos dados
    - Tempo de exibição do aviso (seg): tempo em segundos para exibição de avisos
    Proxy:
    - Endereço: endereço do servidor de email
    - Porta: porta de acesso ao servidor
    Ainda neste menu, acessar o ícone | clip_image008 | e escolher opção | Incluir | para cadastrar e configurar o RSS.
    Ao escolher opção “Incluir RSS” serão apresentadas abas com parametrizações específicas para geração do RSS, onde deve ser informado:

    Aba – Identificação
    Preencher Título, Descrição e caminho URL a ser utilizado. Ao salvar esta informação o campo | Copie a URL abaixo para assinar o Canal | será preenchido e este caminho será considerado para gerar os convites e emails de RSS.

    Aba – Permissões
    Clicar no ícone | Incluir | e selecionar o perfil a ser utilizado para receber as mensagens de RSS. Todos os usuários vinculados a este perfil receberão convite para participar do RSS e ao aceitar, o mesmo receberá emails com conteúdo parametrizado para este RSS.

    Aba – Fontes
    Clicar no ícone | Incluir | e preencher todos os campos apresentados. A informação em questão será considerada para composição e geração dos dados do RSS.

Consulta SQL do Alerta: campo de preenchimento obrigatório, onde o usuário tem que referenciar a consulta SQL inclusa anteriormente, onde o resultado apresentado vai determinar o disparo do RSS.

clip_image012
clip_image010

Identificador Único: Este campo será apresentado para manutenção depois que as outras informações forem preenchidas, visto que, através do mesmo o usuário vai determinar quais campos chaves da base devem ser considerados para disparar o RSS. Para isto deverá clicar na opção | Selecionar | onde serão apresentados campos referenciados na Consulta SQL.

clip_image014

Neste exemplo especifico serão selecionados campos | CODIGOPRD – PRODUTO – CODUSUARIO – NUMLOTE - VALIDADE | que serão referenciados na “Descrição” para compor o conteúdo do RSS a ser enviado ao usuário.

clip_image016

Título: Campo de preenchimento obrigatório onde deve ser informada identificação do RSS para o Feed a ser enviado. Será definido título a ser apresentado no RSS onde o usuário tem opção de vincular o mesmo a um parâmetro que será preenchido ao clicar no ícone | Parâmetros |

clip_image017

Descrição: Campo de preenchimento obrigatório onde deve ser informada descrição do processo a ser enviado para o usuário através do RSS. No campo em questão poderá buscar os dados que retornam na consulta SQL através de { }.

O vínculo entre este campo e o resultado da consulta será feito ao clicar no ícone | Parâmetros |. Ao informar <b> o conteúdo preenchido a partir do mesmo será apresentado em “negrito”, já a opção </b> determina que o texto deixará de ser apresentado em “negrito” e voltará a ser apresentado normal.

Estes dados se referem a linha de programação HTML não sendo de responsabilidade da TOTVS a definição ou utilização dos mesmos.

clip_image019

Cada informação apresentada em | {} | se refere ao conteúdo referenciado na Consulta SQL. Para vincular os dados deverá clicar no ícone | clip_image021 | onde será apresentada coluna | PARAM | com os campos referenciados na descrição, a partir daí, o usuário deverá preencher na coluna | ORIGEM | para vincular ao parâmetro utilizado.

Neste exemplo específico os dados são:
0 – Código do produto
1 – Nome do Produto
2 – Código do usuário
3 – Número do Lote
4 – Data de vencimento do lote

Fonte de Leitura

Tipo de Leitura (SQL\URL): Este campo define o tipo de retorno do RSS podendo ser através de consulta SQL ou através de uma URL que fará o direcionamento á tela do Corpore.NET.
O endereço da URL é gravado na aba | Identificação | no campo | Copie a URL abaixo para assinar o canal.

clip_image023

Nos campos em questão também podem ser passados parâmetros para obter resultado esperado.

Tela Configurada

clip_image024

Publicação de Convite de Canal RSS

Depois de feitas parametrizações anteriores, o Canal RSS estará pronto para ser assinado e enviado convite para o funcionário fazer as configurações do Feeds. Para isto é necessário selecionar o canal e clicar em | Processo | Publicar Canal RSS | onde será enviado convite para todos usuários vinculados ao perfil parametrizado. Nessa tela é permitido alterar o assunto e o corpo do e-mail.

clip_image026

clip_image028

Criação de RSS Feeds no Outook

Ao publicar o Canal RSS será enviado email para o usuário com convite, onde o mesmo deverá copiar o caminho referenciado no RSS e fazer a criação do mesmo.

image

De posse desta informação, deve acessar o Outlook em | RSS | clicar com botão direito do mouse e escolher opção | Adicionar Novo RSS Feed |. A seguir colar caminho informado no email que recebeu com “convite” para assinatura do canal e clicar no ícone | Adicionar |.

clip_image032

Depois de feito isto clicar no ícone | Avançado | e infomar:

clip_image034

- Aba Geral: preencher descrição desejada para o Canal RSS

- Aba Downloads: habilitar campos | Baixar Automaticamente os Anexos neste feed - Baixar o artigo inteiro como um anexo .html para cada um |

A seguir clicar em | OK | para confirmar o processo.

Para assinar o RSS no Outlook 2007 deve-se inserir o usuário e senha do RM Portal se for pedido. Sempre que a consulta SQL referenciada na inclusão do Canal RSS retornar alguma informação será transformada em um Feed que é enviado para o Outlook. Para cada Feed será enviado email para o usuário que aceitou o convite.

Nenhum comentário:

Postar um comentário

RSS Reader