Importar metas

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:

  1. Informações de conjunto de metas.
  2. 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.
  3. 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:
  • A – (ativo) O conjunto de metas está disponível para todos os cursos.
  • I – (inativo) O conjunto de metas não está disponível para nenhum curso.
  • R – (restrito) O conjunto de metas só está visível para os cursos explicitamente alinhados à categoria. (Para alinhar um curso a uma categoria, use o menu próximo da categoria e escolha Associar a cursos.)

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:

  1. Na coluna Conjunto de metas na tela Metas.
  2. No campo Definir nome, tela Editar Conjunto de metas.
  3. Na coluna Nome do conjunto de metas, tela Conteúdo.
  4. Na coluna Conjunto de metas e na lista expansível Conjunto de metas da tela Descobrir metas.
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:

  1. No campo Definir tipo na tela Editar conjunto de metas.
  2. Na lista expansível Tipo de Conjunto de metas, tela Descobrir metas.
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
Grade 1
Grade 2
Grade 3
Grade 4

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:

  1. Na coluna Categoria na tela Metas.
  2. Na coluna Categoria, tela Conteúdo.
  3. Na lista expansível Categoria, tela Descobrir metas.
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:
  • Y – a meta não será restrita.
  • N – a meta será restrita.

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:

  1. Na coluna Metas, na tela Metas.
  2. Na coluna Meta, tela Descobrir metas.
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:

  1. Na coluna Metas, na tela Metas.
  2. No campo Código da meta, tela Editar meta.
  3. Na coluna ID, tela Conteúdo.
  4. Na lista Meta, tela Descobrir metas.

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

  1. 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>
    UID
    STANDARD_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.
          
       

  2. 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>
    UID
    STANDARD_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á.

  3. 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

  1. 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>
    UID
    STANDARD_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.
          
       

  2. 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>
    UID
    STANDARD_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

  1. 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>
    UID
    STANDARD_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.
          
       

  2. 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>
    UID
    STANDARD_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.