Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Informações
titleImportante

A integração realizada para o ambiente de aprendizagem virtual BlackBoard trata apenas de turmas FIC, atendendo ao Regional SEDE FIC EAD (Santa Catarina).

Arquivos integrados (Cursos/Pessoas)

...

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

...

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.

...

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

Informações
titleExemplos:

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY|ROLE|AVAILABLE_IND|ROW_STATUS|DATA_SOURCE_KEY

SC_EAD_FIC_20180495009_OC_PMF|BRA08475430996|S|Y|ENABLED|SC_MATRICULAS

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

Informações
titleExemplo:

EXTERNAL_PERSON_KEY|ROLE_ID|ROW_STATUS|DATA_SOURCE_KEY

BRA04556988489|sc_senac|ENABLED|SC_PERFIL

BRA04556988489|sc_aluno|ENABLED|SC_PERFIL

BRA04556988489|sc_aluno_fic|ENABLED|SC_PERFIL

BRA04556988489|sc_aluno_fic_aperfeicoamento|ENABLED|SC_PERFIL

  • 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

...

...

Integrando associações de cursos

...

cursos

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

Informações
titleExemplo:

EXTERNAL_ASSOCIATION_KEY|EXTERNAL_COURSE_KEY|EXTERNAL_NODE_KEY|DATA_SOURCE_KEY

SC_20181085003_106111|SC_JOI_FIC_20181085003_AAEAD|CAP|SC_HIERARQUIA_TURMAS

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

Informações
titleExemplo:

EXTERNAL_ASSOCIATION_KEY|EXTERNAL_USER_KEY|EXTERNAL_NODE_KEY|DATA_SOURCE_KEY

SENAC_SC_BRA04556988489|BRA04556988489|senacsc|SC_HIERARQUIA_USUARIOS

  • 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