Central de NotificaçãoNotificação 

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

  A central de notificação será composta da junção de duas funcionalidades já implementadas no TOTVS Educacional e a adição de outras duas, são elas: 

• Cadastro de Mensagens de Notificação 
• Processo de Mala Direta 
• Processo de Envio de Notificação e/ou Post nas Comunidades (nova funcionalidade)
• Processo de Envio de Mensagens de Notificações Temporais (nova funcionalidade)

Configuração do ambiente

Fluig:

1. Utilizar o usuário administrador do Fluig e acessar o Painel de controle -> WCM 
2. Configurar o Oauth Provider 
3. Configurar o Oauth App (pode-se utilizar qualquer conjunto de caracteres para definição do Consumer Key e Consumer Secret)
   Para mais detalhes sobre o passo 2 e 3 consulte o documento "Cadastrar aplicativo no Fluig" pelo link: http://tdn.totvs.com/display/public/fluig/Fluig+API#FluigAPI-CadastraraplicativonoFluig

Parâmetros Globais e Contas de Comunicação

1. Acessar a guia Ambiente -> Parâmetros -> Globais
   1. Aba: Integração Fluig definir:
      1. Endereço do servidor do Fluig
      2. Id da empresa do Fluig
      3. Usuário administrador do Fluig
      4. Senha do usuário administrador do Fluig
   2. Aba: Integração oAuth definir:
      1. Chave de consumo: é a chave consumer key definida na etapa da configuração do fluig.
      2. Chave secreta: é a chave consumer secret definida na etapa da configuração do fluig.
   3. Salvar os parâmetros
2. Acessar a guia Gestão -> Fontes e verificar se a fonte de comunicação com o Fluig está cadastrada. Caso não encontre entre em contato com o suporte da TOTVS.
3. Acessar a guia Gestão -> Contas -> Contas individuais e criar um novo registro
   1. Código da fonte de comunicação: vincular a fonte relacionada ao Fluig
   2. Utilizar "Usar esta conta como remetente"
   3. Identificação na rede social: informar o usuário mestre do Fluig
   4. Obter credenciais: ao clicar neste botão será exibida a tela de login do Fluig onde deve ser informado o usuário administrador e sua senha
   5. As credenciais serão obtidas e o campo Descrição será preenchido com o nome do usuário administrador.
   6. Salvar o registro

Cadastro de Mensagens de Notificação (Acessar TOTVS Educacional | Atividades Acadêmicas | Central de notificações | Mensagens de Notificação)

Na versão 12.1.7 todos os parâmetros do sistema relacionados a definição das mensagens de e-mail foram deslocados para este cadastro, unificando o ponto de definição das mensagens de notificação. A partir da versão 12.1.9 este cadastro sofre mais uma evolução passando a permitir que as mensagens de notificação possam ser também enviadas como notificações para usuários no Fluig. Importante frisar que esta evolução foi implementada apenas para o módulo TOTVS Educacional.

Outro ponto, é que a partir desta versão todos os parâmetros que determinam o envio ou não da mensagem foram transferidos dos parâmetros do Educacional para esse cadastro, desta forma na definição da mensagem o usuário passa a parametrizar se utilizará o envio por e-mail e/ou por notificação.

O tipos de mensagens de notificação disponíveis no TOTVS Educacional:

1. Categoria: Secretária
   1. Confirmar reservas de recursos 
   2. Confirmar reservas de instalações
2. Categoria: Estágio
   1. Informar ao aluno que houve alguma alteração na vaga de estágio para a qual ele está inscrito
   2. Informar ao aluno que ele foi selecionado para a vaga de estágio na qual está inscrito
   3. Informar ao aluno que ele não foi selecionado para a vaga de estágio na qual está inscrito
   4. Informar ao aluno sobre aprovação do plano de atividades do estágio
   5. Informar ao aluno sobre reprovação do plano de atividades do estágio
   6. Informar para o participante que ele foi convidado para a banca
3. Categoria: Pesquisa e Extensão 
   1. Informar os pesquisadores sobre a divulgação do edital (Pesquisa)
   2. Informar os pesquisadores sobre a divulgação do edital (Extensão)
4. Categoria: Matrícula e Avaliação
   1. Pendências financeiras do aluno
   2. Cadastro de ocorrência para o aluno
   3. Frequência do aluno próximas do limite ou excedida
   4. Pendências de matrícula
   5. Liberação ou digitação de etapa de nota
   6. Liberação ou digitação de etapa de falta

Os tipos de mensagens passam a ter uma classificação interna que determina de que modo estas são disparadas:

1. Classificação: Fixa -> mensagens com este tipo de classificação são disparadas por funcionalidades já existentes no sistema.
2. Classificação: Temporal -> mensagens com este tipo de classificação são disparadas pela funcionalidade "Envio de mensagens de notificações temporais". 
   As mensagens temporais disponíveis neste primeiro momento são: 
   1. Pendências financeiras do aluno
   2. Frequência do aluno próximas do limite ou excedida
   3. Pendências de matrícula.

Escolhida a mensagem que se quer definir pode-se preencher os seguintes campos:

1. Ativar envio por e-mail
   1. Assunto do e-mail
   2. Texto do e-mail (para envio no formato HTML é permitido formatar o texto e incluir imagens)
   3. Enviar e-mail como HTML ou texto
2. Ativar envio por notificação via Fluig
   1. Texto da notificação (não poderá conter formatação e nem imagens)

Lembrado que cada mensagem de notificação possui algumas tag's que podem ser incluídas na definição do template da mensagem a ser encaminhada.

Processo de Mala Direta (Acessar TOTVS Educacional | Atividades Acadêmicas| Central de Notificações| Mala direta)

1. Informar a consulta SQL responsável por listar os usuários, depois de informado os parâmetros (caso sejam necessários) e executada a consulta os registros são listados para visualização do usuário. Caso seja necessário remover algum registro basta selecionar o mesmo e clicar em remover.
2. Informar o conteúdo da mensagem a ser encaminhada via mala direta. Neste passo o usuário tem as seguintes opções:
   1. Importar um arquivo template para a mala direta
   2. Criar um novo arquivo 
   3. Editar um arquivo existente. 
   Após criar a mensagem o usuário poderá salvá-la em um arquivo para que possa ser utilizado futuramente no envio de outra mala direta (através dos recursos disponíveis na barra de formatação). No conteúdo da mensagem é possível utilizar tags bastando clicar no botão “Tags Disponíveis” e selecionar a que se quer utilizar. As tags disponíveis são as colunas retornadas pela consulta SQL selecionado pelo usuário.
3. Definir a forma de execução
   
   1. Enviar por e-mail
      
      • Informar assunto do e-mail;
      • Tipo de remetente:
        • Usuário logado no sistema;
        • Coligada atual; Coligada global;
        • Parâmetros globais (parametrização padrão de envio de mensagens que está definido na tela de parâmetros Globais na aba Envio E-mails);
        • Personalizado: o usuário poderá informar um e-mail e nome do remetente a ser identificado. Esta lista de e-mail(s) personalizado precisa ser informado em TOTVS Educacional | Configurações | Configuração |Parâmetros | Secretaria | Geral 4/4]
        • Identificador dos registros de log.
        Atenção: Para que seja possível enviar e-mails a consulta SQL utilizada precisa conter a coluna EMAIL.
        
        
   2. Gerar arquivos
      • Informar diretório físico onde serão gravados os arquivos criados;
      • Informar o prefixo para nome dos arquivos. Caso o usuário tenha carregado um arquivo de template no editor de texto, o nome do arquivo será carregado neste campo “prefixo para nome dos arquivos”, podendo o usuário alterar o seu conteúdo.
      • Informar em  “Salvar como” qual extensão para os arquivos. O usuário terá como opção às seguintes extensões: pdf, rtf, doc, docx e html.
      • Identificador dos registros de log.
        
        
4. Após clicar no botão “Executar” será exibida a tela padrão de andamento do processo e nesta teremos dois botões com funcionalidades diferentes:
   
   1. Botão “Cancelar”: Aborta o andamento do processo, mostrando o log até o momento do cancelamento.
   2. Botão “Fechar”: Ao clicar neste botão, o usuário será informado que a tela do processo será fechada e que sua execução continuará em segundo plano. Para que a tela seja fechada é solicitado ao usuário uma confirmação escolhendo a opção “Sim” a tela é fechada e a execução é realizada em segundo plano, ou a opção “Não” que continua o processamento normalmente com a tela aberta.
      Importante: Quando o processo estiver sendo executado em segundo plano, o usuário  receberá uma caixa de mensagem quando sua execução for finalizada.

Processo de Envio de Posts para Comunidades e Notificações para Usuários do Fluig (Acessar TOTVS Educacional | Atividades Acadêmicas| Central de Notificações| Envio de posts para comunidades e notificações para usuários do Fluig) 

Este processo só estará disponível se houver integração com o Fluig. A integração será entendida como ativa quando o parâmetro código de comunicação estiver preenchido nos parâmetros do TOTVS Educacional. Este processo disponibilizará as seguintes etapas: 

1.  Definições relacionadas ao mecanismo de geração das informações.

Processo de Envio de Mensagens de Notificações Temporais (Acessar TOTVS Educacional | Atividades Acadêmicas| Central de Notificações| Envio de mensagens de notificações temporais)

 Este processo será responsável por disparar as mensagens de notificações classificadas como temporais, para tanto o usuário deverá:

1. Definir o período letivo
2. Definir as notificações temporais que devem ser executadas
3. Definir o tipo de consulta:
   1. Consulta padrão do sistema
      1. Pode-se definir a curso, habilitação, matriz curricular ou matriz aplicada
      2. Pode-se definir a turma
   2. Consulta SQL
      1. Definir a consulta SQL. Deve possuir obrigatoriamente os campos CODCOLIGADA, RA, CODUSUARIO e EMAIL para todas as notificações temporais e para a notificação de pendência de matrícula ainda deverá conter os campos "IDHABILITACAOFILIAL", "CODCURSO", "NOMECURSO", "CODHABILITACAO" e "NOMEHABILITACAO".
      2. Preencher os parâmetros
4. Se a mensagem de notificação temporal estiver parametrizada para envio por e-mail todos destinatários que não possuírem um e-mail definido serão ignorados.
5. Se a mensagem de notificação temporal estiver parametrizada para notificação no Fluig: 
   1. Parâmetros Educacional: deve possuir a definição da conta de comunicação 
   2. Todos destinatários que não estiverem cadastrados no Fluig serão ignorados.
6. O log final do processo contendo o detalhamento das mensagens enviadas com sucesso e as que por algum motivo não puderam ser enviadas.

Documentação Adicional:

1. Para utilizar o envio de posts para comunidades deve-se parametrizar a acadêmia social, para mais informações sobre este item acesso o Documento Técnico: DT_Academia_Social

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf