XML do Snapshot
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.
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.
|
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:
O typevalue para o Vista Enterprise deve ser um dos seguintes:
|
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. |