استيراد جهات الاتصال

أعلام منطقية

عند التحديد، تشير قيم 0, false، f، no، وn إلى false. وتشير قيم 1، true، t، yes وy إلى true. أي شيء آخر هو خطأ. ليست حساسة لحالة الأحرف.

قيم مجموعة الرموز

عند تحديد قيمة مجموعة الرموز، يجب أن تكون مطابقة لحالة الأحرف مع رمز فعلي في قاعدة البيانات لنوع الرمز المطبق.

التواريخ

عند التحديد، يجب أن يكون التاريخ بتنسيق mm/dd/yyyy أو mm/dd/yy. تؤدي أي قيم تاريخ ليست بهذا التنسيق إلى حدوث خطأ.

الفراغات

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

محو

لا تقوم الحقول الفارغة في ملف الاستيراد بتحديث الحقل أو مسح البيانات.

أدخل #clear كقيمة الحقل لمسح القيم.

لا يمكن محو القيم المطلوبة، حتى لو تم إدخال #clear كقيمة.

حذف

يمكن حذف جهة الاتصال كلها أو عناصر جهة الاتصال عن طريق تحديد #delete لقيم حقول محددة. تشير الجداول أدناه إلى الحقول القابلة للتطبيق.

محدّد الهوية

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

تنطبق هذه المعلومات أيضًا على الامتدادات الفرعية.

المعرّف

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

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

تنطبق هذه المعلومات أيضًا على الامتدادات الفرعية.

الاسم الأخير

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

حدّد #delete في كل صف يظهر فيه معرف جهة الاتصال لحذف جهة الاتصال بأكملها.

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

الاسم الأول (FirstName)
الاسم الأوسط (MiddleName)
معرف جهة الاتصال الخاصة بالولاية (StateContactID)
جهة العمل

نفس اسم الأخير (LastName)، باستثناء أنه غير مطلوب.

بادئة
لاحقة
نوع الجنس

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

ExcludeFromStateReporting
IsActive

علم المنطقية. الإعدادات الافتراضية التي تم تعيينها لـ ExcludeFromStateReporting هي true إذا لم يتم تحديدها. الإعدادات الافتراضية التي تم تعيينها لـ IsActive هي false. سوف ينشأ التعارض إذا تم تحديد false في صف واحد وتم تحديد true في صف آخر ذي صلة.

هل تم تمكين الوصول إلى الحساب

العلم المنطقي. يحدد كون الحساب ممكنًا أو معطلاً. القيم الصالحة: 1 = ممكن، 0 = معطل. الإعدادات الافتراضية التي تم تعيينها هي 1 إذا لم يتم تحديد قيمة.

الوصول إلى اسم مستخدم الحساب

اسم تسجيل الدخول المستخدم بواسطة خادم مصادقة PowerSchool المركزي لمصادقة مستخدم. مطلوب.

الوصول إلى عنوان البريد الإلكتروني للحساب

حساب بريد إلكتروني لمالك حساب تسجيل الدخول. مطلوب.

حالة GuardianNumber

يتم استخدام هذا الحقل بواسطة تقارير حالة PowerSchool. يمكن استخدامه أيضًا للتكامل مع الأنظمة الخارجية.

PersonEmailAddessAssocID

المفتاح الأساسي لاقتران عنوان البريد الإلكتروني للشخص. مفهرس. إذا لم يكن البريد الإلكتروني المستورد مقترنًا بالفعل بالشخص، فسيتم إنشاء اقتران جديد. إذا كان البريد الإلكتروني المستورد مقترنًا بالفعل بالشخص، فسيتم تحديث الاقتران الحالي بأي تغييرات.

EmailAddress

مطلوب إذا كان سيتم استيراد عنوان بريد إلكتروني. يجب أن يكون تنسيق عنوان بريد إلكتروني صالحًا (somebody@example.com). لا يمكن تضمين عنوان البريد الإلكتروني نفسه (غير حساس لحالة الأحرف) في صفين مرتبطين ما لم يتم أيضًا تحديد قيم EmailType وIsPrimaryEmailAddress بنفس القيمة التي تشير إلى تكرار.

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

حدد #delete لإزالة عنوان البريد الإلكتروني من جهة الاتصال.

نوع البريد الإلكتروني

قيمة مجموعة الرموز. لن يتم تعيين الإعدادات الافتراضية، إذا لم يتم تحديدها.

IsPrimaryEmailAddress

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

PhoneNumberAssocID

المفتاح الأساسي لاقتران رقم الهاتف. مفهرس. إذا لم يكن رقم الهاتف المستورد مقترنًا بالفعل بالشخص، فسيتم إنشاء اقتران جديد. إذا كان رقم الهاتف الذي تم استيراده مقترنًا بالفعل بالشخص، فسيتم تحديث الارتباط الحالي بأي تغييرات.

رقم الهاتف (كما تم إدخاله)

مطلوب إذا كان سيتم استيراد رقم هاتف. التنسيق مفتوح، ولكن يجب ألا يتضمن علامة ملحقة، مثل 212-555-1234 x123. يجب إدخال الامتدادات في حقل "الامتداد". سيتم إسقاطها إذا تم تضمينها في حقل PhoneNumber (كما تم إدخاله). يمكن إدخال نفس رقم الهاتف عدة مرات بأنواع مختلفة وقيم أوامر الأولوية. لاحظ أنه أثناء فتح التنسيق، سيظل يحترم أي قواعد محددة للتحقق من صحة البيانات (LDV).

استخدم #delete لإزالة رقم الهاتف من جهة الاتصال.

الامتداد

قيمة الامتداد الاختيارية. نفس رقم الهاتف مع امتداد مختلف يجعله فريدًا.

PhoneTypeCode

قيمة مجموعة الرموز. لن يتم تعيين الإعدادات الافتراضية، إذا لم يتم تحديدها.

PhoneNumberPriorityOrder

يجب أن يكون عددًا صحيحًا موجبًا إذا تم تحديده. لا يمكن استخدام نفس القيمة أكثر من مرة للصفوف ذات الصلة إلا إذا كانت مكررة. إذا لم يتم تحديدها، فسيتم تعيين قيمة افتراضية. تعتمد القيمة الافتراضية على ترتيب الظهور في الملف وأي قيم ترتيب أولوية لرقم الهاتف محددة في الصفوف ذات الصلة. على سبيل المثال، إذا كانت أربعة صفوف مرتبطة تتضمن أرقام هواتف مميزة ويحدد اثنان منها ترتيبي الأولوية 1 و3، فسيتم تعيين رقمين للصف الأول الذي لم يحدده، في حين يتم تعيين الرقم 4 للآخر.

IsSMS

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

IsPreferred

علم المنطقية. يتم تعيين الإعدادات الافتراضية إلى false، إذا لم يتم تحديدها. سوف ينشأ التعارض إذا تم تحديد true في صف واحد وتم تحديد false أو blank في صف آخر ذي صلة.

AddressAssocID

المفتاح الأساسي لقرن العناوين. مفهرس. إذا لم يكن العنوان مقترنًا بالفعل بالشخص، فسيتم إنشاء ارتباط جديد. إذا كان العنوان المستورد مقترنًا بالفعل بهذا الشخص، فسيتم تحديث الارتباط الحالي بأي تغييرات.

الشارع

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

حدد #delete لإزالة العنوان من جهة الاتصال.

LineTwoUnitCityPostalCode

قيم نصية اختيارية.

GeocodeLatitudeGeocodeLongitude

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

الولاية

قيمة مجموعة الرموز. لن يتم تعيين الإعدادات الافتراضية، إذا لم يتم تحديدها.

من أجل تحديد كل من رمز البلد والولاية، يجب استخدام التنسيق CountryCode_StateCode. يجب أيضًا استخدام هذا التنسيق إذا كانت هناك قيم StateCode متعددة لها قيم CountryCode أصلية منفصلة. على سبيل المثال، يجب تحديد US_PR إذا تم تعريف رمز ولاية PR لكل من مجموعات رموز البلدين US وBR. يمكنك تحديد رمز الولاية فقط إذا لم يكن رمز البلد مرغوبًا فيه وكان يمثل قيمة فريدة في مجموعة رموز الولاية.

نوع العنوان

قيمة مجموعة الرموز. لن يتم تعيين الإعدادات الافتراضية، إذا لم يتم تحديدها.

AddressStartDateAddressEndDate

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

StudentContactAssocID

المفتاح الأساسي لاقتران الطلاب. مفهرس. إذا لم يكن الطالب المستورد مقترنًا بالفعل بهذا الشخص، فسيتم إنشاء اقتران جديد. إذا كان الطالب المستورد مقترنًا بالفعل بهذا الشخص، فسيتم تحديث الاقتران الحالي بأي تغييرات.

StudentNumber

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

حدد #delete لإزالة الطالب من جهة الاتصال.

OriginalContactType

يشير إلى أن جهة الاتصال هي أحد أنواع جهات الاتصال القديمة الستة. القيم الصالحة هي mother وfather وguardian وemergency1 وemergency2 وemergency3. لاحظ أنه قد يكون لدى الطالب جهة اتصال واحدة فقط من كل نوع جهة اتصال أصلية. ولذلك، سيفشل الصف المستورد إذا كان لدى الطالب بالفعل جهة اتصال من نوع جهة الاتصال الأصلية المحددة أو إذا تم تعيين نفس نوع جهة الاتصال الأصلية للطالب لجهات اتصال متعددة يتم استيرادها.

ContactPriorityOrder

يشير إلى الترتيب المفضل الذي ستظهر به جهات اتصال الطالب. القيم الصالحة هي 1 أو 2 أو 3 وما إلى ذلك أو blank.

إذا كانت فارغة، تظهر جهة الاتصال في نهاية قائمة جهات الاتصال للطالب.

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

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

StudentContactDetailID

رقم تسلسلي فريد تم إنشاؤه بواسطة التطبيق ويحدد الصف في الجدول بشكل فريد. مفهرس.

معرف StudentContactDetailID غير مطلوب لإضافة اقتران جديد.

من أجل تحديث اقتران موجود، ستقوم القيمة الموجودة في هذا الحقل بتحديث سجل StudentContactDetail المحدد. سيؤدي ترك هذا الحقل فارغًا إلى تحديث سجل التفاصيل النشط للاقتران الحالي.

لإضافة سجل تفاصيل جديد في الاقتران الحالي، استخدم #new في هذا المجال

نوع العلاقة

قيمة مجموعة الرموز. لن يتم تعيين الإعدادات الافتراضية، إذا لم يتم تحديدها.

RelationshipNote

قيمة نصية اختيارية.

RelationshipStartDate
RelationshipEndDate

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

ContactHasCustody
ContactLivesWith
ContactAllowSchoolPickup
IsEmergencyContact
ContactReceivesMailings

أعلام منطقية. كل الإعدادات الافتراضية هي false، إذا لم يتم تحديدها. سيظهر تعارض إذا حدد صف ذو صلة true وآخر حدد false أو blank.

AllowDataAccess

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

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