رابط برنامه‌نویسی کاربردی (API)

برنامه Time2Emphasize به طور خودکار یک کلید API تولید می‌کند که برای ارتباط استفاده می‌شود. در متن زیر، عبارت <customer> را با این کلید جایگزین کنید.

تغییر زبان

برنامه Time2Emphasize به زبانی که دستگاه پشتیبانی می‌کند باز می‌شود. شما می‌توانید با استفاده از لینک‌های زیر زبان را تغییر دهید:

آفریقایی، عربی، ارمنی، آذربایجانی، پایه، بلاروسی، بنگالی، بوسنیایی، بلغاری، کاتالان، [مرکزی] خمر، چینی، کرواتی، دانمارکی، آلمانی، انگلیسی، اسپرانتو، استونیایی، فنلاندی، فرانسوی، گالیایی گالیسیایی، گرجی، یونانی، گجراتی، هائیتیایی، عبری، هندی، ایسلندی، اندونزیایی، ایرلندی، ایتالیایی، ژاپنی، کانارا، قزاقستانی، کره‌ای، لتونیایی، لیتوانیایی، لوکزامبورگی، مقدونی، مالزی، مالتی، مغولی هلندی، نروژی، فارسی، لهستانی، پرتغالی، رومانیایی، روسی، سوئدی، صربی، اسلواکی، اسلوونیایی، اسپانیایی، تامیلی، تلوگویی، تایلندی، چکی، ترکی، اوکراینی، مجارستانی، اویغوری، ازبکی، ویتنامی، ولزی، فریزی غربی

خروجی گرفتن، وارد کردن و تنظیم مجدد

در برنامه Time2Emphasize، می‌توانید داده‌های دقیق (با فرمت JSON) و تمام ورودی‌ها (با فرمت CSV) را به کادر محاوره‌ای خروجی بگیرید. ویژگی «خروجی گرفتن، وارد کردن و تنظیم مجدد» به شما امکان می‌دهد داده‌ها را خروجی بگیرید (یک نسخه پشتیبان ایجاد کنید) و آن را وارد کنید (یک نسخه پشتیبان بازیابی کنید). همچنین می‌توانید تمام ورودی‌های قبلی را پاک کنید (با حذف، تنظیم مجدد کنید).

تنظیم مجدد همه تنظیمات

می‌توانید برنامه Time2Emphasize را از طریق لینک زیر به تنظیمات اولیه کارخانه برگردانید:

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

احتیاط: این کار طرح فیلد و تمام داده‌های زمانی ثبت‌شده روی دستگاه را حذف می‌کند!

ایجاد اتصالات

اتصالات همچنین می‌توانند به صورت دستی در [Dialog](https://time2.emphasize.de/fa/connections/) از طریق منوی زیر "Connections" به عنوان جایگزینی برای باز کردن لینک‌های توضیح داده شده در زیر پیکربندی شوند. در اینجا، کلیک بر روی اولین آیکون در بالای لیست، URL آن اتصال را در کلیپ بورد کپی می‌کند.

Connections Dialog

برخی از اتصالات امکان کنترل اشیاء ردیابی زمان را از طریق نقاط پایانی در Time2Emphasize REST API فراهم می‌کنند.

دریافت فعالیت‌ها، به عنوان مثال، از طریق اسکن کد QR

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

چاپ صفحه (Ctrl + P) لیستی از تمام کدهای QR را چاپ می‌کند.

حالت کد QR که تمام کدهای QR را در فیلدها نمایش می‌دهد، در نوار ابزار ظاهر می‌شود.

اتصالات "Pair Device" و "Receive Activities" از طریق نقاط انتهایی در Time2Emphasize REST API قابل دسترسی هستند.

قرار دادن یک شکل

شکل در فیلدی قرار می‌گیرد که در آن یک پرس‌وجوی push ارسال می‌شود.

قرار دادن شکل

شکل با ارسال یک پرس‌وجوی off از همه فیلدها قرار می‌گیرد.

افزودن اطلاعات

اطلاعات با ارسال یک پرس‌وجوی info به جدول زمانی اضافه می‌شود.

اتصال به دستگاه دیگر

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

سپس، در گفتگو، لینک را از منوی «اتصالات» کپی کرده و آن را در دستگاه دیگر باز کنید. در صورت لزوم، دستگاه دیگر را از قبل تنظیم مجدد کنید.

اتصال برای یک بیننده

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

سپس، در Dialog، لینک را از منوی «Connections» کپی کرده و برای بیننده ارسال کنید. وقتی بیننده لینک را باز می‌کند، طرح فیلد و موقعیت فعلی شکل را مشاهده می‌کند، اما نمی‌تواند خودش تغییری ایجاد کند.

اتصال برای نمایش وضعیت

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

سپس، در Dialog، کد منبع HTML را از منوی "Connections" کپی کرده و آن را در یک صفحه وب قرار دهید تا وضعیت فعلی به صورت عمومی به اشتراک گذاشته شود.

time2emphasize-badge

همچنین می‌توانید چندین نمایش وضعیت مختلف را از نمونه‌های مختلف Time2Emphasize ادغام کنید. برای انجام این کار، قسمت <script>...</script> را فقط یک بار (در انتها، قبل از تگ body بسته) وارد کنید. در اینجا مثالی آورده شده است:

time2emphasize-badge

<!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

کد منبع در مخزن گیت‌هاب زیر به صورت عمومی در دسترس است: time2.store

الزامات: Nginx، PHP و PDO-SQLite/MySQL باید در دسترس باشند! برای بررسی الزامات و تعیین <url>، صفحه زیر را باز کنید:

https://<url>/check_pdo.php

سپس می‌توان check_pdo.php را از سرور حذف کرد.

اتصال "location" از طریق یک نقطه پایانی در Time2Emphasize REST API (https://time2.emphasize.de/api/) قابل دسترسی است.

تنظیم یک شکل

شکل روی فیلدی تنظیم می‌شود که در آن یک درخواست POST با یک شیء رویداد حاوی مقادیر s: %CURRENT_TIMESTAMP%، n: نام فیلد و c: رنگ فیلد ارسال می‌شود. مثالی از بار داده POST:

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

قرار دادن یک شکل

شکل با ارسال یک کوئری post با یک شیء رویداد حاوی مقدار s: %CURRENT_TIMESTAMP% از تمام فیلدها قرار می‌گیرد. مثالی از بار داده POST:

[{"s": %CURRENT_TIMESTAMP%}]

افزودن اطلاعات

اطلاعات با ارسال یک کوئری post با یک شیء رویداد حاوی مقادیر s: %CURRENT_TIMESTAMP% و i: متن اطلاعات به جدول زمانی اضافه می‌شود. مثالی از بار داده POST:

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

تنظیم تقسیم فیلد

تقسیم‌بندی با ارسال یک کوئری post به همراه یک شیء layout انجام می‌شود. مثالی از payload مربوط به 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"}}]

این مثال از یک طرح‌بندی با سه فیلد استفاده می‌کند: "یک"، "دو" و "سه".

طرح‌بندی مثال

ایجاد فاکتورها

نمای ایجاد فاکتورها از طریق منوی زیر "ایجاد فاکتورها" باز می‌شود. فاکتورهای تولید شده با ZUGFeRD سازگار هستند (PDF با پیوست XML) و می‌توانند اعتبارسنجی شوند، به عنوان مثال، اینجا.

این نما همچنین می‌تواند بدون ردیابی زمان استفاده شود. با این حال، اگر هر دو استفاده شوند، اقلام فاکتور می‌توانند به طور خودکار از زمان ثبت شده تولید شوند!

فاکتور با اقلام

در پایین نواری وجود دارد که فیلد ورودی شماره فاکتور و نمادهایی را نمایش می‌دهد که صفحات ورودی بیشتری را باز می‌کنند. اگر فضای نمایش به اندازه کافی بزرگ نباشد، این نوار می‌تواند به صورت عمودی قابل پیمایش باشد:

نوار فاکتور ممکن است قابل پیمایش باشد

با کلیک بر روی دکمه "ایجاد فاکتور" در صورت وجود هرگونه ورودی مهم، یک کادر محاوره‌ای باز می‌شود که توضیح می‌دهد چه ورودی‌هایی باید باشند. یکی از صفحات ورودی مربوطه باز می‌شود که فیلد ورودی مربوطه با رنگ قرمز برجسته شده است. پس از تکمیل تمام اطلاعات، فایل PDF تولید، نمایش داده می‌شود و می‌توان آن را ذخیره کرد.

ورودی‌های مهم از دست رفته را اصلاح کنید

صفحات ورودی را می‌توان از طریق آیکون‌های سمت راست نوار نیز باز کرد.

صفحه ورودی را برای فروشنده باز کنید

طرح‌بندی قسمت اصلی و پاورقی را می‌توان از طریق آخرین آیکون باز و ویرایش کرد. علاوه بر ویرایش مستقیم، تغییرات دقیق‌تر در کد منبع نیز امکان‌پذیر است.

ویرایش کد طرح‌بندی

اگر طرح‌بندی دیگر صحیح نیست، می‌توانید با استفاده از دکمه "تنظیم مجدد" در زیر فیلد ورودی، طرح‌بندی اولیه را بازیابی کنید.

تنظیم مجدد کد طرح‌بندی

داده‌های ورودی برای فاکتورهای تولید شده فقط در مرورگر یا دستگاه ذخیره می‌شوند و با انتخاب گزینه مناسب در فیلد ورودی "شماره فاکتور" می‌توان آنها را دوباره بارگیری کرد. سپس یک نماد ⚠️ ظاهر می‌شود که هشدار می‌دهد شماره فاکتور از قبل وجود دارد. کلیک بر روی نماد ⚠️ به طور خودکار یک شماره فاکتور جدید و استفاده نشده ایجاد می‌کند.

تمام داده‌های مربوط به مشتریان قبلاً استفاده شده در صفحه ورودی "گیرنده" را می‌توان با انتخاب گزینه مناسب در فیلد "نام" به سرعت وارد کرد.

زبان انتخاب شده نیز بر طرح‌بندی اولیه تأثیر می‌گذارد. بنابراین، زبان نمای «ایجاد فاکتورها»، مقادیر نمونه و قالب‌های طرح‌بندی را می‌توان از طریق لینک‌های زیر تغییر داد:

آفریقایی، عربی، ارمنی، آذربایجانی، باسک، بلاروسی، بنگالی، بوسنیایی بلغاری، کاتالان، خمر مرکزی، چینی، کرواتی، دانمارکی، آلمانی، انگلیسی، اسپرانتو، استونیایی، فنلاندی، فرانسوی، گالیک، گالیسیایی، گرجی، یونانی، گجراتی، هائیتیایی، عبری، هندی، ایسلندی، اندونزیایی، ایرلندی، ایتالیایی، ژاپنی، کانارا، قزاقستانی، کره‌ای، لتونیایی، لیتوانیایی، لوکزامبورگی، مقدونی، مالایی، مالتی، مغولی، هلندی، نروژی، فارسی، لهستانی، پرتغالی، رومانیایی، روسی، سوئدی، صربی، اسلواکی، اسلوونیایی، اسپانیایی، تامیلی، تلوگو، تایلندی، چکی، ترکی، اوکراینی، مجارستانی، اویغوری، ازبکی، ویتنامی، ولزی، فریزی غربی