Arquivos integrados (Cursos/Pessoas)

Regras de Negócios

• Curso:

  • Busca os cursos que possuem os seguinte pré requisitos:

    • Turma com status em andamento;

    • Turma com sala virtual habilitada; 

    • Que ainda não tenha sido enviado para o blackboard ou que já tenha enviado mas precise ser enviado novamente.

  • Para preencher a informação do EXTERNAL_COURSE_KEY é feita uma verificação:
    • Para as programações que não são corporativas e que não são de graduação: SiglaRegional_SiglaUnidade_SiglaModalidade_CodigoProgramacao_SiglaCurso
    • Para as programações que são de graduação: SiglaRegional_EAD_EDS_CodigoUnidadeCodigoProgramacao
    • Para as programações corporativas: SiglaRegional_SiglaUnidade_CORP_CodigoProgramacao_SiglaCurso
    • Para os cursos FIC - Aperfeiçoamento, caso a sigla do curso seja igual a sigla da unidade curricular, deverá informar somente a sigla do curso.
  • O campo ROW_STATUS caso a programação seja Prevista ou Andamento, deverá ser ENABLED, caso a situação da programação seja Cancelada, deverá ser DISABLED.

  • Esses cursos serão adicionados ao arquivo de integração e posteriormente registrados no log.

• Usuário:

  • Busca os usuários de acordo com os dados retornados do método de curso.
    Com base nesses cursos é retornado os usuários que ainda não tenham sido enviados para o blackboard ou que já tenham enviado mas precisem ser enviados novamente.
    Cada tipo de usuário possui suas próprias regras para serem retornados e seguem as seguintes regras:

    • Para os alunos são retornados todos os que estejam com status matriculado em alguma das turmas;

    • Para os instrutores/orientadores e monitores são retornados todos os que estejam vinculados em alguma das turmas.

  • Esses usuários serão adicionados ao arquivo de integração e posteriormente registrados no log.

  
  

• Inscrições:

  • Busca as inscrições de acordo com os dados retornados do método de curso. 
    Com base nesses cursos é retornado as inscrições que ainda não tenham sido enviadas para o blackboard ou que já tenham enviado mas precisem ser enviados novamente.
    Cada tipo de inscrição possui suas próprias regras para serem retornadas e seguem as seguintes regras:

    • Para os alunos são retornados todos os que estejam vinculados em alguma das turmas, com cadastro completo e status da matricula diferente de pré matriculado, cancelado e anulado;

    • Para os instrutores/orientadores são retornados todos os que estejam vinculados em alguma das turmas e que o perfil seja de instrutor, coordenador ou que não esteja preenchido;

    • Para os monitores são retornados todos os que estejam vinculados em alguma das turmas e que o perfil seja de monitor ou que não esteja preenchido.
  • Para preencher a informação do EXTERNAL_COURSE_KEY é feita uma verificação:
    • Para as programações que não são corporativas e que não são de graduação: SiglaRegional_SiglaUnidade_SiglaModalidade_CodigoProgramacao_SiglaCurso
    • Para as programações que são de graduação: SiglaRegional_EAD_EDS_CodigoUnidadeCodigoProgramacao
    • Para as programações corporativas: SiglaRegional_SiglaUnidade_CORP_CodigoProgramacao_SiglaCurso
    • Para os cursos FIC - Aperfeiçoamento, caso a sigla do curso seja igual a sigla da unidade curricular, deverá informar somente a sigla do curso.
  • Confirma se o aluno pode ou não ser desabilitado.
  • Valor padrão para o AVAILABLE_IND é Y.
  • Valor padrão para o ROW_STATUS é ENABLED.

  • Essas inscrições serão adicionadas ao arquivo de integração e posteriormente registradas no log.

• Perfil:

  • Busca os perfis de acordo com os dados retornados do método de inscrições.

  • Após percorrer as pessoas e seus respectivos perfis, é feita uma verificação se o perfil ainda não foi enviado ou que já tenha enviado mas precise ser enviado novamente.

  • Esses perfis serão adicionados ao arquivo de integração e posteriormente registrados no log.

• Associação de Pessoa:

  • Busca as associações de acordo com os dados retornados do método de usuário.

  • Após percorrer os usuários é feita uma verificação se a pessoa ainda não foi enviada para o blackboard.

  • Essas associações serão adicionadas ao arquivo de integração e posteriormente registrados no log.

• Associação de Curso:

  • Busca as associações de acordo com os dados retornados do método de curso.

  • Após percorrer os cursos é feita uma verificação se a turma ainda não foi enviada para o blackboard.

  • Para preencher a informação do EXTERNAL_COURSE_KEY é feita uma verificação:
    • Para as programações que não são corporativas e que não são de graduação: SiglaRegional_SiglaUnidade_SiglaModalidade_CodigoProgramacao_SiglaCurso
    • Para as programações que são de graduação: SiglaRegional_EAD_EDS_CodigoUnidadeCodigoProgramacao
    • Para as programações corporativas: SiglaRegional_SiglaUnidade_CORP_CodigoProgramacao_SiglaCurso
    • Para os cursos FIC - Aperfeiçoamento, caso a sigla do curso seja igual a sigla da unidade curricular, deverá informar somente a sigla do curso.

  • Essas associações serão adicionados ao arquivo de integração e posteriormente registrados no log.

Integrando o sistema com o BlackBoard

Para realizar a integração do sistema educacional para o AVA BlackBoard é utilizada uma URL "endpoint" e realizada uma comunicação REST para transmitir as informações.

End Point Produção SC: https://senac.blackboard.com/webapps/bb-data-integration-flatfile-BBLEARN/endpoint/

End Point Homologação SC: https://hom-senacsc.blackboard.com/webapps/bb-data-integration-flatfile-BBLEARN/endpoint/

Ao buscar a comunicação com os referidos end points, será necessário o fornecimento do usuário e senha do Regional para concluir a autenticação.

A integração dos cursos e alunos para o AVA BlackBoard segue a seguinte sequencia:

• Integração de usuários;
• Integração de cursos;
• Integração de alunos;
• Integração de perfis;
• Integração das associações de pessoas;
• Integração das associações de cursos.

Integrando usuários

Para realizar as integrações dos usuários deve ser seguido o seguinte layout:

• EXTERNAL_PERSON_KEY: BRA + CPF do aluno
• USER_ID: BRA + CPF do aluno
• PASSWD: MD5 (senac)
• PWENCRYPTIONTYPE: MD5
• FIRSTNAME: Primeiro nome do aluno
• LASTNAME: Sobrenome do aluno
• EMAIL: E-mail do aluno
• INSTITUTION_ROLE: senac_nacional
• SYSTEM_ROLE: none
• ROW_STATUS: enabled / disabled
• DATA_SOURCE_KEY: SENAC_USUARIOS

Integrando cursos

Para realizar a integração das turmas do sistema educacional deve ser seguido o seguinte layout:

Integrando alunos

...

Integrando perfis

...

Integrando associações de pessoas

...

Integrando associações de cursos

...