علامات الوصول إلى معلومات الاتصال

في هذه الصفحة:

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

قبل البدء

يتم*contact_info إجراء علامة الوصول إلى البيانات دائما من منظور الطالب.
تبدأ علامة الوصول إلى البيانات بقائمة جهات الاتصال لكل طالب، مرتبة بناء على ترتيب الأولوية الذي يمكن رؤيته في صفحة الاتصال بالطلاب.
يمكن أن يكون لكل جهة اتصال عدد من العناوين أو رسائل البريد الإلكتروني أو أرقام الهواتف التي يتم فرزها بترتيب أولوية تصاعدي لكل فئة. تحتوي عناصر جهات الاتصال هذه على سمات مثل "النوع" والذي يمكن استخدامه لفلترة القائمة.
يتم تعيين فهرس مؤقت للعناصر الموجودة في القائمة التي تمت تصفيتها المتبقية للرجوع إليها داخل علامة الوصول إلى البيانات. على سبيل المثال، عندما يكون لدى جهة اتصال هاتفان من النوع "Home" وهاتفان من النوع "Work"، إذا تمت فلترة علامة الوصول إلى البيانات إلى الهواتف المنزلية فقط، فسيشير الفهرس 2 إلى الهاتف "Home" الثاني حتى لو بدأ كرقم هاتف ثالث في القائمة غير المصفاة.
إذا تم حل مخطط دراسي إلى لا شيء، يتم إرجاع سلسلة فارغة. على سبيل المثال، طلب لعرض هاتف المنزل الثالث في قائمة من 2.
إذا لم يسمح لمخطط دراسي بإرجاع حقل بسبب قيود دور الأمان على مستوى الحقل للمستخدم، يتم إرجاع سلسلة من خمس علامات نجمية (*****).
من الممكن وجود سجلات تفاصيل العلاقة التاريخية والمستقبلية بين جهة اتصال واحدة وطالب. يمكن تنشيط سجل تفاصيل علاقة واحد فقط في أي يوم معين. *contact_info تراعي علامة الوصول إلى البيانات فقط سجل تفاصيل العلاقة النشط في يوم استخدام علامة الوصول إلى البيانات.
إذا تم حل وسيطة إلى لا شيء، مثل طلب علاقة زوج الأم (غير الموجودة)، أو فهرس 10 من قائمة من 3، فلن يتم إرجاع أي شيء (سلسلة فارغة).

الصيغة

فيما يلي الخطوط العريضة للنماذج العامة لاستدعاء *contact_info علامة الوصول إلى البيانات في مناطق مختلفة من PowerSchool:

المنطقة	النموذج
الحجج	مفصولة بفاصلة منقوطة
التواريخ	التاريخ: شهر / يوم / سنة
النموذج على صفحة الويب	~(*contact_info[;...])
النموذج على تقرير الكائن	^(contact_info[;...]) ~(contact_info[;...])
النموذج في التصدير السريع	^(contact_info[;...]) ~(contact_info[;...])
انقر على حقول الطلاب:	*contact_info[;...]
الكلمات الرئيسية	افصل عن وسائطهم بعلامة المساواة

افتراضي (نموذج بدون وسائط)

للحصول على أسرع النتائج في استدعاء *contact_info علامة الوصول إلى البيانات في PowerSchool، استخدم ~ (*contact_info). يؤدي القيام بذلك إلى إرجاع بادئة جهة الاتصال الأولى للطالب والاسم الأول والاسم الأوسط واسم العائلة واللاحقة، مثلDr. Herman Webster Mudgett Sr..

علم قواعد اللغة

نظرة عامة على سير العمل

حدد من يجب تضمينه:

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

حدد ما يجب تضمينه:

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

من يجب تضمينه

تتم الاستعلامات من سياق الطالب المحدد حاليًا. من هناك، يتم تضييق قائمة جهات الاتصال باستخدام الأوصاف التالية:

rel (العلاقة)

ما	فلترة جهات الاتصال حسب العلاقة بالطالب.
الكلمة الرئيسية	العلاقة
الإعداد الافتراضي	الكل
القيم	الكل، أو قائمة مفصولة بفواصل من رموز نوع العلاقة، مثل الأم والأب وما إلى ذلك.
ملاحظات	لا يتم الاحتفاظ بترتيب القائمة. يتم ترتيب جهات الاتصال حسب الأولوية وليس نوع العلاقة.
أمثلة	~(*contact_info; العلاقة= الكل)

العلامات (علامات العلاقة)

ما	فلترة جهات الاتصال حسب العلاقة بالطالب.
الكلمة الرئيسية	العلامات
الإعداد الافتراضي	لا شيء (السلوك الافتراضي هو إظهار جهات الاتصال النشطة فقط
القيم	قائمة مفصولة بفواصل تضم: تضمين غير النشط غير النشط فقط وصائي غير وصائي الطوارئ غير طارئ يعيش مع لا يعيش مع له ولي أمر يستلمه من المدرسة ليس له ولي أمر يستلمه من المدرسة يتلقى البريد لا يتلقى البريد الوصول إلى البيانات عدم الوصول إلى البيانات حساب الويب (WAA - حسب PS 12.1.3.0) ليس له حساب ويب (WAA - حسب PS 12.1.3.0)
أمثلة	~(*contact_info; العلامات= تضمين غير النشط)

حسب الشخص (asof-pers)

ما	فلترة قائمة جهات الاتصال المرتبطة بالطالب إلى تلك الصالحة في وقت معين.
الكلمة الرئيسية	حسب الأشحاص
الإعداد الافتراضي	الحالي (اليوم)
القيم	التاريخ، أو قائمة مفصولة بفواصل للماضي والحالي والمستقبلي والنشط والكل
ملاحظات	يتم تحديد التاريخ بصيغة:MM/dd/yyyy. تتضمن قيمة الحالي الاتصال النشطة اليوم حيث يقع اليوم بين (الشمولي). تتضمن قيمة الماضي جهات الاتصال النشطة أمس فقط؛ ولا يمكن أن يكون لها تاريخ بدء أو انتهاء بعد اليوم الحالي. تتضمن قيمة المستقبل جهات الاتصال النشطة للغد فقط؛ ولا يمكن أن يكون لها تاريخ بدء أو انتهاء قبل اليوم الحالي. تتضمن قيمة نشط الاتصال بتفاصيل الاتصال الأقرب إلى تاريخ اليوم الحالي. يمكن أن يكون هناك اتصال نشط واحد فقط. يجب عدم الخلط بين جهات الاتصال النشطة وتنشيط جهة اتصال.
أمثلة	~(contact_info; حسب الأشحاص = الحالي) ~(contact_info; حسب الأشحاص = الحالي والماضي والمستقبل) ~(*contact_info;asof-pers=date:03/30/2017)

الحد الأقصى للأشخاص (max-pers)

ما	حدد عدد جهات الاتصال في التقرير.
الكلمة الرئيسية	الحد الأقصى للأشخاص
الإعداد الافتراضي	1
القيم	الكل، أو الرقم الذي يشير إلى عدد الأشخاص الذين يجب تضمينهم
ملاحظات	يتم تحديد هذا كفهرس قائم على واحد.
أمثلة	~(*contact_info;max-pers=1)

أي شخص؟ (which-pers)

ما	استخراج جهة اتصال من قائمة جهات الاتصال المقترنة بالطالب.
الكلمة الرئيسية	أي شخص؟ (which-pers)
الإعداد الافتراضي	الكل
القيم	الكل، أو رقم يشير إلى الفهرس في القائمة
ملاحظات	يتم تقييم "أي شخص؟" بعد "الحد الأقصى من الأشخاص" والفرز حسب ترتيب الأولوية
أمثلة	~(*contact_info; أي شخص = الكل)

ما هي البيانات التي يجب تضمينها

"الفئة" (cat)

ما	يحدد فئات بيانات الاتصال التي سيتم تضمينها.
الكلمة الرئيسية	الفئة
الإعداد الافتراضي	التركيبة السكانية
القيم	الكل، أو قائمة مفصولة بفواصل من العلاقة، التركيبة السكانية، الهاتف، البريد الإلكتروني، العنوان
ملاحظات	تتم معالجة الفئات بالترتيب التالي: التركيبة السكانية، العلاقة، الهاتف، البريد الإلكتروني، العنوان. إذا تم تمرير فئة غير معترف بها، يتم تعيين PowerSchool افتراضيا على التركيبة السكانية (dem).

أي قيمة؟ (which-val)

ما	استخراج عنصر من قائمة العناصر.
الكلمة الرئيسية	أي قيمة؟ (which-val)
الإعداد الافتراضي	1
القيم	الكل، أو رقم يشير إلى الفهرس في القائمة
ملاحظات	يتم تطبيق هذا الإعداد عبر الفئات. يتم تحديد هذا كفهرس قائم على واحد.
أمثلة	~(*contact_info;which-val=1)

النوع

ما	فلترة المخرجات لتضمين أنواع البيانات المحددة فقط.
الكلمة الرئيسية	النوع
الإعداد الافتراضي	الكل
القيم	الكل، أو قائمة مفصولة بفواصل لأي رمز نوع صالح للفئات المحددة
ملاحظات	يتم تطبيق هذا الإعداد عبر الفئات. في حالة التوفر، فلترة أي فئة تقبل فلترة النوع بواسطة هذه المعلمة.
أمثلة	~(*contact_info; النوع = الكل)

حسب القيمة (asof-val)

ما	فلترة الإخراج إلى عناصر صالحة في وقت معين.
الكلمة الرئيسية	أسوف فال
الإعداد الافتراضي	الحالي
القيم	التاريخ، أو قائمة مفصولة بفواصل للماضي والحالي والمستقبلي والكل
ملاحظات	هذا الإعداد مدعوم فقط للعناوين (وليس البريد الإلكتروني أو رقم الهاتف). يتم تحديد التاريخ بصيغة:MM/dd/yyyy.
أمثلة	~(contact_info; حسب= الحالي) ~(contact_info;as-of=date:12/31/2017)

القيمة (val)

ما	القيم من فئة إلى تقرير.
الكلمة الرئيسية	القيمة (val)
الإعداد الافتراضي	الكل
القيم	الكل، أو قائمة مفصولة بفواصل من حقول الكائنات: البيانات الديموغرافية: قبول البريد (acctemail) (البريد الإلكتروني لحساب WAA - حسب PS 12.1.3.0) مُعرف الحساب (acctid) (معرف حساب WAA - حسب PS 12.1.3.0) نشط صاحب العمل الاسم الأول نوع الجنس اللغة اسم العائلة أولًا (اسم العائلة، الاسم الأول الاسم الأوسط) اسم العائلة الاسم الأوسط معرف الشخص (حسب PS 12.1.3.0) بادئة معرف الحالة رقم الحالة لاحقة العلاقة: نشط الوصاية الوصول إلى البيانات الطوارئ تاريخ الانتهاء يعيش مع استلام البريد العلاقة له ولي أمر يستلمه من المدرسة التقرير المدرسي المستبعد تاريخ البدء العنوان: المدينة البلد تاريخ الانتهاء line2 تاريخ البدء الولاية/المقاطعة الشارع النوع الوحدة الرمز البريدي الهاتف: الهاتف التفضيلات رسالة نصية قصيرة النوع البريد الإلكتروني: البريد الإلكتروني أساسي النوع
أمثلة	~(*contact_info; القيمة= الكل)

خيارات العرض/التنسيق

المحددات

تستخدم المحددات لتعويض أجزاء مختلفة من البيانات عن بعضها البعض. من بين المحددات اثنان شائعًا الاستخدام:

فاصلة (، )	فاصلة متبوعة بمسافة. مفيد في تقارير تحديد الفاصلة.
فاصلة دون مسافات (،)	فاصلة بدون مسافات. مفيد في تحديد الصادرات بفواصل.

محدد الاتصال (contact-delim)

ما	يحدد المحدد الذي سيتم استخدامه بين جهات اتصال متعددة.
الكلمة الرئيسية	محدد الاتصال (contact-delim)
الإعداد الافتراضي	Dlf
القيم	dlf (تغذية سطر مزدوجة) lf (تغذية سطر) p (فقرة HTML: <p>) br (فاصل HTML: <br>) فاصلة (، ) فاصلة دون مسافات (،) فاصلة منقوطة (؛) مسافة ( ) رمز عمودي (\|)
ملاحظات	التقارير لا تلتزم بـ lf (بتغذية السطر) أو dlf (تغذية السطر المزدوجة)، لذلك استخدم p (فقرة) أو br (فاصل) بدلاً من ذلك.
أمثلة	~(*contact_info; محدد الاتصال = dlf)

محدد العنصر (item-delim)

ما	يحدد المحدد الذي سيتم استخدامه بين مضاعفات نفس العنصر، مثل هواتف متعددة، أو عناوين متعددة، إلخ.
الكلمة الرئيسية	محدد العنصر (item-delim)
الإعداد الافتراضي	فاصلة
القيم	dlf (تغذية سطر مزدوجة) lf (تغذية سطر) p (فقرة HTML: <p>) br (فاصل HTML: <br>) فاصلة (، ) فاصلة دون مسافات (،) فاصلة منقوطة (؛) مسافة ( ) رمز عمودي (\|)
ملاحظات	التقارير لا تلتزم بـ lf (بتغذية السطر) أو dlf (تغذية السطر المزدوجة)، لذلك استخدم p (فقرة) أو br (فاصل) بدلاً من ذلك.
أمثلة	~(*contact_info; محدد العنصر= فاصلة)

محدد القيمة (value-delim)

ما	يحدد المحدد الذي سيتم استخدامه بين قيم متعددة محددة بواسطة معلمة القيمة.
الكلمة الرئيسية	محدد القيمة (value-delim)
الإعداد الافتراضي	مسافة (Space)
القيم	dlf (تغذية سطر مزدوجة) lf (تغذية سطر) p (فقرة HTML: <p>) br (فاصل HTML: <br>) فاصلة (، ) فاصلة دون مسافات (،) فاصلة منقوطة (؛) مسافة ( ) رمز عمودي (\|)
ملاحظات	التقارير لا تلتزم بـ lf (بتغذية السطر) أو dlf (تغذية السطر المزدوجة)، لذلك استخدم p (فقرة) أو br (فاصل) بدلاً من ذلك.
أمثلة	~(*contact_info; محدد القيمة= تغذية السطر)

محدد الفئة (cat-delim)

ما	يحدد المحدد المراد استخدامه بين فئات متعددة، مثل الخصائص الديموغرافية والبريد الإلكتروني وما إلى ذلك.
الكلمة الرئيسية	محدد الفئة
الإعداد الافتراضي	تغذية السطر
القيم	dlf (تغذية سطر مزدوجة) lf (تغذية سطر) p (فقرة HTML: <p>) br (فاصل HTML: <br>) فاصلة (، ) فاصلة دون مسافات (،) فاصلة منقوطة (؛) مسافة ( ) رمز عمودي (\|)
ملاحظات	التقارير لا تلتزم بـ lf (بتغذية السطر) أو dlf (تغذية السطر المزدوجة)، لذلك استخدم p (فقرة) أو br (فاصل) بدلاً من ذلك.
أمثلة	~(*contact_info; محدد الاتصال= dlf)Â

الترجمة

اللغة المحلية

ما	يحدد الإعدادات المحلية التي سيتم استخدامها عند فك تشفير التواريخ.
الكلمة الرئيسية	اللغة المحلية
الإعداد الافتراضي	en_US
القيم	رمز الإعدادات المحلية صالح، مثل el_GR
ملاحظات	يتم دائما إدخال سلاسل التاريخ المستخدمة في وسائط علامة الوصول إلى البيانات بتنسيق شهر / يوم / سنة. يتم ترجمة قيم الإرجاع فقط.
أمثلة	اللغة المحلية ~(*contact_info;locale=en_US)