API

De Time2Emphasize-app genereert automatisch een API-sleutel, die wordt gebruikt voor verbindingen. Deze moet hieronder worden vervangen door <klant>.

De taal wijzigen

De Time2Emphasize-app wordt geopend in de talen die op het apparaat zijn gedetecteerd en die worden ondersteund. De taal kan worden gewijzigd via de volgende links:

Exporteren, importeren en resetten

De Time2Emphasize-app maakt het mogelijk om veldlay-outs (in JSON-formaat) en alle trackinggegevens (in CSV-formaat) in het dialoogvenster "exporteren, importeren en resetten" te exporteren (een back-up maken) en te importeren (een back-up herstellen). Alle trackinggegevens kunnen ook worden verwijderd (resetten).

Alle instellingen resetten

De Time2Emphasize-app kan worden gereset naar de standaardinstellingen door het volgende te openen:

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

Let op: hiermee worden alle veldlay-outs en trackinggegevens van het apparaat verwijderd!

Verbindingen maken

Verbindingen kunnen worden gemaakt door de links te openen zoals hieronder beschreven. Als alternatief kan dit ook handmatig worden geconfigureerd in de dialoog die beschikbaar is via het menu-item "connections". Hier kunt u ook de URL voor deze verbinding naar het klembord kopiëren door op het eerste pictogram bovenaan de lijst te klikken.

connections dialog

Ontvangstactiviteiten bijvoorbeeld door QRCodes te scannen

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

Door de pagina af te drukken (Ctrl + P) wordt een lijst met alle QRCodes afgedrukt.

In de werkbalk mode qrcode verschijnt een QRCode-modusknop, die elke QRCode per veld weergeeft. De QRCode-afbeeldingen zijn tegelijkertijd een link. Door deze link te kopiëren kan men het <channel> gedeelte zien, dat gebruikt moet worden in de volgende voorbeelden:

Het plaatsen van de pion

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

waarbij /<fieldColor> optioneel is.

De pion van het bord halen

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

Voeg info toe

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

Koppelen met een ander apparaat

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

Nadat u dit hebt geopend, kunt u de dialoog die bereikbaar is via het menu-item "connections" gebruiken om de koppelingslink te kopiëren. Deze moet vervolgens op het andere apparaat worden geopend. Overweeg om het apparaat vooraf te resetten.

Verbinding voor een toeschouwer

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

Na het openen hiervan kan de dialoog die bereikbaar is via het menu-item "connections" worden gebruikt om de koppelingslink te kopiëren en deze link naar de toeschouwer te sturen. Door de link te openen kan de toeschouwer de lay-out en positie van de pion bekijken zonder dat hij een van beide kan wijzigen.

Verbinding om een ​​statusbadge weer te geven

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

Na het openen hiervan kan de dialoog die bereikbaar is via het menu-item "connections" worden gebruikt om de html-code te kopiëren en in te voegen in een website om de huidige status openbaar te delen.

time2emphasize-badge

Het is mogelijk om badges van meerdere Time2Emphasize-instanties op dezelfde pagina toe te voegen door het <script>...</script>-gedeelte slechts één keer toe te voegen (bij voorkeur aan het einde, net voor de afsluitende body-tag). Een voorbeeld van deze lay-out:

<!DOCTYPE html>
<html>
<body>
persoon A staat:
<a data-channel="y89h2je1vs" href="https://www.emphasize.de" title="gratis tijdrapportagetool" class="time2-badge"> Time2Emphasize <span class="time2-event">tijdrapportagetool</span></a>
en persoon B staat:
<a data-channel="a9110wvv67" href="https://www.emphasize.de" title="gratis tijdrapportagetool" class="time2-badge"> Time2Emphasize <span class="time2-event">tijdrapportagetool</span></a>

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

Verbinding maken met een opslag

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

Downloaden om een ​​opslagservice te installeren: ZIP

Vereisten: Nginx, PHP en PDO-SQLite/-MySql beschikbaar! Om dit te controleren en de <url> te bepalen, opent u het volgende in uw browser:

<url>/check_pdo.php

check_pdo.php kan daarna op uw server worden verwijderd.

De pion plaatsen

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

De veldnaam "veldnaam" en kleur "#ffab11" moeten worden vervangen door de overeenkomstige van een zichtbaar veld.

Verdere details: 1

De pion van het bord halen

Dit wordt bereikt door de vorige gebeurtenis te beperken (in het onderstaande voorbeeld de "e"-waarde).

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

Verdere details: 1

Voeg info toe

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

Verdere details: 1

Een lay-out instellen

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"}}]

Het voorbeeld stelt een lay-out in met drie velden "one", "two" en "three".

Example layout

Facturen maken

Via het menu onder "Facturen aanmaken" opent u de weergave voor het aanmaken van facturen. De gegenereerde facturen zijn ZUGFeRD (PDF met XML-bijlage) compatibel en kunnen bijvoorbeeld hier worden gevalideerd.

U kunt de weergave ook gebruiken zonder tijdregistratie. Als u beide opties gebruikt, kunnen de factuurposten automatisch uit de geregistreerde tijd worden gehaald!

Facturenbalk hieronder

Onderaan bevindt zich een balk die steeds de belangrijkste invoervelden en symbolen weergeeft. Via deze balk kunt u verdere invoerpagina's openen. Deze balk kan verticaal worden gescrolld als het weergavegebied niet breed genoeg is:

Factuurbalk kan scrollen

Als u op de knop "FACTUUR GENEREREN" klikt, wordt er een dialoogvenster geopend met een beschrijving van eventuele belangrijke ontbrekende vermeldingen. Er wordt een van de relevante invoerpagina's geopend, waarin het bijbehorende invoerveld rood omlijnd is. Als alle informatie beschikbaar is, wordt de PDF gegenereerd, weergegeven en kan deze direct worden verzonden of opgeslagen.

corrigeer ontbrekende, belangrijke vermeldingen

U kunt de invoerpagina's ook openen via de pictogrammen helemaal rechts op de balk.

Open invoerpagina voor verkoper

Via het laatste pictogram kunt u de indeling van het hoofdgedeelte en de voettekst openen en bewerken. Naast directe bewerking zijn ook fijnere wijzigingen in de broncode mogelijk.

Lay-outcode bewerken

Als de lay-out niet meer correct is, kunt u de oorspronkelijke status herstellen met de knop 'Reset' onder het invoerveld.

Lay-outcode resetten

De invoergegevens voor gegenereerde facturen worden alleen in de browser of op het apparaat opgeslagen en kunnen via de selectie in het invoerveld 'Factuurnummer' opnieuw worden geladen. Vervolgens verschijnt er een ⚠️-symbool, dat u waarschuwt dat het factuurnummer al bestaat. Als u op het ⚠️-symbool klikt, wordt automatisch een factuurnummer gegenereerd dat nog niet eerder is gebruikt.

Alle gegevens van klanten die al op de invoerpagina 'Ontvanger' zijn gebruikt, kunnen snel worden ingesteld via de selectie in het veld 'Naam'.

De taalinstelling heeft ook invloed op de beginstatus. De taal kan daarom ook voor de weergave "Facturen maken", voorbeeldwaarden en lay-outsjablonen worden gewijzigd via de volgende links:


Footnotes

  1. In plaats van %CURRENT_TIMESTAMP% kan men ook een bepaalde unix-tijdstempel opgeven (GMT met milliseconden), bijvoorbeeld 1704270072000 voor de 3.1.2024 in de ochtend. 2 3