إنشاء متغيّر مخصّص

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

1. لبدء أول نموذج متغير، انقر على "النماذج" في شريط التنقل الأيمن، ثم انقر على الزر جديد ضمن قسم نماذج المتغيرات.

2. في علامة التبويب المعلومات، اختر اسم المتغيّر ووصفه.

   الاسم هو ما سيتم عرضه للمستخدمين عند انتقالهم لتنفيذ هذا المتغير عبر واجهة مستخدم إدارة العلامات.

   الوصف هو ما يبدو بالضبط - وصف موجز (200 حرف أو أقل) لما يفعله هذا المتغير.

3. انقر على تحديث لمعاينة النموذج.

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

4. انقر على الحقول لإضافة حقول إلى النموذج المتغيّر.

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

5. انقر على إضافة حقل واختَر جدول بسيط. استبدل الاسم الافتراضي (على سبيل المثال "simpleTable1") بـ "list". في معاينة النموذج، انقر على تحديث.

   كرِّر هذه الخطوة مع إدخال النص وأطلق عليه "المصفوفة"، ومربَّعي اختيار هما باسم "use_array" و"sort"، وإدخال نص يُسمى "المُحدِّد". بالنسبة إلى "delimiter"، يمكنك منحها القيمة التلقائية "," من خلال النقر على رمز الترس، وتبديل "القيمة التلقائية" إلى وضع التفعيل، ثم ملء حقل إدخال القيمة التلقائية الجديد.

6. انقر على علامة التبويب الشفرة وأدخل جافا سكريبت في وضع الحماية في المحرر:

   var input = data.array;
   
   if (!data.use_array) {
     input = [];
     for (var i = 0; i < data.list.length; i++) {
       input.push(data.list[i].values);
     }
   }
   
   if (data.sort) {
     input.sort();
   }
   
   return input.join(data.delimiter || ',');
   

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

   • data حقول

     هناك بعض الحقول التي يتم الوصول إليها من خارج النطاق data العام. سيحتوي data على القيم التي أعددتها في الخطوة السابقة. ولهذا السبب يمكننا الوصول إلى data.use_array وdata.sort وdata.list وdata.delimiter.

   • تم ضبط delimiter على القيمة التلقائية "," في حال عدم توفير data.delimiter. من الممارسات الجيدة تعيين القيم الافتراضية لأحد الحقول إذا كان ذلك مناسبًا. وهذا يسهّل على المستخدمين استخدام النموذج المتغير، لأنه لا يلزمهم ملء كل حقل من أجل استخدام المتغير.

7. انقر على حفظ لحفظ تقدمك. سيؤدي ذلك إلى تحميل أي أذونات تم اكتشافها إلى محرر النماذج.

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

8. في علامة التبويب معاينة النموذج، أضِف بعض القيم لإدخال "القيم"، وانقر على تشغيل الرمز، وانظر إلى وحدة التحكّم للاطّلاع على ناتج المتغيّر.

   في حال وجود أي أخطاء، ستظهر في نافذة وحدة التحكّم.

9. انقر على حفظ، وأغلق محرر النماذج

   يجب أن يكون النموذج المتغير جاهزًا للاستخدام الآن.