Importeren en exporteren

OpenPairings leest en schrijft verschillende formaten. Ze verschillen in doel:

Importeren#

Op de pagina Toernooien bevat het menu Importeren de manieren om een toernooi binnen te halen (back-up, overdracht, SWAR, TRF). Elk ervan opent een paneel met een bestandskiezer of een gebied waarin je een bestand kunt slepen.

TRF-bestand#

Een TRF-toernooi importeren leest een .trf-bestand in TRF26- of TRF16-formaat en maakt een volledig toernooi: de kopgegevens (naam, plaats, federatie, datums, bedenktijd, arbiters, rondedatums), de spelers met hun FIDE-ID's, ratings, titels en geboortedata, de rondes, de paringen, de resultaten en de byes. Een bye of afwezigheid die het bestand voor de nog niet gepaarde ronde vermeldt (een record 240, of de XXZ-regel die SWAR schrijft voor de spelers die in de volgende ronde afwezig zijn), komt binnen als bye voor die ronde, zodat de volgende ronde die spelers overslaat. De startrangschikking van het bestand wordt het paringsnummer. Het type van het toernooi wordt uit het bestand overgenomen (Zwitsers, rondetoernooi, teams). Het onbekende resultaat ? komt terug als uitgestelde partij, zoveel waard als de X van het bestand (record

162. een onbekend resultaat waard maakt - een remise als het bestand niets zegt. Een X die in de eigen punten van het bestand een winst of een verlies is, wordt ook hoe het toernooi een uitgestelde partij telt (Instellingen, Puntentelling), en dat haalt het uit de FIDE-modus; een X die geen van de drie is, wordt geweigerd, met de waarde erbij. Op de pagina Paringen staat zo'n bord als * uitgesteld; kies daar het echte resultaat zodra je het kent. Een bord dat het bestand paart maar nog zonder resultaat (een bestand dat bewaard werd terwijl de ronde gespeeld werd) komt terug als een partij die nog gespeeld wordt: het importverslag noemt de ronde, en de volgende ronde wacht op het resultaat. Teambestanden geven de teams en hun bordvolgorden, en de matches van elke ronde die uit de borden kunnen worden afgeleid (een ronde waarvan de matches onduidelijk zijn, wordt benoemd, niet geraden).

Het programma vertrouwt het bestand niet: het herberekent de punten en somt elke speler op wier totaal afwijkt van het bestand, en elke ronde van een Zwitsers toernooi wordt gecontroleerd op de paringsregels: een herhaalde partij, twee spelers die beiden dezelfde kleur verschuldigd waren, een paar dat de eigen verbodsregistratie van het bestand verbiedt, een tweede door de paring toegekende bye.

De controlestap. Er wordt niets geschreven tot je de controle hebt gezien die volgt op de keuze van het bestand:

• De versie. De controle zegt of het bestand als TRF26 of als TRF16 is gelezen. TRF16 heeft geen records voor het puntensysteem, het type toernooi of de tiebreaks; de controle somt dan op wat de import in plaats daarvan heeft gebruikt.
• De aanpassingen. Elke plek waar de import iets moest beslissen, wordt vermeld: de standaard puntentelling die is gebruikt wanneer het bestand geen puntensysteem heeft, het type toernooi dat is overgenomen wanneer de code ontbreekt of onbekend is, een Zwitsers toernooi waarvan de code zegt dat het met de editie van 2017 van het Nederlandse systeem is gepaard (de rondes blijven zoals gespeeld; de rondes die hier worden gepaard, volgen de huidige), rondetoernooi-cycli die zijn teruggebracht tot wat het programma speelt, tiebreaks die niet in het bestand stonden of die het programma niet berekent, een aantal rondes dat is overgenomen uit de rondes die het bestand bevat, deputy-arbiters boven de vierde, forfait- en bye-punten van teams, extra punten buiten de puntentelling, virtuele punten die niet de Baku-methode van de FIDE zijn (geïmporteerd als extra punten in versnellingsmodus: elke ronde houdt de virtuele punten waarmee ze is gepaard, en elke speler krijgt de punten die het bestand voor de volgende ronde geeft), partijen zonder tegenstander die als byes zijn geïmporteerd, en rondes die niet zijn gecontroleerd omdat alleen een Zwitsers volgens het Nederlandse systeem dat kan.
• Symbolen die geen resultaatcode zijn. Een symbool in een resultaatkolom dat geen resultaatcode is (een 5, een x, een %) wordt gelezen als een partij met onbekende resultaat en geïmporteerd als uitgestelde partij, net als ?. Elk symbool wordt vermeld met de speler, het startnummer, de ronde en het gevonden symbool. Het resultaat van de tegenstander in die ronde wordt ook op onbekend gezet, en de lijst zegt dat, omdat beide kanten van een partij moeten overeenkomen. Een symbool in een ronde zonder tegenstander (0000) is geen partij en het bestand wordt nog steeds geweigerd; de melding noemt de speler, de ronde en het symbool. Annuleren importeert niets.
• Resultaten aangenomen voor de controle. De rondes na een partij met een onbekende resultaat (?, of een symbool dat zo gelezen wordt) worden toch getoetst aan de paringsregels, met die partij geteld als gespeeld en de X van het bestand waard voor beide spelers (een remise zonder X) - wat de import ervan maakt, een uitgestelde partij. De controle zegt welke rondes zo getoetst zijn en somt elke aangenomen partij op, met de ronde en de twee spelers.
• Spelers die teruggetrokken lijken. Een TRF-bestand kan niet zeggen dat een speler zich heeft teruggetrokken: het toont een speler met niets in de latere rondes, en zo ziet een afwezigheid er ook uit. De controle somt daarom, onder Lijkt teruggetrokken - wordt in de volgende ronde gepaard tenzij je hem als teruggetrokken markeert, elke speler op die eerder speelde of een bye had en geen partij en geen bye heeft in de laatste ronde van het bestand, of in de laatste paar rondes na elkaar. Elk heeft een vinkje Importeren als teruggetrokken. Aangevinkt wordt de speler als teruggetrokken geïmporteerd en niet meer gepaard; niet aangevinkt als actief, en dan paart de volgende ronde hem. Een speler met niets in de laatste twee rondes of meer is al aangevinkt; een speler die alleen de laatste ronde miste niet, want één gemiste ronde is meestal niet meer dan dat. Pas beide aan zoals je wilt, hier of nadien in de spelerslijst. Niet in de lijst: een late instapper (lege rondes vooraan, partijen achteraan), een speler met niets in geen enkele ronde, een speler met een bye van een half of een heel punt in de laatste ronde of een bye die al voor de volgende is toegekend, iedereen in een bestand waarvan alle rondes gespeeld zijn, en de spelers van een rondetoernooi of een teamtoernooi. Een bye van nul punten telt als niets. Wat je koos, wordt bij het toernooi en in het auditlogboek bewaard.
• Rondes die een paringsregel breken. Als een ronde van het bestand een regel breekt, krijgt de controle de kop Deze rondes van het bestand breken de FIDE-paringsregels en zegt dat het importeren niet in overeenstemming is met de paringsregels. Dit is een waarschuwing die je uitdrukkelijke bevestiging vraagt (niveau 3). De knop luidt dan Toch importeren; anders luidt hij Importeren. Annuleren importeert niets.

Een bevestigde import maakt het toernooi met de rondes precies zoals het bestand ze vastlegt. Wat de import heeft aangepast en elke regel die is gebroken, wordt bij het toernooi en in het auditlogboek bewaard. (Het TRF-bestand voor het ratingkantoor bevat alleen records en geen commentaarregel daarover; de kopie en het ITDX-bestand wel.)

JSON-back-up#

Een OpenPairings-back-up importeren leest een bestand dat is gemaakt met Volledige back-up exporteren (JSON) (hieronder), tot 10 MB. Het geeft een nieuw toernooi, dat van jou is, met de instellingen, officials, teams, elk spelerveld, rondes, resultaten, byes, verboden paringen, paringsregels, de registratie van wat er naar het ratingkantoor is verstuurd en de partijen die live borden meldden (Live borden). Het origineel wordt nooit aangeraakt, ook niet wanneer je je eigen bestand opnieuw importeert. Gaat er iets mis, dan blijft er niets achter.

Wat niet meereist: herstelpunten, het logo, de telefoons die zijn ingeschreven voor het invoeren van resultaten, de koppelcodes en de relaissleutel van een bordkastje, de vergrendeling van een overdracht, en alles wat vanzelf zou werken: de publicatieschakelaar en het adres en het open inschrijfformulier (publiceren moet voor de kopie opnieuw worden ingeschakeld, Publiceren). Het auditlogboek en de medewerkers reizen alleen mee in een overdrachtsbestand, en de medewerkers komen terug als openstaande uitnodigingen die elke persoon moet aanvaarden.

Een toernooi in een groep (Toernooigroepen) neemt de naam van de groep, zijn label en zijn plaats mee in het bestand, ter informatie. De import gebruikt ze niet: de kopie komt in geen enkele groep aan, en je voegt ze op haar pagina Instellingen aan een groep toe als je ze daar wilt.

SWAR-bestand#

Met de functie SWAR-import aan (menu Account, Functies, Belgisch pakket) leest Een SWAR-toernooi importeren een .swar-bestand met spelers, rondes, resultaten, byes, puntentelling (met de 3-2-1 clubpuntentelling inbegrepen), afwezigheden en de categorieën. Spelers zonder FIDE-ID worden in de FIDE-lijst opgezocht, en je bevestigt de overeenkomsten in een stap FIDE-ID's oplossen. Een SWAR-teamcompetitie kan worden geïmporteerd als individueel toernooi (de partijen), niet als teamevenement.

Een SWAR-bestand opnieuw uploaden {#uploading-a-swar-file-again}

Is het bestand een toernooi dat je hier al hebt (SWAR bewaart in elk bestand één ID per toernooi), dan zegt het paneel dat en biedt het drie wegen aan: Vergelijken en samenvoegen, het toernooi openen, of een andere kopie importeren.

Vergelijken en samenvoegen toont alles wat verschilt tussen het bestand en het toernooi, en er verandert niets tot je op Samenvoegen drukt:

• Toernooi-instellingen - houd die van hier of neem die van het bestand over. Instellingen die bepalen hoe rondes gepaard worden, blijven zoals ze zijn zodra er een ronde gepaard is. Instellingen die het bestand niet heeft (normen, een handmatige rangschikking, publiceren) worden nooit aangeraakt.
• Spelersgegevens - houden of die van het bestand overnemen. Spelers worden herkend aan hun FIDE-ID, dan hun nationaal ID, dan naam en geboortejaar. Spelers die alleen in het bestand staan, kun je toevoegen: ze krijgen de volgende vrije paringsnummers en spelen mee na de laatste ronde hier. Niemand krijgt een ander nummer, en spelers die alleen hier staan, blijven.
• Resultaten en byes - één keuze per partij. Een resultaat dat het bestand heeft en dat hier ontbreekt, wordt overgenomen tenzij je anders kiest. Een resultaat dat verschilt van een resultaat dat hier is ingevoerd, is een conflict, gemarkeerd in de marge, en blijft zoals het hier is tenzij je dat van het bestand kiest.
• Paringen die verschillen worden getoond en nooit gewijzigd: een ronde die hier gepaard is, wordt niet opnieuw gepaard vanuit een bestand. Wil je de paring van het bestand, verwijder dan de ronde hier en voeg opnieuw samen.
• Rondes alleen in het bestand, na de laatste ronde hier, kun je toevoegen.

Voor er iets geschreven wordt, wordt het toernooi zoals het was bewaard als herstelpunt op de pagina Geschiedenis, zodat je een samenvoeging waar je spijt van hebt met één klik ongedaan maakt. Verandert het toernooi terwijl je de vergelijking bekijkt, dan wordt er niets samengevoegd en vraagt het paneel je het bestand opnieuw te uploaden.

Resultaten uit een CSV-bestand#

Op de pagina Paringen, Meer, Resultaten importeren (CSV). Zie Resultaten.

Een overdracht ontvangen#

Een overdracht ontvangen neemt een toernooi op dat een andere kopie van het programma heeft overgedragen. Zie Accounts, delen en overdracht.

Exporteren#

Instellingen, Exporteren (de pagina Export / back-up):

TRF (FIDE-ratingverslag)#

Het TRF26-bestand voor het ratingkantoor. Een tabel toont elke gepaarde ronde met de stand (wordt gespeeld, klaar om te versturen, verstuurd) en een vinkje. Een kopie downloaden (niet voor rating) en Alle rondes (TRF-kopie, niet voor rating) maken een kopie van datzelfde bestand met enkele commentaarregels die dat zeggen, en Versturen… maakt het bestand voor het ratingkantoor en markeert de partijen als verstuurd. Dit maakt deel uit van de rapportageprocedure en wordt uitgelegd in Versturen naar FIDE.

Het geschreven bestand is TRF26, het rapportformaat van 2026. Het heeft de spelerregels in de TRF16-indeling, en de toernooirecords: het aantal rondes (142), de startkleur (152), het puntensysteem als dat niet 1, ½, 0 is (162), het programma (182), het type toernooi (192, bijvoorbeeld FIDE_DUTCH_2025 voor een Zwitsers toernooi, _BAKU met versnelling, BERGER_ROUNDROBIN_Gn, FIDE_TEAM_TYPEA_MP_GP, of CUSTOM_SWISS voor Keizer), de tiebreaks (202) en het speeltempo (222). Het meldt de gespeelde partijen en niets wat er alleen is om de volgende ronde te paren: geen virtuele punten (250), geen verboden paringen (260), geen bye voor een nog niet gepaarde ronde (240) en geen administratieve extra punten (299). Een kopie voegt bovenaan ###-commentaarregels toe die zeggen dat het een kopie is, en de notities die het programma over het toernooi bijhoudt. Overzetten naar een ander programma (ITDX) is een derde bestand, om een lopend toernooi aan een ander paringsprogramma over te geven: het schrijft ? voor partijen zonder uitslag (en X in record 162), de nationale ratingrecords, de paringsrecords (250, 260, 240, 299), alle notities, en een blok ### OP-regels dat alleen geschreven wordt, met instellingen, regels, het tijdstip waarop elke ronde gepaard werd en de rondegebeurtenissen, met de reden die je bij een handmatige wijziging gaf ernaast (gewone ASCII, zonder accenten). Het is niet voor rating en zegt dat in de naam (ITDX-NOT-FOR-RATING) en erin. Importeer je het, dan krijg je dezelfde paringen, kleuren en scores; Versturen naar FIDE legt het verschil tussen de drie bestanden uit.

Hoe de engine elke ronde paarde. Het ITDX-bestand eindigt, na de laatste speler, met ### OP trace-regels: voor elke ronde in het bestand hoe de paringsengine ze paarde, in haar eigen woorden. Voor een Zwitserse ronde is dat de eigen uitvoer van de engine: de ingeladen ronde, de borden met hun kleuren, hoe de scoregroepen elkaar voedden (de float-cascade) en, per groep, wie afzakte, wie gepaard werd, wie floatte en welke criteria de doorslag gaven. Dat wordt vlak na het paren berekend, uit precies wat de engine kreeg, en de eerste regel zegt of het eindigt met de borden die bewaard werden. Een ronde van een Zwitsers teamtoernooi krijgt het verslag van de engine over de matchen, de bye en de kleuren. Een ronde die gepaard werd voor dit bewaard werd, toont in de plaats de bewaarde uitleg van de ronde, met dat label erbij; een rondetoernooi, een Keizer-ronde, het tweede deel van een match en een ronde die je met de hand maakte, zeggen dat er geen run van de engine te tonen is. Werden de borden gewijzigd nadat de engine ze paarde, dan zegt een regel dat. Spelers staan er enkel met hun startnummer in. Net als de rest van het ### OP-blok is het ter informatie: importeer je het bestand, dan wordt het genegeerd, en het bestand voor rating en de kopie hebben het nooit.

Elke gepaarde ronde kan ook worden geselecteerd met ?rounds=1-5 in het adres van de download (bereiken en losse rondes, zoals 1-3,6).

Extra punten in het bestand. In het ITDX-bestand (niet in het bestand voor rating) worden extra punten die in de rangschikking meetellen geschreven als record 299: een handicap van vóór ronde 1 (ronde 000), punten die in versnellingsmodus in de eindrangschikking blijven op ronde 999. Extra punten in versnellingsmodus zijn ook virtuele punten (250): de punten waarmee elke ronde is gepaard, en, zolang er rondes over zijn, de punten waarmee de volgende ronde zal worden gepaard. Een toernooi dat uit het bestand wordt geïmporteerd, heeft ze allemaal terug en paart zijn volgende ronde zoals dit toernooi. Extra punten die noch in de rangschikking meetellen noch de paring bereiken (een handicap die niet wordt geteld, of een negatieve waarde in versnellingsmodus wanneer de punten niet worden behouden), hebben geen record in een TRF: een regel onder de downloads zegt hoeveel spelers zulke punten hebben, en een toernooi dat uit het bestand wordt geïmporteerd, heeft er geen.

De oudere TRF16-schrijfwijze van de uitbreidingsregels, die TRF-paringsprogramma's zoals bbpPairings lezen, is beschikbaar door ?dialect=engine toe te voegen aan het adres van de download.

Een uitgestelde partij wordt geschreven als het onbekende resultaat ?, in het bestand een remise waard (de X van record 162). Wanneer elke uitgestelde partij in het bestand voor beide spelers als dezelfde winst of hetzelfde verlies telt - een toernooi geïmporteerd uit een bestand waarvan de X dat zei, bijvoorbeeld - is X die waarde, zodat de punten van het bestand overeenkomen met de rangschikking en het bestand opnieuw importeren hetzelfde toernooi geeft. Wanneer het toernooi uitgestelde partijen intussen als verschillende dingen telt - bijvoorbeeld een overwinning voor de speler die het uitstel niet vroeg, wat alleen buiten de FIDE-modus kan - verschillen de rangschikking en het bestand in punten; de plaatskolom van het bestand wordt dan berekend uit de eigen punten en tiebreaks van het bestand, en niet overgenomen van de pagina Rangschikking. Met de standaardwaardering (remise voor beiden) zijn de twee gelijk.

Back-up en kopie#

• Volledige back-up exporteren (JSON) - het hierboven beschreven bestand, voor dit toernooi. Op de pagina Toernooien exporteert Alles exporteren (JSON) elk toernooi dat je bezit in één bestand.
• .swar exporteren (v7, experimenteel) (Belgisch pakket) schrijft een SWAR-bestand. Een regel somt op wat het SWAR-formaat van dit toernooi niet kan bevatten - onder meer een afwezigheid die iets anders dan een half punt waard is (SWAR heeft een vakje voor het halve punt en verder niets) en een uitgesloten speler, die als Forfait van SWAR wordt weggeschreven, net als een teruggetrokken speler.
• SWAR-resultatenpagina exporteren (.html) (Belgisch pakket) schrijft de resultatenpagina in SWAR-stijl.
• Publiceren op de uitslagensite van de federatie (Belgisch pakket, beheerder).

Spelers (CSV)#

Spelers exporteren (CSV): je kiest de kolommen (toevoegen, verwijderen, omhoog of omlaag verplaatsen), het kolomscheidingsteken (komma, puntkomma voor Excel op een Belgische of Nederlandse computer, tab, pipe), de volgorde van de rijen (startrangschikking en rating, of naam), of afwezige spelers worden weggelaten, en of de UTF-8-markering wordt toegevoegd die ervoor zorgt dat Excel de accenten goed leest.

PGN#

Pagina Paringen, Meer, PGN (alleen metadata - er worden geen zetten bewaard): deze ronde of alle rondes, met of zonder bordnummers, of een bereik van borden. Het programma bewaart geen zetten; elke partij in het PGN-bestand heeft de spelers, de ronde, de datum, het resultaat en een resultaatteken als zettekst. Het is een geldig PGN-bestand, maar een partij die niet opnieuw kan worden afgespeeld.

Een toernooi met live borden heeft ook de partijen die de borden meldden, met hun zetten: zie Partijen en PGN, en Elektronische borden installeren voor hoe ze daar komen.

De FIDE-formulieren#

Geavanceerd, Normen (Categorieën en normen).

Back-ups die het programma maakt#

Een back-up van de toernooidatabase wordt automatisch ongeveer eens per dag geschreven (zie Accounts, delen en overdracht), en vóór elke handeling die moeilijk ongedaan te maken is, wordt een herstelpunt bewaard. Deze zijn los van de bestanden hierboven.