500 E-Shelf-Label (ESL) e-paper » Historie » Revision 3
Revision 2 ([E] Rocco Kreutz, 16.02.2023 09:09) → Revision 3/6 ([E] Frank S, 16.02.2023 16:58)
h1. E-Shelf-Label (ESL)
h2. Voraussetzungen / Einrichtung des WebPortal
attachment:Einrichten.txt (Liste mit Links)
* http://esl-eu.zkong.com/#/login
* Rollen einrichten (Setting > Role setting)
* Nutzer einrichten (Staff Management < Merchant Admin)
* Fehlermeldungen einrichten (Log & Alert > Alert Setting)
* Zugangsdaten übernehmen (Segging > Authorize & Basic Info)
* AccessPoint einrichten (Devices > Base Station)
* Store anlegen (Stores)
* Template-Type einrichten (Template > Template Type)
** "default" mit einem Field "default"
* Template erstellen
** Template importieren
attachment:TronitagTemplates.zip
attachment:TronitagTemplates.txt
*** nach Import jedes Template editieren und die Template-Categorie "default" wählen _(wird beim Export leider nicht gespeichert)_
Info: man muß nicht warten, bis der Editor geladen ist ... einfach "Zurück" im Browser
*** danach lassen sich die Templates enablen
** mit Template-Type default/default verbunden
** enthält ein FullSize-Image mit Slot 0 verbunden (Components > Image > Product image)
* TroniTAG und andere Händler haben teilweise "eigene" Namen.
Aber hinten auf den Tags oder z.B. Alibaba/Google heißen gleich, wie vom Hersteller ZKONG
und da steht grob im Namen drin, was es ist
* {{collapse(Seriennummernformat)
<pre>
cccNNx = Größe in Zoll
ZKCnnx = BlackWhiteRed
ZKYnnx = BlackWhiteYellow
ZKnnx = BlackWhite
cccnnV: Weiß mit NFC (die Großen ohne LED)
cccnnB: Schwarz ohne NFC
cccnnBP
cccnnS
cccnnSM
cccnnV-N
cccnnS-N
cccnnxx-Dx: DoubleSide
cccnnxx-xH: HighDPI
</pre>
}}
h2. Voraussetzungen / Einrichtung in Prodat
* DB-Update muss eingespielt sein https://ci.prodat-sql.de/sources/dbupdates/edit/?q=2022-11-30%2012:40:49
* Settings für API-Zugang (Dynamische Einstellungen > Modul-Definitionen > ESL-Verwaltung) müssen gefüllt sein
{{collapse(Bild)
!clipboard-202302101536-ttilr.png!
}}
** Name und Passwort als Base64 Staff Management < Merchant Admin
{{collapse(Hilfe/Beispiel)
<pre><code class="sql">
SELECT encode('username'::bytea, 'base64')::VARCHAR AS unam,
encode('password'::bytea, 'base64')::VARCHAR AS pass
-- oder
https://www.base64encode.org/
-- Test/Beispiel
username : dXNlcm5hbWU=
password : cGFzc3dvcmQ=
</code></pre>
}}
** Login : "öffentliche Anwendung > Mitarbeiterführung":http://esl-eu.zkong.com/#/staffManager .
** Store : "öffentliche Anwendung > Ladenverwaltung > Ladenverwaltung":http://esl-eu.zkong.com/#/store/storeMgr
** MerchantID : "öffentliche Anwendung > Systemeinstellung > Grundinformation":http://esl-eu.zkong.com/#/system/baseinfo
** TempCategory : "ESL-Anwendung > Vorlagenverwaltung > Vorlageeigenschaften":http://esl-eu.zkong.com/#/template/properties
** ACHTUNG: Links in Browser kopieren, in den Tab, wo man bereits eingeloggt ist. _(Login wird nicht wiederverwendet, andere Tabs werden ausggeloggt und nach neuem Login gibt es keine Weiterleitung)_ .
h2. Verwendung / Datenstruktur
* ESL-Typen werden als Artikel in Artikelverwaltung (Tabelle @art@) angelegt
** AC = ESL1001
** Artikelnummer = Verwaltungsname
** Bezeichnung = Verwaltungshinweis
* Eigenschaften der ESL (Auflösung, Rotation, Farben, ...) werden als Eigenschaften zum Artikel angelegt
** angelegte Paramter für ESL-Eigenschaften (Tablename: 'art', Gruppe: 'ESL')
|_. Eigenschaft |_. pname |_. Typ |_. Bemerkung |
| ESL Model | art.esl.model | ptVARCHAR | Modelbezeichnung (entsprechend Typ im WebPortal, z.B. "ZKC29V") |
| ESL Breite | art.esl.width | ptNUMERIC | Anzahl Pixel horizontal (z.B. "128") |
| ESL Höhe | art.esl.height | ptNUMERIC | Anzahl Pixel vertikel (z.B. "296") |
| ESL Drehung | art.esl.rotation | ptNUMERIC | Bildschirmdrehung in 90° Schritten (von 0-3) |
| ESL Farbe | art.esl.color | ptVARCHAR | Farbdarstellung (Monochrome/BlackWhite/Grayscale/BlackWhiteRed/BlackWhiteRedDebug/BlackWhiteYellow/FullColor) |
* einzelne ESL werden als Inventar in Tabelle @artpr@ angelegt
** attachment:TronitagTemplates.txt _(könnte man die Liste in ein INSERT-Statemnt übernehmen)_
** Eintragung über {{collapse(Qualitätsmanagement > Prüfmittel / Inventar)
!clipboard-202302101545-uynzc.png!
}}
** Eintragung/Übersicht über Stammdaten > Artikelverwaltung > ESL-Verwaltung
* Verlinkungen von ESLs mit anderen Objekten werden in Tabelle @artpr_link@ angelegt
|_. Felder |_. Bemerkung |
| prl_pr_id | ID aus @artpr@ vom ESL |
| prl_table | Zieltabelle |
| prl_pkey | Zieldatensatz |
h2. Druck auf ESL
* Report erstellen
** r_reportgen = ESL
** r_reportparameter = ESL-Typ "ak_nr" wählen (alternativ oder zusätzlich/überschrieben ESL-Color/Width/Height/Rotation)
** der Report-Designer wird ab diesem Zeitpunkt entsprechend für diesen Typ&Größe vorkonfiguriert
(aktuell geht nur ein ESL-Typ / Width+Height pro Report)
** im r_sql eine Spalte "esl_barcode" mit dem ESL-Barcode pro Datensatz/Seite
alternativ/zusätzlich im Report den ESL-Barcode im frxBarcode/frxMemo.TagStr <WorkSql."esl_barcode">
* Beispiel-Ausdruck (Planung und Fertigung > Fertigungsauftrag > ABK bearbeiten)
** Zauberstab > ELS zuordnen
** Report > Ettiket ESL
h2. Triggerfunktionen
@artpr_link__a_iu__lagerorte@ - Funktion sucht zu einem verlinkten Standardlagerort (Übergabebahnhof) den passenden Arbeitsgang
* Voraussetzungen damit ein Folge-AG gefunden wird:
** Standardlagerort muss einer Kostenstelle zugeordnet sein @lgo_ks@
** ESL muss einer ABK zugeordnet sein -> Eintrag in @artpr_link@
** Arbeitsgang der ABK muss der gleichen Kostenstelle zugeordnet sein
** Arbeitsgang muss offen sein
** Falls bereits ein AG mit dem ESL verlinkt ist, muss die Pos-Nr. des Folge-AG größer als die Pos-Nr. des aktuellen AG sein
@artpr_link__b_ud__abk@ - Funktion prüft bei Änderung/Delete einer Verlinkung zu einer ABK ob eine vorhandene Verlinkung zu einem AG gelöscht werden muss
* Verlinkung zu AG wird gelöscht, falls:
** AG nicht zur geänderten ABK passt
** verlinkung zur ABK gelöscht wird
* Ziel: verlinkte ABK und verlinkter AG (falls vorhanden) müssen immer zusammenpassen
h2. Sonstiges
* Projektticket zur Entwicklung für Kreyenberg: ##17849
* Report-Print-Komponente für Tronitag-ESL: ##17924
* -Public Wiki: https://redmine.prodat-sql.de/projects/prodat-v12-public/wiki/500_E-Shelf-Label_(ESL)-