تعد معلمات الاستعلام رائعة لأسباب واضحة. عندما تتيح استعلامات مستكشف البيانات للمستخدمين غير التقنيين، فقد يكونون مرتبكين أحيانًا بالاسم (حتى لو كان مجرد اسم متغير به شرطة سفلية).
هل يمكنك إعطاء اسم مستعار لمعلمة استعلام بحيث تظهر باسم أجمل أسفل الاستعلام؟
نعم، لدي ذلك الآن، ولكنه ليس مصقولًا تمامًا عندما تحاول جعل هذه التقارير سهلة الاستخدام للأشخاص غير التقنيين على الإطلاق في أقسام مثل المبيعات والتسويق وما إلى ذلك.
في الواقع، سيكون من الجيد لو ذهب أبعد من ذلك وقدم لك أيضًا خيار تحديد وصف للأداة/أيقونة المعلومات.
أحد الحلول الأبسط سيكون التحقق من متغير تسمية اختياري بالتنسيق الحالي الذي تستخدمونه جميعًا، على سبيل المثال:
-- [params]
-- text :user_group
-- label: "اسم حساب Salesforce للعميل الذي تريد البحث عنه في هذا الاستعلام."
-- text :topic_id
اعترف بأنني لم أكن مطورًا بدوام كامل منذ أكثر من 5 سنوات والآن، لذلك لا يمكنني الادعاء بمعرفة تفاصيل التنفيذ الحالي ولا التعقيدات المحتملة للاقتراح التالي… ولكنه سيكون رائعًا إذا قمتم بتطبيق Front Matter في بداية استعلام SQL. يمكن أن يكون Front Matter بصيغة yaml أو toml أو حتى json ويبدو بالتأكيد أجمل من التنفيذ الحالي. بصريًا، يبدو أنه سيكون من الأسهل إضافة خيارات أيضًا، في رأيي. قد يبدو استعلام بتطبيق Front Matter نظريًا شيئًا كهذا:
---
user_id:
description: "اسم حساب Salesforce للعميل الذي تريد البحث عنه في هذا الاستعلام."
tooltip: "احصل على هذا من حساب المستخدم في Salesforce، وعادة ما يرتبط بنطاق بريده الإلكتروني. يجب أن يكون مطابقًا تمامًا."
topic_id:
description: "هذا هو معرف الموضوع الذي تريد البحث فيه."
event_attendance_type:
default: 0
---
SELECT ue.user_id, u.name, u.title, ue.email
FROM discourse_post_event_invitees ei
JOIN posts p ON p.id = ei.post_id
JOIN user_emails as ue ON ue.user_id = ei.user_id
JOIN users as u on ei.user_id = u.id
WHERE p.topic_id = :topic_id
AND ei.status = 0