Formát souboru pro import číselníků do TracePRO

Tento dokument popisuje JSON formáty pro import číselníků z ERP do TracePRO: pracovníci, pracoviště, úkony, nástroje a materiál. Import výrobních objednávek popisuje Formát souboru pro import objednávek do TracePRO.

Poznámka

Toto je návrh (v1), zatím neimplementováno. Nástroje a materiál nemají v tracecar/ odpovídající entity - jejich formát je proto záměrně obecný a konkrétní vlastnosti budou doplněny.

Společná pravidla

• Jeden soubor obsahuje jeden typ entity a seznam entit tohoto typu.

• Pole operation ("create" | "update" | "delete") platí pro celý soubor. Systém nemusí rozlišovat mezi create a update - obojí provede sloučení podle klíče entity.

• Při delete stačí, aby každá entita obsahovala jen svůj klíč.

• Enumy a příznaky se zapisují jako symbolické řetězce, stejně jako ve formátu objednávek.

Obálka souboru

Pole	Popis
format	Typ entity: "tracepro-workers" | "tracepro-workplaces" | "tracepro-acts" | "tracepro-tools" | "tracepro-materials".
version	Verze formátu, aktuálně 1.
source	Identifikace zdrojového ERP (volný text, např. "HELIOS", "QAD").
generated	Datum a čas vygenerování souboru (ISO 8601, lokální čas).
operation	"create" | "update" | "delete", společná pro celý soubor.
entities	Seznam entit.

Pracovníci (tracepro-workers)

Cílová entita: PWorker. Klíč pro sloučení: erp_id.

{
    "format": "tracepro-workers",
    "version": 1,
    "source": "HELIOS",
    "generated": "2026-07-09T10:30:00",
    "operation": "update",
    "entities": [
        {
            "erp_id": "1024",
            "id": 1024,
            "name": "Jan Novák",
            "card": "04A1B2C3",
            "login_name": "jnovak",
            "flags": [],
            "data1": "",
            "data2": "",
            "data3": ""
        }
    ]
}

Pole	Cíl v TracePRO	Popis
erp_id	PWorker.erp_id	Číslo pracovníka v ERP. Povinné, klíč pro sloučení.
id	PWorker.id	Osobní číslo v TracePRO (přihlašování na terminálech). Volitelné - pokud chybí, TracePRO ho přidělí (obdoba dnešního QAD importu, kde se pro číselné erp_id navrhne stejné id).
name	PWorker.name	Jméno pracovníka. Povinné.
card	PWorker.card	Číslo karty (RFID apod.).
login_name	PWorker.login_name	Přihlašovací jméno do počítače.
flags	PWorker.flags	Seznam symbolických příznaků, viz níže.
data1, data2, data3	PWorker.data1 - data3	Doplňková data.

Příznaky pracovníka (flags):

JSON	defs.py	Popis
otp	WORKER_FLAG_OTP	Vyžadováno OTP.
no_esd	WORKER_FLAG_ESD_NONE	Nekontrolovat ESD.

Pole otp, otp_tm a esd_tm jsou runtime data TracePRO a v importu nefigurují.

Pracoviště (tracepro-workplaces)

Cílová entita: PWorkplace. Klíč pro sloučení: erp_ref. Interní PWorkplace.id přiděluje TracePRO, v importu není.

{
    "format": "tracepro-workplaces",
    "version": 1,
    "source": "HELIOS",
    "generated": "2026-07-09T10:30:00",
    "operation": "update",
    "entities": [
        {
            "erp_ref": "SMT1-01",
            "name": "Osazovací linka 1",
            "dept": 1,
            "flags": []
        }
    ]
}

Pole	Cíl v TracePRO	Popis
erp_ref	PWorkplace.erp_ref	Označení pracoviště v ERP. Povinné, klíč pro sloučení. Na tuto hodnotu se odkazuje pole workplace operace ve formátu objednávek.
name	PWorkplace.name	Název pracoviště. Povinné.
dept	PWorkplace.dept_id	Id oddělení (PDepartment). Volitelné - pokud chybí, použije se hlavní oddělení.
flags	PWorkplace.flags	Seznam symbolických příznaků, viz níže.

Příznaky pracoviště (flags):

JSON	defs.py	Popis
no_esd	WP_FLAG_ESD_NONE	Nekontrolovat ESD.
admin	WP_FLAG_ADMIN	Administrátorské pracoviště.
any_wp	WP_FLAG_ANYWP	Libovolné pracoviště.
password	WP_FLAG_PASSWORD	Vyžadováno heslo.

Pole rt_flags, block_info a block_tm jsou runtime data TracePRO a v importu nefigurují.

Úkony (tracepro-acts)

Cílová entita: PAct. Klíč pro sloučení: id (číslo úkonu).

{
    "format": "tracepro-acts",
    "version": 1,
    "source": "HELIOS",
    "generated": "2026-07-09T10:30:00",
    "operation": "update",
    "entities": [
        {
            "id": 2523,
            "name": "Osazování SMD",
            "tp": "dpmo",
            "desc": ""
        }
    ]
}

Pole	Cíl v TracePRO	Popis
id	PAct.id	Číslo úkonu. Povinné, klíč pro sloučení.
name	PAct.name	Název úkonu. Povinné.
tp	PAct.tp	Typ statistiky, viz níže. Volitelné.
desc	PAct.desc	Popis úkonu.

Hodnoty tp:

JSON	defs.py
dpmo	STTP_DPMO
dpu	STTP_ICT
fp	STTP_FP

Nástroje (tracepro-tools)

Pro nástroje zatím není v tracecar/ definována entita (zákaznická varianta NVG používá vlastní NVGQADTool). Formát je proto obecný: identifikace, název a volné vlastnosti. Konkrétní klíče params budou doplněny.

Klíč pro sloučení: item.

{
    "format": "tracepro-tools",
    "version": 1,
    "source": "HELIOS",
    "generated": "2026-07-09T10:30:00",
    "operation": "update",
    "entities": [
        {
            "item": "SITO-778",
            "name": "Šablona 778-3283",
            "params": {
                "GROUP": "SITA",
                "CUSTOMER": "COMAP"
            }
        }
    ]
}

Pole	Popis
item	Artikl nástroje. Povinné, klíč pro sloučení. Na tuto hodnotu se odkazuje kusovník objednávky (řádek typu tool).
name	Název / popis nástroje.
params	Volné vlastnosti, klíč/hodnota. Budou doplněny.

Materiál (tracepro-materials)

Pro materiál (artikly) zatím není v tracecar/ definována entita. TracePRO data artiklů potřebuje jen ve specifických případech (viz ERP data), např. úroveň MSL nebo nestandardní chování artiklu. Formát je proto obecný, konkrétní klíče params budou doplněny.

Klíč pro sloučení: item.

{
    "format": "tracepro-materials",
    "version": 1,
    "source": "HELIOS",
    "generated": "2026-07-09T10:30:00",
    "operation": "update",
    "entities": [
        {
            "item": "IC-STM32F4",
            "name": "MCU STM32F407",
            "params": {
                "MSL": "3"
            }
        }
    ]
}

Pole	Popis
item	Artikl. Povinné, klíč pro sloučení. Na tuto hodnotu se odkazuje kusovník objednávky (řádky typu mat / mat_prep).
name	Název / popis artiklu.
params	Volné vlastnosti, klíč/hodnota (např. úroveň MSL). Budou doplněny.