User's Manual

MYTrace1.3
1.3
Original Instructions
English

4048030-EN Rev. 2020-04-14

 MYTrace1.3 Mycronic

ii 4048030-EN
Mycronic MYTrace1.3 Table of contents

Table of contents
1. Revision Information............................................................................................. 1
2. Text Conventions.................................................................................................. 2
2.1 Italic Font.......................................................................................................................................... 2
2.2 Bold Font......................................................................................................................................... 2
2.3 Menu Selections........................................................................................................................... 2
2.3.1 Danger, Warning, Caution, and Note.............................................................................. 2
2.4 Lists.................................................................................................................................................... 3
2.5 Icons................................................................................................................................................... 3
2.5.1 Navigation.................................................................................................................................... 3
2.5.2 Camera view............................................................................................................................... 3
2.5.3 TPSys web interface............................................................................................................... 3
2.5.4 Barcode scan............................................................................................................................. 3
3. Introduction........................................................................................................... 5
3.1 Features and Functions............................................................................................................. 5
3.2 System Overview........................................................................................................................ 5
3.2.1 Included Parts............................................................................................................................. 5
3.3 Technical Specifications.......................................................................................................... 5
3.3.1 Requirements.............................................................................................................................. 6
3.3.2 Disclaimer.................................................................................................................................... 7
4. User Interface....................................................................................................... 8
4.1 Access levels.................................................................................................................................. 8
4.1.1 Sign in.............................................................................................................................................. 8
4.1.2 Language...................................................................................................................................... 8
4.2 Home View..................................................................................................................................... 9
4.3 Reports View................................................................................................................................. 9
4.3.1 Help features............................................................................................................................. 10
4.3.2 Component Based Report................................................................................................ 10
4.3.3 PCB Based Report................................................................................................................. 12
4.4 Administration View................................................................................................................ 14
4.4.1 Add New User.......................................................................................................................... 14
4.4.2 Edit User..................................................................................................................................... 15
4.4.3 Delete User............................................................................................................................... 15
5. Miscellaneous...................................................................................................... 16
5.1 Change of Dataserver in TPSys 2.9 or higher............................................................... 16
5.1.1 Upgrade of TPSys.................................................................................................................... 16
5.2 Backup of Text Files and Database.................................................................................. 16
5.2.1 Backup of text files................................................................................................................. 16
5.2.2 Backup of database.............................................................................................................. 16

4048030-EN iii
Table of contents MYTrace1.3 Mycronic

iv 4048030-EN
Mycronic MYTrace1.3 1. Revision Information

1. Revision Information
In this revision of the manual, these changes have been made:
• Marked Administrator Role in the table: 3.1 Features and
Functions, page 5.
• Updated figure for System Overview: 3.2 System Overview, page 5.
• Updated information:
• 3.3.1.1 Features, page 6.
• 3.3.1.3 Hardware, page 6.
• 4 User Interface, page 8.
• 4.1 Access levels, page 8.
• 4.1.2 Language, page 8.
• 4.3 Reports View, page 9.
• 4.3.1 Help features, page 10.
• 4.3.2.1 Create and save a component based report, page 10.
• 4.3.3.1 Create and save a PCB Based Report, page 12.
• 4.4.1 Add New User, page 14.
• 4.4.3 Delete User, page 15.
• 5.1 Change of Dataserver in TPSys 2.9 or higher, page 16.
• 5.1.1 Upgrade of TPSys, page 16.
• Added note: 4.1.1 Sign in, page 8.
• Removed section "MYTrace Viewer computer".
• Added image; Removed the header "Status View"; Updated information:
4.2 Home View, page 9.
• Added image:
• 4.3.2.1 Create and save a component based report, page 10.
• 4.3.3.1 Create and save a PCB Based Report, page 12.
• 4.4.1 Add New User, page 14.

4048030-EN 1
2. Text Conventions MYTrace1.3 Mycronic

2. Text Conventions
This document uses text conventions to present information in various
situations.

2.1 Italic Font

Italic font is used for software screen text (for example, Parameter 1), names
(for example, Spare Parts Catalog), and for warning text (described in
Danger, Warning, Caution, and Note).

2.2 Bold Font

Bold font is used for particular important words (for example, This must not
be done in reverse order).

2.3 Menu Selections

When software handling is described, menu selections are described in the
following format:
File > Page Setup > Paper Size > Portrait > OK
This example describes to open the File menu and select the Page Setup,
Paper Size, and Portrait options, and finally click the OK button.

2.3.1 Danger, Warning, Caution, and Note

A particular text layout is used to show danger, warning, and caution
information. A triangular icon identifies the type of risk and the text
describes the risk.
Danger, warning, and caution information must be followed.
Notes have the same layout but never triangular icons.
Danger

Danger
Danger means a potentially dangerous situation that can cause
death or severe bodily injury.

Warning

Warning
Warning means a potentially dangerous situation that can cause
bodily injury or considerable damage to the system or equipment.
The icon identifies the type of risk.

Caution

Caution
Caution means that the system or equipment can be damaged or
data can be lost.

Note

2 4048030-EN
Mycronic MYTrace1.3 2. Text Conventions

Note
A note contains any type of more information.

2.4 Lists
Lists of items, points to consider, or procedures without relative order are
shown in bulleted or hyphenated format like this:
• Item 1.
• Item 2.
or
• Item 1.
• Item 2.
Procedures that must be done in a specific order are shown in numbered
lists like this:
1. Do this step first.
2. Do this step second.

2.5 Icons

2.5.1 Navigation
This type of icon helps you to navigate on the screen where TPSys windows
are described. It points out the area in the window where the information is
found.

2.5.2 Camera view

This icon shows that you are working in a camera view.

2.5.3 TPSys web interface

This icon indicates that you can also use the TPSys web interface.

2.5.4 Barcode scan

4048030-EN 3
2. Text Conventions MYTrace1.3 Mycronic

This icon indicates that you can use a barcode scanner.

4 4048030-EN
Mycronic MYTrace1.3 3. Introduction

3. Introduction
About this manual
This manual is designed to help you to use MYTrace to its full potential.
• Chapter 3 – Introduction covers the main features and functions, the
technical specifications, restrictions, and hardware and software
requirements.
• Chapter 4 – User Interface contains information about MYTrace GUI and
how to use the software.
• Chapter 5 – Miscellaneous contains information about some tools that
could be of assistance when using MYTrace.

3.1 Features and Functions

MycronicMYTrace is Windows-based software, developed primarily for
tracing defective components mounted by Mycronic pick and place
machines. MYTrace consists of two applications, MYTrace Harvester and
MYTrace Viewer.
The Harvester subscribes to the registered machines’ log events and stores
them as text files and in a database.
From the Viewer the registered machines process status can be monitored,
reports can be created and roles can be administrated. Two user roles are
defined in MYTrace ; User and Administrator. Each role has different
permissions to the system according to the table below.

Role Status Reports Administration

User X X
Administrator X X X

If not signed in as a User or Administrator it is still possible to view the

registered machines process status.
See chapter 4 User Interface, page 8 for further information about the
range of use for each role.

3.2 System Overview

Figure 1. System overview.

3.2.1 Included Parts

Box including hardware key, manual and CD.

3.3 Technical Specifications

This section describes MYTrace features, restrictions, hardware and
software requirements and, license information. It also briefly describes
MYCenter with the Material Handling module; a highly recommended
software when using MYTrace.

4048030-EN 5
3. Introduction MYTrace1.3 Mycronic

3.3.1 Requirements

3.3.1.1 Features
MYTrace software is accessible (using web browser) from a PC where the
Harvester application is deployed as well. The Harvester collects event log
data for up to ten registered pick and place machines. The collected data is
stored as text files for backup and in a database.
To access the Viewer application, a web browser and intranet connection is
required. The Viewer is a service deployed on TPSys server.

3.3.1.2 License
Mycronic hardware key, including the license key is required to run MYTrace
software. The hardware key is available for up to ten licenses, that is
collecting data from ten pick and place machines.

3.3.1.3 Hardware
Computer where MYTrace will be accessed:
• Recommended screen resolution is 1024 x 768 pixels or higher.
• Intel® Xeon® Dual Core 2.0 GHz.
• 4 GB of RAM.
• A separate 0.75 TB hard disc drive is recommended for the database.
• A separate 0.5 TB hard disc drive is recommended for the operative
system application and backup.
• A UPS is also preferable.

3.3.1.4 Software
• A PC with one of the following supported Windows versions:
• Microsoft Windows® 10 Professional.
• Microsoft 7® Professional with Service Pack 1 (32 bit).
• Microsoft 7® Professional with Service Pack 1 (64 bit).
• Windows Server® 2008 R2 with Service Pack 1 (64 bit).
• Microsoft Edge®, Chrome >= 75.0, FireFox >= 67.0.
• TPSys 2.9 or later.
• USB dongle with MYTrace license.

3.3.1.5 MYCenter Material Handling

MYCenterMaterial Handling is a tool for rapid feeder changeovers in
Mycronic machines. It reduces changeover times and lowers the risk of
erroneous component loading. MYCenterMaterial Handling is a tool for
traceability control, since it simplifies the use of component batch
information. MYCenterMaterial Handling combines Windows-based software
with a barcode scanner and a label printer. Using an open format database,
MYCenterMaterial Handling tracks quantities, Batch Id, stock locations and
other data for each component reel, stick or matrix tray for full utilization of
the TPSys event log for component batch traceability. Refer to MYCenter,
User’s Manual for further information.
MYCenterMaterial Handling 2.1 or higher is compatible with MYTrace. Refer
to MYCenter, User’s Manual to consider what setting of the ’CarrierAsBatch’
option is actual according to your production.

3.3.1.6 Terms Used

Term Description
PostgreSQL Open source relational
database.
GUI Graphic User Interface.
HTML Hyper Text Markup Language.

6 4048030-EN
Mycronic MYTrace1.3 3. Introduction

Term Description
PDF® Portable Document Format.
XML Extensible Markup Language.
UPS Uninterruptible Power Supply.

3.3.2 Disclaimer
Although every reasonable effort has been made to ensure that the
information provided by the MYTrace software is accurate and available,
Mycronic does not warrant its accuracy and availability and disclaims any
liability to any party anywhere in the world for any injury, damage, direct or
indirect loss, consequential or economic loss or any other loss suffered as a
result of the use or reliance upon the information provided by MYTrace to
the maximum extent permitted by law. It is the end user's responsibility to
back up the MYTrace data files regularly in accordance with good business
practice. Mycronic cannot accept responsibility for any disruption, loss of
data, loss of profits, loss of business information, loss of revenue, loss or
interruption of business or disclosure of confidential information that might
occur while using or being unable to use the MYTrace software or the data
within it, however this might arise.

4048030-EN 7
4. User Interface MYTrace1.3 Mycronic

4. User Interface
This chapter describes MYTrace Viewer and how to use it. It describes the
different access levels and how to create and save reports. The MYTrace
Viewer interface has three views: Home (with Status), Reports and
Administration.
MYTrace Viewer is reached using an internet browser. As the MYTrace
Viewer is deployed on TPSys server, the address (URL) should be 'http://
[tpsys_ip_address]:5001’. If the TPSys IP address is for example 10.1.1.1, the
URL should be ’http://10.1.1.1:5001’. 5001 is the port number and always has
this value.

4.1 Access levels

MYTrace Viewer has two defined roles which require sign in; User and
Administrator. Each role has different access rights according to the table
below.

Role Sign in Access rights

User Yes View process status.
Create reports.
Administrator Yes View process status.
Create reports.
Administrate users.

If not signed in the registered machines status can still be viewed.

The purpose of the different views is as follows:
Home shows system information and status for the registered machines.

Reports Search and View places components and PCB data.

Recall Report generators are available for the search process, for example, a
Component Based Report and a PCB Based Report. It depends on the
known search criteria which one to use.

Administration is used to add, edit and delete users.

4.1.1 Sign in
1. Enter your user name.
2. Enter your password.
3. Press Enter or click Sign in.

Note
If you are upgrading from the old MYTrace, your user
accounts from the previous version will stay. When you try to
sign in with this account you will be asked to set a password.

After installation there is a default user identity to use. Sign in using it and
then create your required users.
User: admin
Password: Admin1

4.1.2 Language
English, German, French, Swedish

8 4048030-EN
Mycronic MYTrace1.3 4. User Interface

4.2 Home View

In Home view system information is monitored. The storage information is
only considering the machines’ backup files. Backup files are more critical
than the database because, if the database goes corrupt, they can be used
to generate a new correct database.

Figure 2. MYTrace Home view.

The following system information is shown:
• Total number of registered machines.
• Total used storage space.
• Total remaining storage space. Never run down near zero! At least 2 GB
must be remaining.
• Estimated date when the storage will be full. A ∞-character means not
an issue at current processing rate.
• Current event data processing rate in bytes per hour.
The Machine status is also displayed on the Home page.

In Machine Status part, the current status of the data collection can be
monitored for all registered machines. The status information is primarily
intended to be used by machine operators and production engineers to
verify that the traceability data is being processed by MYTrace system.

Note
If you move the pointer over a specific machine name, an
infotip appears showing extended information about that
machine and the data currently being processed.

This view does not require sign in.

4.3 Reports View

In Reports view two different report generators are available; one based on
component data and one based on PCB data. The purpose of these
generators is to simplify the creation of recall reports targeting defective
components. Which one to use depends on the information at hand.
• The component based recall report generator requires that the
Component Name and Batch Id are known.
• The PCB based Recall Report Generator requires that the PCB Name
and Location are known. It is also possible to add optional data to
narrow down the matching result set.

4048030-EN 9
4. User Interface MYTrace1.3 Mycronic

To access the Reports view the authenticated user must be a member of

MYTraceUser or MYTraceAdmin.

4.3.1 Help features

The features below are available when creating a report. They appear in
windows where the specific feature is useful.

info Click on the info icon and an

information window for the actual
view will appear.
* Indicates that mandatory data must
be entered.
Move the pointer over the icon and
an infotip will be displayed including
contextual help information.
Select all Selects all items in the specific list.
Deselect all Deselects all items from the specific
list.
Remove all Removes all items from the specific
list.

4.3.2 Component Based Report

This section describes in detail how to create and save a component based
report using the Component Based Report Generator.
The Component Based Report Generator should be used when the specific
component name and Batch Id are known for the component of interest.
The actual components are added to a list one by one. The components in
that list are then used by the report engine to create a report of all PCBs
where these matching components have been mounted. The report can be
created in several formats, for example HTML and PDF. It is also possible to
customize optional report data.

4.3.2.1 Create and save a component based report

Step 1 - Select components

Component name and Batch Id are mandatory data for this step.

10 4048030-EN
Mycronic MYTrace1.3 4. User Interface

1. Enter component name.

Note
As soon as one character or more is entered, a drop-
down completion list including matching choices appears.
To select a component, use the arrow keys and scroll
down to it and press Enter or just click on it.

2. Enter component Batch Id.

Figure 3. Example of component search criteria.

3. Click Add to list to add the component to the list.
4. Repeat the steps above until the required components are added to the
list.

Note
If an added component should be discarded, it is possible
to uncheck it in the list. The Remove all command can be
used to empty the list and start all over again.

5. Click Next.

Step 2 - Preview data

The preview data step shows an overview of the matched production
data, including Layout and Batch Id information. If the data for some
reason seems incomplete, it is possible to go back and edit the list of
selected components.
6. Click Next to proceed.

Step 3 - Configure report

The final step is to configure the report. There are some different data
formats available. To each format there are predefined templates to use.
The template controls the optional data that is possible to enter and the
logotype to use. The data formats available are described in the table
below.

Data Format Description

PDF Creates the report in PDF-format.
XML Creates the report in XML-format.
HTML Creates the report in HTML-format.
Text Creates the report in text-format.

4048030-EN 11
4. User Interface MYTrace1.3 Mycronic

7. Select data format.

8. Select one of the available templates.
9. Enter any optional data if required by the template.

Note
Before creating a report, any previously created report
must be saved; otherwise the report may be lost and has
to be recreated.

10. Click Create Report to create the report.

This step may take a while to complete depending on the amount of
report data to process.
11. The created report can be viewed and / or saved.

4.3.3 PCB Based Report

This section describes in detail how to create and save a PCB based report
using the PCB Based Report Generator.
This report generator should be used when you know at least the PCB name
and location designator for the component of interest. The report engine
uses the entered criteria to match all possible components and the PCBs
they have been mounted on. The report can be created in several formats,
for example HTML and PDF. It is also possible to customize optional report
data.

Report Criteria Description

PCB Name Mandatory information. The PCB of
interest that has a defective
component.
Location Mandatory information. The
defective component’s location.
Batch Id Recommended information. The
batch number of the PCB of interest.
PCB Id Recommended information. PCB
identification number.
From Optional information. Components
mounted before the entered date
will be ignored. If only From date is
entered, the system searches all
PCBs produced from that date and
that also matches the entered
Report Criteria.
To Optional information. Components
mounted after the entered date will
be ignored. If only To date is
entered, the system searches all
PCBs produced until that date and
that also matches the entered
Report Criteria.

4.3.3.1 Create and save a PCB Based Report

Step 1 - Enter criteria

PCB name and component location are mandatory data for this report.

12 4048030-EN
Mycronic MYTrace1.3 4. User Interface

1. Enter PCB name.

Note
As soon as one character or more is entered a drop down
completion list including matching choices appears. To
select a component, use the arrow keys and scroll down
to it and press Enter or just click on it.

2. Enter component location, for example R1, C1.

Note
By entering Batch Id, PCB Id and Production date criteria
it is possible to get better matched components.

3. Enter recommended and optional data if required. If you want to choose

a date, click on the calendar icon to pick desired date.

Figure 4. Example of PCB report criteria.

4. Click Next.

Step 2 - Select components

In this view a list of all components matching the report criteria is
presented. It is possible to deselect components that are not of interest
for the report purposes.
5. Verify that the components of interest are selected in the list.
To deselect a component, uncheck the check box. Components that are
unchecked will be shown as disregarded components in the list.
6. To alter the report criteria, click Back.
7. Click Next.

Step 3 - Preview data

The preview data step shows an overview of the matched production
data. If the report data for some reason seems to be incomplete it is
possible to go back and edit the list of matching components, or go
back further and edit the report criteria.

4048030-EN 13
4. User Interface MYTrace1.3 Mycronic

8. Click Next to proceed when the report data is complete.

Step 4 - Configure report

The final step is to configure the report. There are some different data
formats available. To each format there are predefined templates to use.
The template controls the optional data that is possible to enter and the
logotype to use. The data formats available are described in the table
below.

Data Format Description

PDF Creates the report in PDF-format.
XML Creates the report in XML-format.
HTML Creates the report in HTML-format.
Text Creates the report in text-format.
9. Select data format.

Note
If you choose PDF, you can set "Detailed PCB
information" which ensures all matched layouts and PCBs
are in the report.

10. Select one of the available templates.

11. Enter any optional data if required by the template.

Note
Before creating a report, any previously created report
should be saved; otherwise the report may be lost and
would have to be recreated.

12. Click Create report to create the report.

This step may take a while to complete depending on the amount of
report data to process.
13. The created report can be viewed and / or saved.

4.4 Administration View

When signed in to Administration view you can add, edit and delete users.
To access the Administration view the authenticated user must be a
member of MYTraceAdmin.

4.4.1 Add New User

To add a new user click Add User and the form below appears.

14 4048030-EN
Mycronic MYTrace1.3 4. User Interface

Figure 5. Adding a new user.

1. Enter user name.

Valid user name characters are a-z, A-Z, 0-9 and space.
2. Enter first name (optional).
3. Enter last name (optional).
4. Select roles that the new user should belong to.
5. Enter a password. Only Latin characters for password are safe to use.
6. Enter the password again to confirm it.
7. Click Create to confirm the supplied user information and the user is
created and added to the registered users list.

4.4.2 Edit User

Use this function if you want to change a user’s data.
1. Select a user to edit.
2. Click Edit User button.
3. Edit the user information.
4. Verify the changes made and click Update to store the updated user. If
no changes should be made click Cancel to return to the previous view.

4.4.3 Delete User

Use this function if you want to delete a user from the registered users list.
1. Select a user to delete.
2. Click Delete User whereby a confirmation message appears.
3. Click Yes to confirm the deletion or click Cancel to stop it.

4048030-EN 15
5. Miscellaneous MYTrace1.3 Mycronic

5. Miscellaneous
This chapter contains instructions on how to change dataservers when using
MYTrace. TPSys 2.9 or higher is compatible with MYTrace.

5.1 Change of Dataserver in TPSys 2.9 or higher

Follow these steps to change dataserver:
1. Exit MYTrace Harvester TPSys on the pick and place machine.
2. Exit Harvester TPSys on the dataserver, if not a local dataserver.
3. Verify that TPSys is shut down.
4. Stop MYTrace Harvester service.
Note that this service runs on the server, not on the machine.
5. Start TPSys and perform the change of dataserver.
For more information, refer to Administrator TPSys manuals and
upgrade guides.
6. Restart TPSys.
7. Clear the event log on the machine by selecting:
Utility > Clear Event Log
8. Configure the MYTraceHarvester.exe.config file according to the new
settings.
9. Start MYTraceViewer service on TPSys .
For more information, refer to the Installation manual.
10. Start MYTrace Harvester service.

5.1.1 Upgrade of TPSys

Concerns all traced machines.
Follow these steps to upgrade TPSys:
1. Exit TPSys on each pick and place machine.
2. Verify that TPSys is shut down.
3. Stop MYTrace Harvester service.
4. Upgrade the dataserver.
5. Upgrade each machine.
6. Start the MYTraceViewer service on the TPSys.
For more information, refer to the Installation manual.
7. Start the MYTrace Harvester service.
8. Start production on the pick and place machines.

5.2 Backup of Text Files and Database

5.2.1 Backup of text files
Make sure that you periodically backup the text files stored for each
machine under the backup directory that was selected during installation.
Only backup text files that are set to read only; other text files may still be in
use. MYTrace Harvester must be shutdown before removing any text files
from the backup directory.

5.2.2 Backup of database

We recommend that backup of the database should be performed
according to your own backup routines.
If you would like to know how you can backup and administrate
PostgreSQL, please visit their Internet web site.

16 4048030-EN
Mycronic MYTrace1.3 5. Miscellaneous

4048030-EN 17
Index MYTrace1.3 Mycronic

Index
Access levels ................................................................................................................ 8
Add New User ............................................................................................................ 14
Administration View ................................................................................................ 14
Backup of database ................................................................................................. 16
Backup of text files .................................................................................................. 16
Backup of Text Files and Database ................................................................. 16
Barcode scan ................................................................................................................ 3
Bold Font ........................................................................................................................ 2
Camera view ................................................................................................................. 3
Change of Dataserver in TPSys 2.9 or higher ............................................. 16
Component Based Report ................................................................................... 10
Create and save a component based report .............................................. 10
Create and save a PCB Based Report ............................................................ 12
Danger, Warning, Caution, and Note ................................................................ 2
Delete User ................................................................................................................... 15
Disclaimer ....................................................................................................................... 7
Edit User ........................................................................................................................ 15
Features .......................................................................................................................... 6
Features and Functions .......................................................................................... 5
Hardware ........................................................................................................................ 6
Help features .............................................................................................................. 10
Home View .................................................................................................................... 9
Icons .................................................................................................................................. 3
Included Parts .............................................................................................................. 5
Introduction ................................................................................................................... 5
Italic Font ........................................................................................................................ 2
Language ........................................................................................................................ 8
License ............................................................................................................................. 6
Lists ................................................................................................................................... 3
Menu Selections .......................................................................................................... 2
Miscellaneous .............................................................................................................. 16
MYCenter Material Handling .....................................................................................
Navigation ...................................................................................................................... 3
PCB Based Report .................................................................................................... 12
Reports View ................................................................................................................ 9
Requirements ............................................................................................................... 6
Revision Information .................................................................................................. 1
Sign in .............................................................................................................................. 8
Software ......................................................................................................................... 6
System Overview ....................................................................................................... 5
Technical Specifications ......................................................................................... 5
Terms Used ................................................................................................................... 6
Text Conventions ....................................................................................................... 2
TPSys web interface ................................................................................................. 3
Upgrade of TPSys .................................................................................................... 16
User Interface ............................................................................................................... 8

18 4048030-EN
Mycronic MYTrace1.3 Index

4048030-EN 19