Importar metas

Você pode usar uma série de arquivos XML para importar metas para o Blackboard. Crie um arquivo XML para cada conjunto de metas, compacte os arquivos XML juntos e carregue o pacote.

Um arquivo XML não pode conter mais de um conjunto de metas. Você pode ter um número ilimitado de categorias e metas emsse conjunto.

Cada arquivo contém estas informações:

No Painel do administrador, seção Ferramentas e utilitários, clique em Metas. Na página Metas, posicione o ponteiro do mouse sobre Adicionar conjunto de metas para acessar o menu e clique em Importar conjunto de metas. O Blackboard processará todos os arquivos de uma vez.

<?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> element and one <standard> 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> 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>

<?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>

Você pode encontrar outros exemplos de arquivos XML acessando o Portal de Suporte a Anthology e acessando o Artigo Número 64730, "Documentos de Padrões Estaduais (Conjuntos de Metas)".

Edite os atributos e valores relevantes no modelo.

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

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">
    <!-- ================================== -->
    <!-- Standard Document -->
    <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"/>
                        <!-- For example, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- For example, "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}"/>
                        <!-- For example, "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"/>
                        <!-- For example, "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>
    <!-- ================================== -->
    <!-- Organization -->
    <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>
                <!-- For example, "Blackboard College" -->
                <!-- For example, "BB" -->
                <!-- For example, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Subject -->
    <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}"/>
                                <!-- For example, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- For example, "Physics Lab Goals" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Document Set -->
    <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>
                <!-- For example, "Introductory Goals" -->
                <!-- For example, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Grade Range -->
    <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>
                <!-- For example, "The Measurement Category" -->
                <!-- For example, "1" -->
                <!-- For example, "1" -->
                <!-- For example, "NOTEBOOK" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Standard -->
    <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>
    <!-- ================================== -->
    <!-- Title -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- For example, "Lab Notebooks" -->
    <!-- ================================== -->
    <!-- Grade Range Ref -->
    <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 to 101 characters -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- For example, "The student will:" or blank -->
            <!-- For example, "Instrumentation Type" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Statement -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- For example, "understand the uncertainty in measurements" -->
    <!-- ================================== -->
    <!-- Simple Data Types -->
    <!-- ================================== -->
    <!-- String with no spaces -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Two-character code -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- 256-character code -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Goal UIDs -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- 1 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- 0 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- No more than 101 characters -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- 1 to 101 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Non-blank string -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- At least 1 character -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Possibly blank string -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Can be empty-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>

Os diagramas abaixo mostram como os itens do arquivo XML são exibidos na interface do usuário.

Este diagrama mostra como o arquivo XML mapeia os itens na tela Metas.

Este diagrama mostra como o arquivo XML mapeia os itens na tela Editar meta. Essa tela será exibida se você abrir o menu à direita de uma meta na tela Metas e escolher Editar meta. O comando Editar Meta não está disponível se o atributo editável no elemento <standard_document> estiver definido como "falso".

Este diagrama mostra como o arquivo XML mapeia os itens na tela Editar conjunto de metas. Essa tela é exibida se você abrir o menu à direita de um conjunto de metas na tela de Gols e escolher Editar.) Os campos Set Name e Set Type não são editáveis se o atributo editável no elemento <standard_document> estiver definido como "falso").

Este diagrama mostra como o arquivo XML mapeia os itens na tela Conteúdo.

Este diagrama mostra como o arquivo XML mapeia os itens na tela Descobrir metas. Essa tela será exibida quando você escolher Adicionar alinhamentos na tela Conteúdo.

Não é possível excluir itens carregando novos arquivos. Para excluir itens, use a interface do usuário.

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.

O UID do elemento <padrão> também interage com o atributo código do elemento <grade_range>, conforme descrito abaixo.

Você pode adicionar novos itens ou substituir itens antigos mantendo os itens mais altos na hierarquia iguais e usando UIDs diferentes para itens que estão mais baixos na hierarquia.

Se você enviar informações com o mesmo conjunto de códigos de identificação do lote, mas com atributos código diferentes, os itens serão renomeados.

Esse procedimento também funciona para renomear o atributo código do elemento <grade_range>.

Você receberá um erro, e o arquivo não será enviado se os UIDs de elementos que estão mais abaixo na hierarquia já forem usados, mas com UIDs diferentes para elementos mais altos na hierarquia.

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