PREVIEW This application is in preview. Features and functionality may change.

How-To Guide

Note: This section is under construction and may not be accurate.

This guide walks you through the complete workflow for processing XML files with XML Translator.

Prerequisites

  • An account on XML Translator (register at the login page)
  • Hockey match XML files to process

Step-by-Step Workflow

1. Upload Your XML Files

Once logged in:

  1. Click "Upload" in the navigation menu to reach the upload page.
  2. Click the file upload area or drag and drop your XML files. You may upload multiple files at once.
  3. Click "Upload and Process" to begin.

SCREENSHOT: Upload page with file selector

Tips:

  • File names should ideally contain team names for automatic detection
  • Maximum file size: 50MB per file
  • Note that files will only be stored on our servers for 30 minutes, and they will be deleted afterwards.

2. Team Selection (if needed)

If the application cannot automatically determine teams from the filename, you will be redirected to the team selection page.

  1. For each file, select the home and away teams from the dropdown.
  2. If a team is not available in the dropdown, you may create a team using the "Add" button.
  3. Click "Confirm Teams and Continue" when all teams are selected.

SCREENSHOT: Team selection page

3. Review Automatic Mappings

The application will automatically map each code it sees in the XML file to known event codes and team names. The results are presented on the mapping page.

You will see a summary of all files being processed. Use the links in the table or navigate via the sidebar to view a specific file.

Code mapping

Codes are categorised as follows:

  • Green: Exact matches for both event type and team (unless team is not required for that event type).
  • Yellow: Fuzzy matches - The app has matched the code to an event type with similar spelling.
  • Red: Codes that couldn't be matched automatically.
  1. If a team code is red, you may map the code manually by using the "Map Team" button. This opens the Team Mapping dialogue box. Select a team and click "Save Team Mapping".
  2. If an event code is yellow or red, you may map the code manually by using the "Map Event" or "Improve" button. This opens the "Map Event Type Code" dialogue box.
  3. Select an event from the dropdown.
    1. If the right one is not available, you may create a new one by clicking on "Can't find the right event? Create a new one", and filling in the details in the "Create Custom Event Type" dialogue box.
    2. If your custom event type does not require a team, uncheck the "Requires Team" box.
  4. Once you are happy with the mapping, confirm with the "Save Event Mapping" button.
  5. Once you are happy with all the mappings, download the file with the "Approve and Download" button at the bottom of the page.

Note that you can still download a file even if not all codes are mapped, and these will be left unchanged in the output file.

You may also download multiple files on the summary page.

SCREENSHOT: Mapping page with colour-coded events

Advanced Features

Managing events, teams and manual mappings

All mappings that you make while processing XML files are saved to your account. You can see these in the Settings page, which you can access in the top navigation bar.

  1. View all standard event types
  2. Add custom event type variants
  3. Manage your saved mappings
  4. Create team name aliases

Settings and Preferences

Customise your experience:

  1. Update your profile information
  2. Change your password
  3. Manage custom event mappings
  4. Configure team aliases

Best Practices

  1. Consistent Naming: Use consistent team names in filenames
  2. Regular Mapping Reviews: Periodically review your saved mappings
  3. Batch Processing: Process similar matches together for efficiency
  4. Save Custom Mappings: Create mappings for your specific data sources
  5. Verify Output: Always check the first few processed files carefully

Next Steps