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 ao 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"?>
<!-- Define a goal set -->
<!-- Create a separate XML file for each goal set -->
<standard_document year="ENTER RELEVANT YEAR HERE" revision_date="ENTER REVISION DATE AND TIME HERE" uid="ENTER DOCUMENT ID HERE. Do not uses spaces."
   uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
   
   <!-- Define the organization that is the source for this goal set -->
   <organization org_code="ENTER A SOURCE CODE HERE (UP TO 256 CHARACTERS)" country_code="US">
      ENTER FULL TEXT OF GOAL SOURCE HERE.
   </organization>
   
   <!-- Define the name of the goal set -->
   <subject code="ENTER ID FOR GOAL SET HERE. Do not use spaces.">
      ENTER GOAL SET NAME HERE</subject>
   
   <!-- Define the goal set type -->
   <document_set uid="ENTER ID FOR GOAL SET TYPE HERE. Do not use spaces.">
      ENTER FULL TEXT OF GOAL SET TYPE HERE</document_set>
   
   <!-- Define the categories -->
   <!-- Create one <grade_range&gt; element and one <standard&gt; element for each category -->
   <grade_range lo="ENTER LOWEST POSITION IN CATEGORY LIST" hi="ENTER HIGHEST POSITION IN CATEGORY LIST"
      code="ENTER ID FOR CATEGORY HERE. Do not use spaces.">ENTER FULL TEXT OF CATEGORY NAME HERE</grade_range>
   <standard uid="ENTER ID FOR CATEGORY HERE. Do not use spaces.">
      <title>ENTER FULL TEXT OF CATEGORY NAME HERE</title>
      <grade_range_ref code="ENTER CATEGORY ID HERE"/>
      
      <!-- Define the Goals -->
      <!-- Create one <item&gt; element for each goal in the category -->
      <item uid="ENTER UNIQUE ID OF GOAL HERE. Do not use spaces." parent_uid="ENTER ID OF PARENT GOAL HERE OR LEAVE BLANK" label="ENTER FULL TEXT OF GOAL TYPE HERE" linkable="ENTER Y OR N"
         stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
         <statement>ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE</statement>
      </item>
   </standard>
   
</standard_document>

Exemplo

<?xml version="1.0" encoding="UTF-8"?>
<standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="PHYS101" uid_provider="PS" status="A" editable="true">
   <organization org_code="BB" country_code="US">Blackboard College</organization>
   <subject code="PHYSLAB01">Physics Lab Goals</subject>
   <document_set uid="INTRO">Introductory Goals</document_set>
   
   <grade_range lo="1" hi="1" code="MEASURE">The Measurement Category</grade_range>
   <standard uid="1">
      <title>Measurement</title>
      <grade_range_ref code="MEASURE"/>
      <item uid="001" parent_uid="" label="Instrumentation Type" linkable="Y" stem="The student will:" doc_num="MEASURE_001">
         <statement>learn how to use a micrometer</statement>
      </item>
      <item uid="002" parent_uid="001" label="Instrumentation Type" linkable="N" stem="The student will:" doc_num="MEASURE_002">
         <statement>understand the uncertainty in measurements</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="NOTEBOOK">The Lab Notebook Category</grade_range>
   <standard uid="2">
      <title>Lab Notebooks</title>
      <grade_range_ref code="NOTEBOOK"/>
      <item uid="003" parent_uid="" label="Documentation Type" linkable="Y" stem="The student will:" doc_num="NOTE_001">
         <statement>record lab results in detail</statement>
      </item>
   </standard>
</standard_document>

Outros exemplos

Para encontrar outros exemplos de arquivos XML, faça login 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/atributoDescrição
standard_documentO elemento <standard_document> descreve as propriedades do conjunto de objetivos. É necessário que exista um, e somente um, elemento <standard_document> no arquivo.
yearO ano em formato AAAA. Por exemplo, "2013".
revision_dateA data e a hora da revisão, usando o formato AAAA-MM-DD HH:MM:SS. Por exemplo, "2013-12-20 13:40:00".
uidO ID do documento. Não use mais de 37 caracteres. Não use espaços.
uid_providerUm identificador de dois caracteres para o provedor do conjunto de metas. Por exemplo, "PS".
statusUm 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).
organizationO elemento <organization> descreve a organização que é a origem do objetivo. É 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_codeUm identificador da origem. Ele pode ter até 256 caracteres. Por exemplo, "BB".
country_codeUm identificador de dois caracteres para o país da origem. Por exemplo, "US".
subjectO elemento <subject> especifica o nome do conjunto de objetivos. É 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.
codeUm identificador do conjunto de metas. Não use mais de cinco caracteres. Não use espaços.
document_setO elemento <document_set> descreve o tipo de conjunto de objetivos. É 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.
uidUm identificador do tipo de conjunto de metas. Não use espaços.
grade_rangeO 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, hiEspecificadores 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:

<grade_range lo="1" hi="1" code="K">Kindergarten</grade_range>
<grade_range lo="2" hi="2" code="1">Grade 1</grade_range>
<grade_range lo="3" hi="3" code="2">Grade 2</grade_range>
<grade_range lo="4" hi="4" code="3">Grade 3</grade_range>
<grade_range lo="5" hi="5" code="4">Grade 4</grade_range>

codeUm identificador da categoria. Não use espaços.

Precisa corresponder a um atributo code em um dos elementos <grade_range_ref>. É usado para vincular o elemento <grade_range> ao elemento <grade_range_ref>.

standardO elemento <standard> descreve o conjunto de objetivos 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>.

uidUm identificador das metas. Por exemplo, "001". Cada <standard> deve possuir um código exclusivo.

Esse código será exibido na interface do usuário no campo Código exclusivo na tela Editar meta.

titleO 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_refO elemento <grade_range_ref> vincula o conjunto de objetivos à categoria. É necessário que exista um, e somente um, elemento <grade_range_ref> dentro de cada elemento <standard> no arquivo.
codeInsira o atributo code do elemento <grade_range> para a categoria correspondente.
itemO elemento <item> descreve um objetivo. É necessário que exista um ou mais elementos <item> dentro de cada elemento <standard> no arquivo.
uidUm identificador exclusivo da meta. Não use mais de 257 caracteres.
parent_uidO ID da meta pai. Se não existir meta pai, exclua o texto do espaço reservado e deixe o atributo em branco.
labelO 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.
linkableUma 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.

stemO 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_numO 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"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- ================================== -->
    <!-- Documento padrão -->
    <xs:element name="standard_document">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="organization"/>
                <xs:element ref="subject"/>
                <xs:element ref="document_set"/>
                <xs:element ref="grade_range" maxOccurs="unbounded"/>
                <xs:element ref="standard" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="year" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d"/>
                        <!-- Por exemplo, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- Por exemplo, "PS" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\S{1,37}"/>
                        <!-- Por exemplo, "PHYS101" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="status" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="A"/>
                        <xs:enumeration value="I"/>
                        <xs:enumeration value="R"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="revision_date" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d"/>
                        <!-- Por exemplo, "2014-01-30 09:15:00" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="editable" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="true"/>
                        <xs:enumeration value="false"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Organização -->
    <xs:element name="organization">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="org_code" type="ST_256-character_code" use="required"/>
                    <xs:attribute name="country_code" type="ST_two-character_code" use="required"/>
                </xs:extension>
                <!-- Por exemplo, "Blackboard College" -->
                <!-- Por exemplo, "BB" -->
                <!-- Por exemplo, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Assunto -->
    <xs:element name="subject">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="code" use="required">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:pattern value="\S{1,5}"/>
                                <!-- Por exemplo, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- Por exemplo, "Objetivos do laboratório de física" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Conjunto de documentos -->
    <xs:element name="document_set">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="uid" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Por exemplo, "Objetivos introdutórios" -->
                <!-- Por exemplo, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Intervalo de notas -->
    <xs:element name="grade_range">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="lo" type="xs:integer" use="required"/>
                    <xs:attribute name="hi" type="xs:integer" use="required"/>
                    <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Por exemplo, "Categoria de medição" -->
                <!-- Por exemplo, "1" -->
                <!-- Por exemplo, "1" -->
                <!-- Por exemplo, "NOTEBOOK" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Padrão -->
    <xs:element name="standard">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="title"/>
                <xs:element ref="grade_range_ref"/>
                <xs:element ref="item" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_non_blank_string" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Título -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- Por exemplo, "Notebooks de laboratório" -->
    <!-- ================================== -->
    <!-- Referência de intervalo de notas -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Item -->
    <xs:element name="item">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="statement"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_goal_uid" use="required"/>
            <xs:attribute name="stem" type="xs:string" use="required"/>
            <xs:attribute name="parent_uid" type="ST_parent_goal_uid" use="required"/>
            <xs:attribute name="linkable" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="N"/>
                        <xs:enumeration value="Y"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="label" type="ST__string" use="required"/>
            <xs:attribute name="doc_num" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value=".{0,101}"/>
                        <!-- 0 a 101 caracteres -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- Por exemplo, "O aluno irá:" ou em branco -->
            <!-- Por exemplo, "Tipo de instrumentação" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Declaração -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- Por exemplo, "compreenda a incerteza nas medidas" -->
    <!-- ================================== -->
    <!-- Tipos de dados simples -->
    <!-- ================================== -->
    <!-- Cadeia de caracteres sem espaços -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Código de dois caracteres -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Código de 256 caracteres -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- UIDs de objetivos -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- 1 a 257 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- 0 a 257 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Não mais que 101 caracteres -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- 1 a 101 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Cadeia de caracteres não em branco -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- Pelo menos 1 caractere -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Cadeia de caracteres possivelmente em banco -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Pode estar em branco -->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>


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> estiver 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. Essa tela aparecerá se você abrir o menu à direita de uma meta na tela Metas e escolher Editar. Os campos Definir nome e Definir tipo não poderão ser editados se o atributo editable no elemento <standard_document> estiver 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 objetivo (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_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1span>">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  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_1DOCS_SET_1CATEGORY_ASTANDARD_AITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

    Se você alterar o UID do elemento <standard>, terá que alterar também o atributo code do elemento <grade_range>. Se você alterar apenas o UID do elemento <standard>, a importação apresentará falha.

  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"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the new goal.</statement>
          </item>
       </standard>
    </standard_document>

Altere nomes

Se você carregar informações com o mesmo conjunto de UIDs, mas com atributos de code diferentes, 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_1SUBJECT_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  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_1SUBJECT_BDOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_B">Goal Set B</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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_1DOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  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_CDOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

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