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 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 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="INSIRA O CÓDIGO DO PROVEDOR DE DOIS CARACTERES AQUI" status="INSIRA A, I ou R" editable="INSIRA VERDADEIRO OU FALSO">
   
   
   
      INSIRA O TEXTO COMPLETO DA ORIGEM DA META AQUI.
   
   
   
   
      INSIRA O NOME DO CONJUNTO DE METAS AQUI
   
   
   
      INSIRA O TEXTO COMPLETO DO TIPO DO CONJUNTO DE METAS AQUI
   
   
   
          code="INSIRA O CÓDIGO DA CATEGORIA AQUI. Não use espaços.">INSIRA O TEXTO COMPLETO DO NOME DA CATEGORIA AQUI
   
      INSIRA O TEXTO COMPLETO DO NOME DA CATEGORIA AQUI
      
      
      
      
                stem="INSIRA QUALQUER TEXTO INICIAL PARA A META AQUI OU DEIXE EM BRANCO" doc_num="INSIRA O CÓDIGO DA META AQUI OU DEIXE EM BRANCO">
         INSIRA O TEXTO COMPLETO DA DECLARAÇÃO DE META AQUI
      
   
   

Exemplo

<?xml version="1.0" encoding="UTF-8"?>

   Blackboard College
   Metas do laboratório de física
   Metas introdutórias
   
   A categoria de medição
   
      Medição
      
      
         aprender como utilizar um micrômetro
      
      
         entender a incerteza nas medições
      
   
   
   A categoria de notebook do laboratório
   
      Notebooks do laboratório
      
      
         registrar os resultados do laboratório detalhadamente
      
   

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 descreve as propriedades do conjunto de metas. É necessário que exista um (e somente um) elemento 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 ID 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 descreve a organização que é a origem da meta. É necessário que exista um (e somente um) elemento 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 especifica o nome do conjunto de metas. É necessário que exista um (e somente um) elemento 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 descreve o tipo do conjunto de metas. É necessário que exista um (e somente um) elemento 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 descreve uma categoria. É necessário que exista um ou mais elementos no arquivo. O número de elementos deve corresponder ao número de elementos .

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
Nota 1
Nota 2
Nota 3
Nota 4

code Um identificador da categoria. Não use espaços.

Isso precisa ser correspondente a um atributo code em um dos elementos . Isso é usado para vincular o elemento ao elemento .

standard O elemento descreve o conjunto de metas de uma categoria.

É necessário que exista um ou mais elementos no arquivo. O número de elementos deve corresponder ao número de elementos .

uid Um identificador das metas. Por exemplo, "001". Cada 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 em cada elemento 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 vincula o conjunto de metas à categoria. É necessário que exista um (e somente um) elemento dentro de cada elemento no arquivo.
code Insira o atributo code do elemento para a categoria correspondente.
item O elemento descreve uma meta. É necessário que exista um ou mais elementos dentro de cada elemento no arquivo.
uid Um identificador exclusivo da meta. Não use mais de 257 caracteres.
parent_uid O ID 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 ID 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 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 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 , , e ) deve ser exclusivo em todos os arquivos.
  • Esses UIDs formam uma hierarquia:

O UID do elemento também interage com o atributo code do elemento , 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.
    document>
    UID

    UID

    CODE

    UID

    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
       ">Conjunto de metas 1
       DOC_SET_1">Tipo do conjunto de metas 1
       CATEGORY_1">Categoria 1
       STANDARD_1">
          Categoria 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             Esta é a meta.
          
       

  2. Se, em seguida, você carregar um arquivo com os atributos a seguir, essa ação criará uma nova categoria e um novo objetivo.
    document>
    UID

    UID

    CODE

    UID

    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
       Conjunto de metas 1
       DOC_SET_1">Tipo do conjunto de metas 1
       CATEGORY_A">Categoria A
       STANDARD_A">
          Categoria A
          
          ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             This is the goal.
          
       

    Se mudar o UID do elemento , você também deverá mudar o atributo code do elemento . Se você mudar apenas o UID do elemento , 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
       Conjunto de metas 1
       Tipo do conjunto de metas 1
       Categoria A
       
          Categoria 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.
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    UID

    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
       Tipo do conjunto de metas 1
       CATEGORY_1">Categoria 1
       STANDARD_1">
          Categoria 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             Esta é a meta.
          
       

  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").
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    UID

    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">Tipo do conjunto de metas 1
       CATEGORY_1">Categoria 1
       STANDARD_1">
          Categoria 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             Esta é a meta.
          
       

Este procedimento também funciona para renomear o atributo code do elemento .

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.
    document>
    UID
    set>
    UID
    range>
    CODE

    UID

    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
       Conjunto de metas 1
       DOC_SET_1">Tipo do conjunto de metas 1
       CATEGORY_1">Categoria 1
       STANDARD_1">
          Categoria 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             Esta é a meta.
          
       

  2. Se, em seguida, você tentar carregar um arquivo com os atributos a seguir, o carregamento apresentará falha.
    document>
    UID
    set>
    UID
    range>
    CODE

    UID

    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
       Conjunto de metas 1
       DOC_SET_1">Tipo do conjunto de metas 1
       CATEGORY_1">Categoria 1
       STANDARD_1">
          Categoria 1
          
          ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             Esta é a meta.
          
       

Se você quiser adicionar ou alterar itens mais altos da hierarquia, será necessário usar UIDs diferentes para itens mais baixos da hierarquia.