Interfață de programare a aplicațiilor (API)

Aplicația Time2Emphasize generează automat o cheie API, care este utilizată pentru comunicare. Înlocuiți <client> cu această cheie în textul următor.

Schimbați limba

Aplicația Time2Emphasize se deschide în limba acceptată de dispozitiv. Puteți schimba limba folosind următoarele linkuri:

Afrikaans, Arabă, Armeană, Azeră, Limbă de bază, Bielorusă, Bengaleză, Bosniacă, Bulgară, Catalană, [Centrală] Khmeră, Chineză, Croată, Daneză, Germană, Engleză, Esperanto, Estonă, Finlandeză, Franceză, Gaelică, Galiciană, Georgiană, Greacă, Gujarati, Haitiană, Ebraică, Hindi, Islandeză, Indoneziană, Irlandeză, Italiană, Japoneză, Kannada, Kazahă, Coreeană, Letonă, Lituaniană, Luxemburgheză, Macedoneană, Malaeziană, Malteză, Mongolă, Olandeză, Norvegiană, Persană, Poloneză, Portugheză, Română, Rusă, Suedeză, Sârbă, Slovacă, Slovenă, Spaniolă, Tamilă, Telugu, Thailandeză, Cehă, Turcă, Ucraineană, Maghiară, Uigură, Uzbecă, Vietnameză, Galeză, Friziană de Vest

Export, Import și Resetare

Ki Time2Emphasize aplikacia, o aranźmanto e terenosqo (anθ-o formato JSON) thaj sa e garavde date (anθ-o formato CSV) śaj te aven eksportisarde (te keren jekh backup) thaj importisarde (te restaurisaren jekh backup) anθ-o "Export, Import and Restore" dialog box. Sa le data save sas anglal garavde śaj te aven vi xasarde (resetime katar o xasaripe).

Resetare Toate Setările

Puteți reseta aplicația Time2Emphasize la setările inițiale din fabrică prin intermediul următorului link:

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

Atenție: Aceasta va șterge aspectul câmpului și toate datele de timp înregistrate pe dispozitiv!

Creați conexiuni

Conexiunile pot fi configurate și manual în [Dialog](https://time2.emphasize.de/ro/connections/) prin intermediul meniului de la secțiunea „Conexiuni”, ca alternativă la deschiderea linkurilor descrise mai jos. Aici, dacă faceți clic pe prima pictogramă din partea de sus a listei, adresa URL pentru conexiunea respectivă se copiază în clipboard.

Dialog Conexiuni

Unele conexiuni permit controlul obiectelor de urmărire a timpului prin intermediul punctelor finale din API-ul REST Time2Emphasize.

Primirea de activități, de exemplu, prin scanarea codurilor QR

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

Imprimarea paginii (Ctrl + P) imprimă o listă cu toate codurile QR.

Modul cod QR, care afișează toate codurile QR din câmpuri, apare în bara de instrumente.

Conexiunile „Asociere dispozitiv” și „Primire activități” pot fi accesate prin intermediul punctelor finale din API-ul REST Time2Emphasize (https://time2.emphasize.de/api/).

Plasare figură

Figura este plasată pe un câmp prin trimiterea unei cereri push.

Eliminare figură

Figura este eliminată din toate câmpurile prin trimiterea unei cereri off.

Adăugare informații

Informațiile sunt adăugate în cronologie prin trimiterea unei cereri info.

Conectare la un alt dispozitiv

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

Apoi, în Dialog, copiați linkul din meniul „Conexiuni” și deschideți-l pe celălalt dispozitiv. Dacă este necesar, resetați celălalt dispozitiv în prealabil.

Conexiune pentru un vizualizator

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

Apoi, în Dialog, copiați linkul din meniul „Conexiuni” și trimiteți-l către utilizator. Când utilizatorul deschide linkul, va vedea aspectul câmpului și poziția curentă a figurii, dar nu va putea face nicio modificare.

Conexiune pentru afișarea stării

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

Apoi, în Dialog, copiați codul sursă HTML din meniul „Conexiuni” și lipiți-l într-o pagină web pentru a partaja public starea curentă.

time2emphasize-badge

De asemenea, puteți integra mai multe afișaje de stare diferite din diferite instanțe Time2Emphasize. Pentru a face acest lucru, introduceți partea <script>...</script> o singură dată (la sfârșit, înainte de eticheta de închidere body). Iată un exemplu:

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>

Conexiune la o locație de stocare

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

Descărcare pentru configurarea unui server de stocare: [ZIP](../assets/time2-store.zip „Fișiere PHP care vă permit să configurați propriul server de stocare”)

Codul sursă este disponibil publicului în următorul depozit GitHub: time2.store

Cerințe: Nginx, PHP și PDO-SQLite/MySQL trebuie să fie disponibile! Pentru a verifica cerințele și a determina <url>, deschideți următoarea pagină:

https://<url>/check_pdo.php

check_pdo.php poate fi apoi eliminat de pe server.

Conexiunea „locație de stocare” poate fi accesată printr-un punct final din API-ul REST Time2Emphasize.

Setarea unei cifre

Figura este plasată pe un câmp în care este trimisă o interogare post cu un obiect de eveniment care conține valorile s: %CURRENT_TIMESTAMP%, n: numele câmpului și c: culoarea câmpului. Exemplu de sarcină POST:

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

Plasarea unei figuri

Figura este plasată din toate câmpurile prin trimiterea unei interogări post cu un obiect de eveniment care conține valoarea s: %CURRENT_TIMESTAMP%. Exemplu de sarcină POST:

[{"s": %CURRENT_TIMESTAMP%}]

Adăugarea de informații

Informațiile sunt adăugate în cronologie prin trimiterea unei interogări post cu un obiect de eveniment care conține valorile s: %CURRENT_TIMESTAMP% și i: text informativ. Exemplu de sarcină POST:

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

Setarea divizării câmpurilor

Divizarea este setată prin trimiterea unei interogări post cu un obiect layout. Exemplu de sarcină 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"}}]

Acest exemplu folosește un layout cu trei câmpuri: „unu”, „doi” și „trei”.

Exemplu de layout

Crearea facturilor

Dikh pentru crearea facturilor te arakhel pes angluno intermediul meniului de sub „Creați facturi”. Facturile generate sunt compatibile cu ZUGFeRD (PDF cu atatașament XML) și pot fi validate, for example, aici.

Vizualizarea poate fi utilizată și fără urmărirea timpului; cu toate acestea, dacă ambele sunt utilizate, articolele din factură pot fi generate automat din timpul înregistrat!

Factură cu articole

În partea de jos se află o bară care afișează câmpul de introducere a numărului facturii și pictograme care deschid pagini de introducere suplimentare. Această bară poate fi derulabilă pe verticală dacă zona de afișare nu este suficient de lată:

Bara de facturi poate fi derulabilă

Făcând clic pe butonul „GENERAȚI FACTURĂ”, se deschide o casetă de dialog dacă lipsesc informații importante, descriind ce ar trebui să fie. Se deschide una dintre paginile de introducere relevante, cu câmpul de introducere corespunzător evidențiat cu roșu. Dacă toate informațiile sunt complete, PDF-ul este generat, afișat și poate fi salvat.

Corectează intrări lipsă, importante

Paginile de introducere pot fi deschise și prin intermediul pictogramelor din extrema dreaptă a barei.

Deschide pagina de introducere pentru vânzător

Aspectul zonei principale și al subsolului pot fi deschise și editate prin intermediul ultimei pictograme. Pe lângă editarea directă, se pot face și modificări mai detaliate în codul sursă.

Editează codul aspectului

Dacă aspectul nu mai este corect, puteți restaura starea inițială folosind butonul „Resetare” de sub câmpul de introducere.

Resetează codul aspectului

Datele de introducere pentru facturile generate sunt stocate doar în browser sau pe dispozitiv și pot fi reîncărcate selectând opțiunea corespunzătoare în câmpul de introducere „Număr factură”. Va apărea apoi un simbol ⚠️, care avertizează că numărul facturii există deja. Dacă faceți clic pe simbolul ⚠️, se va genera automat un număr de factură nou, neutilizat.

Toate datele pentru clienții utilizați anterior pe pagina de introducere „Destinatar” pot fi introduse rapid selectând opțiunea corespunzătoare în câmpul „Nume”.

Limba selectată afectează și setările inițiale. Limba pentru vizualizarea „Creează facturi”, valorile eșantion și șabloanele de aspect pot fi modificate prin intermediul următoarelor linkuri:

Afrikaans, Arabă, Armeană, Azeră, Bască, Belarusă, Bengaleză, Bosniacă Bulgară, Catalană, Khmeră centrală, Chineză, Croată, Daneză, Germană, Engleză, Esperanto, Estonă, Finlandeză, Franceză, Gaelică, Galiciană, Georgiană, Greacă, Gujarati, Haitiană, Ebraică, Hindi, Islandeză, Indoneziană, Irlandeză, Italiană, Japoneză, Kannada, Kazahă, Coreeană, Letonă, Lituaniană, Luxemburgheză, Macedoneană, Malaeziană, Malteză, Mongolă, Olandeză, Norvegiană, Persană, Poloneză, Portugheză, Română, Rusă, Suedeză, Sârbă, Slovacă, Slovenă, Spaniolă, Tamilă, Telugu, Thailandeză, Cehă, Turcă, Ucraineană, Maghiară, Uigură, Uzbecă, Vietnameză, Galeză, Frizonă occidentală