Token Cache
نظرة عامة
فيما يلي شرح عملي يركز على الأعمال لنوع المستند Token Cache كما يُستخدم داخل دفاتر:
ما هو استخدام نوع المستند Token Cache في عمليات الأعمال؟
نوع المستند Token Cache هو أداة داعمة لعمليات التكامل مع الأنظمة والخدمات الخارجية.
وظيفته الأساسية هي الاحتفاظ ببيانات الدخول المؤقتة التي تسمح لدفاتر بالتواصل بسلاسة مع أنظمة أخرى (مثل بوابات دفع، خدمات رسائل، منصات حكومية أو أنظمة شركاء).
من منظور الأعمال، Token Cache يضمن أن: - عمليات التكامل تعمل بشكل مستمر دون انقطاع. - لا يضطر النظام لإعادة طلب بيانات الدخول في كل مرة. - تتم المعاملات الخارجية بسرعة وموثوقية.
المتطلبات الأساسية أو الإعدادات قبل استخدام Token Cache
قبل أن يكون لـ Token Cache دور فعّال في الأعمال، يجب توفر ما يلي:
- وجود تكامل مفعل مع جهة خارجية (مثل مزود خدمة أو شريك أعمال).
- اعتماد بيانات الدخول والتصاريح الخاصة بهذا التكامل.
- تحديد الجهة أو الخدمة التي سيتم تبادل البيانات معها ضمن دفاتر.
ملاحظة مهمة: المستخدمون عادة لا ينشئون أو يعدّلون Token Cache يدوياً، بل يتم التعامل معه تلقائياً عند تفعيل التكاملات.
سير العمل النموذجي وكيف يتناسب مع عمليات الأعمال
بدء تكامل جديد
تقوم الشركة بتفعيل تكامل مع خدمة خارجية لدعم عملية أعمال (تحصيل، إشعارات، تقارير، إلخ).تأكيد الصلاحيات
يتم التحقق من صلاحية الاتصال بين دفاتر والنظام الخارجي.تخزين بيانات الدخول المؤقتة
هنا يأتي دور Token Cache، حيث يتم حفظ هذه البيانات مؤقتاً لاستخدامها لاحقاً.تشغيل العمليات اليومية
- إرسال فواتير
- استقبال مدفوعات
- مزامنة بيانات
تتم هذه العمليات بسلاسة دون الحاجة لإعادة تسجيل الدخول في كل مرة.
تجديد تلقائي عند الحاجة
عند انتهاء صلاحية البيانات، يتم تحديثها دون تدخل المستخدم.
السيناريوهات التجارية الرئيسية التي يكون فيها Token Cache ضرورياً
يكون Token Cache ضرورياً في حالات مثل:
- التحصيل الإلكتروني: عند الاتصال ببوابات الدفع لتنفيذ عمليات سداد متكررة.
- التكامل مع جهات حكومية: لإرسال أو استقبال بيانات تنظيمية بشكل دوري.
- خدمات الرسائل والتنبيهات: إرسال رسائل للعملاء أو الموظفين تلقائياً.
- الربط مع أنظمة شركاء: مثل شركات التمويل، الشحن، أو مزودي الخدمات.
في كل هذه السيناريوهات، يضمن Token Cache استمرارية العمل دون تعطّل.
اعتبارات مهمة للمستخدمين
- لا يتطلب تدخلاً يومياً: هذا النوع من المستندات يعمل في الخلفية لدعم الأعمال.
- مؤشر لصحة التكامل: أي خلل في العمليات المتكاملة قد يكون مرتبطاً بصلاحية البيانات المخزنة.
- الأمان والاستمرارية: وجود Token Cache يقلل من المخاطر التشغيلية الناتجة عن انقطاع الاتصال.
- للمتابعة فقط: غالباً يطلع عليه مسؤولو النظام أو فرق الأعمال عند مراجعة حالة التكاملات.
الخلاصة
Token Cache هو عنصر أساسي غير مرئي في نجاح التكاملات داخل دفاتر.
هو لا يدير عملية أعمال مباشرة، لكنه يمكّن العديد من العمليات الحيوية من العمل بثبات وكفاءة، مما ينعكس إيجاباً على تجربة العملاء وسرعة تنفيذ الأعمال.
المعلومات الأساسية
- الوحدة: التكاملات
- نوع المستند: نظام
الحقول
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| user | مستخدم | رابط | مستخدم | المستخدم المرتبط بالرمز للوصول عبر دفاتر | |
| connected_app | Connected App | رابط | Connected App | التطبيق المتصل الذي يستخدم الرمز داخل دفاتر | |
| provider_name | اسم المزود | البيانات | - | اسم مزود الخدمة المانح للرمز | |
| access_token | رمز وصول | كلمة مرور | - | رمز وصول آمن لتمكين التكامل | |
| refresh_token | تحديث رمز | كلمة مرور | - | رمز لتجديد الوصول دون إعادة مصادقة | |
| expires_in | ينتهي في | الباحث | - | مدة صلاحية الرمز بالثواني | |
| state | المحافظة | البيانات | - | قيمة تتبع أمان لطلب المصادقة | |
| scopes | نطاقات | جدول | OAuth Scope | نطاقات الصلاحيات الممنوحة للتطبيق | |
| success_uri | Success URI | البيانات | - | رابط إعادة التوجيه بعد نجاح المصادقة | |
| token_type | Token Type | البيانات | - | نوع الرمز المستخدم للمصادقة |
الجداول الفرعية
نطاقات (OAuth Scope)
| اسم الحقل | التسمية | النوع | مطلوب | الخيارات | الوصف |
|---|---|---|---|---|---|
| scope | نطاق | البيانات | - | نطاق الصلاحيات الممنوحة للتطبيقات عبر دفاتر |
الصلاحيات
| الدور | قراءة | كتابة | إنشاء | حذف | إرسال | إلغاء |
|---|---|---|---|---|---|---|
| All | ✓ | ✓ | ||||
| System Manager | ✓ | ✓ |
أنواع المستندات ذات الصلة
| نوع المستند | العلاقة | الوحدة |
|---|---|---|
| Connected App | يربط إلى | التكاملات |
| مستخدم | يربط إلى | النواة |