Skip to main content

Visão geral da estrutura do Sistema de informações do aluno (SIA)

Importante

É possível que já existam investimentos em processos de integração do SIA em seu campus. Você pode continuar a usar esses processos de integração existentes como no passado enquanto avalia a adoção dos tipos de integração da Estrutura de Integração do Sistema de informações do aluno (SIA). No entanto, é importante entender que, à medida que Blackboard evolui, os processos de integração legados provavelmente não acompanharão o ritmo dos objetos mais recentes introduzidos em suporte a novos Blackboard recursos e capacidades.

Sobre a integração do Sistema de informações do aluno (SIA) e a Estrutura de Integração do Blackboard Sistema de informações do aluno (SIA)

A integração do Sistema de Informações do Aluno (SIA) ajuda os administradores a integrar dados de cursos, usuários e matrícula com o Blackboard. Os dados podem ter origem de fontes diversas e em formatos variados. A integração do Sistema de informações do aluno (SIA) fornece uma maneira fácil Blackboard de atualizar para outro sistema de gerenciamento de aprendizagem, como CE ou Vista, suportando o mesmo formato de feed de dados gerado por esses sistemas para troca de dados. A integração do Sistema de informações do aluno (SIA) também permite que as atualizações do sistema sejam delegadas a outros Blackboard administradores, permitindo que a flexibilidade seja incorporada ao sistema.

A Estrutura de integração do Sistema de informações do aluno (SIA) é uma estrutura extensível ao Building block que fornece funcionalidade comum a todas as integrações, ao mesmo tempo em que facilita a criação, configuração e gerenciamento da integração na interface do usuário do Painel do Blackboard administrador. O princípio é baseado em uma separação de funcionalidade. A Estrutura do SIA fornece os recursos de criação, configuração e operação/manutenção baseados na UI, bem como os Tipos de integração (baseados em Building Blocks) para fornecer a lógica específica para cada tipo de integração do SIA. Isso permite que a Estrutura do SIA suporte uma abordagem de compra combinada para a integração, ao mesmo tempo que permite várias instâncias de um tipo de integração. Isso proporciona uma grande flexibilidade no desenvolvimento de soluções de integração do SIA, pois fornece a capacidade de atender às necessidades de integração, das mais simples às mais complexas.

Um recurso adicional disponível para todos os tipos de integração é o mapeamento de dados em tempo real. Isso permite o mapeamento personalizado de objetos de dados recebidos para objetos Blackboard de dados. Essa capacidade de mapeamento permite que você aplique scripts personalizados baseados em javascript para dados de entrada. No caso do tipo de integração Arquivo simples do Snapshot, você pode aplicar mapeamentos de cabeçalho personalizados para corresponder os formatos de dados existentes aos Blackboard formatos. Você pode ler mais sobre Mapeamento personalizado de acordo com cada tipo de integração na seção de exemplos para cada tipo de integração.

Planeamento

Existem vantagens importantes em usar as integrações do Sistema de informações do aluno (SIA) para transmitir dados Blackboard para preencher e atualizar automaticamente seu sistema. A primeira é que 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. Outra vantagem é que os dados podem ser transferidos de forma rápida e eficiente do seu sistema de Informações para Blackboard.

É fundamental envolver todas as partes interessadas no processo de planejamento da integração. Aproveitar a contribuição do seu Sistema de informações do aluno (SIA) e do Registrador, bem como das equipes Blackboard administrativas, garantirá uma integração bem-sucedida.

Uma integração bem-sucedida requer conhecimento das opções de configuração do Sistema de informações do aluno (SIA), a seleção do tipo de Blackboard integração que atende aos seus requisitos e uma compreensão dos requisitos de dados para o tipo de integração. Nos casos dos tipos de integração Snapshot e Enterprise 1.1, também é necessária uma compreensão do script do lado do servidor para facilitar a transferência de dados para os terminais de integração.

Saiba mais sobre planejamento de integrações do Sistema de informações do aluno (SIA).SIS Integration Planning

Serviços de mentoria

Um compromisso de participação com a Blackboard Consultoria pode ajudar a planejar, dimensionar e atualizar suas integrações. Blackboard A Consulting oferece um programa de integração abrangente que se adapta às suas necessidades.

Mentoria do Sistema de informações do aluno (SIA) Integration Framework

O objetivo do serviço de Mentoria do Quadro de Integração do Sistema de informações do aluno (SIA) é auxiliar os clientes na implementação do Quadro de Integração do Blackboard Sistema de informações do aluno (SIA). Totalmente remoto, esse serviço fornecerá um consultor a seu distrito para orientar sobre elementos básicos de dados, configuração, limpeza de dados, técnicas de script e solução de problemas.

Atividades do projeto

  • Um consultor remoto atribuído à sua instituição durante o período de duração do projeto

  • Identificação de elementos básicos de dados, comportamentos e regras de negócios, visando a automatização de processos para a criação de contas e cursos de usuários, matrícula de usuários e tarefas de professores/pessoal para cursos.

  • Documentação de decisões relativas a elementos de dados importantes em uma pasta de trabalho de planejamento de dados para uso posterior do cliente.

  • Forneça orientação em relação à configuração da Estrutura de integração do SIA para atender aos requisitos de dados documentados.

  • Auxiliar na limpeza de dados de contas de usuários existentes no Blackboard ambiente para garantir a compatibilidade com um ambiente automatizado e integrado.

  • Forneça uma visão geral das técnicas básicas de script a serem usadas para transformação de dados na ferramenta Sistema de informações do aluno (SIA).

  • Revisão de técnicas de solução de problemas para questões de dados e de integração.

  • Revise o gerenciamento do ciclo de vida dos dados e a visão geral das Práticas recomendadas para arquivar e limpar Blackboard dados.

  • Configuração inicial dos artefatos do programa da Estrutura de integração do sistema de informações do aluno (SIA):

    • Documentação de requisitos dos processos empresariais (Pasta de trabalho de planejamento de dados)

    • Documentação de configuração de integração (Pasta de trabalho de operações)

    • Blackboard Materiais de referência e documentação do produto principal

Dê o próximo passo!

Entre em contato com seu representante de Blackboard vendas para agendar um horário para discutir suas opções recomendadas e as próximas etapas. Concentre-se em engajar e avaliar os alunos, não em navegar em uma integração de dados complexa. Deixe a Blackboard Consultoria ajudar.

O serviço de Mentoria da Estrutura de Integração do Sistema de informações do aluno (SIA) dos Serviços de Consultoria fornecerá o suporte necessário para automatizar a transferência de informações de usuários, cursos e matrículas de um sistema de origem (como Sistema de informações do aluno (SIA), LMS, RH, Planejamento de Recursos Empresariais ou outro sistema de registro) para Blackboard. A consultoria trabalhará com você para identificar os principais elementos de dados, comportamentos e regras de negócios.

Como funciona o Quadro de Integração do Sistema de informações do aluno (SIA)

Além das opções de configuração e dos tipos de dados de integração (abordados em seções separadas e específicas por tipo de integração), a Estrutura de integração do SIA opera em quatro conceitos principais:

  1. Formato de dados

  2. Transferência de dados

  3. Propriedade dos dados

  4. Processamento de dados

Em resumo, cada tipo de integração e instância configurada do mesmo recebe dados devidamente formatados de acordo com os requisitos para a integração(1) para transferência Blackboard através de um conjunto de serviços específicos de integração (2) utilizando um identificador exclusivo por instância de integração configurada que controla a propriedade dos dados(3) para processamento pelo Blackboard Sistema de informações do aluno (SIA) Framework(4).

Cada um desses apresenta conceitos importantes para compreender como a Estrutura de integração do SIA funciona, como determinar melhor sua configuração de integração e como melhorar sua infraestrutura de integração para auxiliar a Estrutura de integração do SIA.

Formato de dados

Cada tipo de integração de dados suporta um formato de dados específico para esse tipo de integração. Assim, os dados para o Enterprise 1.1 são diferentes do Enterprise 1.1 Vista, que é diferente de arquivo simples do Snapshot e LIS. O conhecimento desses formatos de dados informa não apenas os tipos de objeto suportados pela integração associada, mas também a sintaxe do Mapeamento personalizado para o tipo de integração.

A cobertura detalhada dos formatos de dados de integração é abordada nos tópicos para cada tipo específico de integração.

Transferência de dados

Cada tipo de integração de dados suporta a transferência de dados por meio de terminais de serviço baseados em HTTP que são específicos em formato e método para o tipo de integração. Em todos os casos, é considerada uma prática recomendada passar dados por uma conexão HTTPS.

Detalhes sobre o modelo de transferência de dados e Blackboard endpoints de cada tipo de integração estão nos tópicos específicos para esse tipo de integração.

Um fluxograma ilustrando a transferência de dados do Sistema de informações do aluno (SIA) para o banco de dados do Blackboard por meio de uma série de caixas e setas. Os dados são movidos da Origem do Sistema de informações do aluno (SIA) por meio de uma transferência HTTPS de dados para os Endpoints de integração do Sistema de informações do aluno (SIA) por meio do tipo de integração do Sistema de informações do aluno (SIA) do Blackboard Target, que processa os dados e atualiza o banco de dados do Blackboard usando a estrutura para gravar registros para visualização por meio da interface do usuário ou da linha de comando.

Todos os tipos de integração podem receber dados por fio direcionando os dados para a URL de integração. Isso é útil no contexto dos tipos Enterprise 1.1 e do Snapshot, já que eles agora podem transferir dados via cabo e postar dados com base em arquivos.

Propriedade dos dados

A Estrutura de integração do SIA suporta a capacidade de gerenciar dados usando mais de um tipo de integração. Cada configuração de integração implantada gerencia os dados específicos dessa integração específica e nenhum outro. Embora as chaves de fonte de dados #visão-geral-da-chave-da-fonte-de-dados possam ser utilizadas para agrupar dados para gerenciamento por meio da interface do usuário e das ferramentas de suporte, as chaves de fonte de dados não são usadas pela estrutura de integração do Sistema de informações do aluno (SIA) para limitar as alterações nos dados associados. Assim, os Blackboard objetos são de propriedade da integração que os "criou" e não das Chaves de Fonte de Dados associadas. Isso significa que uma integração pode atuar em todos os pontos de dados que possui independentemente das chaves de origem de dados associadas.

As instâncias individuais do mesmo tipo de integração são identificadas de forma exclusiva por um UID gerado pelo sistema que é exibido na página de configuração da integração e pode, no caso do LIS, ser usado na configuração do SIA ou, no caso dos tipos de integração do Enterprise ou do Snapshotquais transmitem os dados de integração para o terminal. Para saber mais sobre a configuração do LIS ou do serviço ao cliente, consulte os tópicos de configuração e automação para cada tipo de integração.

Processamento de dados

Seja qual for o tipo de integração ou formato de dados, todo processamento ocorre da mesma maneira:

  1. A estrutura de integração do SIA recebe uma solicitação em um terminal específico para um tipo de integração

  2. Com base no UID de entrada, a configuração do tipo de integração é carregada

  3. No pré-processamento bem-sucedido dos dados para validação, a tarefa é intermediada pelo ActiveMQ para ser executada em um servidor de Blackboard aplicativos de destino

  4. Os dados são processados de acordo com as configurações, os cabeçalhos personalizados e mapeamento personalizado, se utilizados pela integração

  5. Todas as operações de processamento de objetos são registradas por objeto, gravadas em um arquivo de registro e também armazenadas no Blackboard banco de dados para recuperação pelo visualizador de registro da interface do usuário.

A Estrutura de integração do SIA não processa os dados em paralelo; isso introduziria um alto risco de condições de corrida de dados. Em vez disso, os dados são processados de acordo com o modo primeira entrada e primeira saída, garantindo que os dados sejam processados na sequência desejada. Assim, você sempre deve aguardar a conclusão do processamento de um conjunto de dados antes de enviar o próximo conjunto de dados.

Tipos de integração, suporte a objetos e requisitos

O Blackboard Sistema de informações do aluno (SIA) Framework suporta cinco tipos de integração em uma instalação padrão composta por padrões e tipos de integração Blackboard desenvolvidos. Tipos personalizados adicionais podem ser desenvolvidos e adicionados por meio do Gerenciador de Building Blocks. Essa capacidade de estender os tipos suportados com tipos adicionais amplia o valor da Estrutura do SIA na empresa, ao mesmo tempo que nos permite atualizar os tipos de integração baseados em Building Blocks fora da caixa e fora do ciclo, se necessário.

Cada tipo de integração Blackboard fornecido tem suporte a Blackboard objetos e requisitos de sistema de Informações específicos para o tipo de integração. A seguir, você encontrará uma descrição relevante dos tipos de integração, os objetos que eles suportam e os requisitos do Sistema de Informações para suportar a integração.

Observe que os tipos de integração suportam Blackboard objetos conforme especificado pelo tipo de integração – não há 100% de sobreposição no suporte a objetos em todos os tipos de integração – essa é uma consideração importante para selecionar seu tipo de integração. Outra consideração importante é a capacidade do Sistema de Informações de suportar o tipo de integração e o formato de dados. Para saber mais sobre um tipo de integração, o formato de dados e os meios de transporte de dados, consulte as seções de cada tipo de integração.

Como Blackboard avanços no apoio à integração do sistema de Informações, estaremos focados nos tipos de integração LIS 2.0 e Snapshot Flat File – estes devem ser considerados como alvos prioritários para a integração. Os três tipos de integração restantes são fornecidos para auxiliar clientes que possuem integrações existentes utilizando essas integrações e que estão interessados em utilizar a Estrutura do SIA. Observe os tipos de integração, Enterprise 1.1, Enterprise 1.1 Vista e Snapshot XML não verão mais desenvolvimento em suporte a novos Blackboard objetos.

Enterprise 1.1 e Enterprise 1.1 Vista

Enterprise 1.1: O Enterprise 1.1 foi introduzido em 2002 e pretendia substituir o Enterprise 1.0 (1999). Fornecia uma descrição de dados baseada em XML para transmitir informações de Pessoas, Grupos e Associações de grupos. Destinado à troca de dados dentro e entre sistemas de Planejamento de Recursos Empresariais institucionais, os principais fornecedores adotaram o padrão para fins de integração – WebCT e Blackboard ambos adotaram o padrão.

Muitas vezes, faz-se referência ao Enterprise 1.1 no contexto das integrações "baseadas em eventos", embora também tenha sido usado para gerar arquivos de dados simples. As duas 'versões' do Enterprise 1.1 que Blackboard suportam são a versão original do Vista e uma versão Ellucian Banner que contém extensões para a especificação para clientes Banner. Esses são os tipos de integração Enterprise 1.1 Vista e Enterprise 1.1 na Estrutura do SIA.

Objetos com suporte

Projetado para instituições que:

  • Fornecem uma visão geral do processo empresarial

  • Fornecem orientação com relação à configuração da Estrutura de integração do SIA

  • Fornecem uma revisão das técnicas básicas de script

  • Fornecem técnicas de solução de problemas para questões de dados e de integração

  • Documentam decisões relativas a elementos de dados importantes

tabela 52. Objetos suportados – Enterprise 1.1

Objeto

Descrição

Cursos

Dados para criar e gerenciar cursos

Usuários

Dados para criar e gerenciar usuários do sistema (Alunos, professores, funcionários etc.)

Matrículas

Dados para criar e gerenciar matrículas em cursos (matrículas)

Nós

Dados para criar e gerenciar relações de hierarquia

Períodos

Dados para criar e gerenciar

Cursos em listas cruzadas

Dados para mesclar cursos filho e cursos pai.

Funções da instituição

Dados para gerenciar os relacionamentos das funções de usuário.

A função primária da instituição (somente) pode ser definida no objeto Usuário nessa integração usando um mapeamento de campo personalizado. As integrações em que a função na instituição é totalmente suportada aceitam as funções das instituições primárias E secundárias.

Organizações

Dados para criação e gerenciamento de sites Blackboard da organização.

As organizações podem ser criadas nessa integração usando um mapeamento de campo personalizado dos objetos de cursos. As integrações onde as organizações são totalmente suportadas podem ter feeds separados exclusivos paraorganizações



sistemas de Informações

Versões do Peoplesoft:

Peoplesoft Campus Solutions 9, versão 21 ou anterior

Versões do Ellucian Banner:

Banner General

- 8.0 ou acima para Intcomp 8.0.1

- 8.1 ou acima para Intcomp 8.0.2

Banner Student

- 8.0 ou acima para Intcomp 8.0.1

- 8.1 ou acima para Intcomp 8.0.2

Banner Intcomp – 8.0.1 ou acima

Banner Financial Aid – 8.x

Banner Integration para eLearning – 8.0

Colega eluciano

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Nota

Antes de comprometer-se a utilizar o Enterprise 1.1, confirme o suporte a versões posteriores de sistemas de terceiros.

Consulte a seção Tipo de integração Enterprise 1.1 para obter uma descrição detalhada do tipo de integração, observando que o formato de dados é ligeiramente diferente entre as duas versões suportadas do Enterprise 1.1 (padrão e Vista).

LIS 2.0

LIS 2.0: Os Serviços de Informação ao Aluno 2.0 devem ser considerados o substituto do Planejamento de Recursos Empresariais 1.1 e compreendem uma solução baseada nas aulas aprendidas com as deficiências do Planejamento de Recursos Empresariais 1.1. O LIS 2.0 não apenas descreve os dados, mas também descreve os métodos de transporte e sua publicação/consumo. Isso permite um mapeamento 1:1 dos dados no sistema de origem compatível com LIS para os processos que permitem consumir esses dados, o que é bom para integrações plug and play. O LIS 2.0 é baseado em serviço da web – os sistemas compatíveis transmitem os dados de acordo com serviços conhecidos e simplesmente fornecem os terminais do sistema. Dois sistemas podem trocar dados.

O LIS 2.0 é um modelo "baseado em eventos", embora os arquivos simples que aderem à descrição de dados XML do LIS 2.0 podem ser gerados para upload manual.

Objetos com suporte

tabela 53. Objetos suportados – LIS 2.0

Objeto

Descrição

Cursos

Dados para criar e gerenciar cursos

Usuários

Dados para criar e gerenciar usuários do sistema (Alunos, professores, funcionários etc.)

Matrículas

Dados para criar e gerenciar matrículas em cursos (matrículas)

Períodos

Dados para criar e gerenciar

Funções da instituição

Dados para gerenciar os relacionamentos das funções de usuário.

A função primária da instituição (somente) pode ser definida no objeto Usuário nessa integração usando um mapeamento de campo personalizado. As integrações em que a função na instituição é totalmente suportada aceitam as funções das instituições primárias E secundárias.

Organizações

Dados para criação e gerenciamento de sites Blackboard da organização.

As organizações podem ser criadas nessa integração usando um mapeamento de campo personalizado dos objetos de cursos. As integrações onde as organizações são totalmente suportadas podem ter feeds separados exclusivos paraorganizações



sistemas de Informações

Versões do Peoplesoft:

Peoplesoft Campus Solutions 9, versão 22 ou posterior

Versões do Ellucian Banner:

Banner General

- 8.1 ou acima é exigido

Banner Student

- 8.1 ou acima é exigido

Banner Intcomp

- 8.0.2 ou acima é exigido

Banner Financial Aid

- 8.11

Para o Servidor de aplicativos Oracle

- 10.1.3

Colega eluciano

Requer ILP versão 3.5

Nota

Antes de se comprometer com o suporte ao LIS 2.0, confirme o suporte em versões posteriores de sistemas de terceiros.

Arquivo simples do Snapshot

Blackboard também suporta nossa abordagem de Snapshot Flat File para importação de dados. O Snapshot foi a primeira integração suportada no Blackboard Planejamento de Recursos Empresariais e tem uma longa história de sucesso devido à sua simplicidade de função. Originalmente, o Snapshot suportava arquivos delimitados por XML e CSV – um arquivo criado por tarefa de gerenciamento de dados para Usuários, Cursos, Matrículas e Tarefas de pessoal. A Estrutura do SIA suporta o consumo de arquivos do Snapshots usando os tipos de integração do XML do Snapshot ou arquivos simples do Snapshot. Note, no entanto, que o arquivo simples do Snapshot é o único formato que receberá atualizações para o suporte de "novos" objetos de dados daqui para frente. O XML do Snapshot está congelado a este respeito e pode não atender aos futuros requisitos de integração.

Objetos com suporte

tabela 54. Objetos suportados – arquivo simples do Snapshot

Objeto

Descrição

Cursos

Dados para criar e gerenciar cursos

Usuários

Dados para criar e gerenciar usuários do sistema (Alunos, professores, funcionários etc.)

Matrículas

Dados para criar e gerenciar matrículas em cursos (matrículas)

Nós

Dados para criar e gerenciar relações de hierarquia

Períodos

Dados para criar e gerenciar

Categorias do catálogo

Dados para criação e gerenciamento do Catálogo Blackboard de Cursos

Funções da instituição

Dados para gerenciar os relacionamentos das funções de usuário.

A função primária da instituição (somente) pode ser definida no objeto Usuário nessa integração usando um mapeamento de campo personalizado. As integrações em que a função na instituição é totalmente suportada aceitam as funções das instituições primárias E secundárias.

Organizações

Dados para criação e gerenciamento de sites Blackboard da organização.

As organizações podem ser criadas nessa integração usando um mapeamento de campo personalizado dos objetos de cursos. As integrações onde as organizações são totalmente suportadas podem ter feeds separados exclusivos paraorganizações

Cursos em listas cruzadas

Dados para mesclar cursos filho e cursos pai.

Observadores

Dados para criar e gerenciar observadores



sistemas de Informações

Versões do Peoplesoft:

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Versões do Ellucian Banner:

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Colega eluciano

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Antes de comprometer-se a utilizar o arquivo simples do Snapshot, confirme o suporte a extração de dados em versões instaladas de sistemas de terceiros.

XML do Snapshot

O XML de snapshot tem laços estreitos com a especificação Enterprise 1.1 com adições Blackboard específicas. Semelhante ao Enterprise 1.1, o XML do Snapshot aumenta a flexibilidade nos arquivos XML que podem conter um tipo de dados ou combinar vários tipos de dados para serem processados de uma só vez.

Outro ponto que vale a pena reiterar – o formato de dados XML do Snapshot não deve ser a primeira opção de integração, uma vez que está apenas recebendo atualizações de manutenção e não suporte a objetos novos ou desenvolvimento de recursos. Espera-se que, em algum momento no futuro, seja feito um aviso sobre o término do suporte com tempo suficiente para a adaptação do cliente.

Objetos com suporte

tabela 55. Objetos suportados – XML do Snapshot

Objeto

Descrição

Cursos

Dados para criar e gerenciar cursos

Usuários

Dados para criar e gerenciar usuários do sistema (Alunos, professores, funcionários etc.)

Matrículas

Dados para criar e gerenciar matrículas em cursos (matrículas)

Categorias do catálogo

Dados para criação e gerenciamento do Catálogo Blackboard de Cursos

Funções da instituição

Dados para gerenciar os relacionamentos das funções de usuário.

A função primária da instituição (somente) pode ser definida no objeto Usuário nessa integração usando um mapeamento de campo personalizado. As integrações em que a função na instituição é totalmente suportada aceitam as funções das instituições primárias E secundárias.

Organizações

Dados para criação e gerenciamento de sites Blackboard da organização.

As organizações podem ser criadas nessa integração usando um mapeamento de campo personalizado dos objetos de cursos. As integrações onde as organizações são totalmente suportadas podem ter feeds separados exclusivos para comunidades.

Observadores

Dados para criar e gerenciar observadores



sistemas de Informações

Versões do Peoplesoft:

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Versões do Ellucian Banner:

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Colega eluciano

Requer ferramentas para extração e conversão de dados antes de enviar para Blackboard

Nota

Antes de comprometer-se a utilizar o XML do Snapshot, confirme o suporte da extração de dados em versões instaladas de sistemas de terceiros.

Integrações personalizadas

Uma vez que a Estrutura de integração do SIA é uma estrutura de Building Block do tipo extensível, você pode usar as APIs da Estrutura do SIA para criar tipos de integração personalizados que atendam às suas necessidades comerciais específicas. Isso é aplicável se o seu sistema de informações não suportar um dos tipos de integração Blackboard fornecidos ou se você tiver necessidades de integração específicas fora do escopo dos tipos de integração Blackboard fornecidos. Nesses casos, você pode criar seu próprio Building block de integração e ter controle sobre os Blackboard objetos que sua integração suporta e a lógica de integração específica do seu sistema de informações.

Suporte geral e configuração

Blackboard Os Serviços de Suporte oferecem suporte para os Blackboardtipos de Integração entregues. Se você tiver dúvidas ou encontrar problemas com seus processos de configuração ou integração, entre em contato com o suporte preenchendo um tíquete de suporte com Anthology Support.

Você configura Blackboard para receber dados para cada um dos tipos de integração usando as páginas de configuração de Integração de Sistema de informações do aluno (SIA) do Blackboard Administrador. Para configurar uma integração, assim que você determinar qual tipo é mais adequada aos seus objetivos de negócios e recursos de informações, na página principal de Configuração do SIA, você precisa completar nove etapas:

  1. Crie sua integração selecionando o tipo de integração no menu suspenso Criar

  2. Configure sua integração recém-criada

  3. Coloque a integração no modo de teste

  4. Faça alterações no mapeamento personalizado

  5. Teste sua integração (nenhuma alteração é feita nos Blackboard dados quando uma integração está no modo de teste)

  6. Confirme a configuração visualizando os registros de integração na UI

  7. Repita as etapas 4 a 6 até que tenha certeza que a integração funcionará como esperado

  8. Ao completar o teste com sucesso, coloque a integração no modo ativo para iniciar

  9. Monitore sua integração observando os registros de integração

Para saber mais, consulte os tópicos de configuração para cada tipo de integração.

Registro de integração

O registro de todos os tipos de integração está disponível por meio da UI de registro para a Estrutura de integração do SIA. A partir da UI, você tem acesso a registros que contêm o status das integrações configuradas nos níveis dos objetos e de registro suportados para manter você informado sobre as operações de integração.

A página de registro permite a classificação de mensagens de registro com base no tipo e na integração.

Além do acesso à UI, os registros também são gravados em disco para arquivamento e análise e triagem a longo prazo.

Nota

O carimbo de data e hora exibido no Último registro no registro (na página de log) e no Último evento (na página de Integrações) representa os eventos como registrados com base nos níveis de registro selecionados.

Você também pode usar os serviços da web REST para acessar registros e erros encontrados durante o processamento de dados.

Para acessar os registros, acrescente /learn/api/v1/logs/Sistema de informações do aluno (SIA)/{dataSetUid} ao seu Blackboard domínio. O sistema fornece um código de referência, dataSetUid, toda vez que um arquivo feed for processado. Esse parâmetro é necessário para retornar os resultados. As mensagens de erro e sucesso são registradas na tabela DATA_INTGR_LOG.

Parâmetros adicionais estão disponíveis para segmentar os dados:

  • parâmetro logLevel: /learn/api/v1/logs/sistema de informações do aluno (SIA)/{dataSetUid}?logLevel=(DEBUG,WARNING,ERROR,INFORMATION).

  • Parâmetros de paginação padrão: /learn/api/v1/logs/Sistema de informações do aluno (SIA)/{dataSetUid}?limit=25&&offset=10. Por padrão, a solicitação padrão tem um limite de 20 páginas, a menos que você altere esse valor.

O processo para solucionar problemas de erros de registro nos serviços da web não é alterado do processo para solucionar problemas de registros de erros encontrados na UI. Se você encontrar uma mensagem de erro "não encontrado", é possível que o dataSetUid não exista no sistema ou o arquivo de feed ainda esteja sendo processado.