Histórico da Página

Arquivos integrados (Cursos/Pessoas)

Regras de Negócios

• Curso:

  • RN 01 - Busca os cursos que possuem os seguinte pré requisitos:

    • Turma com status em andamento e realizada;

    • 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.

  • RN 02 - 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.
  • RN 03 - 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.

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

• Usuário:

  • RN 01 - 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.

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

  
  

• Inscrições "Alunos":

  • RN 01 - 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.
  • RN 02 - 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.
  • RN 03 - Confirma se o aluno pode ou não ser desabilitado.
  • RN 04 - Valor padrão para o AVAILABLE_IND é Y.
  • RN 05 - Valor padrão para o ROW_STATUS é ENABLED.

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

• Perfil:

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

  • RN 02 - 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.

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

• Associação de Pessoa:

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

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

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

• Associação de Curso:

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

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

  • RN 03 - 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.

  • RN 04 - 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

...

Integrando cursos

...

Integrando alunos

...

Integrando perfis

...

Integrando associações de pessoas

...

Integrando associações de cursos

...

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:

• EXTERNAL_COURSE_KEY: código do curso no AVA formado de acordo com  a regra RN 02 de cursos.
  
• COURSE_ID: código do curso no AVA formado de acordo com  a regra RN 02 de cursos.
• COURSE_NAME: descrição da turma.
• START_DATE: data de início da turma
• END_DATE: data de término da turma
• ROW_STATUS: código do curso no AVA formado de acordo com  a regra RN 03 de cursos.
• DATA_SOURCE_KEY: SC_TURMAS_ + ano de início da turma
• TEMPLATE_COURSE_KEY: SC_EAD_FIC_MOD_ + sigla do curso + sigla da unidade curricular

Integrando alunos

Para realizar a integração dos alunos deve ser seguido o seguinte layout:

• EXTERNAL_COURSE_KEY: código do curso no AVA formado de acordo com  a regra RN 02 de cursos.
• EXTERNAL_PERSON_KEY: BRA + CPF do aluno
  
• ROLE: caso estudante (S), caso tutor (SC_TUTOR), caso coordenador (SC_COORDENADOR) e caso monitor (SC_MONITOR).
  
• AVAILABLE_IND: valor default "Y", porém se o aluno não deve mais ter acesso ao curso o valor deve ser enviado como "N".
  
• ROW_STATUS: valor default "ENABLED", porém se o aluno não deve mais ter acesso ao AVA enviar como "DISABLED".
  
• DATA_SOURCE_KEY: SC_MATRICULAS

Integrando perfis

Para realizar a integração dos perfis deve ser seguido o seguinte layout:

• EXTERNAL_PERSON_KEY: BRA + CPF do aluno
  
• ROLE_ID:
  
  • Caso aluno: devem ser enviados os perfis (sc_senac + sc_aluno + sc_aluno_fic + sc_aluno_fic_aperfeicoamento).
  • Caso tutor: devem ser enviados os perfis (sc_senac + sc_tutor_fic_programas_instrumentais ou sc_aluno_fic_aperfeicoamento ou sc_aluno_fic_capacitacao).
• ROW_STATUS: valor default "ENABLED", caso deseje desativar determinado perfil enviar como "DISABLED".
  
• DATA_SOURCE_KEY: SC_PERFIL

Integrando associações de cursos

Para realizar a integração das associações de cursos perfis deve ser seguido o seguinte layout:

• EXTERNAL_ASSOCIATION_KEY: SC + Código da Turma + Código da unidade curricular.
  
• EXTERNAL_COURSE_KEY: código do curso no AVA formado de acordo com  a regra RN 02 de cursos.
  
• EXTERNAL_NODE_KEY: se turma corporativa (CORP), se formação inicial e continuada (FIC).
  
• DATA_SOURCE_KEY: SC_HIERARQUIA_TURMAS

Integrando associações de pessoas

Para realizar a integração das associações de pessoas perfis deve ser seguido o seguinte layout:

• EXTERNAL_ASSOCIATION_KEY: SC + Código da Turma + Código da unidade curricular.
  
• EXTERNAL_USER_KEY: BRA + CPF do aluno
  
• EXTERNAL_NODE_KEY: se turma corporativa (CORP), se formação inicial e continuada (FIC).
  
• DATA_SOURCE_KEY: SC_HIERARQUIA_USUARIOS