Univerzální struktura

Tento dokument se zabývá univerzální strukturou, což je objekt díky němuž je možné do systému xTrace vkládat data z různých zdrojů a zajistit vyhodnocení stejným mechanismem.

Procesní data

Obsahuje procesní data testovaného dílu.

ProcessData

Název	Datový typ	Popis
NumOfPcbs	int	Počet testovaných pcb.
NumOfOkPcbs	int	Počet pcb jejichž testy dopadli OK.
NumOfNokPcbs	int	Počet testovaných desek jejichž testy dopadli NOK.
MainBarcode	string	Barcode dílu, jenž má nejnižší TestIndex.
Product	string	Označení produktu získané z poskytnutých dat.
ProgramName	string	Název programu získaný z poskytnutých dat.
Side	string	Testovaná strana.
User	string	Označení uživatele získané z poskytnutých dat.
MachineName	string	Název stroje získaný z poskytnutých dat.
DTS	DateTime	Datum a čas začátku testu.
DTE	DateTime	Datum a čas konce testu.
IsPanel	bool	Určení jestli se testoval panel nebo samostaná pcb.
ResultFromLog	string	Řetězec s výsledkem testu v originální podobě.
PathToOriginalFile	string	Cesta k souboru ze které byl zpracován.
PathToBackupedFile	string	Cesta k souboru na kterou byl zálohován.
ResultsPath	string	Cesta k pomocným souborům testu.
FilePosition	long	Hodnota na které skončilo zpracovávání souboru. Pokud se pro každý test generují nové soubory pak není potřeba vyplňovat.
IsError	bool	Určení zda byl soubor zpracován úspěšně nebo byl zpracován s chybou.
Result	bool	Celkový výsledek testu.
Misc	string	Řetězec klíč,hodnota pro údaje o testu, které chceme přenést do xTrace, ale neexistuje pro ně samostatná proměnná.
BusTestPartObject	Dictionary	Slovník, kde klíčem je pořadí testovaného dílu uchovávající data o testech všech dílů na panelu.

BusTestPartObject

Název	Datový typ	Popis
Barcode	string	Řetězec udávající sériové číslo testovaného dílu.
TestIndex	int	Řetězec udávající pořadí testovaného dílu.
IsBadmark	bool	Hodnota udávající zda je díl s tímto barcodem/testindexem badmark.
BusTestReferenceResult	dictionary	Slovník, kde klíčem je označení reference, uchovávající data o všech referencích na díle s daným barcodem/testindexem.
Result	bool	Výsledek testu tohoto dílu.
Misc	string	Řetězec klíč,hodnota pro údaje o testu, které chceme přenést do xTrace, ale neexistuje pro ně samostatná proměnná.

BustTestReferenceResult

Název	Datový typ	Popis
Position	string
Result	bool	Výsledek testu této reference.
Misc	string	Řetězec klíč,hodnota pro údaje o testu, které chceme přenést do xTrace, ale neexistuje pro ně samostatná proměnná.
BusTestParameterResult	List	Kolekce záznamů jednotlivých testů této reference.

BusTestParameterResult

Název	Datový typ	Popis
Name	string	Název/Označení testu
ParsedValue	string	Získaná hodnota testu (napětí, proud apod.).
LowLimitMachine	string	Minimální povolená hodnota testu.
HighLimitMachine	string	Maximální povolená hodnota testu.
TestResultMachine	string	Řetězec udávající výsledek.
Image	string	Cesta k obrázku. Je možné zadat jak cestu ve FileSystemu tak i http adresu.
ErrorCode	string	Kód chyby, jenž může specifikovat povahu chyby.
PinNo	int	Číslo pinu, kterého se test týká.
TypeOfTestResult	řetězec odpovídající výčtovému typu TypeOfTestResult	Určuje o jaký výsledek testu se jedná.
Result	bool	Výsledek tohoto testu.
Misc	string	Řetězec klíč,hodnota pro údaje o testu, které chceme přenést do xTrace, ale neexistuje pro ně samostatná proměnná.

Chyby z procesních dat

Obsahuje informace o chybách v testu dílu či dílů pokud jsou testovány zároveň ve fixtuře (formě, rámečku, jigu).

Seznam hodnot

Název	Datový typ	Popis
Barcode	string	Sériové číslo testovaného dílu. Pokud je známé, tak je doporučeno ho uvádět, díky čemuž je možné uložit v xTrace chybu ke konkrétnímu dílu s jistotou.
TestIndex	int	Index testované pozice. Určuje pořadí pcb, která byla testována, pro přiřazení chyby ke konkrétnímu dílu může být zapotřebí vyplnit TesterPcbDirection v nastaveni GMS na xTrace webu.
Reference	string	Označení místa kterého se týká tato chyba.
ErrorCode	string	Kód chyby, jenž může specifikovat povahu chyby. V xTrace dojde k porovnání s polem Uživatelský kód v číselníku chyb, pokud chyba s takovým kódem nebude nalezena, tak se přiřadí defaultní chyba.
TypeOfTestResult	řetězec odpovídající výčtovému typu TypeOfTestResult	Určuje o jaký výsledek testu se jedná. Nabývá hodnot FalseError a Error z výčtového typu TypeOfTestResult (viz. níže), hodnotu Ok sem není potřeba zadávat, protože toto je seznam chyb.
Result	bool	Hodnota udávající výsledek testu.
LoLim	string	Minimální povolená hodnota testu.
HiLim	string	Maximální povolená hodnota testu.
ParsedValue	string	Získaná hodnota testu (napětí, proud apod.).
Image	string	Cesta k obrázku. Je možné zadat jak cestu ve FileSystemu tak i http adresu.

Údaje o vypálených kódech

Obsahuje informace o vypálených sériových číslech na laseru.

Seznam hodnot

Název	Datový typ	Popis
Code	string	Vylaserované sériové číslo.
Result	string	Data z testu čitelnosti kódu, pokud jej laser provádí.
Side	string	Strana na kterou byl kód vypálený.
MarkingPosition	string	Údaje o pozici na které je vypálený kód.
IsBadmark	bool	Určuje jestli se jedná o badmark.
LaserItemIndex	string	Pořadí kódu. Pokud jej explicitně nespecifikují zdrojová data, tak odpovídá pořadí v jakém byl kód nalezen.
IsPanelCode	bool?	Určuje jestli se jedná o panleový kód. Vyplňovat jen pokud to je z dat laseru poznat.

Údaj o chybě při zpracování vstupních dat

Předává do xTrace informaci o tom, že zpracování souboru skončilo s chybou.

Seznam Hodnot

Název	Datový typ	Popis
MsgID	long	ID zprávy, kterou má xTrace vypsat.
MsgParams	string	Parametry, které se mají ve zprávě vypsat.
FilePath	string	Původní cesta k souboru, který se nepodařilo z nějakého důvodu zpracovat.
BackupFilePath	string	Cesta na kterou se nezpracovaný soubor zálohoval.
StackTrace	string	Zásobník volání funkcí pro diagnostiku, proč se nepodařilo zpracovat soubor.

Údaj o zpracovávaném sériovém čísle dílu

Obsahuje položku Barcode, v níž je uloženo sériové číslo dílu, kterého se týkají data v tomto souboru. Obsahuje vždy jedno sériové číslo, pokud bylo zpracováno více rozdělených pcb, pak je na programátorovi xTrace, aby se s touto situací vypořádal.

Údaje o tom kdo soubor vytvořil

Obsahuje informace o tom jaké pracoviště nebo aplikace soubor vytvořila.

Seznam Hodnot

Název	Datový typ	Popis
WorkplaceID	long	Kód pracoviště, pokud data generuje xTrace, tak se podle něj dá poznat z jakého pracoviště data pochází. Pokud generuje jiná aplikace, tak nezáleží na hodnotě.
WorkplaceCode	string	Označení pracoviště, platí informace pro WorkplaceID.
DateTime	DateTime	Datum a čas vytvoření souboru.

Pomocné věci

Výčtový typ TypeOfTestResult

Určuje o jaký typ výsledku testu se jedná. Nabývá tří stavů: - Ok - stroj vyhodnotil test jako v pořádku - FalseError - stroj vyhodnotil test jako chybu, ale operátor rozhodl o tom, že to chyba není - Error - stroj/operátor vyhodnotil test jako chybu