Skip to main content

Enterprise 1.1

Note

Esta documentação foi traduzida utilizando tradução automática assistida por IA. As traduções são fornecidas "no estado em que se encontram", sem qualquer garantia quanto à sua precisão. A versão em inglês deste conteúdo é a fonte oficial e de referência.

Nesta seção, leia mais sobre como usar o Enterprise 1.1 para integrar seu Sistema de informações do aluno (SIA).

Configurar a sintaxe XML de integração do Vista Sistema de informações do aluno (SIA) para a criação do curso

A hierarquia do Vista é muito diferente da hierarquia do Blackboard. Os primeiros quatro níveis de uma hierarquia do Vista (instituição, Divisão, Grupo e Curso) são convertidos em nós de hierarquia do Blackboard e vinculados uns aos outros adequadamente. O quinto nível da hierarquia do Vista (Seção do curso) é convertido em um curso do Blackboard e associado ao seu nó pai.

Nota

O Blackboard não gera nós para a camada de curso da hierarquia do Vista e, como resultado, os cursos criados a partir dos elementos Vista da seção do curso são associados ao grupo pai.

Esse comportamento pode ser alterado nas configurações de integração.

A seguir está um fragmento XML de elementos de <group> e <relationship> que descreve uma Divisão, Grupo e Curso e suas associações.

<enterprise xmlns:webct="http://www.webct.com/IMS">
<!-- division item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>DIVISION1</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="25"/>
  </grouptype>
  <description>
    <short>AAA Division IMS</short>
    <long>Test Division IMS</long>
    <full>This Division is for testing IMS imports by WebCT Support staff</full>
  </description>
  <datasource>TestDS</datasource>
  </group>
<!-- Group Item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>GROUPBABBLE_IMS4</id>
  </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="30"/>
  </grouptype>
  <description>
    <short>AAA Group IMS</short>
    <long>Test Group IMS</long>
    <full>This Group is for testing IMS imports by WebCT Support staff</full>
  </description>
  <relationship relation = "1">
    <sourcedid>
    <source>TestDS</source> <!-- *** DIVISION ID HERE *** -->
    <id>DIVISION1</id> <!-- *** DIVISION ID HERE *** -->
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
<!-- course item 1 -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>COURSEBABBLEONE_IMS4</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="80"/>
  </grouptype>
  <description>
    <short>AAA-101</short>
    <long>Introduction to Triple A</long>
    <full>This course introduces basic concepts of AAA, an important part of your life</full>
  </description>
  <relationship relation = "1">
    <sourcedid>
    <source>TestDS</source>
    <id>GROUPBABBLE_IMS4</id>
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
<!-- Section Item -->
  <group recstatus="1">
    <sourcedid>
    <source>TestDS</source>
    <id>SECTIONBABBLEONE_IMS4</id>
    </sourcedid>
  <grouptype>
    <scheme>LEARNING_CONTEXT_V1</scheme>
    <typevalue level="90"/>
  </grouptype>
  <description>
    <short>AAA-101-001</short>
    <long>Introduction to Triple A - Section 001</long>
    <full>This course introduces basic concepts of AAA, an important part of your life</full>
  </description>
  <relationship relation = "1"><!-- Parent Course -->
    <sourcedid>
    <source>TestDS</source>
    <id>COURSEBABBLEONE_IMS4</id>
    </sourcedid>
  <label/>
  </relationship>
  <datasource>TestDS</datasource>
  </group>
</enterprise>

Edite os atributos e valores relevantes no código acima com os detalhes de cada nível.

tabela 59. Detalhes do nível

Elemento/atributo

Obrigatório

Descrição

recstatus

Não

Tipo de ação a ser realizada em um objeto. Os números são usados para independência de idioma: 1 = Adicionar, 2 = Atualizar e 3 = Excluir. Se nenhum atributo recstatus for fornecido, a API será padronizada para 1 (Adicionar) se o registro ainda não existir ou 2 (Atualizar) se o registro existir.

sourcedid

Sim

Contém um identificador exclusivo para o objeto de grupo que consiste em um elemento de origem e um elemento código.

fonte

Sim

Identificador exclusivo do sistema que criou o objeto do grupo em primeiro lugar.

código

Sim

Identificador exclusivo de nível inferior para o objeto do grupo. Para um curso, ele identifica exclusivamente o curso específico, o período e assim por diante, dentro da organização ou sistema de origem. Para um nó, ele identifica exclusivamente o departamento, a escola e assim por diante, dentro da organização ou do sistema.

grouptype

Sim

O tipo de grupo.

Esquema

Sim

Identifica o esquema de categorização de grupo que está sendo usado. O Blackboard Enterprise usa <scheme>Blackboard</scheme><.span>. O Vista Enterprise usa <scheme>LEARNING_CONTEXT_V1</scheme>.

typevalue

Sim

Especifica o que está sendo adicionado. O objeto que esse grupo representa. O typevalue do Blackboard Enterprise deve ser um dos seguintes:

  • 10 – Isso representa um nó na hierarquia institucional.

  • 20 – Isso representa um curso do Blackboard.

O typevalue para o Vista Enterprise deve ser um dos seguintes:

  • 25 – Isso representa uma divisão

  • 30 – Isso representa um grupo

  • 60 – Isso representa um período

  • 80 – Isso representa um curso

  • 90 – Isso representa uma seção

descrição

Sim

Descreve o curso ou nó.

short

Sim

Para um curso, identifica a versão abreviada do título do curso. Para um nó, identifica o nome do nó. Por exemplo, Engenharia.

long

Não

Título do curso. Se nenhum valor <long> for especificado, o

full

Não

A descrição completa do curso ou do nó.

relationship

Não

O nó pai (contexto de aprendizagem) do curso ou nó que está sendo adicionado. Isso substitui a linha de comando e a configuração padrão inseridas na interface de configurações da administração.

relation

Não

Qualifica o tipo de relacionamento. Isso deve sempre ser um vale de 1.

relação.

sourcedid

Sim

O sourcedid do nó pai ao qual o curso ou nó deve estar associado.

label

Sim

Descreve o relacionamento. Embora esse seja um campo obrigatório, uma referência de elemento vazio poderá ser usada se não houver valor para rótulo como visto no exemplo.



Extensões do Blackboard para o IMS Enterprise 1.1

Fragmento de código:

<extension>
     <inst_email>hl@duelm.com</inst_emal>
</extension>

Elemento/atributo

Obrigatório

Descrição

Mapeamento de campo JavaScript personalizado

inst_email

Não

O endereço de e-mail da instituição do usuário.

inst_e-mail pode ser definido como NULL.

Nenhuma comunicação por e-mail é enviada ao inst_email.

O script personalizado de exemplo a seguir pode ser usado para preencher o campo de e-mail da instituição nas especificações do IMS Enterprise 1.1 usando mapeamentos de campo.

(function(){
     if(data.extension != null){
          return helper.getXPathString (data.extension, '/extension/inst_email');
     }
     return null;
}());

Pronomes

Não

Os pronomes do usuário.

Os pronomes podem ser definidos como NULL.

Pronúncia

Sim

Guia de ortografia ou pronúncia fonética para o nome de um usuário.