API

Time2Emphasize 应用程序会自动生成一个 API 密钥,用于连接。下面将用 <customer> 替换该密钥。

更改语言

Time2Emphasize 应用程序将以设备上检测到的受支持的语言打开。可以通过以下链接更改语言:

导出、导入和重置

Time2Emphasize 应用允许在 对话框"导出、导入和重置"中导出(创建备份)和导入(恢复备份)字段布局(JSON 格式)和所有跟踪数据(CSV 格式)。所有跟踪数据也可以被删除(重置)。

重置所有设置

Time2Emphasize 应用可以通过打开以下设置重置为默认设置:

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

注意:这会从设备中删除所有字段布局和跟踪数据!

创建连接

可以通过打开下面描述的链接来创建连接。或者,也可以在菜单项"connections"上的 dialog 中手动配置。 您还可以通过单击列表顶部的第一个图标将此连接的 URL 复制到剪贴板。

connections dialog

例如通过扫描二维码接收活动

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

通过打印页面 (Ctrl + P),可以打印所有二维码的列表。

在工具栏 mode qrcode 中,会出现一个二维码模式按钮,它将显示每个字段的每个二维码。二维码图像同时也是一个链接。通过复制此链接,可以看到其中的 <channel> 部分,该部分将在以下示例中使用:

放置棋子

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

其中 /<fieldColor> 是可选的。

将棋子从棋盘上拿走

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

添加信息

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

与另一台设备配对

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

打开后,可通过菜单项"连接"访问的 对话框 可用于复制配对链接。然后应在另一台设备上打开它。请考虑事先 重置 设备。

观众连接

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

打开后,可通过菜单项"连接"访问的 对话框 可用于复制配对链接并将此链接发送给观众。通过打开链接,观众可以查看棋子的布局和位置,但无法更改其中任何一个。

显示状态徽章的连接

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

打开后,可通过菜单项"连接"访问的 对话框 可用于复制 html 代码以插入任何网站以公开分享当前状态。

time2emphasize-badge

只需添加一次 <script>...</script> 部分(最好在结尾处,紧接在结束 body 标签之前),即可在同一页面上添加多个 Time2Emphasize 实例的徽章。显示此布局的示例:

<!DOCTYPE html>
<html>
<body>
人员 A 状态:
<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>
人员 B 状态:
<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

要求:Apache、PHP 和 PDO-SQLite/-MySql 可用!要检查并确定 <url>,请在浏览器中打开以下内容:

<url>/check_pdo.php

之后可以从服务器上删除 check_pdo.php

放置棋子

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

字段名称"field name"和颜色"#ffab11"将被替换为可见字段的相应名称。

更多详细信息:1

将棋子从棋盘上拿走

这是通过限制前一个事件(在下面的示例中为"e"值)来实现的。

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

更多详细信息:1

添加信息

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

更多详细信息:1

设置布局

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

该示例设置了一个布局,其中包含三个字段"one"、"two"和"three"。

示例布局

创建发票

创建发票”下的菜单打开创建发票的视图。生成的发票与 ZUGFeRD(带有 XML 附件的 PDF)兼容,并且可以进行验证,例如,此处

该视图也可以在没有时间跟踪的情况下使用 - 但如果同时使用,则发票项目可以自动来自记录的时间!

下面的发票栏

在下方区域有一个栏,始终显示最重要的条目和符号,可用于打开进一步的输入页面。如果显示区域不够宽,此栏可以垂直滚动:

发票栏可以滚动

如果您单击“生成发票”按钮,将打开一个对话框,描述任何缺失的重要条目。其中一个相关输入页面将打开,其中相应的输入字段将以红色勾勒出来。如果所有信息可用,则会生成、显示 PDF,并可立即发送或保存。

更正缺失的重要条目

还可以使用栏最右侧的图标打开输入页面。

打开卖家输入页面

可以通过最后一个图标打开和编辑主区域和页脚的布局。除了直接编辑之外,还可以对源代码进行更精细的更改。

编辑布局代码

如果布局不再正确,您可以使用输入字段下方的“重置”按钮恢复初始状态。

重置布局代码

生成发票的输入数据仅保存在浏览器或设备上,可以通过“发票号”输入字段中的选择重新加载。然后会出现一个⚠️符号,警告您该发票号码已经存在。如果您点击⚠️符号,就会自动生成一个以前未使用的发票号。

通过“姓名”字段中的选择,可以快速设置“收件人”输入页面中已使用的所有客户数据。

语言设置也会影响初始状态。因此,也可以通过以下链接更改“创建发票”视图、示例值和布局模板的语言:


Footnotes

  1. 除了 %CURRENT_TIMESTAMP%,还可以指定某个 unix 时间戳(GMT 毫秒),例如 1704270072000 表示 2024 年 3 月 1 日上午。 2 3