Perguntas Frequentes (FAQ) sobre a Integração TOTVS RM x Blackboard

Esta seção foi criada para responder às perguntas mais comuns sobre a Integração TOTVS RM x Blackboard by Worknow, ajudando você a entender melhor seu funcionamento e a solucionar dúvidas rápidas.

1. Sobre a Integração

O que é a Integração TOTVS RM x Blackboard?

É uma ferramenta que automatiza a troca de informações entre o sistema de gestão educacional TOTVS RM e a plataforma de aprendizado Blackboard Learn. Ela garante que dados como usuários, cursos, matrículas e notas estejam sempre sincronizados entre os dois ambientes.

Quais dados são sincronizados entre o TOTVS RM e o Blackboard?

A integração pode sincronizar: usuários (alunos e professores) e suas informações de perfil, criação e atualização de cursos e turmas, matrículas e desvinculação de alunos e professores nos cursos, estruturas de hierarquia e grupos, e notas de avaliações do Blackboard para o TOTVS RM.

A sincronização é bidirecional?

Principalmente, a integração é do TOTVS RM para o Blackboard. No entanto, a sincronização de notas pode ser configurada para ser bidirecional, ou seja, notas lançadas no Blackboard podem ser enviadas de volta para o TOTVS RM, dependendo da sua configuração.

2. Configuração e Conexão

Como obtenho a ‘Application Key’ e o ‘Secret’ para a configuração Geral?

Essas chaves são credenciais de segurança fornecidas pela sua instância do Blackboard. Geralmente, elas são geradas ou acessadas na área de administração do Blackboard, sob as configurações de integrações ou APIs. É recomendável que um administrador do Blackboard na sua instituição forneça essas informações.

Preciso de conhecimentos técnicos para configurar a integração?

A documentação visa ser amigável ao usuário, mas algumas configurações, especialmente as de “Fórmula visual” ou mapeamento de campos específicos, podem exigir um entendimento básico da estrutura de dados do TOTVS RM e do Blackboard. Em caso de dúvidas, consulte sua equipe de TI ou o suporte técnico.

Como testar se a conexão com o Blackboard está funcionando?

Na aba “Geral” > “Detalhes”, após inserir a URL, Application Key e Secret, você encontrará um botão “Testar Conexão”. Clique nele para verificar se a integração consegue se comunicar com o Blackboard.

3. Usuários (Alunos e Professores)

Como os alunos/professores são criados no Blackboard?

Na aba “Alunos” ou “Professores” > “Criação de Alunos/Parâmetros de Criação”, você define quais campos do TOTVS RM serão usados para gerar o identificador de usuário, e-mail e senha no Blackboard. A integração utiliza esses dados para criar ou atualizar os usuários automaticamente.

É possível personalizar a senha dos usuários?

Sim. Na seção de criação de usuários (Alunos ou Professores), você pode escolher a origem da senha (como as duas primeiras letras do nome + data de nascimento) ou definir uma “Senha fixa para todos”.

A integração envia e-mails de boas-vindas?

Sim. Na sub-aba “E-mail de Alunos” ou “E-mail de Professores”, você pode habilitar o envio de e-mails, personalizar o assunto e o corpo da mensagem, e usar “Tags disponíveis” para inserir informações dinâmicas (como login e senha).

O que acontece se um aluno/professor já existir no Blackboard?

A integração tentará primeiro encontrar o usuário existente com base no identificador configurado. Se encontrado, ela atualizará as informações do perfil. Se não encontrado, um novo usuário será criado. Isso evita duplicações.

4. Cursos, Hierarquia e Grupos

Como a integração cria os cursos no Blackboard?

A criação e configuração dos cursos são baseadas nos parâmetros definidos na aba “Cursos”. Você pode configurar o agrupamento (ex: Turma/Disciplina), a duração, as opções de template (funcionalidades do curso), e as regras de inscrição.

Para que servem as configurações de “Hierarquia”?

A aba “Hierarquia” permite que você replique a estrutura organizacional e acadêmica do seu TOTVS RM (como Coligadas, Filiais, Níveis de Ensino, Cursos) dentro do Blackboard, proporcionando uma navegação e organização mais consistentes para os usuários.

Os grupos são criados automaticamente?

Sim, na aba “Grupos”, você pode configurar o tipo de integração e o agrupamento para que os grupos sejam criados e gerenciados automaticamente com base nos dados do TOTVS RM, como Turma/Disciplina e Subturma.

5. Notas e Avaliações

Como as notas são sincronizadas do Blackboard para o TOTVS RM?

Na aba “Notas”, você configura o modo de integração e agregação das notas. A integração mapeia as avaliações do Blackboard para o TOTVS RM, permitindo que as pontuações e resultados sejam transferidos e registrados no sistema de gestão acadêmica.

Posso definir como as notas são agregadas?

Sim. Na aba “Notas”, o campo “Tipo de agregação de notas” permite que você escolha como as pontuações de diferentes tarefas ou etapas devem ser combinadas ao serem enviadas para o TOTVS RM (ex: Soma das notas).

6. Solução de Problemas

Onde posso verificar os logs da integração?

A integração gera logs de suas operações. O tempo de retenção desses logs pode ser configurado na aba “Geral” > “Detalhes”, no campo “Dias de Log”. Para acessar os logs detalhados, geralmente é necessário verificar os arquivos de log da aplicação no servidor onde a integração está hospedada, ou através de ferramentas de monitoramento configuradas.

Um usuário/curso não foi criado ou atualizado. O que devo fazer?

Verifique as configurações relevantes para aquela entidade (Alunos, Professores, Cursos). Confirme se as condições de criação ou atualização estão sendo atendidas no TOTVS RM. Consulte os logs da integração para identificar possíveis erros ou avisos relacionados ao processamento daquele item específico.

Quem devo contatar se precisar de suporte técnico avançado?

Para dúvidas ou problemas que não puderem ser resolvidos com esta documentação, entre em contato com a equipe de suporte técnico da Worknow ou com o administrador de sistemas da sua instituição responsável pela integração.