Skip to content

Federation Migration

Steps

Steps to follow in order:

  • 1) Define organization structure and tournament taxonomies (responsible entity: Federation)
  • 2) Prepare import script (responsible entity: Coral)
  • 3) Deploy dedicated test environment for federation (responsible entity: Coral)
  • 4) Federation testing (iterate until we find the proper settings and configurations) (responsible entity: Federation)
  • 5) Find Coral federation delegates(s) before going LIVE (knowledge base, support, direct contact etc.) (responsible entity: Federation)
  • 6) Go LIVE (responsible entity: Coral)
  • 7) Progressively import history data (tournaments, competitions, rankings etc) (responsible entity: Federation and Coral)

Organization Structure

Hierarchy

A federation must choose one of the following hierarchy templates:

  • Player > National Federation
  • Player > Club > National Federation (recommended)
  • Player > Club > Regional Federation > National Federation

Regional Federation is recommended when regional independent rankings are required.

Membership Types

List of recommended membership types to allow players play depending on their preference:

  • Recreational - club/local level
  • National - national competitions
  • International - international competitions

Info

For a better player experience and easier management of the federation structure, it is best to have every member association using the same membership types.

Club join policy

Choose one of the following options:

  • Players are allowed to be active members of only 1 club under the national federation (recommended)
  • Players are allowed to be active members of 1 or more clubs under the national federation (only possible if membership types are not enforced by the national federation).

Fees

Info

For a better player experience and easier management of the federation fees, it is best to have every player pay directly to only one parent organization/club. The national federation can charge the member associations (club or regional) a fee based on the players number or types (see indirect affiliation fees).

Membership fees

Options for player paying directly to parent organizations:

  • Player > Club
  • Player > Regional Federation
  • Player > National Federation
  • Player > International Federation

All of these options can be active at the same time. The player will have to pay to each parent organization a fee starting with the lowest level (club > regional > national). After each payment is confirmed, the player will become active within the same federation/club he has paid his membership fee to.

Options for player paying indirectly to parent organizations:

  • Player > Club > National Federation
  • Player > Club > Regional Federation
  • Player > Regional Federation > National Federation
  • Player > National Federation > International Federation

The amount can be adjusted based on different parameters like membership type, player category etc.

Affiliation fees

Organization/Club paying a fixed amount directly to parent organizations:

  • Club > Regional Federation
  • Club > National Federation
  • Regional Federation > National Federation

Player Skills

Choose one option:

  • National federation has a global skill level rule for all their players.

  • National federation does not have player skills defined.

  • Example:

    • Master
    • Pro
    • Amateur
    • Rookie
    • Beginner

Info

Coral can auto-update player's skill based on their ranking or ratings. It is best to have between 3 to 5 different types of skills.

Affiliation Calendar

Choose one option:

  • International: 1st of January <-> 31st of December (recommended)
  • Custom: 1st of September <-> 31st of August (example)

Tournament Taxonomies

Tour & Calendar

  • National tour name: National Tour
  • Calendar: (same as organization)

Tip

Each tour can have an independent calendar, tournament categories and ranking systems if necessary.

Match Formats

Provide a list of match formats that the federation requires besides the most common ones (see below).

  • Points
    • First to 7
    • First to 7 draw at 6
    • First to 8 draw at 7
  • Games
    • First to 2 games won - decisive game up to 8
    • First to 3 games won - decisive game up to 8
    • First to 2 games won - decisive game 2 goals diff
    • First to 3 games won - decisive game 2 goals diff
  • Team:Relay
    • Race to 40 - S/D/S/D - 2 goals diff
    • Race to 30 - D/D/D - 2 goals diff
  • Team:Split
    • n/a

Tournament Categories

  • Define a list of tournament categories for individuals and club teams.
  • Each tournament category has to be assigned a point system (see below).
  • It is recommended to have between 2-4 categories.

Example Table:

Category Point System International
Open Local ITSF50 -
Open Regional ITSF100 -
Open National 250 ITSF250 Pro Tour
Open National 500 ITSF500 Masters

Membership access:

Category/Permission Recreational National International
Open Local ✅ ✅ ✅
Open Regional ✅ ✅
Open National 250 ✅? ✅
Open National 500 ✅? ✅

Ranking Systems

Individual player

Most common defaults:

Singles Doubles Combined Classic
Open ✅ ✅ ✅ ✅
Men
Women ✅ ✅
Junior U19 ✅ ✅
Junior U16
Junior U13
Senior O50 ✅ ✅
Senior O63
Open Mixed ✅
Junior Mixed
Senior Mixed
Wheelchair
  • Define the number of how many top results to be counted: Top 7
  • U19 options: 50% of Open
  • O50 options: 50% of Open

Tip

Coral can assist to create advanced ranking systems that can include results from more than just one competition category. For example, assign points to Junior U19 players if they play in Open and the tournament does not have any Junior U19 competition.

Tip

Coral can assist to create custom points within the ranking systems depending on teams attending.

Import

Regions

To import regions the export must contain the following fields:

  • Name
  • Owner - region owner/president (international license or Coral user code)
  • Managers (comma separated list of international license or Coral user code)

Clubs

To import clubs the export must contain the following fields:

  • Name
  • Region short name (optional - only if club belongs to a region)
  • Owner - region owner/president (international license or Coral user code)
  • Managers (comma separated list of international license or Coral user code)

Players

For importing non-international players only, make sure the federation has the players' consent. If the players' haven't givent their consent, they must create an account in Coral by themselves using the link provided to each federation.

The following fields are required to import players with consent:

  • Last name (required in order for the player to take over his account)
  • First name (required in order for the player to take over his account)
  • Gender (optional - can be filled by the player after the account take-over)
  • Nationality (optional - can be filled by the player after the account take-over)
  • Birth year (optional - can be filled by the player after the account take-over)
  • Club (optional)

Contact information is not required (email, phone, address) as these fields must be filled by the player.