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

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