دليل تكامل Tasker

دليل شامل لإضافات Tasker في تطبيق Agenda

ملخص: يوفر تطبيق Agenda تسع (9) إضافات لتطبيق Tasker تتيح لك أتمتة كاملة لإدارة مواعيدك. تشمل هذه الإضافات إنشاء المواعيد وإكمالها وحذفها والاستعلام عنها وتبديل التنبيهات، بالإضافة إلى الاستجابة للأحداث ومراقبة الحالات لحظياً.

النوع العدد الوصف
الإجراءات (Actions) 5 تنفيذ عمليات على المواعيد
الأحداث (Events) 2 الاستجابة لمحفزات المواعيد
الحالات (States) 2 مراقبة حالة المواعيد لحظياً

محتويات الدليل

المتطلبات

ACTION الإجراءات (Actions)

الإجراءات هي عمليات يمكنك تنفيذها على المواعيد من خلال Tasker. يوفر Agenda خمسة إجراءات مختلفة.

1. إنشاء موعد (Create Appointment)

ينشئ موعداً جديداً في تطبيق Agenda بالمعاملات المحددة. يمكنك تحديد العنوان والوصف والموقع والتاريخ والوقت والتصنيف والأولوية والتذكير ونمط التكرار.

معاملات الإدخال:

المعامل النوع مطلوب القيمة الافتراضية الوصف
title نص نعم - عنوان الموعد
description نص لا فارغ وصف الموعد
location نص لا فارغ موقع الموعد
date نص لا اليوم+ساعة تاريخ الموعد بصيغة yyyy-MM-dd
time نص لا 09:00 وقت البداية بصيغة HH:mm
endTime نص لا - وقت النهاية بصيغة HH:mm
isAllDay منطقي لا false هل الموعد طوال اليوم
category نص لا PERSONAL تصنيف الموعد
priority نص لا MEDIUM أولوية الموعد
reminderEnabled منطقي لا true تفعيل التذكير
reminderTime نص لا FIFTEEN_MIN وقت التذكير قبل الموعد
notes نص لا فارغ ملاحظات إضافية
repeatMode نص لا NONE نمط التكرار

متغيرات الإخراج:

المتغير النوع الوصف
%success منطقي هل نجحت العملية
%appointment_id رقم معرّف الموعد المُنشأ
%error نص رسالة الخطأ في حالة الفشل

2. إكمال موعد (Complete Appointment)

يُعلّم موعداً محدداً كمكتمل. يمكنك تحديد الموعد عبر المعرّف أو العنوان.

معاملات الإدخال:

المعامل النوع مطلوب القيمة الافتراضية الوصف
appointmentId رقم لا* - معرّف الموعد المراد إكماله
title نص لا* - عنوان الموعد للبحث عنه

ملاحظة: يجب توفير واحد على الأقل من appointmentId أو title. عند إكمال الموعد، يتم إطلاق حدث اكتمال الموعد تلقائياً. كما يتم إنشاء النسخة التالية تلقائياً للمواعيد المتكررة.

متغيرات الإخراج:

المتغير النوع الوصف
%success منطقي هل نجحت العملية
%appointment_id رقم معرّف الموعد المُكتمل

3. حذف موعد (Delete Appointment)

يحذف موعداً محدداً نهائياً من التطبيق. يمكنك تحديد الموعد عبر المعرّف أو العنوان.

معاملات الإدخال:

المعامل النوع مطلوب القيمة الافتراضية الوصف
appointmentId رقم لا* - معرّف الموعد المراد حذفه
title نص لا* - عنوان الموعد للبحث عنه

ملاحظة: يجب توفير واحد على الأقل من appointmentId أو title. عند حذف الموعد، يتم إلغاء جميع التنبيهات المعلقة المرتبطة به تلقائياً.

متغيرات الإخراج:

المتغير النوع الوصف
%success منطقي هل نجحت العملية
%appointment_id رقم معرّف الموعد المحذوف

4. استعلام المواعيد (Query Appointments)

يستعلم عن المواعيد حسب معايير مختلفة ويُرجع قائمة بالنتائج. يمكنك الاستعلام عن مواعيد اليوم أو الغد أو القادمة أو المتأخرة أو ضمن نطاق تاريخ محدد.

معاملات الإدخال:

المعامل النوع مطلوب القيمة الافتراضية الوصف
queryType نص لا TODAY نوع الاستعلام
startDate نص لا - تاريخ البداية بصيغة yyyy-MM-dd (لنوع DATE_RANGE)
endDate نص لا - تاريخ النهاية بصيغة yyyy-MM-dd (لنوع DATE_RANGE)
category نص لا - تصفية حسب التصنيف
limit رقم لا - الحد الأقصى لعدد النتائج

أنواع الاستعلام:

القيمة الوصف
TODAY مواعيد اليوم
TOMORROW مواعيد الغد
UPCOMING المواعيد القادمة
OVERDUE المواعيد المتأخرة
DATE_RANGE مواعيد ضمن نطاق تاريخ محدد (يتطلب startDate و endDate)

متغيرات الإخراج (لكل موعد):

المتغير النوع الوصف
%success منطقي هل نجح الاستعلام
%count رقم عدد المواعيد المُرجعة
%appointment_ids() مصفوفة معرّفات المواعيد
%titles() مصفوفة عناوين المواعيد
%dates() مصفوفة تواريخ المواعيد
%times() مصفوفة أوقات المواعيد
%categories() مصفوفة تصنيفات المواعيد
%priorities() مصفوفة أولويات المواعيد

5. تبديل التنبيه (Toggle Reminder)

يُفعّل أو يُعطّل التنبيه لموعد محدد عبر معرّفه.

معاملات الإدخال:

المعامل النوع مطلوب القيمة الافتراضية الوصف
appointmentId رقم نعم - معرّف الموعد
enabled منطقي لا true تفعيل (true) أو تعطيل (false) التنبيه

متغيرات الإخراج:

المتغير النوع الوصف
%success منطقي هل نجحت العملية
%appointment_id رقم معرّف الموعد

EVENT الأحداث (Events)

الأحداث هي محفزات يُطلقها Agenda عند حدوث شيء معين. يمكنك استخدامها في ملفات Tasker التعريفية (Profiles) لتشغيل مهام تلقائياً.

1. تنبيه موعد (Appointment Reminder)

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

متى يُطلق:

عند عرض إشعار التذكير للموعد في الوقت المحدد.

متغيرات الإخراج:

المتغير النوع الوصف
%appointment_id رقم معرّف الموعد
%title نص عنوان الموعد
%description نص وصف الموعد
%date نص تاريخ الموعد
%time نص وقت الموعد
%category نص تصنيف الموعد
%priority نص أولوية الموعد
%location نص موقع الموعد

2. اكتمال موعد (Appointment Completed)

يُطلق هذا الحدث عند إكمال أي موعد، سواء من داخل التطبيق أو من الإشعار أو عبر إجراء Tasker.

متى يُطلق:

عند إكمال موعد من التطبيق، أو من زر الإكمال في الإشعار، أو عبر إجراء إكمال Tasker.

متغيرات الإخراج:

المتغير النوع الوصف
%appointment_id رقم معرّف الموعد المكتمل
%title نص عنوان الموعد
%description نص وصف الموعد
%date نص تاريخ الموعد
%time نص وقت الموعد
%category نص تصنيف الموعد
%priority نص أولوية الموعد

STATE الحالات (States)

الحالات هي ظروف مستمرة يراقبها Tasker. تكون الحالة إما نشطة أو غير نشطة، ويمكنك تشغيل مهام عند تغيّر الحالة.

1. يوجد مواعيد الآن (Has Appointments Now)

تكون هذه الحالة نشطة عند وجود مواعيد نشطة في الوقت الحالي (أي مواعيد بدأت ولم تنتهِ بعد).

الإعداد: لا يتطلب أي إعداد. يُرجع true عند وجود مواعيد نشطة حالياً و false عند عدم وجودها.

2. يوجد مواعيد متأخرة (Has Overdue Appointments)

تكون هذه الحالة نشطة عند وجود مواعيد متأخرة غير مكتملة (أي مواعيد تجاوز وقتها دون إكمالها).

الإعداد: لا يتطلب أي إعداد. يُرجع true عند وجود مواعيد متأخرة غير مكتملة و false عند عدم وجودها.

القيم المرجعية

الجداول التالية توضح القيم المقبولة لمعاملات الإضافات المختلفة.

التصنيفات (Categories)

القيمة الوصف
WORK عمل
PERSONAL شخصي
HEALTH صحة
MEETING اجتماع
FAMILY عائلة
EDUCATION تعليم
FINANCE مالية
OTHER أخرى

الأولويات (Priorities)

القيمة الوصف
LOW منخفضة
MEDIUM عادية
HIGH عالية
URGENT عاجل

أوقات التذكير (Reminder Times)

القيمة الوصف
FIVE_MIN 5 دقائق
TEN_MIN 10 دقائق
FIFTEEN_MIN 15 دقيقة
THIRTY_MIN 30 دقيقة
ONE_HOUR ساعة
TWO_HOURS ساعتين
ONE_DAY يوم

أنماط التكرار (Repeat Modes)

القيمة الوصف
NONE بدون تكرار
DAILY يومي
WEEKLY أسبوعي
MONTHLY شهري
YEARLY سنوي

أمثلة عملية

فيما يلي عشرة أمثلة عملية توضح كيفية استخدام إضافات Agenda مع Tasker لأتمتة مختلف السيناريوهات.

1. إنشاء اجتماعات يومية تلقائياً

الهدف: إنشاء موعد اجتماع فريق العمل تلقائياً كل يوم أحد في الساعة 8 مساءً.

الملف التعريفي: الوقت → كل أحد الساعة 20:00

المهمة:

Profile: Weekly Team Meeting Time: Every Sunday at 20:00 Enter Task: Create Meeting A1: Agenda - Create Appointment title: "اجتماع فريق العمل" description: "اجتماع أسبوعي لمراجعة المهام" category: MEETING priority: HIGH date: %DATE time: "20:00" endTime: "21:00" reminderTime: THIRTY_MIN location: "قاعة الاجتماعات"

2. إشعار ذكي عند الوصول للعمل

الهدف: عند الاتصال بشبكة WiFi الخاصة بالعمل، يتم استعلام مواعيد اليوم وعرض ملخص.

الملف التعريفي: الحالة → اتصال WiFi بشبكة العمل

المهمة:

Profile: Work Arrival Briefing State: Wifi Connected [SSID: WorkNetwork] Enter Task: Show Today Summary A1: Agenda - Query Appointments queryType: TODAY category: WORK A2: If %count > 0 A3: Notify Title: "مواعيد العمل اليوم" Text: "لديك %count موعد عمل اليوم. الأول: %titles(1) الساعة %times(1)" Icon: calendar A4: End If

3. إكمال المواعيد المتأخرة تلقائياً

الهدف: كل ليلة الساعة 11 مساءً، يتم البحث عن المواعيد المتأخرة وإكمالها تلقائياً.

الملف التعريفي: الوقت → كل يوم الساعة 23:00

المهمة:

Profile: Auto Complete Overdue Time: Every Day at 23:00 Enter Task: Complete Overdue A1: Agenda - Query Appointments queryType: OVERDUE A2: For %id In %appointment_ids() A3: Agenda - Complete Appointment appointmentId: %id A4: End For A5: If %count > 0 A6: Notify Title: "تم إكمال المواعيد المتأخرة" Text: "تم إكمال %count موعد متأخر تلقائياً" A7: End If

4. تنبيه اجتماع بالصوت

الهدف: عند تذكير موعد من تصنيف "اجتماع"، يتم نطق العنوان والوقت بصوت عالٍ باستخدام TTS.

الملف التعريفي: الحدث → تنبيه موعد من Agenda

المهمة:

Profile: Voice Meeting Alert Event: Agenda - Appointment Reminder Enter Task: Speak Meeting A1: If %category eq MEETING A2: Say Text: "تذكير: لديك اجتماع %title الساعة %time" Engine: Google TTS Stream: Notification A3: Else A4: Say Text: "تذكير: %title الساعة %time" Engine: Google TTS Stream: Notification A5: End If

5. احتفال عند إكمال موعد

الهدف: عند إكمال أي موعد، يتم تشغيل صوت احتفالي وعرض إشعار تحفيزي.

الملف التعريفي: الحدث → اكتمال موعد من Agenda

المهمة:

Profile: Celebrate Completion Event: Agenda - Appointment Completed Enter Task: Celebrate A1: Play Ringtone Type: Notification Sound: Achievement A2: Notify Title: "أحسنت! تم إكمال الموعد" Text: "لقد أكملت: %title - استمر في الإنجاز!" Icon: check_circle Priority: High A3: Wait Seconds: 3 A4: Notify Cancel Title: "أحسنت! تم إكمال الموعد"

6. عدم الإزعاج أثناء المواعيد

الهدف: تفعيل وضع عدم الإزعاج تلقائياً عند وجود مواعيد نشطة حالياً، وإيقافه عند انتهائها.

الملف التعريفي: الحالة → يوجد مواعيد الآن من Agenda

المهمة:

Profile: DND During Appointments State: Agenda - Has Appointments Now Enter Task: Enable DND A1: Do Not Disturb Mode: Priority Only A2: Notify Title: "وضع عدم الإزعاج" Text: "تم تفعيل عدم الإزعاج - لديك موعد الآن" Exit Task: Disable DND A1: Do Not Disturb Mode: Off A2: Notify Title: "انتهى وقت الموعد" Text: "تم إيقاف وضع عدم الإزعاج"

7. تنبيه متكرر للمواعيد المتأخرة

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

الملف التعريفي: الحالة → يوجد مواعيد متأخرة من Agenda

المهمة:

Profile: Overdue Nagging State: Agenda - Has Overdue Appointments Enter Task: Nag About Overdue A1: Agenda - Query Appointments queryType: OVERDUE A2: Notify Title: "لديك %count موعد متأخر!" Text: "الموعد الأول: %titles(1) - أكمله الآن" Icon: warning Priority: Max A3: Wait Minutes: 30 A4: Goto Number: 1 Exit Task: Stop Nagging A1: Notify Cancel Title: "لديك %count موعد متأخر!"

8. إنشاء موعد بالصوت

الهدف: استخدام الإدخال الصوتي لإنشاء موعد جديد بسرعة عبر الأمر الصوتي.

الملف التعريفي: الاختصار → أيقونة على الشاشة الرئيسية

المهمة:

Task: Voice Create Appointment A1: Say Text: "ما عنوان الموعد؟" Engine: Google TTS A2: Get Voice Title: "عنوان الموعد" Language: ar A3: Variable Set Name: %voice_title To: %VOICE A4: Say Text: "في أي ساعة؟ مثال: 14:30" Engine: Google TTS A5: Get Voice Title: "وقت الموعد" Language: ar A6: Variable Set Name: %voice_time To: %VOICE A7: Agenda - Create Appointment title: %voice_title time: %voice_time category: PERSONAL priority: MEDIUM A8: If %success eq true A9: Say Text: "تم إنشاء الموعد: %voice_title" A10: End If

9. تقرير أسبوعي

الهدف: كل يوم جمعة الساعة 6 مساءً، يتم إنشاء تقرير بمواعيد الأسبوع القادم وإرساله.

الملف التعريفي: الوقت → كل جمعة الساعة 18:00

المهمة:

Profile: Weekly Report Time: Every Friday at 18:00 Enter Task: Generate Report A1: Variable Set Name: %start To: %DATE A2: Variable Add Name: %end_offset Value: 7 A3: Agenda - Query Appointments queryType: DATE_RANGE startDate: %start endDate: %end_date A4: Variable Set Name: %report To: "تقرير الأسبوع القادم:\n" A5: For %i From 1 To %count A6: Variable Set Name: %report To: "%report\n- %titles(%i) | %dates(%i) الساعة %times(%i)" A7: End For A8: Notify Title: "تقرير الأسبوع القادم" Text: "%report" Icon: assignment Priority: High

10. كتم التنبيهات حسب الموقع

الهدف: عند الاتصال بسماعة Bluetooth محددة (مثلاً في السيارة)، يتم تعطيل التنبيهات لجميع مواعيد اليوم.

الملف التعريفي: الحالة → اتصال Bluetooth بجهاز محدد

المهمة:

Profile: Mute Reminders While Driving State: BT Connected [Name: Car_Speaker] Enter Task: Disable Reminders A1: Agenda - Query Appointments queryType: TODAY A2: For %id In %appointment_ids() A3: Agenda - Toggle Reminder appointmentId: %id enabled: false A4: End For A5: Notify Title: "تم كتم التنبيهات" Text: "تم تعطيل تنبيهات %count موعد أثناء القيادة" Exit Task: Enable Reminders A1: Agenda - Query Appointments queryType: TODAY A2: For %id In %appointment_ids() A3: Agenda - Toggle Reminder appointmentId: %id enabled: true A4: End For A5: Notify Title: "تم تفعيل التنبيهات" Text: "تم إعادة تفعيل تنبيهات مواعيد اليوم"

استكشاف الأخطاء

الإضافات لا تظهر في Tasker

تأكد من تثبيت كل من تطبيق Agenda وتطبيق Tasker على جهازك. أعد تشغيل Tasker بعد تثبيت Agenda. إذا استمرت المشكلة، أعد تشغيل الجهاز.

الإجراءات تفشل

تحقق من المعاملات المطلوبة لكل إجراء. تأكد من أن القيم المُدخلة صحيحة (مثل صيغة التاريخ yyyy-MM-dd وصيغة الوقت HH:mm). راجع متغير %err لمعرفة سبب الخطأ.

الأحداث لا تُطلق

تأكد من أن تطبيق Tasker يعمل في الخلفية ولم يتم إيقافه بواسطة النظام. قم بإيقاف تحسين البطارية لكل من Tasker و Agenda. تأكد من السماح لكلا التطبيقين بالعمل في الخلفية في إعدادات الجهاز.

الحالات لا تتحدث

أعد تشغيل مراقبة Tasker من إعدادات التطبيق. تأكد من أن Tasker يملك الصلاحيات اللازمة. جرّب إعادة إنشاء الملف التعريفي (Profile) الذي يستخدم الحالة.