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:

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ń")

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świetli każdy kod QR dla każdego pola. Obrazy kodów QR są jednocześnie linkiem. Kopiując ten link, można zobaczyć w nim część <channel>, która ma być użyta w następujących przykładach:

Umieszczanie pionka

GET https://time2.emphasize.de/connect/<channel>/push/<fieldName>/<fieldColor>

gdzie /<fieldColor> jest opcjonalne.

Zdejmowanie pionka z planszy

GET https://time2.emphasize.de/connect/<channel>/off

Dodaj informację

GET https://time2.emphasize.de/connect/<channel>/info/<infoText>

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

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

<url>/check_pdo.php

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

Umieszczanie pionka

POST <url>/?topic=<customer>
PAYLOAD [{"s": %CURRENT_TIMESTAMP%, "n": "field name", "c": "#ffab11"}]

Nazwa pola „field name" i kolor „#ffab11" mają zostać zastąpione odpowiednimi nazwami widocznego pola.

Więcej szczegółów: 1

Zdejmowanie pionka z planszy

Osiąga się to poprzez ograniczenie poprzedniego zdarzenia (w poniższym przykładzie wartości „e").

POST <url>/?topic=<customer>
PAYLOAD [{"s": 1704270072000, "n": "nazwa pola", "c": "#ffab11", "e": %CURRENT_TIMESTAMP%}]

Więcej szczegółów: 1

Dodaj informację

POST <url>/?topic=<customer>
PAYLOAD [{"s": %CURRENT_TIMESTAMP%, "i": "jakieś informacje"}]

Więcej szczegółów: 1

Ustawianie układu

POST <url>/?topic=<customer>
PAYLOAD [{"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:


Footnotes

  1. Zamiast %CURRENT_TIMESTAMP% można również określić pewien znacznik czasu uniksowego (GMT z milisekundami), na przykład 1704270072000 dla 3.1.2024 rano. 2 3