Informações | ||
---|---|---|
| ||
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)
Sequencia Envio | Objeto (Arquivos) | Identificação | Descrição |
---|---|---|---|
1 | Course | Curso | Os dados para criação e gerenciamento de Turmas/disciplinas. |
2 | Person | Usuário | Registros para criação e gerenciamento de usuários do sistema (alunos, professores, tutores, etc). |
3 | Enrollments | Inscrições | Os dados para criação e gerenciamento de associações de disciplinas (Turmas) - Matrículas (Usuários). |
4 | FI_secundary | Perfil | Permite a associação do usuário para uma função institucional secundária. |
5 | Hierarchy_user_association | Associação de Pessoa | Os dados enviados serão para associação de usuário ao nó hierárquico. |
6 | Hierarchy_course_association | Associação de Curso | Os dados enviados serão para associação da turma ao nó hierárquico, quando houver uma mesma turma associada a mais de um nó. |
Regras de Negócios
Curso:
RN 01 - Busca os cursos que possuem os seguinte pré requisitos:
Turma com status em andamento e realizada;
Turma Turma com sala virtual habilitada;
Que Que ainda não tenha sido enviado para o blackborad 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ário usuários de acordo com a listagem dos cursos os dados retornados do método anteriorde curso.
Com base nesses cursos é retornado os usuário de acordo com os seguintes pré requisitos, sendo que para todos eles vale o requisito que usuários que ainda não tenham sido enviados para o blackborad 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 a listagem dos cursos os dados retornados do método anteriorde curso.
Com base nesses cursos é retornado as inscrições de acordo com os seguintes pré requisitos, sendo que para todos eles vale o requisito que ainda não tenham sido enviados enviadas para o blackborad 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.
Exportar arquivo com boletos:
- Acesse o Menu: Financeiro → Financeiro → Exportar Carteira Registrada
Esta tela permite a pesquisa dos boletos que ainda não foram exportados
Selecione os boletos a serem exportados no arquivo.
O botão Gerar Selecionados realiza apenas a exportação dos registros que foram selecionados.
O botão Gerar Todos ignora os registros selecionados e realiza a exportação de todos os registros que constam na pesquisa.
- Assim que pressionado um dos botões (Gerar Selecionados ou Gerar Todos) o sistema disponibiliza pada download o arquivo.
Visualizar remessas já geradas
- Clique no botão: Visualizar Remessas Geradas
Esta tela permite baixar novamente um arquivo texto gerado por qualquer outro usuário.
Informações |
---|
Observações
|
Artigos relacionados
Conteúdo por Rótulo | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
hidden | true |
---|
...
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:
Informações | ||
---|---|---|
| ||
EXTERNAL_PERSON_KEY|USER_ID|PASSWD|PWENCRYPTIONTYPE|FIRSTNAME|LASTNAME|EMAIL|INSTITUTION_ROLE|SYSTEM_ROLE|ROW_STATUS|DATA_SOURCE_KEY |
- 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:
Informações | ||
---|---|---|
| ||
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|START_DATE|END_DATE|ROW_STATUS|DATA_SOURCE_KEY|TEMPLATE_COURSE_KEY SC_EAD_FIC_20180495009_OC_PMF|SC_EAD_FIC_20180495009_OC_PMF|Princípios de Matemática Financeira|20180919|20181101|ENABLED|SC_TURMAS_2018|SC_EAD_FIC_MOD_OC_PMF |
- 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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 cursos
Para realizar a integração das associações de cursos perfis deve ser seguido o seguinte layout:
Informações | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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