Academia Social

Características do Requisito

Descrição

A utilização de comunidades sociais no contexto acadêmico já é uma realidade nas instituições de ensino e a TOTVS já disponibiliza através do Fluig todos os recursos necessários para implantação deste conceito. A partir da versão 12.1.7 com a implementação da integração entre TOTVS Educacional e Fluig a criação de comunidades e manutenção de seus participantes ficou muito mais ágil e simples para nossos clientes.

Neste documento será dividido em três grandes blocos: configuração do ambiente, parametrizações e o funcionamento das funcionalidades, cada um destes blocos aborda o passo a passo.

Configuração do ambiente

No Fluig:

1. Com o usuário administrador do Fluig 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 http://tdn.totvs.com/display/public/fluig/Fluig+API#FluigAPI-CadastraraplicativonoFluig

No TOTVS Educacional

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.
2. Acessar a guia Gestão -> Fontes e certificar que 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: informação definida no cadastro de Fontes
   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

Parametrizações

O TOTVS Educacional passa a disponibilizar a integração com o Fluig - Social, possibilitando que as comunidades possam ser criadas para as seguintes entidades:

• Curso
• Habilitação ou Serie
• Turma
• Turma/disciplina
• Subturma
• Atividade ofertada

Para tanto basta que o cliente faça as parametrizações necessárias no Parametrizador do Educacional, abaixo uma descrição a respeito dos parâmetros disponibilizados:

A parametrização da integração com o Fluig (Academia Social) possui os seguintes itens:

Aba: Geral

• Definir o código da conta de comunicação com o Fluig.
• Filtrar apenas as informações de períodos letivos em aberto.
  Este parâmetro determina se as informações vinculadas a períodos letivos encerrados devem ou não ser consideradas nos processos da academia social.

Aba: Curso, habilitação (Serie), turma, turma/disciplina, subturma e atividade ofertada

Os parâmetros abaixo estão disponíveis para todas as entidades que podem ser integradas as comunidades do Fluig:

Geral:

• Integrar com o Fluig <nome entidade>
  Define se a entidade em questão estará ou não integrada com as comunidades do Fluig

Comunidade:

• Comunidade deve ser privada
• Participação na comunidade deve ser aprovada
• Após exclusão <nome entidade> a comunidade continua ativa
  Exemplo: A turma “FISIO-0001” é cadastrada e a comunidade “C_FISIO-0001” é gerada, se a turma “FISIO-0001” for eliminada da base de dados a comunidade vinculada “C_FISIO-0001” deverá continuar ativa ou será desativada.

• Usuário administrador (este é o usuário que tem total permissão na comunidade que será gerada)
  • Definir administrador da comunidade no processo
    Neste caso a definição do código do usuário que desempenhará o papel de administrador da comunidade deverá ser realizado nos processos que criarão as comunidades no Fluig.
  • Utilizar como administrador da comunidade o usuário definido nos parâmetros globais
  • Usuário administrador das comunidades relacionadas <nome entidade>
    A definição do código do usuário que desempenhará o papel de administrador da comunidade deverá ser realizada no próprio parametrizador do TOTVS Educacional.

 Participação na comunidade:

• Data da última sincronização dos participantes realizada pelo processo

Aba: Curso, habilitação (Serie)

Os parâmetros abaixo estão disponíveis para as entidades de curso e habilitação:

•  Coordenadores 
  
  • Sincronizar coordenador vinculado <nome entidade>
    • Como moderador da comunidade
    • Como participante da comunidade
  • Nenhuma ação definida (neste caso os coordenadores não serão sincronizados com as comunidades vinculadas a entidade)
  • Coordenador excluído <nome entidade> continua ativo na comunidade
    Se um coordenador é excluído da comissão coordenadora da matriz aplicada este parâmetro define se este também deve ser excluído das comunidades. O usuário relacionado ao coordenador de um curso pode estar vinculado a uma comunidade também por ser um professor do curso, neste cenário a exclusão do coordenador não acarretará a sua exclusão na comunidade.
  • Coordenador com data final de participação na comissão ultrapassada continua ativo na comunidade
    A exclusão do usuário vinculado ao coordenador das comunidades segue a mesma regra do item acima.

• Professores:
  • Professor com data final de participação nas turmas ultrapassada continua ativo na comunidade

Aba: Turma, Turma/Disciplina e Subturma

Os parâmetros abaixo estão disponíveis para as entidades turma, turma/disciplina e subturma:

Geral:

• Período letivo encerrado comunidades continuarão ativas
  Este parâmetro define se as comunidades vinculadas a turma, turma/disciplina e/ou subturmas continuam ativas mesmo após o encerramento de um período letivo.  Se este parâmetro estiver definido para desativar as comunidades o encerramento de período letivo ocasionará a desativação de todas as comunidades vinculadas ao período letivo. Caso o período letivo seja reaberto as comunidades vinculadas não serão ativadas, o usuário deverá executar o processo de ativação de comunidade.

Comunidade:

• A entidade turma/disciplina possui o seguinte parâmetro adicional.
  • Turma/disciplina gerenciais e gerenciadas:
    • Criar comunidade para turma/disciplina gerencial
    • Criar comunidade para turma/disciplina gerenciada
      As opções não são excludentes, ou seja, pode-se criar comunidades para turma/disciplinas gerencial e gerenciada desde que os dois parâmetros acima estejam marcados.

• A entidade turma/disciplina e subturma possuem o seguinte parâmetro adicional.
  • Após turma/disciplina inativada comunidade continuará ativa
    Se este parâmetro estiver desmarcado ao colocar uma turma/disciplina como inativa as comunidades relacionadas a turma/disciplina e subturmas serão desativadas, no entanto, a ativação da turma/disciplina não ativará as comunidades.

Participação na comunidade:

• Coordenadores:
  • Sincronizar coordenador vinculado <nome entidade>
    • Como moderador da comunidade
    • Como participante da comunidade
    • Nenhuma ação definida (neste caso os coordenadores não serão sincronizados com as comunidades vinculadas a entidade)
  • Coordenador excluído da matriz aplicada da <nome entidade> continua ativo na comunidade
  • Coordenador com data final de participação na comissão ultrapassada continua ativo na comunidade

• Alunos:
  • Aluno excluído da <nome entidade> continua ativo na comunidade

• Professores:
  • Sincronizar professor vinculado à <nome entidade>:
    • Como moderadores da comunidade
    • Como participantes da comunidade
    • Nenhuma ação definida (neste caso os professores não serão sincronizados com as comunidades vinculadas a entidade)
  • Professor excluído da <nome entidade> continua ativo na comunidade
  • Professor com data final de participação na <nome entidade> ultrapassada continua ativo na comunidade

Atividade Ofertada

Os parâmetros abaixo devem ser criados para atividade ofertada:

Participação na comunidade:

• Inscrito:
  • Sincronizar inscrito na atividade ofertada:
    • Como participante da comunidade
    • Nenhuma ação definida (neste caso os inscritos não serão sincronizados com as comunidades vinculadas a atividade ofertada)
    • Inscrito excluído da atividade ofertada continua ativo na comunidade

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.

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

Return aCab