Você pode usar uma série de arquivos XML para importar metas para o Blackboard Learn. Crie um arquivo XML para cada conjunto de metas, compacte os arquivos XML juntos e carregue o pacote.
Não use a função "compactar" nativa em um Mac para criar um arquivo ZIP para importar metas. Em vez disso, use o comando compress no Terminal.
Um arquivo XML não pode conter mais de um conjunto de metas. Você pode ter um número ilimitado de categorias e metas dentro desse conjunto.
Cada arquivo contém estas informações:
- Informações de conjunto de metas.
- Informações de categoria. É necessário duplicar e editar esse código para cada categoria do conjunto de objetivos. Copie e cole esse código em uma linha antes da linha </standard_document> no final do arquivo.
- Informações dos objetivos. É necessário duplicar e editar esse código para cada objetivo da categoria. Copie e cole esse código em uma linha antes da linha </standard> próxima do final do arquivo.
Carregar arquivos
No Painel do administrador, seção Ferramentas e utilitários, selecione Metas. Na página Metas, posicione o ponteiro do mouse sobre Adicionar conjunto de metas para acessar o menu e selecione Importar conjunto de metas. O Blackboard Learn processará todos os arquivos imediatamente.
Modelo XML de um conjunto de objetivos, incluindo categorias e objetivos
<?xml version="1.0" encoding="UTF-8"?>
uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
ENTER FULL TEXT OF GOAL SOURCE HERE.
ENTER GOAL SET NAME HERE
ENTER FULL TEXT OF GOAL SET TYPE HERE
code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE
ENTER FULL TEXT OF CATEGORY NAME HERE
stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE
Exemplo
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Physics Lab Goals
Introductory Goals
The Measurement Category
Measurement
learn how to use a micrometer
understand the uncertainty in measurements
The Lab Notebook Category
Lab Notebooks
record lab results in detail
Outros exemplos
Para encontrar outros exemplos de arquivos XML, faça logon no Behind the Blackboard e acesse o Artigo nº 13668, “Documentos padrão do Blackboard Learn e CE/Vista.”
Descrições de elemento/atributo
Edite os atributos e valores relevantes no modelo.
| Elemento/atributo | Descrição |
|---|---|
| standard_document | O elemento <standard_document> descreve as propriedades do conjunto de metas. É necessário que exista um (e somente um) elemento <standard_document> no arquivo. |
| year | O ano em formato AAAA. Por exemplo, "2013". |
| revision_date | A data e a hora da revisão, usando o formato AAAA-MM-DD HH:MM:SS. Por exemplo, "2013-12-20 13:40:00". |
| uid | O código do documento. Não use mais de 37 caracteres. Não use espaços. |
| uid_provider | Um identificador de dois caracteres para o provedor do conjunto de metas. Por exemplo, "PS". |
| status | Um valor de status de um caractere. Esse elemento é opcional. Se presente, será uma destas opções:
Esse valor é substituído pela escolha do botão Status na interface ao importar o arquivo XML. |
| editable | "verdadeiro" ou "falso". Esse elemento é opcional. Se for "true", o conjunto de metas poderá ser editado na interface do usuário. Se for "false", ele não poderá ser editado (exceção feita à configuração de itens como ativos, inativos ou restritos). |
| organization | O elemento <organization> descreve a organização que é a origem da meta. É necessário que exista um (e somente um) elemento <organization> no arquivo. Substitua o texto do espaço reservado "DIGITE AQUI O TEXTO COMPLETO DA ORIGEM DO OBJETIVO". Por exemplo, substitua-o por "Blackboard College". |
| org_code | Um identificador da origem. Ele pode ter até 256 caracteres. Por exemplo, "BB". |
| country_code | Um identificador de dois caracteres para o país da origem. Por exemplo, "US". |
| subject | O elemento <subject> especifica o nome do conjunto de metas. É necessário que exista um (e somente um) elemento <subject> no arquivo. Substitua o texto do espaço reservado "DIGITE AQUI O NOME DO CONJUNTO DE OBJETIVOS". Por exemplo, substitua-o por "Metas do laboratório de física". Esse nome será exibido na interface do usuário nos seguintes locais:
|
| code | Um identificador do conjunto de metas. Não use mais de cinco caracteres. Não use espaços. |
| document_set | O elemento <document_set> descreve o tipo do conjunto de metas. É necessário que exista um (e somente um) elemento <document_set> no arquivo. Substitua o texto do espaço reservado "DIGITE AQUI O TEXTO COMPLETO DO TIPO DE CONJUNTO DE OBJETIVOS". Não use mais de 101 caracteres. Por exemplo, substitua-o por "Metas introdutórias". Esse texto será exibido na interface do usuário nos seguintes locais:
|
| uid | Um identificador do tipo de conjunto de metas. Não use espaços. |
| grade_range | O elemento <grade_range> descreve uma categoria. É necessário que exista um ou mais elementos <grade_range> no arquivo. O número de elementos <grade_range> deve corresponder ao número de elementos <standard>. Substitua o texto do espaço reservado "INSIRA O TEXTO COMPLETO DO NOME DA CATEGORIA AQUI". Não use mais de 101 caracteres. Esse texto não será exibido na interface do usuário. |
| lo, hi | Especificadores dos locais mais baixos e mais altos em que essa categoria deve aparecer na lista. Geralmente, são usados para substituir a alfabetização padrão de categorias. Por exemplo, estas linhas forçam a categoria "Jardim de infância" para o topo da lista: Kindergarten |
| code | Um identificador da categoria. Não use espaços. Isso precisa ser correspondente a um atributo code em um dos elementos <grade_range_ref>. Isso é usado para vincular o elemento <grade_range> ao elemento <grade_range_ref>. |
| standard | O elemento <standard> descreve o conjunto de metas de uma categoria. É necessário que exista um ou mais elementos <standard> no arquivo. O número de elementos <standard> deve corresponder ao número de elementos <grade_range>. |
| uid | Um identificador das metas. Por exemplo, "001". Cada <standard> deve ter um código exclusivo. Esse código será exibido na interface do usuário no campo Código exclusivo na tela Editar meta. |
| title | O título da categoria. Por exemplo, "Medição". É necessário que exista um (e somente um) elemento <title> em cada elemento <standard> no arquivo. Esse título será exibido na interface do usuário nos seguintes locais:
|
| grade_range_ref | O elemento <grade_range_ref> vincula o conjunto de metas à categoria. É necessário que exista um (e somente um) elemento <grade_range_ref> dentro de cada elemento <standard> no arquivo. |
| code | Insira o atributo code do elemento <grade_range> para a categoria correspondente. |
| item | O elemento <item> descreve uma meta. É necessário que exista um ou mais elementos <item> dentro de cada elemento <standard> no arquivo. |
| uid | Um identificador exclusivo da meta. Não use mais de 257 caracteres. |
| parent_uid | O código da meta pai. Se não existir meta pai, exclua o texto do espaço reservado e deixe o atributo em branco. |
| label | O tipo de meta. Por exemplo, "Tipo de instrumentação". Esse texto é exibido na interface do usuário, na lista expansível Tipo de meta da tela Descobrir metas. |
| linkable | Uma destas:
Metas restritas só ficam visíveis para cursos que estão explicitamente associados à categoria. Na tela Metas, essas metas apresentam um ícone de seta ao lado delas para mostrar que podem ser abertas em uma nova janela. Para associar um curso a uma categoria, abra um menu de categoria e escolha Associar a cursos. |
| stem | O texto de introdução da meta. Por exemplo, "O aluno:". Se não houver um texto de introdução, exclua o texto do espaço reservado e deixe o atributo em branco. Esse texto será exibido na interface do usuário nos seguintes locais:
|
| doc_num | O identificador da meta. Por exemplo, "MEASURE_001". Não use mais de 101 caracteres. Se você não quiser que um código de meta seja exibido, exclua o texto do espaço reservado e deixe esse atributo em branco. Esse texto será exibido na interface do usuário nos seguintes locais:
|
Esquema
Veja abaixo um esquema XML para esses arquivos XML:
<?xml version="1.0" encoding="UTF-8"?>
http://www.w3.org/2001/XMLSchema">
Como esses arquivos afetam a interface do usuário
Os diagramas abaixo mostram como os itens do arquivo XML são exibidos na interface do usuário.
As imagens estão disponíveis somente em inglês.
A tela Metas
Este diagrama mostra como o arquivo XML mapeia os itens na tela Metas.
A tela Editar meta
Este diagrama mostra como o arquivo XML mapeia os itens na tela Editar meta. Essa tela aparecerá se você abrir o menu à direita de uma meta na tela Metas e escolher Editar meta. O comando Editar meta não estará disponível se o atributo editable no elemento <standard_document> for definido como "falso".
A tela Editar conjunto de metas
Este diagrama mostra como o arquivo XML mapeia os itens na tela Editar conjunto de metas. Esta tela será exibida se você abrir o menu à direita de uma meta definida na tela Metas e escolher Editar.) Os campos Definir nome e Definir arquivos de tipo não serão editáveis se o atributo editable no elemento <standard_document> for definido como "falso".)
A tela Conteúdo
Este diagrama mostra como o arquivo XML mapeia os itens na tela Conteúdo.
A tela Descobrir metas
Este diagrama mostra como o arquivo XML mapeia os itens na tela Descobrir metas. Essa tela aparecerá quando você escolher Adicionar alinhamentos na tela Conteúdo.
Excluir itens
Não é possível excluir itens carregando novos arquivos. Para excluir itens, use a interface do usuário.
Adicione e substitua itens
A maneira mais simples de adicionar ou substituir itens é excluir os itens existentes (por meio da interface do usuário) e, em seguida, carregar um arquivo que contenha as informações atualizadas.
Caso você precise adicionar ou substituir itens sem usar a interface do usuário, as seções abaixo descrevem o processo.
A hierarquia de UIDs
- O conjunto de UIDs para cada meta (em outras palavras, o conjunto de UIDs para <standard_document>, <document_set>, <standard> e <item>) deve ser exclusivo em todos os arquivos.
- Esses UIDs formam uma hierarquia:
- <standard_document>
- <document_set>
- <standard>
- <item>
O UID do elemento <standard> também interage com o atributo code do elemento <grade_range>, conforme descrito abaixo.
Adicionar novos itens
Para adicionar novos itens, ou substituir itens antigos, mantenha os itens mais altos na hierarquia da mesma forma e use UIDs diferentes para itens mais baixos na hierarquia.
Exemplo
- Digamos que você carregue um arquivo com os atributos a seguir. Essa ação criará um conjunto de objetivos, uma categoria e um objetivo.
<standard_
document>
UID<document_set>
UID<grade_range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
">Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Se, em seguida, você carregar um arquivo com os atributos a seguir, essa ação criará uma nova categoria e um novo objetivo.
<standard_
document>
UID<document_set>
UID<grade_range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_A">Category A
STANDARD_A">
Category A
ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Se mudar o UID do elemento <standard>, você também deverá mudar o atributo code do elemento <grade_range>. Se você mudar apenas o UID do elemento <standard>, a importação falhará.
- Se, em seguida, você carregar um arquivo com os mesmos atributos, mas com um conteúdo diferente, a declaração do objetivo será atualizada.
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Goal Set 1
Goal Set Type 1
Category A
Category A
This is the new goal.
Altere nomes
Se você carregar informações com o mesmo conjunto de UIDs, mas com diferentes atributos code, os itens serão renomeados.
Exemplo
- Digamos que você carregue um arquivo com os atributos a seguir. Essa ação criará um conjunto de objetivos, uma categoria e um objetivo.
<standard_
document>
UID<subject>
CODE<document_
set>
UID<grade_
range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_1">Goal Set 1
Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Se, em seguida, você carregar um arquivo com os atributos a seguir, o conjunto de objetivos será renomeado (de "Conjunto de objetivos 1" para "Conjunto de objetivos B").
<standard_
document>
UID<subject>
CODE<document_
set>
UID<grade_
range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_B">Goal Set B
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Este procedimento também funciona para renomear o atributo code do elemento <grade_range>.
Adicionar ou alterar itens mais altos na hierarquia
Você receberá uma mensagem de erro e os arquivos não serão carregados se os UIDs dos elementos mais baixos na hierarquia já tiverem sido usados com UIDs diferentes para elementos mais altos na hierarquia.
Exemplo
- Digamos que você carregue um arquivo com os atributos a seguir. Essa ação criará um conjunto de objetivos, uma categoria e um objetivo.
<standard_
document>
UID<document_
set>
UID<grade_
range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Se, em seguida, você tentar carregar um arquivo com os atributos a seguir, o carregamento apresentará falha.
<standard_
document>
UID<document_
set>
UID<grade_
range>
CODE<standard>
UID<item>
UIDSTANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Se você quiser adicionar ou alterar itens mais altos da hierarquia, será necessário usar UIDs diferentes para itens mais baixos da hierarquia.
