في هذه الصفحة

متغيرات البيانات

خصص المحتوى ديناميكيًا باستخدام متغيرات البيانات.

تسمح متغيرات البيانات لك بالإشارة إلى بيانات محددة بمكان العمل وعرضها بشكل ديناميكي، مما يجعل المحتوى الخاص بك أكثر صلة وتخصيصًا للمستخدمين. سواء كنت تعرض معلومات المستخدم، تفاصيل الفكرة، أو إحصائيات المجموعة، تمكّن متغيرات البيانات من التحديثات الفورية والمحتوى المُخصص.

استخدام متغيرات البيانات

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

  • مثال: {{ sessionUser.name }} يعرض اسم المستخدم الحالي.
  • مثال: {{ ideaCollection.stats.ideas.total }} يعرض العدد الإجمالي للأفكار المقدمة في مجموعة الأفكار الحالية.

متغيرات البيانات المستخدمة بشكل شائع

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

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

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

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

بيانات متعلقة بالمستخدم

  • sessionUser.name: يعرض الاسم الكامل للمستخدم الحالي.
  • sessionUser.rank: يعرض رتبة المستخدم كقيمة رقمية، حيث تساوي رتبة الزائر 1000، والعضو 2000، والمسؤول 3000، وصاحب مساحة العمل 5000. تسهّل القيم الرقمية إنشاء عمليات مقارنة، على سبيل المثال بقول {{IF(sessionUser.rank > 1000, "Welcome")}}
  • sessionUser.stats.ideas: يعيد العدد الإجمالي للأفكار التي قدمها المستخدم.

بيانات الفكرة

  • idea.friendlyId: معرّف قصير وفريد للفكرة.
  • idea.url.full: عنوان URL الكامل للفكرة.
  • idea.status.title: الحالة الحالية للفكرة (مثل: قيد المراجعة، معتمدة، مؤجلة).
  • ‍idea.phase.name: اسم المرحلة الحالية للفكرة (مثل: نقاش مفتوح).‍
  • idea.stats.comments: عدد التعليقات التي تلقتها الفكرة.‍
  • idea.owner.name: اسم المستخدم الذي قدم الفكرة.‍
  • idea.status.title: عنوان الحالة التي توجد فيها الفكرة حاليًا‍
  • idea.submittedAt: الطابع الزمني لإنشاء الفكرة‍
  • idea.stats.comments: عدد التعليقات التي حصلت عليها الفكرة‍
  • idea.stats.likes.total: إجمالي عدد الإعجابات التي حصلت عليها الفكرة‍
  • idea.stats.totalAvgRating: متوسط التقييم الإجمالي الذي حصلت عليه الفكرة‍
  • idea.field.<UUID>.value: القيمة التي أرسلها المستخدم لحقل النموذج ذي معرّف UUID المطابق. إذا كان لديك حقل باسم "التكلفة المقدرة" ذي معرّف UUID 123abc، فيمكنك استخدام {{ idea.field.123abc.value }} لعرض القيمة المُرسلة. إذا لم تكن متأكدًا من معرّف UUID وتريد التحقق منه، فيمكنك نسخ معرّف أي حقل فكرة أثناء تحرير نموذجه.

بيانات مجموعة الأفكار

  • ideaCollection.title: عنوان مجموعة الأفكار.
  • ideaCollection.question: السؤال الإرشادي أو صياغة التحدي للمجموعة.
  • ideaCollection.stats.ideas.total: العدد الإجمالي للأفكار المقدمة ضمن المجموعة.
  • ideaCollection.status: الحالة الحالية للمجموعة (مثل: نشطة، منتهية.
  • ideaCollection.url.full: عنوان URL الكامل لمجموعة الأفكار
  • ideaCollection.friendlyId: معرّف قصير وبسيط وفريد لمجموعة الأفكار ضمن مساحة العمل
  • ideaCollection.goal.title: عنوان الهدف لمجموعة الأفكار
  • ideaCollection.owner.name: اسم المستخدم الذي أنشأ مجموعة الأفكار.

بيانات مكان العمل

  • workspace.name: عنوان مجموعة الأفكار.
  • workspace.subdomain: السؤال التوجيهي أو صياغة التحدي للمجموعة.
  • workspace.url.full: عنوان URL الكامل للموقع الإلكتروني الذي يمكن للأشخاص استخدامه للانتقال إلى مساحة العمل الخاصة بك. إذا تم تعيين نطاق فرعي مخصص، فسيطابق عنوان URL هذا.

استخدام متغيرات البيانات في السياق

يمكن لمتغيرات البيانات التكيف بناءً على المكان الذي يتم استخدامها فيه. على سبيل المثال:

  • في أوصاف مجموعات الأفكار: استخدم مثلاً {{ ideaCollection.goal.title }} لعرض عنوان هدف المجموعة.
  • في خطوة الإجراء ضمن عملية تشغيل آلي: استخدم مثلاً {{ idea.owner.name }} لاستخدام اسم منشئ الفكرة، أو {{ action.receiver.name }} لكتابة اسم الشخص الذي سيتلقى الرسالة.
  • عبر حقول الأفكار: عند الإشارة إلى قيمة حقل سابق داخل نموذج فكرة أو حقل فكرة من داخل نموذج إدخال، يمكنك استخدام {{context.field.<UUID>.value}} للإشارة إلى قيمة حقل آخر.

التنسيق والتخصيص

يمكن دمج متغيرات البيانات مع الدوال و العوامل لتنسيق وتخصيص الإخراج:

  • كتابة اسم المستخدم بأحرف كبيرة: {{ CAPITALIZE(sessionUser.name) }}
  • عرض عدد الأفكار مع قيمة احتياطية: {{ ideaCollection.stats.ideas.total != 0 ? ideaCollection.stats.ideas.total : "No ideas yet" }}
  • تقريب متوسط نقاط تفاعل المستخدم: {{ ROUND(sessionUser.stats.engagementScore) }}

مثال على عنوان ووصف لمجموعة أفكار لتوفير التكاليف

السؤال: كيف يمكننا توفير التكاليف في {{ sessionUser.country }}؟

الوصف: مرحباً {{ sessionUser.name }}، وأهلاً بك في حملة {{ workspace.name }} السنوية المهمة لتوفير التكاليف!

يسعدنا الاطلاع على أفكارك المبتكرة لخفض النفقات. لقد جمعنا معاً حتى الآن {{ ideaCollection.stats.ideas.total }} فكرة — شاركنا صوتك أيضاً!

يمكنك دائمًا رؤية لوحة المتصدرين لهذه المجموعة بزيارة:

‍{{ ideaCollection.url.full }}/لوحة المتصدرين.

أفضل ممارسات لمتغيرات البيانات

  • استخدم تسميات وصفية: تأكد من توثيق أسماء المتغيرات بوضوح لتجنب الالتباس.
  • اختبر المحتوى الديناميكي: قم بمعاينة الصفحات لضمان عرض متغيرات البيانات للمعلومات المتوقعة.
  • ادمج مع متغيرات الترجمة المخصصة: استخدم المتغيرات داخل الترجمات لضمان التعريب مع الحفاظ على المحتوى ديناميكيًا.
  • تجنّب القيم الفارغة: عند استخدام متغيرات قد لا تحتوي دائماً على بيانات (مثل حقول النماذج المخصصة)، أدرج نصاً احتياطياً لضمان تجربة سلسة، على سبيل المثال: {{ idea.stats.comments > 0 ? idea.stats.comments + " comments" : "No comments yet" }}

من خلال استخدام متغيرات البيانات بفعالية، يمكنك إنشاء محتوى مخصص مدعوم بالبيانات يتكيف مع مدخلات المستخدم ويعزز تجربة مكان العمل بشكل عام.