API

Ứng dụng Time2Emphasize tự động tạo API-Key, được sử dụng cho các kết nối. Khóa này sẽ được thay thế bằng <customer> bên dưới.

Thay đổi ngôn ngữ

Ứng dụng Time2Emphasize sẽ mở bằng các ngôn ngữ được phát hiện trên thiết bị và được hỗ trợ. Ngôn ngữ có thể được thay đổi thông qua các liên kết sau:

Xuất, nhập và đặt lại

Ứng dụng Time2Emphasize cho phép xuất (tạo bản sao lưu) và nhập (khôi phục bản sao lưu) các bố cục trường (ở định dạng JSON) và tất cả dữ liệu theo dõi (ở định dạng CSV) trong hộp thoại "xuất, nhập và đặt lại". Tất cả dữ liệu theo dõi cũng có thể bị xóa (đặt lại).

Đặt lại tất cả cài đặt

Ứng dụng Time2Emphasize có thể được đặt lại về mặc định bằng cách mở:

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

Lưu ý: thao tác này sẽ xóa tất cả các bố cục trường và dữ liệu theo dõi khỏi thiết bị!

Tạo kết nối

Có thể tạo kết nối bằng cách mở các liên kết như mô tả bên dưới. Ngoài ra, bạn cũng có thể cấu hình thủ công trong hộp thoại có sẵn trên mục menu "connections".

connections dialog

Nhận hoạt động chẳng hạn bằng cách quét QRCode

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

Bằng cách in trang (Ctrl + P), danh sách tất cả QRCode sẽ được in ra.

Trên thanh công cụ mode qrcode, nút chế độ QRCode sẽ xuất hiện, nút này sẽ hiển thị từng QRCode theo từng trường. Hình ảnh QRCode đồng thời là một liên kết. Bằng cách sao chép liên kết này, bạn có thể thấy phần <channel> trong đó, phần này sẽ được sử dụng trong các ví dụ sau:

Đặt quân tốt

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

trong đó /<fieldColor> là tùy chọn.

Lấy quân tốt ra khỏi bàn cờ

NHẬN https://time2.emphasize.de/connect/<channel>/off

Thêm thông tin

NHẬN https://time2.emphasize.de/connect/<channel>/info/<infoText>

Ghép nối với thiết bị khác

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

Sau khi mở hộp thoại này, hộp thoại có thể truy cập qua mục menu "connections" có thể được sử dụng để sao chép liên kết ghép nối. Sau đó, bạn nên mở hộp thoại này trên thiết bị khác. Hãy cân nhắc đặt lại thiết bị trước.

Kết nối cho khán giả

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

Sau khi mở hộp thoại này, hộp thoại có thể truy cập qua mục menu "connections" có thể được sử dụng để sao chép liên kết ghép nối và gửi liên kết này cho khán giả. Bằng cách mở liên kết, khán giả có thể xem bố cục và vị trí của quân cờ mà không thể thay đổi bất kỳ mục nào trong số chúng.

Kết nối để hiển thị huy hiệu trạng thái

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

Sau khi mở hộp thoại này, hộp thoại có thể truy cập qua mục menu "connections" có thể được sử dụng để sao chép mã html để chèn vào bất kỳ trang web nào để chia sẻ trạng thái hiện tại một cách công khai.

time2emphasize-badge

Có thể thêm huy hiệu của nhiều trường hợp Time2Emphasize trên cùng một trang bằng cách chỉ thêm phần <script>...</script> một lần (tốt nhất là ở cuối ngay trước thẻ body đóng). Ví dụ cho thấy bố cục này:

<!DOCTYPE html>
<html>
<body>
trạng thái của người 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>
và trạng thái của người 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>

Đang kết nối với lưu trữ

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

Tải xuống để cài đặt dịch vụ lưu trữ: ZIP

Yêu cầu: Có Nginx, PHP và PDO-SQLite/-MySql! Để kiểm tra điều này và xác định <url>, hãy mở phần sau trong trình duyệt của bạn:

<url>/check_pdo.php

check_pdo.php có thể bị xóa trên máy chủ của bạn sau đó.

Đặt quân cờ

POST <url>/?topic=<customer>
PAYLOAD [{"s": %CURRENT_TIMESTAMP%, "n": "tên trường", "c": "#ffab11"}]

Tên trường "tên trường" và màu "#ffab11" sẽ được thay thế bằng các tên tương ứng của trường hiển thị.

Chi tiết thêm: 1

Lấy quân tốt ra khỏi bàn cờ

Điều này đạt được bằng cách giới hạn sự kiện trước đó (trong ví dụ bên dưới giá trị "e").

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

Chi tiết thêm: 1

Thêm thông tin

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

Chi tiết thêm: 1

Thiết lập bố cục

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

Ví dụ này thiết lập một bố cục với ba trường "one", "two" và "three".

Example layout

Tạo hóa đơn

Menu trong mục "Tạo hóa đơn" sẽ mở chế độ xem để tạo hóa đơn. Các hóa đơn được tạo ra tương thích với ZUGFeRD (PDF có tệp đính kèm XML) và có thể được xác thực, ví dụ: tại đây.

Bạn cũng có thể sử dụng chế độ xem này mà không cần theo dõi thời gian - nhưng nếu sử dụng cả hai, các mục hóa đơn có thể tự động xuất phát từ thời gian đã ghi lại!

Thanh hóa đơn bên dưới

Ở khu vực phía dưới có một thanh luôn hiển thị các mục nhập và ký hiệu quan trọng nhất có thể được sử dụng để mở thêm các trang nhập liệu. Thanh này có thể cuộn theo chiều dọc nếu vùng hiển thị không đủ rộng:

Thanh hóa đơn có thể cuộn được

Nếu bạn nhấp vào nút "TẠO HÓA ĐƠN", một hộp thoại sẽ mở ra mô tả những mục quan trọng bị thiếu. Một trong những trang nhập liệu có liên quan sẽ mở ra, trong đó trường nhập liệu tương ứng sẽ được viền màu đỏ. Nếu tất cả thông tin đã có sẵn, tệp PDF sẽ được tạo, hiển thị và có thể được gửi hoặc lưu ngay lập tức.

sửa các mục quan trọng bị thiếu

Các trang nhập liệu cũng có thể được mở bằng các biểu tượng ở phía bên phải của thanh.

Mở trang nhập liệu cho người bán

Có thể mở và chỉnh sửa bố cục của khu vực chính và chân trang thông qua biểu tượng cuối cùng. Ngoài việc chỉnh sửa trực tiếp, bạn cũng có thể thực hiện những thay đổi chi tiết hơn đối với mã nguồn.

Chỉnh sửa mã bố cục

Nếu bố cục không còn chính xác, bạn có thể khôi phục trạng thái ban đầu bằng cách sử dụng nút "Đặt lại" bên dưới trường nhập.

Đặt lại mã bố cục

Dữ liệu đầu vào cho hóa đơn đã tạo chỉ được lưu trong trình duyệt hoặc trên thiết bị và có thể tải lại thông qua lựa chọn trong trường nhập "Số hóa đơn". Sau đó, biểu tượng ⚠️ sẽ xuất hiện, cảnh báo bạn rằng số hóa đơn đã tồn tại. Nếu bạn nhấp vào biểu tượng ⚠️, số hóa đơn chưa sử dụng trước đó sẽ tự động được tạo.

Tất cả dữ liệu của khách hàng đã sử dụng trong trang nhập "Người nhận" có thể được thiết lập nhanh chóng thông qua lựa chọn trong trường "Tên".

Cài đặt ngôn ngữ cũng ảnh hưởng đến trạng thái ban đầu. Do đó, ngôn ngữ cũng có thể được thay đổi cho chế độ xem "Tạo hóa đơn", giá trị mẫu và mẫu bố cục thông qua các liên kết sau:


Footnotes

  1. Thay vì %CURRENT_TIMESTAMP%, bạn cũng có thể chỉ định một dấu thời gian unix nhất định (GMT với mili giây), ví dụ 1704270072000 cho ngày 3.1.2024 vào buổi sáng. 2 3