API

Aplikacja Time2Emphasize automatycznie generuje klucz API, który jest używany do połączeń. Należy go zastąpić poniższym <customer>.

Zmiana języka

Aplikacja Time2Emphasize otworzy się w językach wykrytych na urządzeniu i obsługiwanych. Język można zmienić za pomocą następujących linków: afrikaans, arabski, armeński, azerski, baskijski, białoruski, bengalski, bośniacki, bułgarski, kataloński, khmerski środkowy, chiński, chorwacki, duński, niemiecki, angielski, esperanto, estoński, fiński, francuski, gaelicki, galicyjski, gruziński, grecki, gudżaracki, haitański, hebrajski, hindi, islandzki, indonezyjski, irlandzki, włoski, japoński, kannada, kazachski, koreański, łotewski, litewski, luksemburski, macedoński, malajski, maltański, mongolski, niderlandzki, norweski, perski, polski, portugalski, rumuński, rosyjski, szwedzki, serbski, słowacki, słoweński, hiszpański, tamilski, telugu, tajski, czeski, turecki, ukraiński, węgierski, ujgurski, uzbecki, wietnamski, walijski, zachodni fryzyjski

Eksport, import i reset

Aplikacja Time2Emphasize umożliwia eksportowanie (tworzenie kopii zapasowej) i importowanie (przywracanie kopii zapasowej) układów pól (w formacie JSON) oraz wszystkich danych śledzenia (w formacie CSV) w dialogu „eksport, import i reset". Wszystkie dane śledzenia można również usunąć (zresetować).

Resetuj wszystkie ustawienia

Aplikację Time2Emphasize można zresetować do domyślnych, otwierając:

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

Uwaga: spowoduje to usunięcie wszystkich układów pól i danych śledzenia z urządzenia!

Tworzenie połączeń

Połączenia można utworzyć, otwierając łącza, jak opisano poniżej. Alternatywnie można to również skonfigurować ręcznie w dialogu dostępnym w pozycji menu „connections". Tutaj możesz również skopiować adres URL tego połączenia do schowka, klikając na pierwszą ikonę u góry listy.

![dialog połączeń](./assets/dialog-connections.png „dialog połączeń")

Niektóre połączenia umożliwiają sterowanie obiektami do śledzenia czasu za pomocą punktów końcowych w Time2Emphasize REST API.

Odbieranie działań, na przykład poprzez skanowanie kodów QR

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

Po wydrukowaniu strony (Ctrl + P) drukowana jest lista wszystkich kodów QR.

Na pasku narzędzi mode qrcode pojawia się przycisk trybu QRCode, który wyświetla każdy kod QR dla każdego pola.

Połączenia "Sparuj urządzenie" i "Otrzymuj działania" są dostępne poprzez punkty końcowe w Time2Emphasize REST API.

Umieszczanie pionka

Figurę umieszcza się na polu poprzez wysłanie żądania push.

Zdejmowanie pionka z planszy

Figurę usuwa się ze wszystkich pól poprzez wysłanie żądania off.

Dodaj informację

Informacja jest wprowadzana na oś czasu poprzez wysłanie żądania info.

Parowanie z innym urządzeniem

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

Po otwarciu tego dialogu dostępnego przez pozycję menu „connections" można użyć do skopiowania łącza parowania. Następnie należy je otworzyć na innym urządzeniu. Rozważ zresetowanie urządzenia wcześniej.

Połączenie dla widza

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

Po otwarciu tego dialogu dostępnego przez pozycję menu „connections" można użyć do skopiowania linku parowania i wysłania tego linku do widza. Otwierając link widz może zobaczyć układ i pozycję pionka bez możliwości zmiany żadnego z nich.

Połączenie do wyświetlania odznaki statusu

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

Po otwarciu tego dialogu dostępnego przez pozycję menu „connections" można użyć do skopiowania kodu html w celu wstawienia do dowolnej witryny internetowej w celu publicznego udostępnienia bieżącego statusu.

time2emphasize-badge

Można dodać odznaki kilku instancji Time2Emphasize na tej samej stronie, dodając część <script>...</script> tylko raz (najlepiej na końcu, tuż przed zamykającym znacznikiem body). Przykład pokazujący ten układ:

<!DOCTYPE html>
<html>
<body>
stan osoby A:
<a data-channel="y89h2je1vs" href="https://www.emphasize.de" title="darmowe narzędzie do raportowania czasu" class="time2-badge"> Time2Emphasize <span class="time2-event">narzędzie do raportowania czasu</span></a>
i stan osoby B:
<a data-channel="a9110wvv67" href="https://www.emphasize.de" title="darmowe narzędzie do raportowania czasu" class="time2-badge"> Time2Emphasize <span class="time2-event">narzędzie do raportowania czasu</span></a>

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

Łączenie się z przechowywanie

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

Pobierz, aby zainstalować usługę przechowywania: ZIP

Źródła są publicznie dostępne w następującym repozytorium GitHub: time2.store

Wymagania: Dostępne Nginx, PHP i PDO-SQLite/-MySql! Aby to sprawdzić i ustalić <url>, otwórz w przeglądarce:

https://<url>/check_pdo.php

check_pdo.php można następnie usunąć na serwerze.

Połączenie "Lokalizacja" jest dostępne poprzez punkt końcowy w REST API Time2Emphasize.

Umieszczanie pionka

Pionek jest umieszczany na polu poprzez wysłanie żądania [post](https://time2.emphasize.de/api/#operations-tag-post „Interfejs REST API Time2Emphasize”) z obiektem zdarzenia zawierającym wartości s: %CURRENT_TIMESTAMP%, n: nazwa pola i c: kolor pola. Przykładowy ładunek POST:

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

Zdejmowanie pionka z planszy

Osiąga się to poprzez wysłanie żądania post z obiektem zdarzenia zawierającym tylko wartość s: %CURRENT_TIMESTAMP%. Przykładowy ładunek POST:

[{"s": %CURRENT_TIMESTAMP%}]

Dodaj informację

Informacje są dodawane do osi czasu poprzez wysłanie żądania post z obiektem zdarzenia o wartościach s: %CURRENT_TIMESTAMP% i i: tekst informacyjny. Przykładowy ładunek POST:

[{"s": %CURRENT_TIMESTAMP%, "i": "kilka informacji"}]

Ustawianie układu

Układ jest ustawiany poprzez wysłanie żądania post z obiektem układu. Przykładowy ładunek 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"}}]

Przykład ustawia układ z trzema polami „one", „two" i „three".

![Przykładowy układ](../assets/example_layout.png „przykładowy układ")

Utwórz faktury

Menu pod „Utwórz faktury” otwiera widok umożliwiający tworzenie faktur. Wygenerowane faktury są zgodne ze standardem ZUGFiRD (plik PDF z załącznikiem XML) i można je sprawdzić, np. tutaj.

Widoku tego można używać również bez śledzenia czasu — jednak jeśli użyje się obu opcji, pozycje faktury mogą automatycznie pochodzić z zarejestrowanego czasu!

Pasek faktur poniżej

W dolnej części znajduje się pasek, który zawsze pokazuje najważniejsze wpisy i symbole, dzięki którym można otwierać kolejne strony wprowadzania danych. Ten pasek można przewijać w pionie, jeśli obszar wyświetlania nie jest wystarczająco szeroki:

Pasek faktury może być przewijalny

Po kliknięciu przycisku „GENERUJ FAKTURĘ” otworzy się okno dialogowe z opisem brakujących ważnych wpisów. Otworzy się jedna z odpowiednich stron wprowadzania danych, na której odpowiednie pole wprowadzania danych zostanie zaznaczone na czerwono. Jeżeli wszystkie informacje są dostępne, plik PDF zostaje wygenerowany, wyświetlony i może zostać natychmiast wysłany lub zapisany.

popraw brakujące, ważne wpisy

Strony wejściowe można również otworzyć za pomocą ikon znajdujących się po prawej stronie paska.

Otwórz stronę wprowadzania danych dla sprzedawcy

Układ obszaru głównego i stopki można otworzyć i edytować za pomocą ostatniej ikony. Oprócz bezpośredniej edycji możliwe jest także wprowadzanie drobnych zmian w kodzie źródłowym.

Edytuj kod układu

Jeśli układ nie jest już poprawny, możesz przywrócić stan początkowy, klikając przycisk „Resetuj” znajdujący się poniżej pola wprowadzania danych.

Resetuj kod układu

Dane wejściowe wygenerowanych faktur są zapisywane wyłącznie w przeglądarce lub na urządzeniu i mogą zostać ponownie wczytane poprzez dokonanie wyboru w polu wejściowym „Numer faktury”. Następnie pojawi się symbol ⚠️ ostrzegający, że numer faktury już istnieje. Kliknięcie symbolu ⚠️ spowoduje automatyczne wygenerowanie nowego, wcześniej nieużywanego numeru faktury.

Wszystkie dane klientów, które zostały już użyte na stronie wprowadzania danych „Odbiorca”, można szybko ustawić, wybierając odpowiednią opcję w polu „Nazwa”.

Ustawienia językowe mają również wpływ na status początkowy. Język można zatem zmienić również dla widoku „Tworzenie faktur”, przykładowych wartości i szablonów układu za pomocą następujących linków:

afrikaans, arabski, armeński, azerski, baskijski, białoruski, bengalski, bośniacki, bułgarski, kataloński, khmerski środkowy, chiński, chorwacki, duński, niemiecki, angielski, esperanto, estoński, fiński, francuski, gaelicki, galicyjski, gruziński, grecki, gudżaracki, haitański, hebrajski, hindi, islandzki, indonezyjski, irlandzki, włoski, japoński, kannada, kazachski, koreański, łotewski, litewski, luksemburski, macedoński, malajski, maltański, mongolski, niderlandzki, norweski, perski, polski, portugalski, rumuński, rosyjski, szwedzki, serbski, słowacki, słoweński, hiszpański, tamilski, telugu, tajski, czeski, turecki, ukraiński, węgierski, ujgurski, uzbecki, wietnamski, walijski, zachodni fryzyjski