API

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

更改语言

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

导出、导入和重置

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

重置所有设置

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

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

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

创建连接

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

connections dialog

某些连接允许通过 Time2Emphasize REST API 中的端点控制时间跟踪的对象。

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

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

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

工具栏中 mode qrcode 会出现一个二维码模式按钮,该按钮会显示每个区域对应的二维码。

配对设备”和“接收活动”连接可通过 Time2Emphasize REST API 中的端点访问。

放置棋子

通过发送 push 请求,将棋子放置在区域上。

将棋子从棋盘上拿走

通过发送 off 请求,将棋子从所有区域移除。

添加信息

通过发送 info 请求,可以在时间线中输入信息。

与另一台设备配对

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

源代码可在以下 GitHub 存储库中公开获取:time2.store

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

https://<url>/check_pdo.php

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

可以通过 Time2Emphasize REST API 中的端点访问“地点”连接。

放置棋子

通过发送一个 post 请求,将棋子放置在场地上,该请求包含一个 Event 对象,该对象包含以下值:s:%CURRENT_TIMESTAMP%,n:场地名称,以及 c:场地颜色。 POST 负载示例:

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

将棋子从棋盘上拿走

这可以通过发送一个 post 请求来实现,该请求包含一个仅包含值 s: %CURRENT_TIMESTAMP% 的 Event 对象。POST 负载示例:

[{"s": %CURRENT_TIMESTAMP%}]

添加信息

通过发送一个 post 请求,将信息添加到时间线,该请求包含一个包含值 s: %CURRENT_TIMESTAMP% 和 i: info text 的 Event 对象。 POST 请求示例:

[{"s": %CURRENT_TIMESTAMP%, "i": "一些信息"}]

设置布局

布局的设置是通过发送一个包含布局对象的 post 请求来实现的。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"}}]

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

示例布局

创建发票

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

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

下面的发票栏

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

发票栏可以滚动

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

更正缺失的重要条目

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

打开卖家输入页面

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

编辑布局代码

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

重置布局代码

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

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

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