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

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

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

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

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

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

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

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

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

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

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

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

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

• idea.friendlyId: معرف قصير وفريد للفكرة.
• idea.url.full: الرابط الكامل للفكرة.
• 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 المقابل. إذا كان لديك حقل لـ "التكلفة المقدرة" بالمعرف 123abc، يمكنك استخدام {{ idea.field.123abc.value }} لعرض القيمة المقدمة. إذا كنت غير متأكد من UUID وترغب في التأكد، يمكن نسخ معرف أي حقل فكرة عند تحرير النموذج الخاص به.

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

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

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

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

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

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

• في أوصاف مجموعة الأفكار: استخدم مثلاً {{ 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 : "لا توجد أفكار حتى الآن" }}
• قرب متوسط درجة تفاعل المستخدم: {{ ROUND(sessionUser.stats.engagementScore) }}

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

السؤال: كيف يمكننا تقليل التكاليف في {{ sessionUser.country }}?

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

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

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

‍{{ ideaCollection.url.full }}/leaderboard.

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

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

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