استيراد الأهداف

يمكنك استخدام سلسلة من ملفات XML لاستيراد الأهداف من Blackboard Learn. أنشئ ملف XML لكل مجموعة أهداف، واضغط ملفات XML معًا، وقم بتحميل الحزمة.

لا تستخدم الوظيفة "compress" (ضغط) المحلية على نظام Mac لإنشاء ملف ZIP لاستيراد أهدافك. استخدم الأمر compress في الوحدة الطرفية بدلاً من ذلك.

يجب ألا يحتوي ملف XML على أكثر من مجموعة أهداف واحدة. ويمكنك الحصول على أهداف وفئات غير محدودة داخل مجموعة الأهداف.

يحتوي كل ملف على هذه المعلومات:

  1. معلومات مجموعة الأهداف.
  2. معلومات الفئة. يجب تحرير هذا الرمز وتكراره مع كل فئة موجودة في مجموعة الأهداف. انسخ هذه التعليمة البرمجية والصقها في سطر قبل السطر </standard_document> في آخر الملف.
  3. معلومات الهدف. يجب تحرير هذا الرمز وتكراره مع كل رمز موجود في مجموعة الأهداف. انسخ هذه التعليمة البرمجية والصقها في سطر قبل السطر</standard> في آخر الملف.

رفع الملفات

في لوحة المسؤولين ضمن قسم الأدوات والأدوات المساعدة، حدد الأهداف. في صفحة الأهداف، قم بتحريك مؤشر الماوس فوق إضافة مجموعة أهداف للوصول إلى القائمة وحدد استيراد مجموعة الأهداف. وسيقوم Blackboard Learn بمعالجة كل الملفات مرة واحدة.

قالب XML لمجموعة الأهداف، بما في ذلك الفئات والأهداف

<?xml version="1.0" encoding="UTF-8"?>
<!-- تحديد مجموعة أهداف -->
<!-- إنشاء ملف XML منفصل لكل مجموعة أهداف -->
<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">
   
   <!-- تحديد المؤسسة التي تمثل مصدرًا لمجموعة الأهداف هذه -->
   <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. لا تستخدم المسافات.">
      ENTER GOAL SET NAME HERE</subject>
   
   <!-- تحديد نوع مجموعة الأهداف -->
   <document_set uid="ENTER ID FOR GOAL SET TYPE HERE. لا تستخدم المسافات.">
      ENTER FULL TEXT OF GOAL SET TYPE HERE</document_set>
   
   <!-- تحديد الفئات -->
   <!-- إنشاء عنصر <grade_range> element واحد وعنصر <standard> واحد لكل فئة -->
   <grade_range lo="ENTER LOWEST POSITION IN CATEGORY LIST" hi="ENTER HIGHEST POSITION IN CATEGORY LIST"
      code="ENTER ID FOR CATEGORY HERE. لا تستخدم المسافات.">ENTER FULL TEXT OF CATEGORY NAME HERE</grade_range>
   <standard uid="ENTER ID FOR CATEGORY HERE. لا تستخدم المسافات.">
      <title>ENTER FULL TEXT OF CATEGORY NAME HERE</title>
      <grade_range_ref code="ENTER CATEGORY ID HERE"/>
      
      <!-- تحديد الأهداف -->
      <!-- إنشاء عنصر <item> واحد لكل هدف في الفئة -->
      <item uid="ENTER UNIQUE ID OF GOAL HERE. لا تستخدم المسافات." 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">أهداف معمل الفيزياء</subject>
   <document_set uid="INTRO">الأهداف الأولية</document_set>
   
   <grade_range lo="1" hi="1" code="MEASURE">فئة القياس</grade_range>
   <standard uid="1">
      <title>القياس</title>
      <grade_range_ref code="MEASURE"/>
      <item uid="001" parent_uid="" label="نوع الأدوات" linkable="Y" stem="الطالب سوف:" doc_num="MEASURE_001">
         <statement>يتعلم كيفية استخدام الميكروميتر</statement>
      </item>
      <item uid="002" parent_uid="001" label="نوع الأدوات" linkable="N" stem="سيقوم الطالب بـ:" doc_num="MEASURE_002">
         <statement>فهم الشك في القياسات</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="NOTEBOOK">فئة كمبيوتر المعمل</grade_range>
   <standard uid="2">
      أجهزة كمبيوتر المعمل</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>تسجيل نتائج المعمل بالتفصيل</statement>
      </item>
   </standard>
</standard_document>

أمثلة أخرى

يمكنك العثور على أمثلة أخرى لملفات XML عن طريق تسجيل الدخول إلى Behind the Blackboard والانتقال إلى المقال رقم 13668, "Blackboard Learn والمستندات القياسية لـ CE/Vista".

أوصاف السمة/العنصر

تحرير السمات والقيم ذات الصلة في القالب.

السمة/العنصر الوصف
standard_document يصف عنصر <standard_document> خصائص مجموعة الأهداف. يجب أن يكون هناك عنصر <standard_document> واحد، وواحد فقط، في الملف.
year تستخدم السنة تنسيق "س س س س". على سبيل المثال، "2013".
revision_date وقت وتاريخ المراجعة باستخدام التنسيق "س س س س-ش ش-ي ي س س:ق ق:ث ث". فعلى سبيل المثال، "2013-12-20 13:40:00".
uid معرف المستند. لا تستخدم أكثر من 37 حرفاً. لا تستخدم المسافات.
uid_provider معرف مكون من حرفين لموفر مجموعة الأهداف. على سبيل المثال "PS".
status قيمة حالة لحرف واحد. هذا العنصر اختياري. في حالة وجوده، يجب أن يكون واحدًا مما يلي:
  • A - (نشط) مجموعة الأهداف متاحة لجميع المقررات الدراسية.
  • I - (غير نشط) مجموعة الأهداف غير متاحة لأي من المقررات الدراسية.
  • R - (مقيد) مجموعة الأهداف مرئية فقط للمقررات الدراسية المقترنة بشكل صريح بالفئة. (لربط المقرر الدراسي بفئة، استخدم القائمة الموجودة بجانب الفئة واختر الارتباط بالمقررات الدراسية.)

يتم تجاوز هذه القيمة عن طريق اختيار الزر الحالة في واجهة المستخدم عند استيراد ملف XML.
editable أما "صواب" أو "خطأ". هذا العنصر اختياري. إذا كان صواب، يمكن تحرير مجموعة الأهداف في واجهة المستخدم. وإذا كان خطأ، لا يمكن تحريره (باستثناء تعيين العناصر لتكون نشطة أو غير نشطة أو مقيدة).
organization يصف العنصر <organization> منتدى المجموعة الذي يعد مصدرًا للهدف. يجب أن يكون هناك عنصر <organization> واحد، وواحد فقط، في الملف.

استبدل نص العنصر النائب “ENTER FULL TEXT OF GOAL SOURCE HERE". على سبيل المثال، استبدله بـ "Blackboard College".
org_code معرف للمصدر. يمكن أن يصل إلى 256 حرفاً. على سبيل المثال: "BB".
country_code معرف مكون من حرفين لدولة المصدر. على سبيل المثال: "US".
subject يحدد العنصر <subject> اسم مجموعة الأهداف. يجب أن يكون هناك عنصر <subject> واحد، وواحد فقط، في الملف.

استبدل نص العنصر النائب "ENTER GOAL SET NAME HERE". على سبيل المثال، استبدله بـ "أهداف معمل الفيزياء".

يظهر هذا الاسم في واجهة المستخدم في الأماكن التالية:

  1. في العمود مجموعة الأهداف على شاشة الأهداف.
  2. في الحقل اسم المجموعة على الشاشة تحرير مجموعة الأهداف.
  3. في العمود اسم مجموعة الأهداف على شاشة المحتوى.
  4. في العمود مجموعة الأهداف والقائمة القابلة للتوسع مجموعة الأهداف على الشاشة اكتشاف الأهداف.
code معرف لمجموعة الأهداف. لا تستخدم أكثر من خمسة أحرف. لا تستخدم المسافات.
document_set يصف عنصر <document_set> نوع مجموعة الأهداف. يجب أن يكون هناك عنصر <document_set> واحد، وواحد فقط، في الملف.

استبدل نص العنصر النائب "ENTER FULL TEXT OF GOAL SET TYPE HERE". لا تستخدم أكثر من 101 حرفاً. على سبيل المثال، استبدله بـ "أهداف تقديمية".

يظهر هذا النص في واجهة المستخدم في الأماكن التالية:

  1. في الحقل نوع المجموعة على الشاشة تحرير مجموعة الأهداف.
  2. في القائمة القابلة للتوسع نوع مجموعة الأهداف على الشاشة اكتشاف الأهداف.
uid معرف لنوع مجموعة الأهداف. لا تستخدم المسافات.
grade_range يصف العنصر <grade_range> إحدى الفئات. يجب أن يكون هناك عنصر <grade_range> واحد أو أكثر في الملف. يجب أن يتطابق عدد عناصر <grade_range> مع عدد عناصر <standard>.

استبدل نص العنصر النائب "ENTER FULL TEXT OF CATEGORY NAME HERE". لا تستخدم أكثر من 101 حرفاً.

لا يظهر هذا النص في واجهة المستخدم.
lo, hi تحديد أقل وأعلى مكانين لظهور هذه الفئة في القائمة.

بشكل تقليدي، يتم الاستخدام لتجاوز الترتيب الأبجدي الافتراضي للفئات. على سبيل المثال، فإن هذه السطور تجبر الفئة "Kindergarten" للتواجد أعلى القائمة.

<grade_range lo="1" hi="1" code="K">روضة أطفال</grade_range>
<grade_range lo="2" hi="2" code="1">المستوى الأول</grade_range>
<grade_range lo="3" hi="3" code="2">المستوى الثاني</grade_range>
<grade_range lo="4" hi="4" code="3">المستوى الثالث</grade_range>
<grade_range lo="5" hi="5" code="4">المستوى الرابع</grade_range>
code معرف للفئة. لا تستخدم المسافات.

يجب أن يتطابق ذلك مع السمة code في أحد عناصر <grade_range_ref>. ويتم استخدام ذلك لربط <grade_range> element with <grade_range_ref> element.
standard يوضح العنصر <standard> مجموعة الأهداف الخاصة بفئة.

يجب أن يكون هناك عنصر <standard> واحد أو أكثر في الملف. يجب أن يتطابق عدد عناصر <standard> مع عدد عناصر <grade_range>.
uid معرف للأهداف. على سبيل المثال، "001". يجب أن يحتوي كل <standard> على معرف فريد.

يظهر المعرف في واجهة المستخدم في الحقل معرف فريد على الشاشة تحرير الهدف.
title عنوان الفئة. على سبيل المثال: "مقياس" يجب أن يكون هناك عنصر <title> واحد، وواحد فقط، في كل عنصر <standard> في الملف.

يظهر هذا العنوان في واجهة المستخدم في الأماكن التالية:

  1. في العمود الفئة على شاشة الأهداف.
  2. في العمود الفئة على شاشة المحتوى.
  3. في القائمة القابلة للتوسع الفئة على شاشة اكتشاف الأهداف.
grade_range_ref يربط العنصر <grade_range_ref> مجموعة الأهداف بالفئة. يجب أن يكون هناك عنصر <grade_range_ref> واحد، وواحد فقط، داخل كل عنصر <standard> في الملف.
code أدخل السمة code للعنصر <grade_range> للفئة المقابلة.
item يوضح العنصر <item> أحد الأهداف. يجب أن يكون هناك عنصر <item> واحد أو أكثر، داخل كل عنصر <standard> في الملف.
uid المعرف الفريد لهذا الهدف. لا تستخدم أكثر من 257 حرفاً.
parent_uid مُعرف الهدف الأصل. في حالة عدم وجود هدف أصل، احذف نص العنصر النائب واترك هذه السمة فارغة.
label نوع الهدف. على سبيل المثال، "Instrumentation Type": يظهر هذا النص في واجهة المستخدم في القائمة القابلة للتوسع نوع الهدف على الشاشة اكتشاف الأهداف.
linkable واحدًا مما يلي:
  • Y - لن يتم تقييد الهدف.
  • N - سيتم تقييد الهدف.

تظهر الأهداف المقيدة فقط للمقررات الدراسية التي تقترن بشكل صريح بالفئة. في الشاشة Goals (أهداف)، يوجد رمز سهم بجوار هذه الأهداف للدلالة على إمكانية فتحها في إطار جديد. (لربط المقرر الدراسي بفئة، افتح قائمة الفئة واختر Associate to Courses (الارتباط بمقررات دراسية).)
stem النص الاستهلالي للهدف. على سبيل المثال، "سيقوم الطالب بـ:". في حالة عدم وجود نص استهلالي، احذف نص العنصر النائب واترك هذه السمة فارغة.

يظهر هذا النص في واجهة المستخدم في الأماكن التالية:

  1. في العمود الأهداف على شاشة الأهداف.
  2. في العمود الهدف على شاشة اكتشاف الأهداف.
doc_num معرف الهدف على سبيل المثال، "MEASURE_001". لا تستخدم أكثر من 101 حرفاً. وفي حالة عدم رغبتك في ظهور مُعرف الهدف، قم بحذف نص العنصر النائب واترك هذه السمة فارغة.

يظهر هذا النص في واجهة المستخدم في الأماكن التالية:

  1. في العمود الأهداف على شاشة الأهداف.
  2. في العمود معرف الهدف على شاشة تحرير الهدف.
  3. في العمود المعرف على شاشة المحتوى.
  4. في القائمة الهدف على شاشة اكتشاف الأهداف.

مخطط

فيما يلي مخطط XML لملفات XML هذه:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- ================================== -->
    <!-- مستند قياسي -->
    <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"/>
                        <!-- على سبيل المثال، "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- على سبيل المثال، "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}"/>
                        <!-- على سبيل المثال، "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"/>
                        <!-- على سبيل المثال، "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>
    <!-- ================================== -->
    <!-- منتدى المجموعة -->
    <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>
                <!-- على سبيل المثال، "Blackboard College" -->
                <!-- على سبيل المثال، "BB" -->
                <!-- على سبيل المثال، "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- المادة -->
    <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}"/>
                                <!-- على سبيل المثال، "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- على سبيل المثال، "أهداف معمل الفيزياء" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- مجموعة المستندات -->
    <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>
                <!-- على سبيل المثال، "أهداف أولية" -->
                <!-- على سبيل المثال، "مقدمة" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- نطاق التقديرات -->
    <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>
                <!-- على سبيل المثال، "فئة القياس" -->
                <!-- على سبيل المثال، "1" -->
                <!-- على سبيل المثال، "1" -->
                <!-- على سبيل المثال، "كمبيوتر محمول" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- قياسي -->
    <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>
    <!-- ================================== -->
    <!-- العنوان -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- على سبيل المثال، "أجهزة الكمبيوتر المحمولة المعملية" -->
    <!-- ================================== -->
    <!-- مرجع نطاق التقديرات -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- العنصر -->
    <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 إلى 101 حرف -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- على سبيل المثال، "الطالب سوف" or blank -->
            <!-- على سبيل المثال، "نوع الأداة" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- العبارة -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- على سبيل المثال، "فهم الشك في القياسات" -->
    <!-- ================================== -->
    <!-- أنواع البيانات البسيطة -->
    <!-- ================================== -->
    <!-- سلاسل بدون مسافات -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- تعليمة برمجية بحرفين -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- تعليمة برمجية بـ 256 حرفًا -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- معرفات UID الهدف -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- من 1 إلى 257 حرفًا -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- من 0 إلى 257 حرفًا -->
        </xs:restriction>
    </xs:simpleType>
    <!-- لا يزيد عن 101 حرف -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- من 1 إلى 101 حرف -->
        </xs:restriction>
    </xs:simpleType>
    <!-- سلسلة غير فارغة -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- حرف واحد على الأقل -->
        </xs:restriction>
    </xs:simpleType>
    <!-- سلسلة فارغة ممكنة -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- يمكن أن تكون فارغة-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>

كيف تؤثر هذه الملفات على واجهة المستخدم

توضح الرسومات البيانية الموجودة أدناه كيفية ظهور العناصر الموجودة في ملف XML في واجهة المستخدم.

تتوفر الصور باللغة الإنجليزية فقط.

شاشة الأهداف

يوضح هذا الرسم البياني كيفية تعيين ملف XML إلى العناصر الموجودة على الشاشة الأهداف.

شاشة تحرير الهدف

يوضح هذا الرسم البياني كيفية تعيين ملف XML إلى العناصر الموجودة على الشاشة تحرير الأهداف. تظهر هذه الشاشة في حالة قيامك بفتح القائمة الموجودة إلى يسار الهدف في شاشة الأهداف واختيار تحرير الهدف. لا يتاح أمر تحرير الهدف في حالة تعيين السمة editable في العنصر <standard_document> إلى "خطأ".

شاشة تحرير مجموعة الأهداف

يوضح هذا الرسم البياني كيفية تعيين ملف XML إلى العناصر الموجودة على الشاشة تحرير مجموعة الأهداف. تظهر الشاشة عند قيامك بفتح القائمة الموجودة إلى يسار مجموعة الأهداف المعروضة على شاشة الأهداف، واختيار تحرير. (لا يمكن تحرير حقلي اسم المجموعة وملفات نوع المجموعة إذا كانت السمة editable الموجودة في العنصر <standard_document> معينة بالقيمة "خطأ".)

شاشة المحتوى

يوضح هذا الرسم البياني كيفية تعيين ملف XML إلى العناصر الموجودة على الشاشة المحتوى.

شاشة اكتشاف الأهداف

يوضح هذا الرسم البياني كيفية تعيين ملف XML إلى العناصر الموجودة على الشاشة اكتشاف الأهداف. تظهر هذه الشاشة عند اختيارك إضافة توافقات إلى شاشة المحتوى.

حذف العناصر

لا يمكنك حذف العناصر عن طريق رفع ملفات جديدة. لحذف العناصر، استخدم واجهة المستخدم.

إضافة عناصر واستبدالها

تعتبر أسهل طريقة لإضافة عناصر أو استبدالها هي حذف العناصر الموجودة (من خلال واجهة المستخدم) ثم تحميل ملف يحتوي على المعلومات المحدثة.

إذا كنت في حاجة إلى إضافة عناصر أو استبدالها دون استخدام واجهة المستخدم، فإن الأقسام الموجودة أدناه تصف العملية.

التدرج الهرمي لمعرفات UID

  • يجب أن تكون مجموعة معرفات UID لكل هدف (أي، مجموعة معرفات UID لكل من <standard_document>، و<document_set>، و<standard>، و<item>) فريدة في جميع الملفات.
  • وتشكل معرفات UID تدرجاً هرمياً:
    • <standard_document>
    • <document_set>
    • <standard>
    • <item>

يتفاعل معرف UID لعنصر <standard> أيضًا مع السمةcode لعنصر <grade_range> كما هو موضح أدناه.

إضافة عناصر جديدة

يمكنك إضافة عناصر جديدة أو استبدال العناصر القديمة، عن طريق الاحتفاظ بالعناصر العليا في التدرج الهرمي كما هي واستخدام معرفات UID مختلفة بالنسبة للعناصر الأدنى في التدرج الهرمي.

مثال

  1. فلنفترض أنك قمت أولاً برفع ملف باستخدام السمات التالية. فسيؤدي هذا الأمر إلى إنشاء مجموعة أهداف وفئة وهدف.
    <standard_
    document>
    UID    		 <document_set>
    UID    		 <grade_range>
    الرمز    		 <standard>
    UID    		 <item>
    UID
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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>">مجموعة الأهداف 1</subject>
       <document_set uid="DOC_SET_1">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">الفئة 1</grade_range>
       <standard uid="STANDARD_1">
          <title>الفئة 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>هذا هو الهدف.</statement>
          </item>
       </standard>
    </standard_document>

  2. إذا قمت بعد ذلك بتحميل ملف له السمات التالية، فإن هذا الأمر سيؤدي إلى إنشاء فئة جديدة وهدف جديد.
    <standard_
    document>
    UID    		 <document_set>
    UID    		 <grade_range>
    الرمز    		 <standard>
    UID    		 <item>
    UID
    STANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_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">مجموعة الأهداف 1</subject>
       <document_set uid="DOC_SET_1">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">الفئة أ</grade_range>
       <standard uid="STANDARD_A">
          <title>الفئة أ</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>

    إذا قمت بتغيير معرف UID للعنصر <standard>، يجب أن تقوم أيضًا بتغيير السمة codeللعنصر <grade_range>. إذا قمت فقط بتغيير معرف UID الخاص بالعنصر <standard>، فستفشل عملية الاستيراد.

  3. وإذا قمت بعد ذلك بتحميل ملف له نفس السمات ولكن مع محتوى مختلف، فسيتم تحديث بيان الهدف.

    <?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">مجموعة الأهداف 1</subject>
       <document_set uid="DOC_SET_1">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">الفئة أ</grade_range>
       <standard uid="STANDARD_A">
          <title>الفئة أ</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>

تغيير الأسماء

إذا قمت بتحميل معلومات بنفس مجموعة معرفات UID ولكن مع سمات code مختلفة، فستتم إعادة تسمية العناصر.

مثال

  1. فلنفترض أنك قمت أولاً برفع ملف باستخدام السمات التالية. فسيؤدي هذا الأمر إلى إنشاء مجموعة أهداف وفئة وهدف.
    <standard_
    document>
    UID    		 <subject>
    الرمز    		 <document_
    set>
    UID    		 <grade_
    range>
    الرمز    		 <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_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">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">الفئة 1</grade_range>
       <standard uid="STANDARD_1">
          <title>الفئة 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>هذا هو الهدف.</statement>
          </item>
       </standard>
    </standard_document>

  2. إذا قمت برفع الملف مع السمات التالية، فستتم إعادة تسمية مجموعة الأهداف (من "مجموعة الأهداف 1" إلى "مجموعة الأهداف B").
    <standard_
    document>
    UID    		 <subject>
    الرمز    		 <document_
    set>
    UID    		 <grade_
    range>
    الرمز    		 <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_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">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">الفئة 1</grade_range>
       <standard uid="STANDARD_1">
          <title>الفئة 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>هذا هو الهدف.</statement>
          </item>
       </standard>
    </standard_document>

يعمل هذا الإجراء أيضًا على إعادة تسمية السمة code للعنصر <grade_range>.

إضافة عناصر أو تغييرها في العناصر العليا في التدرج الهرمي

ستتلقى رسالة خطأ، ولن يتم رفع الملف في حالة استخدام معرفات UID للعناصر الأدنى في التدرج الهرمي بالفعل لكن باستخدام معرفات UID مختلفة للعناصر الأعلى في التدرج الهرمي.

مثال

  1. فلنفترض أنك قمت أولاً برفع ملف باستخدام السمات التالية. فسيؤدي هذا الأمر إلى إنشاء مجموعة أهداف وفئة وهدف.
    <standard_
    document>
    UID    		 <document_
    set>
    UID    		 <grade_
    range>
    الرمز    		 <standard>
    UID    		 <item>
    UID
    STANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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">مجموعة الأهداف 1</subject>
       <document_set uid="DOC_SET_1">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">الفئة 1</grade_range>
       <standard uid="STANDARD_1">
          <title>الفئة 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>هذا هو الهدف.</statement>
          </item>
       </standard>
    </standard_document>

  2. فإذا حاولت بعد ذلك تحميل ملف له السمات التالية، فسيفشل التحميل.
    <standard_
    document>
    UID    		 <document_
    set>
    UID    		 <grade_
    range>
    الرمز    		 <standard>
    UID    		 <item>
    UID
    STANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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">مجموعة الأهداف 1</subject>
       <document_set uid="DOC_SET_1">نوع مجموعة الأهداف 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">الفئة 1</grade_range>
       <standard uid="STANDARD_1">
          <title>الفئة 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>هذا هو الهدف.</statement>
          </item>
       </standard>
    </standard_document>

إذا كنت ترغب في إضافة أو تغيير العناصر الأعلى في التدرج الهرمي، يجب أن تستخدم معرفات UID مختلفة للعناصر الأقل في التدرج الهرمي.