واجهة برمجة التطبيقات (API)

يقوم تطبيق Time2Emphasize تلقائيًا بإنشاء مفتاح API، يُستخدم للاتصال. استبدل <customer> بهذا المفتاح في النص التالي.

تغيير اللغة

يفتح تطبيق Time2Emphasize باللغة التي يدعمها الجهاز. يمكن تغيير اللغة باستخدام الروابط التالية:

الأفريكانية, العربية, الأرمنية, الأذرية, الباسكية, البيلاروسية, البنغالية, البوسنية, البلغارية, الكتالونية, [الوسطى] الخمير، الصينية، الكرواتية، الدنماركية، الألمانية، الإنجليزية، الإسبرانتو، الإستونية، الفنلندية، الفرنسية، الغيلية، الجاليكية, الجورجية, اليونانية, الغوجاراتية, الهايتية, العبرية, الهندية, الأيسلندية, الإندونيسية, الأيرلندية, الإيطالية, اليابانية، الكانادا، الكازاخية، الكورية، اللاتفية، الليتوانية، اللوكسمبورغية، المقدونية، الماليزية، المالطية، المنغولية، الهولندية، النرويجية، الفارسية، البولندية، البرتغالية، الرومانية، الروسية، السويدية، الصربية، السلوفاكية، السلوفينية، الإسبانية، التاميلية، التيلوجوية، التايلاندية، التشيكية، التركية، الأوكرانية، المجرية، الأويغورية، الأوزبكية، الفيتنامية، الويلزية، الفريزية الغربية

التصدير والاستيراد وإعادة الضبط

في تطبيق Time2Emphasize، يمكنك تصدير البيانات التفصيلية (بصيغة JSON) وجميع الإدخالات (بصيغة CSV) إلى مربع الحوار. تتيح لك خاصية "التصدير والاستيراد وإعادة الضبط" تصدير البيانات (إنشاء نسخة احتياطية) واستيرادها (استعادة نسخة احتياطية). كما يمكنك مسح جميع الإدخالات السابقة (إعادة الضبط عن طريق الحذف).

إعادة ضبط جميع الإعدادات

يمكن إعادة ضبط تطبيق Time2Emphasize إلى إعدادات المصنع الأصلية عبر الرابط التالي:

https://time2.emphasize.de?a=reset

تنبيه: سيؤدي هذا إلى حذف تخطيط الحقول وجميع بيانات الوقت المسجلة على الجهاز!

إنشاء اتصالات

يمكن أيضًا تهيئة الاتصالات يدويًا في [Dialog](https://time2.emphasize.de/ar/connections/) عبر القائمة الموجودة ضمن "الاتصالات" كبديل لفتح الروابط الموضحة أدناه. هنا، يؤدي النقر على الأيقونة الأولى في أعلى القائمة إلى نسخ عنوان URL الخاص بهذا الاتصال إلى الحافظة.

Connections Dialog

تتيح بعض الاتصالات التحكم في عناصر تتبع الوقت عبر نقاط النهاية في Time2Emphasize REST API.

استقبال الأنشطة، على سبيل المثال، عبر مسح رمز الاستجابة السريعة (QR code)

https://time2.emphasize.de?m=e

طباعة الصفحة (Ctrl + P) تطبع قائمة بجميع رموز QR.

يظهر وضع رمز QR، الذي يعرض جميع رموز QR في الحقول، في شريط الأدوات.

يمكن الوصول إلى اتصالات "إقران الجهاز" و"استلام الأنشطة" عبر نقاط النهاية في واجهة برمجة تطبيقات Time2Emphasize REST.

وضع الشكل

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

وضع الشكل

يتم وضع الشكل من جميع الحقول عن طريق إرسال استعلام off.

إضافة معلومات

تُضاف المعلومات إلى المخطط الزمني عن طريق إرسال استعلام info.

الاتصال بجهاز آخر

https://time2.emphasize.de?m=a

ثم، في نافذة الحوار (https://time2.emphasize.de/ar/connections/)، انسخ الرابط من قائمة "الاتصالات" وافتحه على الجهاز الآخر. إذا لزم الأمر، أعد ضبط الجهاز الآخر مسبقًا.

اتصال للمشاهد

https://time2.emphasize.de?m=v

ثم، في مربع الحوار (https://time2.emphasize.de/ar/connections/)، انسخ الرابط من قائمة "الاتصالات" وأرسله إلى المشاهد. عند فتح المشاهد للرابط، سيشاهد تخطيط الحقل والموضع الحالي للشكل، لكن لن يتمكن من إجراء أي تغييرات بنفسه.

اتصال لعرض الحالة

https://time2.emphasize.de?m=p

ثم، في نافذة الحوار (Dialog)(https://time2.emphasize.de/ar/connections/)، انسخ كود HTML من قائمة "الاتصالات" والصقه في صفحة ويب لعرض الحالة الحالية للعامة.

يمكنك أيضًا دمج عدة عروض حالة مختلفة من نسخ مختلفة من Time2Emphasis. للقيام بذلك، أدرج الجزء <script>...</script> مرة واحدة فقط (في النهاية، قبل وسم إغلاق body). إليك مثال:

<!DOCTYPE html>
<html>
  <body>
    Person A Status:
    <a data-channel="y89h2je1vs" href="https://www.emphasize.de" title="free time-reporting tool" class="time2-badge"> Time2Emphasize <span class="time2-event">time-reporting tool</span></a>
    und Person B Status:
    <a data-channel="a9110wvv67" href="https://www.emphasize.de" title="free time-reporting tool" class="time2-badge"> Time2Emphasize <span class="time2-event">time-reporting tool</span></a>

    <script>...</script>
  </body>
</html>

الاتصال بموقع التخزين

https://time2.emphasize.de?m=s&c=<customer>&d=<url>

لتحميل ملف إعداد خادم التخزين: ZIP

يتوفر كود المصدر للجميع في مستودع GitHub التالي: time2.store

المتطلبات: يجب توفر Nginx وPHP وPDO-SQLite/MySQL! للتحقق من المتطلبات وتحديد الرابط، افتح الصفحة التالية:

https://<url>/check_pdo.php

يمكن بعد ذلك حذف الملف check_pdo.php من الخادم.

يمكن الوصول إلى اتصال "الموقع" عبر نقطة نهاية في واجهة برمجة تطبيقات REST الخاصة بـ Time2Emphasize (https://time2.emphasize.de/api/).

تعيين رقم

يتم تعيين الرقم إلى حقل يتم إرسال طلب POST إليه مع كائن حدث يحتوي على القيم التالية: %CURRENT_TIMESTAMP%، n: اسم الحقل، و c: لون الحقل. مثال على حمولة POST:

[{"s": %CURRENT_TIMESTAMP%, "n": "Arbeiten", "c": "#4aff00"}]

إدراج شكل

يتم إدراج الشكل من جميع الحقول عن طريق إرسال استعلام POST (https://time2.emphasize.de/api/#operations-tag-post "Time2Emphasize REST API") مع كائن حدث يحتوي على القيمة s: %CURRENT_TIMESTAMP%. مثال على حمولة POST:

[{"s": %CURRENT_TIMESTAMP%}]

إضافة المعلومات

تُضاف المعلومات إلى الجدول الزمني عن طريق إرسال طلب POST إلى واجهة برمجة تطبيقات Time2Emphasize REST API، مع كائن حدث يحتوي على القيمتين: %CURRENT_TIMESTAMP% و i: نص المعلومات. مثال على حمولة طلب POST:

[{"s": %CURRENT_TIMESTAMP%, "i": "meine Info"}]

ضبط تقسيم الحقول

يتم ضبط التقسيم عن طريق إرسال استعلام POST (https://time2.emphasize.de/api/#operations-tag-post "Time2Emphasize REST API") مع كائن تخطيط. مثال على حمولة POST:

[{"v":"2","format":"time.emphasize","r":{"s":[{"s":[{"n":"one","c":"#4aff00"},{"n":"two","c":"#ffaa11"}],"l":"h"},{"n":"three","c":"#308a11"}],"l":"v"}}]

يستخدم هذا المثال تخطيطًا بثلاثة حقول: "واحد"، "اثنان"، و"ثلاثة".

Example Layout

إنشاء الفواتير

يُفتح عرض إنشاء الفواتير من خلال القائمة الموجودة أسفل "إنشاء فواتير". الفواتير المُنشأة متوافقة مع ZUGFeRD (ملف PDF مع مرفق XML) ويمكن التحقق من صحتها، على سبيل المثال، هنا.

يمكن أيضًا استخدام العرض بدون تتبع الوقت؛ ولكن في حال استخدام كليهما، يمكن إنشاء بنود الفاتورة تلقائيًا من الوقت المُسجل!

Invoice with Items

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

Invoice bar may be scrollable

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

` شريط الفاتورة قابل للتمرير

` فاتورة مع الأصناف


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

![فتح صفحة إدخال البائع](./assets/invoice_seller.png "فتح صفحة إدخال البائع")

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


![تعديل رمز التخطيط](./assets/invoice_layout_code.png "تعديل رمز التخطيط")

إذا لم يعد التخطيط صحيحًا، يمكنك استعادة الحالة الأصلية باستخدام زر "إعادة الضبط" أسفل حقل الإدخال.

![إعادة ضبط رمز التخطيط](./assets/invoice_layout_reset.png "إعادة ضبط رمز التخطيط")

يتم تخزين بيانات إدخال الفواتير المُنشأة في المتصفح أو على الجهاز فقط، ويمكن إعادة تحميلها بتحديد الخيار المناسب في حقل إدخال "رقم الفاتورة". سيظهر رمز ⚠️ للتحذير من أن رقم الفاتورة موجود بالفعل. سيؤدي النقر على رمز ⚠️ إلى إنشاء رقم فاتورة جديد غير مستخدم تلقائيًا.

يمكن إدخال جميع بيانات العملاء المُستخدمين سابقًا في صفحة إدخال "المستلم" بسرعة عن طريق تحديد الخيار المناسب في حقل "الاسم".

تؤثر اللغة المُختارة أيضًا على الإعدادات الأولية. يمكن تغيير لغة عرض "إنشاء الفواتير" والقيم النموذجية وقوالب التخطيط عبر الروابط التالية:

[الأفريكانية](https://time2.emphasize.de/af/invoice/), [العربية](https://time2.emphasize.de/ar/invoice/), [الأرمنية](https://time2.emphasize.de/hy/invoice/), [الأذرية](https://time2.emphasize.de/az/invoice/), [الباسكية](https://time2.emphasize.de/eu/invoice/), [البيلاروسية](https://time2.emphasize.de/be/invoice/), [البنغالية](https://time2.emphasize.de/bn/invoice/), [البوسنية](https://time2.emphasize.de/bs/invoice/) [البلغارية](https://time2.emphasize.de/bg/invoice/)، [الكتالونية](https://time2.emphasize.de/ca/invoice/)، [الخميرية الوسطى](https://time2.emphasize.de/km/invoice/)، [الصينية](https://time2.emphasize.de/zh/invoice/)، [الكرواتية](https://time2.emphasize.de/hr/invoice/)، [الدنماركية](https://time2.emphasize.de/da/invoice/)، [الألمانية](https://time2.emphasize.de/de/invoice/)، [الإنجليزية](https://time2.emphasize.de/en/invoice/)، [الإسبرانتو](https://time2.emphasize.de/eo/invoice/)، [إستونية](https://time2.emphasize.de/et/invoice/)، [فنلندية](https://time2.emphasize.de/fi/invoice/)، [فرنسية](https://time2.emphasize.de/fr/invoice/)، [غيلية](https://time2.emphasize.de/gd/invoice/)، [جاليكية](https://time2.emphasize.de/gl/invoice/)، [جورجية](https://time2.emphasize.de/ka/invoice/)، [يونانية](https://time2.emphasize.de/el/invoice/)، [غوجاراتية](https://time2.emphasize.de/gu/invoice/)، [هايتية](https://time2.emphasize.de/ht/invoice/)، [العبرية](https://time2.emphasize.de/iw/invoice/)، [الهندية](https://time2.emphasize.de/hi/invoice/)، [الأيسلندية](https://time2.emphasize.de/is/invoice/)، [الإندونيسية](https://time2.emphasize.de/id/invoice/)، [الأيرلندية](https://time2.emphasize.de/ga/invoice/)، [الإيطالية](https://time2.emphasize.de/it/invoice/)، [اليابانية](https://time2.emphasize.de/ja/invoice/)، [الكانادا](https://time2.emphasize.de/kn/invoice/)، [الكازاخية](https://time2.emphasize.de/kk/invoice/)، [الكورية](https://time2.emphasize.de/ko/invoice/)، [اللاتفية](https://time2.emphasize.de/lv/invoice/)، [الليتوانية](https://time2.emphasize.de/lt/invoice/)، [اللوكسمبورغية](https://time2.emphasize.de/lb/invoice/)، [المقدونية](https://time2.emphasize.de/mk/invoice/)، [الماليزية](https://time2.emphasize.de/ms/invoice/)، [المالطية](https://time2.emphasize.de/mt/invoice/)، [المنغولية](https://time2.emphasize.de/mn/invoice/)، [الهولندية](https://time2.emphasize.de/nl/invoice/)، [النرويجية](https://time2.emphasize.de/no/invoice/)، [الفارسية](https://time2.emphasize.de/fa/invoice/)، [البولندية](https://time2.emphasize.de/pl/invoice/)، [البرتغالية](https://time2.emphasize.de/pt/invoice/)، [الرومانية](https://time2.emphasize.de/ro/invoice/)، [الروسية](https://time2.emphasize.de/ru/invoice/)، [السويدية](https://time2.emphasize.de/sv/invoice/)، [الصربية](https://time2.emphasize.de/sr/invoice/)، [السلوفاكية](https://time2.emphasize.de/sk/invoice/)، [السلوفينية](https://time2.emphasize.de/sl/invoice/)، [الإسبانية](https://time2.emphasize.de/es/invoice/)، [التاميلية](https://time2.emphasize.de/ta/invoice/)، [التيلوجوية](https://time2.emphasize.de/te/invoice/)، [التايلاندية](https://time2.emphasize.de/th/invoice/)، [التشيكية](https://time2.emphasize.de/cs/invoice/)، [التركية](https://time2.emphasize.de/tr/invoice/)، [الأوكرانية](https://time2.emphasize.de/uk/invoice/)، [المجرية](https://time2.emphasize.de/hu/invoice/)، [الأويغورية](https://time2.emphasize.de/ug/invoice/), [الأوزبكية](https://time2.emphasize.de/uz/invoice/), [الفيتنامية](https://time2.emphasize.de/vi/invoice/), [الويلزية](https://time2.emphasize.de/cy/invoice/), [الفريزية الغربية](https://time2.emphasize.de/fy/invoice/)"