Auf dieser Seite https://validator.countermetrics.org/ ist es möglich, COUNTER-Daten - seien es Reports in Tabellenform oder eine API-Schnittstelle - gemäß der gültigen COUNTER-Spezifizierung prüfen und validieren zu lassen. Die Seite stellt einen umfrangreichen Prüfbericht vor, der die Fehler und Hinweise auflistet.
Für die Nutzung des Tools ist ein Nutzeraccount erforderlich. Dieser kann problemlos angelegt werden; es sind nur eine Mailadresse und ein Passwort erforderlich.
Nach dem Login wird die Liste erfolgter Validierungen angezeigt. Diese Liste ist nach initialer Anmeldung natürlich leer.
Oberhalb der Tabelle gibt es zwei Knöpfe "Validate a file" und "Validate API". Hierüber können COUNTER-Daten zur Prüfung geschickt werden.
Datei-Validierung
Über den Knopf "Validate a file" gelangen Sie zur Dateieingabe, wo Sie eine Datei hochladen können. Diese Datei kann eine Excel-Tabelle sein, die einen tabellarischen COUNTER-Report oder ein JSON-Auszug enthält, der die Daten in einer JSON-Map aufschlüsselt. Nach dem Hochladen wird die Datei geprüft und ein Prüfbericht erzeugt. Der Prüfbericht kann aus der Tabelle der Validierungen aufgerufen werden.
Schnittstellenvalidierung
Der Knopf "Validate API" bringt Sie zur Schnittstellenvalidierung. Der erste Schritt ist die Eingabe der Serverdaten. Wenn Sie Ihre Plattform bei der COUNTER-Zertifizierungsstelle angemeldet haben, können Sie sie hier heraussuchen, alternativ können Sie die Daten Ihres Servers manuell eingeben:
- unter "CoP version" die Versionsnummer (5 oder 5.1), die Ihre Schnittstelle erfüllt bzw. erfüllen soll
- die URL Ihrer Plattform
- falls Ihr Server das verlangt: der COUNTER-Name der Plattform. ACHTUNG: dies ist nicht zwingend der Name der Plattform, wie er in der we:kb angegeben ist! Erkundigen Sie sich bei Ihrem Techniker bzw. Ihrem Dienstleister, ob und wenn ja wie Ihre Plattform konkret über die API angesteuert wird
- unter "Credentials" ein gültiges Schlüsselpaar aus Kundennummer (Customer ID), Requestor ID und - falls erforderlich - ein API-Key. Erkundigen Sie sich auch hier bei Ihrem Techniker bzw. Dienstleister, welche Credentials für die API erforderlich sind
Im nächsten Schritt wählen Sie den Endpunkt und ggf. Report aus, den Sie testen möchten: unter "Endpoint" den zu testenden Endpunkt. Wenn Sie irgendeinen anderen Endpunkt als "report" auswählen, sind Sie schon fertig und können im nächsten Schritt die Validierung veranlassen.
Falls Sie "report" als Endpunkt ausgewählt haben, fragt Sie der Validator, welcher Report getestet werden soll. Sie können einen Zeitraum definieren, von wann bis wann die Nutzungstatistiken reichen sollen. Falls Sie einen der Master-Reports (TR, DR, PR, IR) testen möchten, können Sie neben dem Zeitraum auch die weiteren Parameter wie Metrik, Zugriffstyp etc. konfigurieren. Anschließend können Sie Ihre Eingaben prüfen und die Validierung starten.
Auswertung der Validierung
Wenn Sie Daten zur Validierung eingegeben haben, tauchen diese in der nun befüllten Tabelle "My Validations" auf. Unter "Filename" können Sie sich den Prüfbericht abrufen; er wird bis zu sieben Tagen auf dem Server hinterlegt.
Wenn Sie sich einen Bericht ansehen, können Sie die Fehler im Reiter "Statistics" aufrufen. Dort stehen die Fehler und Hinweise nach Fehlergrad aufgeschlüsselt.
