Skip to main content

XML do Snapshot

Como configurar a sintaxe XML de integração do SIA para criação de cursos.

O formato Blackboard é um tipo do padrão IMS que atende explicitamente a objetos específicos do Blackboard. Este tópico preocupa-se com os aspectos desse formato relacionados à criação de um curso usando o elemento do <group> e associá-lo a um nó na hierarquia institucional.

No formato Blackboard,

  • Os elementos de grupo são usados para representar dois tipos de objetos: cursos e nós.

  • Os elementos de relacionamento são o tecido conjuntivo do esquema Blackboard: eles ligam nós a nós para formar a hierarquia da instituição e cursos a nós para criar associações de cursos.

Criar um elemento de grupo do curso

Veja a seguir um fragmento XML de um elemento <grupo> que descreve um curso.

<!-- create a course -->

<group recstatus="1">

  <sourcedid>

    <source>My Institution SIS</source>

   <id>0390COMPSCI697CSec1-1164</id>

  </sourcedid>

  <grouptype>

    <scheme>Blackboard</scheme>

    <typevalue level = "20"/>

  </grouptype>

  <datasource>My Institution SIS</datasource>

  <description>

    <short>Comp697</short>

    <long>Security In Computing</long>

    <full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>

  </description>

</group>

Edite os atributos e valores relevantes no código acima com os detalhes do curso.

Nota

Você também pode usar esse código para criar um nó.

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 de 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

Identificador exclusivo do objeto do grupo que consiste em um elemento de origem e um elemento de 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, o período etc. específico 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

Esquema de categorização de grupo sendo usado.

  • O Blackboard Enterprise usa <scheme>o Blackboard</scheme>.

  • 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 para o 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

Identifica o título do curso.

OBSERVAÇÃO: Se nenhum <long> valor for especificado, o <short> valor se tornará o título do curso.

full

Não

Identifica o curso completo ou a descrição do nó.

Associar um curso a um nó usando um elemento de relacionamento

Um elemento <relationship> sempre vive dentro de um elemento <group> e descreve o relacionamento desse elemento com outros grupos. Veja a seguir um fragmento XML de um elemento <relationship> que descreve a associação do curso a um nó.

<group recstatus="1">

  <sourcedid>

    <source>My Institution SIS</source>

    <id>0390COMPSCI697CSec1-1164</id>

  </sourcedid>

  <grouptype>

    <scheme>Blackboard</scheme>

    <typevalue level = "20"/>

  </grouptype>

  <datasource>My Institution SIS</datasource>

  <description>

    <short>Comp697</short>

    <long>Security In Computing</long>

    <full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>

  </description>


<!-- primary association -->

  <relationship relation="1">

  <sourcedid>

    <source>My Institution SIS</source>

    <id>CompSciDept</id>

  </sourcedid>

  <label/>

  </relationship>


<!-- secondary association -->

  <relationship relation="1">

  <sourcedid>

    <source>My Institution SIS</source>

    <id>EEDept</id>

  </sourcedid>

  <label/>

  </relationship>

</group>

Quando um curso tem várias associações, a ordem em que essas associações são especificadas é importante. A primeira é considerada a associação primária; todas as outras são secundárias. Quando um curso tiver que determinar quais configurações de ferramenta do nó honrar, ele buscará pela associação primária.

Nota

Se o curso já existir (por exemplo, se esta for uma atualização para um curso existente), a diretriz acima apagará qualquer uma das associações de nós atuais de um curso antes de criar as novas.

Edite os atributos e valores relevantes no código acima com os detalhes da associação.

Elemento/atributo

Obrigatório

Descrição

relationship

Não

Indica o nó pai (contexto de aprendizagem) do curso ou nó que está sendo adicionado.

OBSERVAÇÃO: Isso substitui a linha de comando e a configuração padrão inserida na interface de configurações de administração.

relation

Não

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

relacionamento.sourcedid

Sim

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

label

Sim

Descreve o relacionamento.

OBSERVAÇÃO: Embora este seja um campo obrigatório, uma referência de elemento vazio pode ser usada se não houver valor para rótulo, como visto no exemplo.