Skip to main content

Planejamento de integração do SIA

Vantagens

As principais vantagens de usar as integrações do Sistema de Informações do Aluno (SIA) Blackboard para transmitir dados para preencher e atualizar automaticamente seu sistema incluem o seguinte:

  • O gerenciamento de dados do curso e do usuário pode ser delegado a um ou mais administradores que não precisam de acesso de linha de comando aos Blackboard servidores.

  • Os dados podem ser transferidos rápida e eficientemente de um Sistema de Gerenciamento de Aprendizagem (LMS) para outro.

Antes de começar

Antes de criar uma ou mais integrações do Sistema de informações do aluno (SIA), é extremamente importante envolver todas as partes interessadas para planejar quais dados de quais fontes e em que formato serão usados Blackboard para preencher o sistema. Como a comunicação é unidirecional do Sistema de informações do aluno (SIA) para Blackboard, todos os dados de cada curso, usuário e função de usuário devem ser definidos e descritos Blackboard. Além disso, todos os usuários devem ter credenciais que os identifiquem exclusivamente Blackboard.

A coleta de dados do curso, usuário e matrícula é um processo recorrente. À medida que as pessoas entram e saem da instituição, os cursos são criados e as matrículas mudam, então os dados Blackboard dentro deles precisam mudar. A frequência com que os dados devem ser coletados e carregados é determinada pela política da instituição. As fontes de dados que fornecem informações ao sistema devem configurar procedimentos repetíveis para a entrega de dados aos Blackboard administradores.

Sua instituição já pode ter um processo robusto, de acordo com as regras de negócios estabelecidas. Nesse caso, um planejamento extenso pode não ser necessário, mas você precisará entender as Blackboard necessidades de requisitos de informações, bem como a ordem e a frequência das tarefas que precisam ser concluídas. Se a instituição está somente começando a executar ou alterar os processos automatizados, um planejamento mais detalhado será necessário para que você tenha as regras de negócios e as informações disponíveis antes de começar.

Informações necessárias para usuários, cursos e matrículas

Você precisará Blackboard fornecer as seguintes informações para usuários, cursos e matrículas para criar uma integração. Identificar de onde vem cada dado é a primeira parte do planejamento.

Objeto

Elemento

Usuários (Pessoas)

Identificador exclusivo da pessoa

Identificador de acesso

Senha (para acessar Blackboard)

Primeiro nome

Sobrenome

Apelido (opcional)

Endereço de e-mail

Endereço de e-mail da instituição

Função institucional

Curso

Identificador exclusivo do curso

Identificador do curso

Nome do curso

Fonte do conteúdo do curso (opcional)

Matrículas

Conjunto de usuários associado para o Curso

Função do usuário no curso

Decida sobre o método de autenticação

Coletar um identificador de acesso e uma senha para cada usuário. Você pode usar o sistema de autenticação Blackboard nativo da sua instituição.

  • Se você usar o sistema de autenticação Blackboard nativo do, o identificador de acesso e uma senha estarão entre os dados do usuário coletados. O identificador de acesso e a senha precisarão ser distribuídos para cada usuário.

  • Se o identificador de acesso e a senha vierem do sistema de autenticação institucional, colete o identificador de acesso e gere uma senha aleatória para cada usuário. O usuário então se autenticaria no sistema de autenticação institucional.

Definir fontes de dados

Embora seja possível coletar todas as suas informações de dados internamente de um LMS como o Vista, é muito melhor usar os dados institucionais oficiais que a instituição coleta e mantém. Esses dados institucionais provavelmente serão provenientes de diferentes fontes de dados. Quais são essas fontes de dados e quais dados você pode coletar delas já pode estar estabelecido em sua instituição ou ainda pode ser decidido. Em qualquer caso, você precisará ter fontes de dados acordadas e um método de extração de dados para criar uma integração.

Cada instituição é configurada de forma diferente, mas existem alguns lugares comuns para você encontrar as informações necessárias.

  • Sistema de Informações do Aluno (SIA): Repositório de informações do aluno, como nome, endereço, informações de contato, ano letivo ou datas de formatura.

  • O Escritório do Registrador: Informações do catálogo de cursos, bem como nomes de cursos, descrição e informações de seção, também informações de matrícula.

  • Departamento de Recursos Humanos ou Sistema de Gestão de Recursos Humanos (HRMS): informações que descrevem cada pessoa em sua instituição, incluindo professores, funcionários, adjuntos e assistentes de ensino (TAs).

  • Serviço de diretório escolar (páginas brancas): procure números de telefones de funcionários e departamentos, endereços de e-mail e endereços de escritórios. Esse diretório pode ser uma fonte de informações para o LMS.

  • Departamento de TI ou Serviços de Informática: Define métodos para autenticar usuários, como um serviço LDAP. Pode gerar endereços de e-mail e credenciais de acesso.

Resolva dados conflitantes

Quando os dados são coletados de várias fontes de dados, podem ocorrer elementos de dados conflitantes. É necessário estabelecer uma política para resolver os conflitos, para que o sistema saiba qual fonte usar. Por exemplo, o HRMS pode solicitar ao usuário um endereço de e-mail. A Secretaria também pode solicitar um endereço de e-mail. Os endereços de e-mail conflitantes podem ocorrer quando um usuário tem duas funções diferentes na instituição, como aluno e assistente de ensino ou pessoal e docente adjunto. Nesse caso, quando dois endereços de e-mails institucionais são diferentes, é necessário decidir qual fonte tem precedência e qual será usado como e-mail institucional do usuário.

Outro exemplo de elementos de dados conflitantes é quando o Escritório da secretaria e o SIA possuem endereços de e-mail diferentes para os alunos. O serviço de diretório da instituição também pode manter um endereço de e-mail para cada usuário. Uma maneira de resolver esse conflito é escolher uma fonte em vez de outra. Outra solução é permitir que o usuário defina seu endereço de e-mail no Blackboard.

Para criar integrações bem-sucedidas, os locais em que os elementos de dados conflitantes podem ocorrer precisam ser identificados e resolvidos.

O que significa E-mail da Instituição e o que ele suporta?

O campo E-mail da Instituição permite mapeamentos de campo personalizados entre o serviço suportado externamente de um cliente e Blackboard. No caso de um provedor de dados que também é um provedor de nuvem, como a Microsoft, o User Principal Name (UPN) é um identificador exclusivo primário para cada usuário que consiste em um prefixo de UPN (o nome da conta do usuário) e um sufixo do UPN (um nome de domínio DNS) unidos por um símbolo de @. Isto cria um endereço de e-mail exclusivo para cada usuário específico dentro do diretório de serviço de dados.

Para garantir que os dados sejam precisos e que as matrículas ou associações entre Blackboard e o provedor de serviços de dados sejam alcançadas corretamente, o endereço de e-mail de um usuário deve corresponder entre os dois sistemas. Em Blackboard, um usuário pode alterar ou substituir seu endereço de e-mail pessoal existente na interface do usuário, o que pode resultar na ocorrência de erros de sincronização e na adição incorreta do usuário. O mapeamento do campo E-mail da Instituição garante que esse nível de segurança e verificação de validação possa ser gerenciado corretamente, independentemente de o usuário ter alterado seu E-mail da Pessoa dentro Blackboard ou não.

Ordem de carregamento dos dados

Todas as informações de que o sistema precisa para criar usuários, cursos e matrículas são necessárias, mas como os dados podem vir de fontes diferentes, eles precisam ser carregados Blackboard em uma ordem específica. As informações do curso e do usuário precisam ser carregadas primeiro porque as matrículas dependem dessas informações. A ordem de carregamento de dados é:

  1. Usuários

  2. Cursos

  3. Matrículas

As informações específicas para a criação de usuários, cursos e matrículas estão descritas nas seções abaixo.

Criar usuários

  • EXTERNAL_PERSON_KEY. Esse elemento é usado para identificar o usuário dentro da base de dados. Embora nunca exibida, essa chave não deve conter nenhum dado que possa identificar as pessoas, como nomes, números de registro ou datas de nascimento. A razão para isso é que os dados pessoais mudam. As pessoas se casam, se divorciam, alteram os nomes ou os números de registro. Ao não incluir dados que possam identificar as pessoas, você evita problemas com mudanças. Essa chave pode ter até 64 caracteres. Por causa do risco de exposição acidental de dados de um aluno a outro aluno, essa chave nunca deverá ser reutilizada. Uma vez emitida para um aluno, não deverá ser emitida de novo. A reemissão de EXTERNAL_PERSON_KEY corre o risco de tornar as informações de um usuário visível para outro usuário. Portanto, Blackboard recomenda que essa chave faça parte de um espaço de chave muito grande. Uma boa maneira de construir essa chave, se você ainda não tiver um identificador adequado, é gerar um número hexadecimal aleatório de 16 a 20 dígitos por aluno. A grande variabilidade e distribuição aleatória permitem que a base de dados crie um índice equilibrado.

  • USER_ID. O USER_ID também é conhecido como um código de rede, um nome de usuário ou nome de acesso. Esse elemento, em conjunto com uma senha, é usado para autenticar um usuário no LMS. Se um sistema de autenticação centralizado não existir, Blackboard pode ser usado como sistema de autenticação. Nesse caso, o Blackboard administrador precisa criar USER_IDs e senhas para cada usuário. Se estiver usando um sistema de autenticação centralizado com um protocolo compatível com o Blackboard, recomendamos autenticar Blackboard os usuários com esse sistema. Nesse caso, uma lista de USER_IDs vinculados aos EXTERNAL_PERSON_KEYs deve ser montada para carregar Blackboard. Isso também servirá como autorização para Blackboard.

  • FIRSTNAME, LASTNAME, NICKNAME. Esses elementos determinam como a identidade do Aluno é exibida Blackboard. Se possível, peça à fonte dos dados de nome que divida os nomes em seus componentes antes de serem entregues Blackboard. Esse nome provavelmente será o nome oficial usado pela instituição para registros oficiais, como históricos escolares, formulários de imposto de renda ou carteiras de identidade. Nem todas as pessoas são chamadas por seu primeiro nome oficial, algumas insistem em um apelido. Blackboard fornece a capacidade de (opcionalmente) especificar um apelido com o elemento de dados NICKNAME. Configure o LMS para exibir o conteúdo de NICKNAME em vez do de FIRSTNAME. Como prática recomendada, formalize e centralize a coleta e armazenamento de apelidos.

  • E-MAIL. O endereço de e-mail é necessário para a comunicação com o usuário.

    • Blackboard suporta dois endereços de e-mail por pessoa (E-mail da pessoa e E-mail da instituição). Se o usuário tiver vários endereços de e-mail devido à coleta de dados de várias fontes de dados, a instituição deve:

      • Escolha um sistema de registro como e-mail principal, ou

      • Use o campo E-mail da instituição para definir um endereço de e-mail oficial para a conta do usuário, permitindo que o usuário defina seu próprio endereço de e-mail Blackboard sem que ocorram conflitos.

    • Situações de e-mails diversos também podem ocorrer quando um usuário tem mais de uma função dentro da instituição, por exemplo, aluno e assistente de ensino ou membro da equipe e instrutor adjunto. Você deve escolher apenas um e-mail para esse usuário.

    • Alguns instrutores podem querer um endereço de e-mail para usar dentro Blackboard que não seja seu endereço de e-mail oficial, e alguns Alunos podem querer separar o endereço de e-mail de trabalho do curso do endereço de e-mail social. Para que isso seja possível, o usuário deve poder atualizar seu endereço de e-mail emBlackboard. (A instituição pode decidir se os alunos podem atualizar seu endereço de e-mail.) Depois que um usuário alterar seu endereço de e-mail, você não poderá atualizá-lo novamente a partir da fonte oficial. Torna-se responsabilidade do usuário manter seu endereço de e-mail dentro do Blackboard atual. O perigo é de que o usuário se esqueça de atualizar seu registro oficial e a comunicação por e-mail não chegue ao endereço correto.

  • INST_EMAIL: agora disponível para todos os tipos de integração SIA existentes, com exceção do SIF, o e-mail da instituição é um identificador exclusivo primário para cada usuário que consiste em um prefixo UPN (nome da conta do usuário) e um sufixo UPN (um nome de domínio DNS) unidos por um símbolo de @. Isso cria um endereço de e-mail exclusivo para cada usuário específico dentro de um diretório de serviço de dados, permitindo que as instituições gerenciem o processo de sincronização de dados de forma eficaz entre o Blackboard e o serviço. Ele é definido por padrão para o E-mail da pessoa em todos os formatos SIA e exige que seja exclusivo para cada pessoa. Todas as integrações existentes, já configuradas e funcionando, vão ter este mapeamento de dados em vigor, já que ocorrerá uma falha no SIA para importar usuários se os respectivos e-mail forem duplicados. Você pode gerenciá-lo nas Definições de configuração avançada do Sistema de informações do aluno (SIA), depois Tipo de objeto do aprendizagem dos usuários e Mapeamento de campo.

    Importante

    Nenhuma comunicação por e-mail é enviada ao inst_email. É usado estritamente com integrações de terceiros neste momento.

    Este campo de usuário não pode ser definido por meio de um arquivo em lote na seção Usuários -> Criar do painel do administrador.

  • INSTITUTION_ROLE. Esse elemento tem uma função de usuário na instituição. Não se trata da função no curso, mas sim uma forma de identificar a função de um usuário na instituição. A INSTITUTION_ROLE determina no que o usuário pode visualizar Blackboard. Essa função também é usada para especificar quais usuários terão privilégios elevados dentro do aplicativo. Se não houver o desejo de apresentar visualizações de página de portal diferentes aos usuários com base em suas funções na instituição, o elemento de dados INSTITUTION_ROLE pode ser definido como "nenhum".

  • SYSTEM_ROLE. Este elemento mantém a função de um usuário Blackboard. Esta função concede a capacidade de gerenciar aspectos de Blackboard. Os aspectos incluem a administração do sistema, a criação de cursos e o gerenciamento do conteúdo do curso. A função de "NONE" não oferece privilégios de administração de sistema ou criação de cursos e é a função mais comum.

Criar cursos

  • EXTERNAL_COURSE_KEY. Esse elemento identifica de forma exclusiva o curso. Não é visto por qualquer Blackboard usuário. Como prática recomendada, formate esses elementos de dados para torná-los convenientes para organização e manipulação. Você precisará coletar vários elementos de dados que descrevam um curso de forma exclusiva ao longo de vários anos (o período de retenção de dados). Geralmente, a secretaria mantém um número que identifica de forma exclusiva o curso pelo menos dentro de um determinado semestre. Por exemplo, se você tiver um curso de química 301 para o primeiro semestre de 2012 com o número de curso exclusivo 12345, você pode escolher 2012_fall_12345_CH_301 como o valor de EXTERNAL_COURSE_KEY. Uma melhoria adicional é tornar todos os elementos do EXTERNAL_COURSE_KEY do mesmo comprimento, se possível, especialmente o departamento e as datas. Um semestre pode ser representado por um dígito de mês, 1, 6, 9. Alguns Building blocks de terceiros exigem que os campos tenham o mesmo comprimento. Isso é especialmente verdadeiro para as informações de datas. O exemplo anterior separou os elementos de dados individuais com um separador de dados consistente: o sublinhado "_".

  • COURSE_ID. Esse elemento é usado para módulos de portal ao organizar os cursos. Após a criação do curso, esse elemento não poderá ser alterado. Essa chave fica visível para usuários e deve conter informações de fácil entendimento para o usuário. Em geral, essa chave deve conter o ano e semestre para fins de organização. Também deve conter o departamento e os números do curso, além de um identificador exclusivo. Por exemplo, um COURSE_ID pode ser 2010_9_12345_CHEM_301. Use um separador de dados consistente. Recomenda-se o sublinhado. Por padrão, o módulo do portal "Meus cursos" organiza os cursos pelo COURSE_ID. Isso é importante para quando a lista de cursos ficar extensa.

  • COURSE_NAME. Esse elemento pode ser qualquer item que descreva o curso. Não precisa ser exclusivo e pode ser alterado durante o carregamento de dados ou pelo instrutor. Alguns Building Blocks se organizam pelo COURSE_NAME.

  • TEMPLATE_COURSE_KEY. O elemento opcional TEMPLATE_COURSE_KEY apresenta o nome de um curso existente que foi preparado com conteúdo. Algumas organizações precisam oferecer cursos com conteúdo padronizado, o que é possível com o TEMPLATE_COURSE_KEY. Esse conteúdo pode incluir arquivos, pesquisas de opinião, questionários, avisos e até instrutores. O modelo de curso deve estar completo antes de criar os cursos. O conteúdo é copiado para um novo curso no momento da criação. Alterar o modelo do curso após a criação dos cursos não causará nenhum efeito nos cursos já criados. O modelo de curso deve estar em sua versão final antes de criar novos cursos com base no modelo. Escolha uma nomenclatura padronizada para os modelos de cursos. Por exemplo, inicie os modelos de cursos com "modelo" seguido de um sublinhado e um outro identificador.

Criar matrículas

Uma matrícula é uma tarefa de um usuário em um curso e a definição da função do usuário, como aluno ou instrutor, no curso.

  • EXTERNAL_COURSE_KEY. Esse elemento é uma chave exclusiva dos dados do curso.

  • EXTERNAL_PERSON_KEY. Esse elemento é uma chave exclusiva dos dados do usuário. Essas chaves devem ser definidas antes que um determinado registro de matrícula possa ser processado.

  • FUNÇÃO. O elemento de dados ROLE define a função do usuário no curso.

Rotule e formate seus dados

Depois que identificar todas as fontes de dados, defina as regras de solução de conflitos e colete todos os elementos de dados de suas fontes. Você precisará criar alguns rótulos para seus dados, denominados Chaves de origem de dados (DSKs), para que um conjunto de dados possa ser processado em uma única operação. Você também precisa assegurar que seus dados estão formatados para que possam ser reconhecidos e processados da forma correta pelo tipo de integração selecionada.

Criar chaves de fonte de dados

Uma chave da fonte de dados é um rótulo que pode ser dado a um conjunto de dados para que ele possa ser tratado em uma única operação, em vez de ter cada registro processado individualmente. Você pode criar várias chaves de fonte de dados e usá-las para carregar e processar dados Blackboard.

Como prática recomendada, crie suas chaves de origem de dados para que você possa carregar todos os itens de uma só vez. Atribua aos usuários uma chave de origem de dados. Atribua aos cursos de cada semestre uma outra chave de origem de dados. Dessa forma, você poderá manipular de forma eficiente o equivalente a um semestre de cursos, com um único comando, sem afetar os usuários. Carregue as matrículas de cada semestre em suas próprias chaves de origem de dados pelos mesmos motivos.

Crie o nome da DATA_SRC_KEY usando o ano, semestre e o tipo de dados. Por exemplo, use 2011_fall_SIA_courses para rotular os cursos do primeiro semestre de 2011.

Formatar os dados

Os dados precisam ser formatados de uma forma que o Building Block da integração do SIA possa reconhecer cada elemento e processá-lo apropriadamente. Cada elemento de dados precisa ser identificado pelo seu tipo. A linguagem XML (Extensible Markup Language) fornece um método simples, generalizado e detalhado para descrever dados. O formato XML será ligeiramente diferente dependendo do tipo de integração selecionado.

Informações adicionais de planejamento

Como parte do seu planejamento para as integrações do SIA, você precisará decidir qual o tipo ou tipos de integração que deseja criar, bem como tomar outras decisões com base nas políticas e requisitos de sua instituição.

Tipos de integração

Existem seis tipos de integrações disponíveis, e o formato de dados será ligeiramente diferente dependendo do tipo selecionado. Não há limite para o número de integrações que um sistema pode ter. É incomum, embora possível, ter uma variedade de Tipos de integraçãoem um único sistema.

  • IMS Enterprise 1.1

  • IMS Enterprise 1.1 – Vista

  • Serviços de informação do aprendizagem IMS

  • Arquivo simples do Snapshot

  • XML do Snapshot

  • Joranada de Notas

Para saber mais sobre o mapeamento de dados para cada tipo de integração, consulte Criar e editar integrações do SIA.

Criptografia de senha SSHA para serviços de informações de aprendizagem IMS

A autorização é baseada em métodos usados pelo Sugard Banner. Se você definir o tipo de criptografia no campo mapeamento como SSHA, ele precederá o {SSHA} se este já não estiver lá. Além de definir e incorporar o prefixo SSHA, pwencryptiontype também é definido e incorporado, como mostra o exemplo a seguir:

<userid useridtype="SCTID" pwencryptiontype="SSHA" password="{SSHA}OMMjWPR+6fM/iQ+ZvpWHEVGxoAEFT0JUQUE4Qz==">N00013021</userid>

Planejar interrupções de comunicação

No caso de haver um problema de comunicação entre o Sistema de informações do aluno (SIA) e Blackboard, você precisa de um plano sobre como lidar com a interrupção. É possível carregar seus dados manualmente para a Integração na GUI. Os acionamentos e backups do sistema precisam ser estabelecidos para manter seu sistema em bom funcionamento e os dados do sistema atualizados.

Definir o Status da integração

Blackboard recomenda que novas integrações comecem no status Teste. Selecionar esse status permitirá que você teste a Integração e repare quaisquer problemas que possam surgir antes da Integração. Quando o Teste for concluído, defina o status como Inativo ou Ativo. Um status Inativo não processará solicitações ou atualizará dados na base de dados. Quanto ao status Ativo, o sistema processará solicitações, atualizará os dados na base de dados e ficará visível aos usuários.

Blackboard também sugere a criação dessa integração em um ambiente de preparo ou teste antes de liberar para produção.

Log

Definir o detalhamento de registro durante a criação definirá o tipo e a profundidade do registro mantido no seu sistema para a Integração selecionada. Os registros podem ser filtrados usando um método de busca avançado que inclui o tipo de erro, a integração e o intervalo de datas.

Configuração avançada

O Tipo de Blackboard Objeto e o Tipo de Objeto do seu Sistema de informações do aluno (SIA) são mapeados em uma lista de 1 para 1. Defina como manipular inserções, atualizações e exclusões para cada Tipo de objeto.

Saiba Mais

Você pode saber mais acessando Cartilha de especificação de serviço de informações de aprendizagem.